98 lines
2.6 KiB
Markdown
98 lines
2.6 KiB
Markdown
# 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*
|