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