rank24.pl/CLAUDE.md

Projektowe zasady dla rank24.pl

Stack

• Język: PHP (vanilla, bez frameworka)
• Frontend: HTML + JavaScript + jQuery
• Baza danych: MySQL
• ORM: medoo.php
• Szablony: Savant3
• Scraping: Własna klasa GoogleScraper + proxy
• Harmonogram: class.Cron.php

Zasady kodu

• Stosuj PSR-12 dla formatowania kodu PHP
• Nazewnictwo: PascalCase dla klas (class.NazwaKlasy.php), 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"
• Klasy w katalogu autoload/ ładowane automatycznie
• Szablony w katalogu templates/

Baza danych

• Schemat dokumentowany w .paul/codebase/db_schema.md
• ORM: medoo.php (plik libraries/medoo.php)
• Baza: MySQL, host lokalny + produkcja

Testy

• Brak automatycznych testów — testowanie manualne
• Sprawdzaj logi błędów PHP oraz output klasy Cron

Dokumentacja

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

Wdrażanie

• FTP/SFTP na serwer produkcyjny (konfiguracja w ftp-kr.json / sftp.json)
• Pliki konfiguracyjne: config.php (lokalne dane DB/proxy)

UI/Frontend

• Szablony HTML w katalogu templates/
• Layouty w layout/
• Style CSS/SCSS w libraries/style-css/ i libraries/style-scss/
• jQuery + własne pluginy JS