# 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*