49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# 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
|