update

.paul/PROJECT.md

@@ -0,0 +1,97 @@
+# rank24.pl
+
+## What This Is
+
+Aplikacja webowa do monitorowania pozycji stron internetowych w wyszukiwarce Google na wybrane frazy kluczowe. Umożliwia śledzenie zmian pozycji w czasie oraz zarządzanie monitorowanymi frazami i domenami.
+
+## Core Value
+
+Użytkownicy mogą monitorować pozycje swoich stron w Google dla wybranych fraz kluczowych i śledzić historię zmian.
+
+## Current State
+
+| Attribute | Value |
+|-----------|-------|
+| Version | 0.1.0 |
+| Status | Prototype |
+| Last Updated | 2026-05-05 |
+
+## Requirements
+
+### Validated (Shipped)
+
+- [x] Monitorowanie pozycji w Google (scraping)
+- [x] Obsługa proxy do zapytań Google
+- [x] System cachowania wyników
+- [x] Baza danych MySQL (medoo.php)
+- [x] System szablonów (Savant3)
+- [x] Harmonogram zadań cron
+
+### Active (In Progress)
+
+- [ ] [To be defined during planning]
+
+### Planned (Next)
+
+- [ ] [To be defined during planning]
+
+### Out of Scope
+
+- [To be identified during planning]
+
+## Target Users
+
+**Primary:** Właściciele stron internetowych i agencje SEO
+- Chcą śledzić pozycje swoich stron w Google
+- Potrzebują historii zmian pozycji
+- Monitorują wiele fraz i domen jednocześnie
+
+## Context
+
+**Business Context:**
+Narzędzie SEO do monitorowania rankingów w Google. Projekt rank24.pl — własna platforma do śledzenia pozycji.
+
+**Technical Context:**
+PHP (bez frameworka), MySQL, własny system szablonów Savant3, medoo jako ORM, system proxy do scrappingu Google, harmonogram cron.
+
+## Constraints
+
+### Technical Constraints
+- PHP (vanilla, bez Composer/frameworka)
+- MySQL jako baza danych
+- Scraping Google przez proxy
+
+### Business Constraints
+- [To be identified during planning]
+
+### Compliance Constraints
+- [To be identified during planning]
+
+## Key Decisions
+
+| Decision | Rationale | Date | Status |
+|----------|-----------|------|--------|
+| PHP bez frameworka | Istniejąca architektura | - | Active |
+| Scraping przez proxy | Omijanie limitów Google | - | Active |
+
+## Success Metrics
+
+| Metric | Target | Current | Status |
+|--------|--------|---------|--------|
+| Dokładność pozycji | 95%+ | TBD | TBD |
+| Czas odświeżania | < 24h | TBD | TBD |
+
+## Tech Stack
+
+| Layer | Technology | Notes |
+|-------|------------|-------|
+| Backend | PHP (vanilla) | Brak frameworka |
+| Frontend | HTML/JS/jQuery | Własne szablony |
+| Database | MySQL | medoo.php jako ORM |
+| Templates | Savant3 | Własny system szablonów |
+| Scraping | GoogleScraper | Własna klasa, proxy |
+| Cron | class.Cron.php | Harmonogram zadań |
+
+---
+*PROJECT.md — Updated when requirements or context change*
+*Last updated: 2026-05-05*