This commit is contained in:
2026-05-05 20:31:55 +02:00
parent 0776c4531e
commit d203370870
9 changed files with 682 additions and 42 deletions

48
CLAUDE.md Normal file
View File

@@ -0,0 +1,48 @@
# 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