Download all files FTP

2026-04-13 15:50:16 +02:00
parent d8382136b2
commit cb5b386424
6906 changed files with 1956223 additions and 40713 deletions
--- a/.paul/phases/03-miejsca-postojowe/03-01-PLAN.md
+++ b/.paul/phases/03-miejsca-postojowe/03-01-PLAN.md
@@ -0,0 +1,256 @@
+---
+phase: 03-miejsca-postojowe
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - wp-content/plugins/elementor-addon/elementor-addon.php
+  - wp-content/plugins/elementor-addon/widgets/parking-spots.php
+  - wp-content/plugins/elementor-addon/assets/js/main.js
+  - wp-content/plugins/elementor-addon/assets/css/main.css
+autonomous: false
+---
+
+<objective>
+## Goal
+Stworzyc widget Elementor "Miejsca postojowe" wyswietlajacy ceny dwoch typow miejsc (zwykle i rodzinne) z przyciskiem "Historia cen" oraz popup, a takze rozszerzyc cron, AJAX i XML export o dane parkingowe.
+
+## Purpose
+Deweloper musi prezentowac ceny miejsc postojowych na stronie oferty oraz raportowac je do dane.gov.pl zgodnie z ustawa o jawnosci cen.
+
+## Output
+- Nowy widget Elementor: `Elementor_Parking_Spots`
+- Tabela DB: `wp_parking_price_history`
+- Rozszerzony cron o zapis cen parkingowych
+- Rozszerzony AJAX o historie cen parkingowych
+- Rozszerzony XML export o miejsca postojowe
+</objective>
+
+<context>
+## Project Context
+@.paul/PROJECT.md
+@.paul/ROADMAP.md
+@.paul/STATE.md
+
+## Source Files
+@wp-content/plugins/elementor-addon/elementor-addon.php
+@wp-content/plugins/elementor-addon/widgets/apartaments.php
+@wp-content/plugins/elementor-addon/assets/js/main.js
+@wp-content/plugins/elementor-addon/assets/css/main.css
+
+## Existing Patterns
+- Apartament widget: klasa Elementor_Apartaments w widgets/apartaments.php
+- Historia cen popup: globalny overlay #price-history-overlay, wypelniany przez AJAX
+- AJAX endpoint: wp_ajax_apartamenty_get_price_history → JSON {title, price, price_m2, history}
+- Cron: apartamenty_record_prices → INSERT IGNORE do wp_price_history
+- XML: apartamenty_generate_price_xml() → <lokale> z <lokal> per apartament
+- ACF: parking prices sa w opcjach ACF (options page), klucze do odkrycia w DB
+- Garage map: get_field('garage_spots', 'option') → parking-N → status
+</context>
+
+<skills>
+No specialized flows configured.
+</skills>
+
+<acceptance_criteria>
+
+## AC-1: Widget wyswietla ceny parkingowe
+```gherkin
+Given widget "Miejsca postojowe" jest dodany na stronie w Elementorze
+When uzytkownik otwiera strone
+Then widzi sekcje z dwoma typami: "Miejsce postojowe zwykle" i "Miejsce postojowe Rodzinne"
+And kazdy typ ma wyswietlona aktualna cene z ACF
+And kazdy typ ma przycisk "HISTORIA CEN"
+```
+
+## AC-2: Popup historia cen dziala dla miejsc postojowych
+```gherkin
+Given uzytkownik widzi widget miejsc postojowych
+When klika przycisk "HISTORIA CEN" przy dowolnym typie
+Then otwiera sie popup z aktualna cena i tabela historii zmian cen
+And popup zamyka sie przyciskiem X, klikajac overlay lub klawiszem Escape
+```
+
+## AC-3: Cron zapisuje ceny parkingowe codziennie
+```gherkin
+Given WP Cron jest zaplanowany
+When uruchamia sie dzienne zadanie
+Then aktualne ceny obu typow miejsc postojowych sa zapisywane do wp_parking_price_history
+And zapis jest idempotentny (INSERT IGNORE, jeden rekord na typ na dzien)
+```
+
+## AC-4: XML export zawiera miejsca postojowe
+```gherkin
+Given endpoint /ceny-mieszkan.xml jest dostepny
+When uzytkownik pobiera XML
+Then XML zawiera sekcje <miejsca_postojowe> z oboma typami
+And kazdy typ ma aktualna cene i historie zmian
+```
+
+</acceptance_criteria>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Odkryj klucze ACF dla cen parkingowych i stworz tabele DB + cron + AJAX</name>
+  <files>wp-content/plugins/elementor-addon/elementor-addon.php</files>
+  <action>
+    1. **Odkryj ACF meta keys** — sprawdz w bazie (wp_options) jakie klucze ACF sa uzywane dla cen miejsc postojowych. Prawdopodobnie sa w opcjach ACF (get_field z 'option'). Poszukaj kluczy zawierajacych "parking", "postojow", "garage_price" lub podobnych.
+
+    2. **Stworz tabele wp_parking_price_history:**
+       ```sql
+       CREATE TABLE wp_parking_price_history (
+         id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
+         parking_type VARCHAR(50) NOT NULL,  -- 'zwykle' lub 'rodzinne'
+         price VARCHAR(50) NOT NULL DEFAULT '',
+         recorded_at DATE NOT NULL,
+         UNIQUE KEY unique_daily (parking_type, recorded_at),
+         KEY idx_type (parking_type)
+       )
+       ```
+       - Dodaj funkcje tworzaca tabele analogicznie do elementor_addon_create_price_history_table()
+       - Zaktualizuj elementor_addon_maybe_update_db() — zmien wersje DB na '1.1'
+
+    3. **Rozszerz cron** — w elementor_addon_record_prices() dodaj po petli apartamentow:
+       - Pobierz ceny parkingowe z ACF options (odkryte klucze)
+       - INSERT IGNORE do wp_parking_price_history dla kazdego typu
+
+    4. **Dodaj AJAX endpoint** — nowa funkcja `elementor_addon_get_parking_price_history_ajax()`:
+       - Akcja: wp_ajax_parking_get_price_history / wp_ajax_nopriv_parking_get_price_history
+       - Parametr: parking_type ('zwykle' lub 'rodzinne')
+       - Zwraca: JSON {type_label, price, history: [{recorded_at, price}]}
+       - Uzywa tego samego nonce co apartamenty
+
+    5. **Rozszerz XML** — w apartamenty_generate_price_xml() po zamknieciu </lokale>... nie, lepiej:
+       - Zmien root element na <nieruchomosci> opakowujacy <lokale> i nowy <miejsca_postojowe>
+       - LUB dodaj <miejsca_postojowe> wewnatrz <lokale> (prostsze)
+       - Kazdy typ: <miejsce_postojowe typ="zwykle">, <cena>, <historia_cen>
+       - Wyczysc transient po aktualizacji
+
+    Avoid:
+    - NIE zmieniaj istniejacego schematu wp_price_history (apartamenty)
+    - NIE usuwaj istniejacych endpointow XML — rozszerzaj
+  </action>
+  <verify>
+    - Tabela wp_parking_price_history istnieje po aktywacji/upgrade
+    - Reczne wywolanie crona zapisuje rekordy parkingowe
+    - AJAX endpoint zwraca poprawny JSON
+    - XML zawiera sekcje miejsca_postojowe
+  </verify>
+  <done>AC-3 i AC-4 satisfied: cron zapisuje ceny, XML eksportuje miejsca postojowe</done>
+</task>
+
+<task type="checkpoint:human-verify" gate="blocking">
+  <what-built>Backend: tabela DB, cron, AJAX endpoint, XML export dla miejsc postojowych</what-built>
+  <how-to-verify>
+    1. Sprawdz w wp-admin > Narzedzia > Jawnosc Cen czy XML zawiera miejsca postojowe
+    2. Otworz /ceny-mieszkan.xml w przegladarce i sprawdz sekcje miejsca_postojowe
+    3. Potwierdz ze ACF klucze zostaly poprawnie odkryte
+  </how-to-verify>
+  <resume-signal>Type "approved" to continue to widget, or describe issues</resume-signal>
+</task>
+
+<task type="auto">
+  <name>Task 2: Stworz widget Elementor "Miejsca postojowe" z przyciskiem historia cen</name>
+  <files>
+    wp-content/plugins/elementor-addon/widgets/parking-spots.php,
+    wp-content/plugins/elementor-addon/assets/js/main.js,
+    wp-content/plugins/elementor-addon/assets/css/main.css,
+    wp-content/plugins/elementor-addon/elementor-addon.php
+  </files>
+  <action>
+    1. **Stworz widgets/parking-spots.php** — klasa Elementor_Parking_Spots:
+       - get_name() → 'parking_spots'
+       - get_title() → 'Miejsca Postojowe'
+       - get_style_depends / get_script_depends → te same co apartaments
+       - render():
+         a) Pobierz ceny z ACF options (odkryte klucze)
+         b) Wyrenderuj dwie karty: "Miejsce postojowe zwykle" i "Miejsce postojowe Rodzinne"
+         c) Kazda karta: nazwa typu, cena, przycisk "HISTORIA CEN" z data-parking-type="zwykle/rodzinne"
+         d) Uzyj stylistyki zblizonej do apartament-card__info (tabela z cenami)
+         e) Wyrenderuj ten sam popup overlay co apartamenty (reuse #price-history-overlay)
+            — popup juz istnieje globalnie, wiec NIE renderuj go ponownie jesli jest na tej samej stronie
+            — dodaj warunek: renderuj popup tylko jesli nie ma go jeszcze w DOM
+
+    2. **Zarejestruj widget** w elementor-addon.php:
+       - W register_hello_world_widget() dodaj require + register dla Elementor_Parking_Spots
+
+    3. **Rozszerz main.js** — dodaj obsluge klikniecia .btn-parking-historia-cen:
+       - Analogicznie do .btn-historia-cen ale wysyla parking_type zamiast post_id
+       - Uzywa akcji 'parking_get_price_history'
+       - Wypelnia ten sam popup (reuse)
+       - Tabela historii: data, cena (bez ceny/m2 — uproszczona)
+
+    4. **Rozszerz main.css** — dodaj style dla widgetu parkingowego:
+       - Klasa .parking-spots z kartami
+       - Styl zbliżony do apartament-card ale uproszczony (bez galerii, dokumentow)
+       - Responsive
+
+    Avoid:
+    - NIE duplikuj popupa historia cen — uzyj istniejacego
+    - NIE zmieniaj stylow apartamentow
+    - NIE dodawaj Swipera/FancyBoxa — widget parkingowy ich nie potrzebuje
+  </action>
+  <verify>
+    - Widget pojawia sie w panelu Elementor w kategorii "basic"
+    - Po dodaniu na strone wyswietla dwa typy z cenami
+    - Klikniecie "Historia cen" otwiera popup z danymi
+  </verify>
+  <done>AC-1 i AC-2 satisfied: widget wyswietla ceny, popup historia cen dziala</done>
+</task>
+
+<task type="checkpoint:human-verify" gate="blocking">
+  <what-built>Widget Elementor "Miejsca Postojowe" z historia cen — design wg Figma Frame 16</what-built>
+  <how-to-verify>
+    1. Otworz Elementor na stronie /apartamenty/ lub testowej
+    2. Dodaj widget "Miejsca Postojowe"
+    3. Sprawdz czy wyswietla dwa typy z cenami
+    4. Kliknij "Historia cen" — sprawdz popup
+    5. Porownaj z designem na Figmie (Frame 16)
+    6. Sprawdz responsywnosc (mobile)
+  </how-to-verify>
+  <resume-signal>Type "approved" or describe visual/functional issues</resume-signal>
+</task>
+
+</tasks>
+
+<boundaries>
+
+## DO NOT CHANGE
+- wp-content/plugins/elementor-addon/widgets/apartaments.php (widget apartamentow stabilny)
+- wp-content/themes/hello-elementor/template-parts/garage-map.php (mapa garazowa)
+- Istniejacy schemat tabeli wp_price_history (nie modyfikuj kolumn)
+- Istniejace endpointy XML — rozszerzaj, nie usuwaj
+
+## SCOPE LIMITS
+- Tylko dwa typy miejsc postojowych: zwykle i rodzinne
+- Brak galerii/dokumentow w widgecie parkingowym
+- Brak edycji cen w widgecie — ceny z ACF options
+- Strona admina Jawnosc Cen — nie modyfikuj (XML sam sie rozszerzy)
+
+</boundaries>
+
+<verification>
+Before declaring plan complete:
+- [ ] Widget "Miejsca Postojowe" renderuje dwa typy z cenami ACF
+- [ ] Przycisk "Historia cen" otwiera popup z danymi z AJAX
+- [ ] Cron zapisuje ceny parkingowe do wp_parking_price_history
+- [ ] /ceny-mieszkan.xml zawiera sekcje z miejscami postojowymi
+- [ ] Brak bledow PHP (WP_DEBUG=true)
+- [ ] Istniejace funkcjonalnosci apartamentow nie naruszone
+- [ ] All acceptance criteria met
+</verification>
+
+<success_criteria>
+- All tasks completed
+- All verification checks pass
+- No PHP errors or warnings introduced
+- Widget dostepny w Elementor i poprawnie renderuje
+- Historia cen popup dziala identycznie jak dla apartamentow
+- XML export zawiera miejsca postojowe z historia
+</success_criteria>
+
+<output>
+After completion, create `.paul/phases/03-miejsca-postojowe/03-01-SUMMARY.md`
+</output>
--- a/.paul/phases/03-miejsca-postojowe/03-01-SUMMARY.md
+++ b/.paul/phases/03-miejsca-postojowe/03-01-SUMMARY.md
@@ -0,0 +1,134 @@
+---
+phase: 03-miejsca-postojowe
+plan: 01
+subsystem: ui, api, database
+tags: [elementor, acf, wp-cron, xml, ajax, parking]
+
+requires:
+  - phase: 01-historia-cen
+    provides: price_history table, popup pattern, AJAX pattern, XML endpoint
+  - phase: 02-jawnosc-cen
+    provides: XML export structure, dane.gov.pl integration
+provides:
+  - Elementor widget "Miejsca Postojowe" with price display and history popup
+  - wp_parking_price_history DB table
+  - Daily cron recording parking prices
+  - AJAX endpoint for parking price history
+  - XML export extended with parking spots
+affects: []
+
+tech-stack:
+  added: []
+  patterns: [ACF group field access pattern]
+
+key-files:
+  created:
+    - wp-content/plugins/elementor-addon/widgets/parking-spots.php
+  modified:
+    - wp-content/plugins/elementor-addon/elementor-addon.php
+    - wp-content/plugins/elementor-addon/assets/js/main.js
+    - wp-content/plugins/elementor-addon/assets/css/main.css
+
+key-decisions:
+  - "ACF groups: pola cen w grupach, nie flat — get_field('grupa', 'option')['pole']"
+  - "Osobna tabela wp_parking_price_history zamiast rozszerzania wp_price_history"
+  - "Cena m2 ukryta w widgecie na życzenie użytkownika (dane nadal w cronie/XML)"
+  - "Layout bez ramek, kolumnowy zamiast grid 2-kolumnowego"
+
+patterns-established:
+  - "ACF group field access: get_field('group_name', 'option')['group_name_field']"
+  - "Parking popup reuse: fallback overlay usuwany jeśli apartamentowy istnieje"
+
+duration: ~30min
+completed: 2026-03-25
+---
+
+# Phase 3 Plan 01: Miejsca Postojowe Summary
+
+**Widget Elementor wyswietlajacy ceny miejsc postojowych (zwykle/rodzinne) z historia cen, cron i XML export**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~30min |
+| Completed | 2026-03-25 |
+| Tasks | 2 auto + 2 checkpoints |
+| Files modified | 4 (1 new, 3 modified) |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: Widget wyswietla ceny parkingowe | Pass | Dwa typy z cenami z ACF grup, layout kolumnowy |
+| AC-2: Popup historia cen dziala | Pass | Reuse popup apartamentow, AJAX endpoint dziala |
+| AC-3: Cron zapisuje ceny codziennie | Pass | INSERT IGNORE do wp_parking_price_history |
+| AC-4: XML export zawiera miejsca postojowe | Pass | Sekcja <miejsca_postojowe> w /ceny-mieszkan.xml |
+
+## Accomplishments
+
+- Widget "Miejsca Postojowe" w Elementorze — 2 karty (zwykle/rodzinne) z ceną i przyciskiem historia cen
+- Tabela wp_parking_price_history z codziennym zapisem cen przez WP Cron
+- AJAX endpoint parking_get_price_history z popupem reusujacym overlay apartamentow
+- XML /ceny-mieszkan.xml rozszerzony o sekcje <miejsca_postojowe> z historia
+
+## Files Created/Modified
+
+| File | Change | Purpose |
+|------|--------|---------|
+| `widgets/parking-spots.php` | Created | Elementor widget rendering parking spot cards |
+| `elementor-addon.php` | Modified | DB table, cron extension, AJAX endpoint, XML export |
+| `assets/js/main.js` | Modified | Parking price history click handler + AJAX |
+| `assets/css/main.css` | Modified | Parking widget styles (no border, column layout) |
+
+## Decisions Made
+
+| Decision | Rationale | Impact |
+|----------|-----------|--------|
+| Osobna tabela wp_parking_price_history | Parking to opcje ACF, nie CPT — inna struktura (parking_type vs post_id) | Czysta separacja, brak zmian w istniejącej tabeli |
+| ACF group access pattern | Pola cen są w grupach ACF, nie flat | Wymaga get_field('grupa', 'option')['pole'] |
+| Ukrycie ceny m2 w widgecie | Request użytkownika — uproszczony wygląd | Dane m2 nadal w cronie i XML |
+| Layout bez ramek, kolumnowy | Request użytkownika — bliższy designowi Figma | Prostszy CSS |
+
+## Deviations from Plan
+
+### Summary
+
+| Type | Count | Impact |
+|------|-------|--------|
+| User-requested changes | 2 | Design adjustments, no functional impact |
+| Auto-fixed | 1 | ACF group access pattern |
+
+**Total impact:** Essential fixes + design preferences, no scope creep
+
+### Details
+
+1. **ACF group fields** — Plan zakladal flat access (get_field('pole', 'option')). Odkryto ze pola sa w grupach ACF. Naprawione na get_field('grupa', 'option')['pole'].
+
+2. **Ukrycie ceny m2** — User request. Usunieto z HTML widgetu, dane nadal zapisywane.
+
+3. **Layout bez ramek, kolumnowy** — User request. Zmieniono z grid 2-kolumnowego z ramkami na flex column bez ramek.
+
+## Issues Encountered
+
+| Issue | Resolution |
+|-------|------------|
+| Figma MCP niedostępny (oryginalny plik) | User udostępnił kopię, pobrano screenshot Frame 16 |
+| Ceny nie wyświetlały się po wdrożeniu | ACF pola w grupach — naprawiony pattern dostępu |
+
+## Next Phase Readiness
+
+**Ready:**
+- Milestone v0.2 Miejsca Postojowe kompletny (1 faza, 1 plan)
+- Wszystkie AC spełnione
+
+**Concerns:**
+- WP Cron pseudocron — na produkcji zalecany systemowy cron
+- Cena m2 ukryta — może wymagać przywrócenia w przyszłości
+
+**Blockers:**
+- None
+
+---
+*Phase: 03-miejsca-postojowe, Plan: 01*
+*Completed: 2026-03-25*