34 lines
1.1 KiB
Markdown
34 lines
1.1 KiB
Markdown
# Projektowe zasady dla globelus.pl
|
|
|
|
## Stack
|
|
- **Jezyk:** PHP
|
|
- **Framework:** Wlasny system MVC + szablony PHP
|
|
- **Wersja:** legacy/custom
|
|
|
|
## Zasady kodu
|
|
- Stosuj PSR-12 dla formatowania kodu PHP.
|
|
- Nazewnictwo: PascalCase dla klas, camelCase dla metod, snake_case dla pol DB.
|
|
- Unikaj zagniezdzen > 3 poziomy; wydzielaj metody pomocnicze.
|
|
- Komentarze tylko gdy wyjasniaja "dlaczego", nie "co".
|
|
|
|
## Baza danych
|
|
- Schemat dokumentowany w `.paul/docs/DB_SCHEMA.md`.
|
|
- Kazda zmiana schematu wymaga migracji lub udokumentowanej procedury SQL.
|
|
- Nie modyfikuj historycznych migracji/skryptow bez uzasadnienia.
|
|
|
|
## Testy
|
|
- Ustal i udokumentuj komende testowa dla projektu (brak standardowej konfiguracji testow).
|
|
|
|
## Dokumentacja
|
|
- Dokumentacja techniczna w `.paul/docs/`.
|
|
- Przy kazdej zmianie aktualizuj odpowiednie pliki docs.
|
|
- `TECH_CHANGELOG.md` aktualizowany po kazdej fazie.
|
|
|
|
## Wdrazanie
|
|
- Ustal i dopisz procedure deploy dla produkcji/staging.
|
|
|
|
## UI/Frontend
|
|
- Projekt korzysta z szablonow PHP i assets statycznych; utrzymuj spojnosc z istniejacym stylem.
|
|
- Zmiany UX w listingu ofert testuj na flow filtrowania i paginacji.
|
|
|