107 lines
7.2 KiB
Markdown
107 lines
7.2 KiB
Markdown
# Roadmap — Carei Reservation Form
|
|
|
|
## Milestone v0.1: Formularz Rezerwacji MVP
|
|
|
|
**Goal:** Działający formularz rezerwacji jako plugin Elementor, zintegrowany z API Softra Rent.
|
|
|
|
### Phase 1: Plugin Skeleton + API Proxy ✅ Complete
|
|
Utworzenie pluginu WordPress z proxy REST API do Softra Rent. Backend obsługujący autoryzację JWT, pobieranie oddziałów, klas pojazdów, cenników i dodatków. Rejestracja widgetu Elementor.
|
|
|
|
### Phase 2: Form UI — Krok 1 (Formularz) ✅ Complete
|
|
Frontend formularza rezerwacji w modalu Elementor. Dynamiczne segmenty (ze wszystkich lokalizacji), oddziały filtrowane po segmencie, opcje dodatkowe z cennika API, walidacja, responsive. Pominięto ubezpieczenie i wyjazd zagraniczny (brak w API — backlog).
|
|
|
|
### Phase 3: Submit + Booking Flow ✅ Complete
|
|
Pełny flow: formularz → customer/add → pricing summary overlay → makebooking → confirm → success z numerem. Pola adresowe + PESEL. Error handling. Fixy: boolean API params, timeout mapowania, drivers[] required.
|
|
|
|
### Phase 4: Polish & Integration Testing ✅ Complete
|
|
Edge cases (token retry, timeout, network errors), animacje przejść form↔summary↔success, accessibility (ARIA dialog, focus trap, focus management, aria-live), CSS fix.
|
|
|
|
### Phase 5: Admin Panel — Historia Formularzy ✅ Complete
|
|
CPT `carei_reservation` z automatycznym zapisem po booking, lista z kolumnami i filtrem statusu, meta box szczegółów, system statusów nowe/przeczytane/zrealizowane, auto-mark-read.
|
|
|
|
---
|
|
|
|
## Milestone v0.2: Wyjazd Zagraniczny
|
|
|
|
**Goal:** Wydzielenie pozycji "WYJAZD ZA GRANICĘ" z opcji dodatkowych do dedykowanej sekcji z wyszukiwarką krajów (zgodnie z Figmą).
|
|
|
|
**Status:** Complete ✅
|
|
|
|
### Phase 6: Wyjazd zagraniczny — sekcja + wyszukiwarka krajów ✅ Complete
|
|
Sekcja "Wyjazd zagraniczny" z checkboxem toggle, wyszukiwarką krajów z flagami/cenami, dodawanie/usuwanie krajów, integracja z API submit. Design z Figmy (node 32-397, 122:1054, 122:1091, 123:1195).
|
|
|
|
### Phase 7: Hero Search Form — mini formularz w hero ✅ Complete
|
|
Kompaktowy widget Elementor "Carei Search Form" osadzany w sekcji hero. Pola: segment, daty od/do, lokalizacja, checkbox zwrotu. Po kliknięciu przycisku otwiera istniejący modal rezerwacji z pre-wypełnionymi danymi. Design z Figmy (Form.svg).
|
|
|
|
---
|
|
|
|
## Milestone v0.3: Mapa Oddziałów + Cache API
|
|
|
|
**Goal:** Wizualna prezentacja sieci oddziałów Carei — interaktywna mapa SVG z pinami i siatka miast, plus ujednolicone cachowanie API.
|
|
|
|
**Status:** Complete ✅
|
|
|
|
### Phase 8: Mapa oddziałów + siatka miast + cache API ✅ Complete
|
|
Dwa widgety Elementor: (1) mapa Polski SVG z dynamicznymi pinami oddziałów i tooltipami adresowymi, (2) siatka miast. Cachowanie `/branch/list` z TTL 60 min.
|
|
|
|
---
|
|
|
|
## Milestone v0.5: Pakiety Ochronne + Poprawki
|
|
|
|
**Goal:** Wyświetlanie dwóch pakietów ochronnych (SOFT i PREMIUM) ze stałą ceną/dobę zarządzaną w panelu administratora WP. Plus poprawki UX (mobile modal fix).
|
|
|
|
**Status:** Complete ✅
|
|
|
|
### Phase 13: Pakiety ochronne — kafelki z ceną za dobę z panelu WP ✅ Complete
|
|
Dedykowane kafelki SOFT/PREMIUM w sekcji "Pakiety ochronne" z ceną za dobę z panelu WP. Radio z możliwością odznaczenia. Panel admina (wp-admin → Rezerwacje → Pakiety ochronne), REST endpoint /protection-packages. Pakiet poza priceItems Softra — wysyłany w comments + zapisany w meta CPT _carei_protection_package. Summary frontend dokłada wiersz pakietu i grandTotal. Plan 13-02 ukończony (13-01 superseded).
|
|
|
|
### Phase 14: Mobile modal fix ✅ Complete
|
|
Fix: modal rezerwacji nie otwierał się na mobile/tablet — sekcja Elementor miała elementor-hidden-mobile. Przeniesienie overlay do document.body.
|
|
|
|
---
|
|
|
|
---
|
|
|
|
## Milestone v0.6: Cleanup — Pakiety ochronne (jedno źródło prawdy)
|
|
|
|
**Goal:** W sekcji „Pakiety ochronne" modala zostają wyłącznie pakiety z panelu WP (SOFT/PREMIUM). Pozycje insurance z Softra API („Zniesienie udziału") są usuwane z widoku i nie trafiają do podsumowania ani payloadu.
|
|
|
|
**Status:** Complete ✅
|
|
|
|
### Phase 15: Remove Softra-insurance z modala ✅ Complete
|
|
Usunięty kontener `#carei-insurance-container` + divider w widgecie PHP. W JS usunięta zmienna `insuranceContainer` i render insuranceItems. Pozycje pricelist zawierające `ubezp|ochrony|zniesienie|insurance` są dropowane — nie trafiają do extras, podsumowania ani do `makebooking` payloadu. Pakiety WP (SOFT/PREMIUM) z Phase 13 są jedynym źródłem prawdy.
|
|
|
|
---
|
|
|
|
## Milestone v0.7: Dwujęzyczność (PL/EN) widgetów Carei
|
|
|
|
**Goal:** Plugin `carei-reservation` (modal, hero search, admin, mapa, grid miast, grid oddziałów) działa dwujęzycznie PL/EN zgodnie z bieżącym językiem Polylang. Obejmuje: (1) i18n refactor pluginu, (2) dwujęzyczne pakiety ochronne + mapowanie błędów Softra, (3) tłumaczenie EN + QA.
|
|
|
|
**Status:** Complete ✅
|
|
|
|
### Phase 16: i18n refactor pluginu ✅ Complete
|
|
Plan 16-01 ukończony. 8 plików PHP z user-facing stringami w `__()`/`esc_html__()`/`esc_attr__()` (~105 stringów), textdomain `carei-reservation` ładowany na `plugins_loaded`. JS (1573 linie): ~70 literałów zmigrowanych do `window.careiI18n` przez `wp_localize_script`, helper `pluralPl()` dla polskich form. Wygenerowany `.pot` z 157 unikalnymi msgid. PL UI bez regresji (verified).
|
|
|
|
### Phase 17: Dwujęzyczne pakiety ochronne + mapowanie błędów Softra ✅ Complete
|
|
Plan 17-01 ukończony. Panel pakietów z polami `name_en`/`description_en` + sanitize/save. REST `/protection-packages` z `resolve_locale()` (`?lang=` → `determine_locale()` fallback) zwraca wariant per locale z fallbackiem PL; klucze `_en` nie wyciekają w payloadzie. `Carei_Softra_API::extract_softra_message()` + `map_error_message()` ze słownikiem 13 komunikatów (exact + fuzzy prefix + graceful passthrough). Frontend `loadProtectionPackages()` dodaje `?lang=` na podstawie `document.documentElement.lang`.
|
|
|
|
### Phase 18: Tłumaczenie EN (.po/.mo) + Flatpickr ✅ Complete
|
|
Plan 18-01 ukończony. `carei-reservation-en_US.po` + `.mo` (158 wpisów) + kopia en_GB; własny PHP kompilator `po2mo.php` (msgfmt niedostępny). **Scope addition:** Flatpickr 4.6.13 (CDN jsdelivr) jako cross-browser date picker z locale PL/EN dla modal (static:true — popup w container) + hero (default). `disableMobile:true` dla spójności UX. Kompaktowy CSS theme w kolorach Carei (#2F2482). Graceful fallback do native picker.
|
|
|
|
---
|
|
|
|
## Milestone v0.8: Admin-managed tłumaczenia extras
|
|
|
|
**Goal:** Panel administratora do zarządzania tłumaczeniami dynamicznych nazw dodatkowych opcji (extras) zwracanych z Softra API. Plugin auto-zbiera napotkane PL nazwy, admin wypełnia tłumaczenia EN w UI, frontend EN automatycznie używa.
|
|
|
|
**Status:** Complete ✅
|
|
|
|
### Phase 19: Extras translations admin panel ✅ Complete
|
|
Plan 19-01 ukończony. WP options `carei_extras_seen` (auto-collected) + `carei_extras_translations` (admin override). Static helpery w `Carei_Admin_Panel`: `remember_extra_name()`, `get_extras_seen()`, `get_extras_translations()`, `translate_extra_name()`. Submenu `Rezerwacje → Tłumaczenia extras` (nonce + sanitize + redirect). `Carei_REST_Proxy::get_pricelist()` z runtime auto-collect + per-locale name replacement z fallbackiem do PL. Zero zmian w JS.
|
|
|
|
---
|
|
|
|
### Backlog
|
|
- Eksport CSV/PDF rezerwacji
|
|
- Email notyfikacje
|