krolewskie-miody.pl/CLAUDE.md

Projektowe zasady dla krolewskie-miody.pl

Stack

• Język: PHP
• Framework: WordPress + WooCommerce
• Wersja: WordPress (sprawdź wp-includes/version.php)

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"
• Customizacje tylko w child theme lub dedykowanym pluginie — nigdy w core WordPress

Baza danych

• Schemat dokumentowany w .paul/codebase/db_schema.md
• Każda zmiana schematu wymaga migracji
• Nie modyfikuj istniejących migracji — twórz nowe

Testy

• Uzupełnij jak uruchamiać testy

Dokumentacja

• Dokumentacja techniczna w .paul/codebase/
• Przy każdej zmianie aktualizuj odpowiednie pliki (db_schema.md, stack.md)

Wdrażanie

• Deploy przez FTP/SFTP (konfiguracja w .vscode/ftp-kr.json)

UI/Frontend

• Motyw w wp-content/themes/
• Customizacje JS/CSS w child theme lub pluginie