# Projektowe zasady dla backPRO

## Stack
- **Język:** PHP 8.1+
- **Framework:** Custom (bez frameworka — PSR-4 autoload)
- **HTTP Client:** Guzzle 7
- **Config:** phpdotenv
- **Baza danych:** SQLite (migracje SQL)
- **Frontend:** PHP templates (vanilla)

## Zasady kodu
- Stosuj PSR-12 dla formatowania kodu PHP
- Nazewnictwo: PascalCase dla klas, camelCase dla metod, snake_case dla zmiennych DB
- Unikaj zagnieżdżeń > 3 poziomy — wydzielaj do metod
- Komentarze tylko gdy wyjaśniają "dlaczego", nie "co"

## Baza danych
- Schemat dokumentowany w `.paul/docs/DB_SCHEMA.md`
- Każda zmiana schematu wymaga migracji w `migrations/`
- Nie modyfikuj istniejących migracji — twórz nowe
- Konwencja nazw: `NNN_opis.sql` (np. `013_nowa_tabela.sql`)

## Testy
- Uzupełnij jak uruchamiać testy

## Dokumentacja
- Dokumentacja techniczna w `.paul/docs/`
- Przy każdej zmianie aktualizuj odpowiednie pliki docs
- `TECH_CHANGELOG.md` aktualizowany po każdej fazie

## Wdrażanie
- (Uzupełnij procedurę deploy)

## UI/Frontend
- PHP templates w `templates/`
- (Uzupełnij konwencje frontendowe — komponenty, style)