backPRO/CLAUDE.md

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)