globelus.pl/CLAUDE.md

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.