# 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