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

2.7 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.2.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)

Validated (Shipped) — v0.2

  • Widget Elementor wyświetla ceny miejsc postojowych (zwykłe i rodzinne) — v0.2
  • Popup historia cen dla miejsc postojowych (reuse apartamentów) — v0.2
  • Cron zapisuje ceny parkingowe codziennie do wp_parking_price_history — v0.2
  • 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

  • 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-25 after v0.2 Miejsca Postojowe