Historia cen: - Tabela wp_price_history z WP Cronem dziennym (snapshot cen) - AJAX endpoint apartamenty_get_price_history (zabezpieczony nonce) - Popup "Historia cen" w widgecie — vanilla JS, modal zgodny z projektem Jawnosc cen: - Endpointy /ceny-mieszkan.xml + /dane-gov-pl.xml (XSD-compliant) - Pliki MD5 dla obu XML - Strona admina: Narzedzia -> Jawnosc Cen z URL-ami do Ministerstwa - Transient cache 1h z inwalidacja przez cron Dokumentacja: docs/readme.md + docs/jawnosc-cen.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
76 lines
2.3 KiB
Markdown
76 lines
2.3 KiB
Markdown
# Project: wyszynskiego12.pagedev.pl
|
|
|
|
## What This Is
|
|
|
|
Strona internetowa dla dewelopera pozwalająca na okazanie oferty klientom.
|
|
|
|
## Core Value
|
|
|
|
Użytkownicy mogą przeglądać na stronie ofertę dewelopera.
|
|
|
|
## Current State
|
|
|
|
| Attribute | Value |
|
|
|-----------|-------|
|
|
| Version | 0.1.0 |
|
|
| Status | Released |
|
|
| Last Updated | 2026-03-12 |
|
|
|
|
## Requirements
|
|
|
|
### Validated (Shipped)
|
|
|
|
- [x] Użytkownik widzi historię zmian cen dla każdego apartamentu — v0.1 Initial Release
|
|
- [x] Popup „Historia cen" otwiera się po kliknięciu z aktualną ceną i tabelą zmian — v0.1 Initial Release
|
|
- [x] System automatycznie zapisuje ceny codziennie (WP Cron) — v0.1 Initial Release
|
|
- [x] Deweloper może raportować ceny do portalu dane.gov.pl przez publiczny endpoint XML — v0.1 Initial Release
|
|
- [x] Strona admina z URL-ami do zgłoszenia do Ministerstwa — v0.1 Initial Release
|
|
|
|
### Active (In Progress)
|
|
|
|
- (brak — gotowy na nowy milestone)
|
|
|
|
### Planned (Next)
|
|
|
|
- (do zdefiniowania podczas następnego planowania)
|
|
|
|
### Out of Scope
|
|
|
|
- Rejestracja dewelopera na dane.gov.pl (czynność ręczna po stronie klienta)
|
|
- Walidator XSD po stronie PHP
|
|
- Obsługa wielu inwestycji (tylko Wyszyńskiego 12)
|
|
- Formularz do edycji danych inwestycji w adminie
|
|
|
|
## Target Users
|
|
|
|
**Primary:** Potencjalni klienci dewelopera
|
|
- Poszukują mieszkania lub lokalu
|
|
- Chcą szybko zapoznać się z ofertą
|
|
- Oczekują przejrzystej prezentacji inwestycji
|
|
|
|
**Secondary:** Deweloper / admin
|
|
- Zarządza ofertą przez WordPress admin
|
|
- Musi raportować ceny do portalu rządowego
|
|
|
|
## Constraints
|
|
|
|
### Technical Constraints
|
|
- WordPress + Elementor (plugin elementor-addon)
|
|
- ACF dla pól apartamentów (flat meta keys: `information_price`, `information_price_m2`, etc.)
|
|
- Hosting: brak gwarancji ext-dom PHP — XML generowany jako czysty string
|
|
- WP Cron (pseudocron) — wymaga ruchu na stronie lub systemowego crona
|
|
|
|
### Business Constraints
|
|
- Ustawa o jawności cen nieruchomości — obowiązek raportowania do dane.gov.pl
|
|
- Format XML zgodny z XSD portalu otwarte_dane_latest.xsd
|
|
|
|
## Success Criteria
|
|
|
|
- [x] Użytkownicy mogą przeglądać na stronie ofertę dewelopera
|
|
- [x] Użytkownicy mogą sprawdzić historię zmian cen apartamentów
|
|
- [x] Deweloper spełnia wymóg ustawy o jawności cen (endpoint XML gotowy do zgłoszenia)
|
|
|
|
---
|
|
*Created: 2026-03-12*
|
|
*Last updated: 2026-03-12 after v0.1 Initial Release*
|