update
This commit is contained in:
48
CLAUDE.md
Normal file
48
CLAUDE.md
Normal 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
|
||||
Reference in New Issue
Block a user