Files
wyszynskiego12.pagedev.pl/.paul/PROJECT.md
Jacek Pyziak 972c69b136 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>
2026-03-12 15:40:29 +01:00

2.3 KiB

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)

  • Użytkownik widzi historię zmian cen dla każdego apartamentu — v0.1 Initial Release
  • Popup „Historia cen" otwiera się po kliknięciu z aktualną ceną i tabelą zmian — v0.1 Initial Release
  • System automatycznie zapisuje ceny codziennie (WP Cron) — v0.1 Initial Release
  • Deweloper może raportować ceny do portalu dane.gov.pl przez publiczny endpoint XML — v0.1 Initial Release
  • 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

  • Użytkownicy mogą przeglądać na stronie ofertę dewelopera
  • Użytkownicy mogą sprawdzić historię zmian cen apartamentów
  • 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