37 lines
1.1 KiB
Markdown
37 lines
1.1 KiB
Markdown
# 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)
|