Files
wyszynskiego12.pl/.paul/PROJECT.md
2026-04-13 15:50:16 +02:00

83 lines
2.7 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.2.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)
### Validated (Shipped) — v0.2
- [x] Widget Elementor wyświetla ceny miejsc postojowych (zwykłe i rodzinne) — v0.2
- [x] Popup historia cen dla miejsc postojowych (reuse apartamentów) — v0.2
- [x] Cron zapisuje ceny parkingowe codziennie do wp_parking_price_history — v0.2
- [x] XML /ceny-mieszkan.xml zawiera sekcję <miejsca_postojowe> — v0.2
### 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-25 after v0.2 Miejsca Postojowe*