feat(v0.1): historia cen + jawnosc cen — milestone Initial Release

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>

.paul/PROJECT.md

@@ -0,0 +1,75 @@
+# 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*