feat(05-admin-panel): Admin panel z historią rezerwacji

Phase 5 complete — CPT carei_reservation z automatycznym zapisem, lista z kolumnami i filtrem statusu, meta box szczegółów, system statusów nowe/przeczytane/zrealizowane, auto-mark-read. Milestone v0.1 Formularz Rezerwacji MVP — all 5 phases complete. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 17:39:09 +01:00
parent a82ec90a51
commit 2af73782f2
11 changed files with 1261 additions and 23 deletions
--- a/.paul/handoffs/archive/HANDOFF-2026-03-25-phase3.md
+++ b/.paul/handoffs/archive/HANDOFF-2026-03-25-phase3.md
@@ -0,0 +1,108 @@
+# PAUL Handoff
+
+**Date:** 2026-03-25
+**Status:** paused — Phase 3 complete, Phase 4 not started
+
+---
+
+## READ THIS FIRST
+
+You have no prior context. This document tells you everything.
+
+**Project:** Carei — Formularz rezerwacji samochodu jako plugin Elementor, zintegrowany z Softra Rent API
+**Core value:** Klient klika "Złóż zapytanie o rezerwację" → modal z formularzem → dane z API Softra → rezerwacja
+
+---
+
+## Current State
+
+**Milestone:** v0.1 Formularz Rezerwacji MVP
+**Phase:** 3 of 5 — Complete ✅
+**Plan:** 03-01 — Complete
+
+**Loop Position:**
+```
+PLAN ──▶ APPLY ──▶ UNIFY
+  ✓        ✓        ✓     [Loop complete — ready for next PLAN]
+```
+
+---
+
+## What Was Done
+
+**This session:**
+- Refactored form layout: segment+dates in one row, pickup+same-return checkbox in one row
+- New endpoint `/segments-branches-map` (simplified: 2 API calls, all branches for all segments)
+- Segment→branch filtering in pickup select (all branches shown, API verifies at booking)
+- Extras hidden until segment AND pickup selected
+- Investigated API for insurance (none) and foreign travel (none) → deferred to backlog
+- Added Phase 5 to roadmap: Admin Panel historia formularzy
+- **Phase 3 complete:** full booking flow end-to-end
+  - Added address fields (city, zipCode, street) + PESEL
+  - Pricing summary overlay with cost breakdown table
+  - Success view with reservation number
+  - customer/add → princingSummary → makebooking → confirm
+  - Error handling at each step
+
+**API discoveries (critical for future work):**
+- Boolean params: must send `true`/`false`, NOT `'T'`/`'N'` (Java deserialization)
+- `drivers[]` is required in makebooking (not documented as required)
+- Penalty items in pricelist (BRAK/BRUD/KARA codes) filtered from display
+- No insurance or foreign travel endpoints in current API version
+
+---
+
+## What's Next
+
+**Immediate:** `/paul:plan` for Phase 4 — Polish & Integration Testing
+- Edge cases (brak dostępności, timeout tokenu, błędy API)
+- Animacje przejść form↔summary↔success
+- Accessibility
+- End-to-end testing on carei.pagedev.pl
+
+**After that:**
+- Phase 5: Admin Panel — zapisywanie formularzy w WP, przeglądanie w wp-admin
+
+**Backlog (czeka na nową wersję API):**
+- Ubezpieczenie (Pakiet Soft/Premium)
+- Wyjazd zagraniczny (checkbox + wyszukiwarka krajów)
+
+---
+
+## Key Decisions Made
+
+| Decision | Rationale |
+|----------|-----------|
+| Boolean API params (true/false) | Java backend rejects 'T'/'N' strings |
+| Simplified branch mapping (no per-branch filtering) | 39 branches × API call = timeout; all branches shown, API verifies at booking |
+| drivers[] = najemca | API requires NotNull, form collects same data |
+| skipAccountCreate: true | MVP — no customer accounts needed |
+| Penalty items filtered by code prefix | BRAK/BRUD/KARA not customer-facing options |
+| Ubezpieczenie + wyjazd zagraniczny → backlog | API has no dedicated endpoints |
+
+---
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `.paul/STATE.md` | Live project state |
+| `.paul/ROADMAP.md` | Phase overview (1-3 ✅, 4-5 ⬜, backlog) |
+| `.paul/phases/03-form-submit-booking/03-01-SUMMARY.md` | Phase 3 summary |
+| `wp-content/plugins/carei-reservation/` | Plugin directory (all code) |
+| `docs/rent-api-02-klienci-i-konta.md` | Customer API docs |
+| `docs/rent-api-03-rezerwacje-i-platnosci.md` | Booking API docs |
+| `softra-test.php` | API test reference |
+| `.env` | API credentials |
+
+---
+
+## Resume Instructions
+
+1. Read `.paul/STATE.md` for latest position
+2. Phase 3 complete — ready for Phase 4 planning
+3. Run `/paul:resume` or `/paul:plan`
+
+---
+
+*Handoff created: 2026-03-25*
--- a/.paul/handoffs/archive/HANDOFF-2026-03-25-phase5.md
+++ b/.paul/handoffs/archive/HANDOFF-2026-03-25-phase5.md
@@ -0,0 +1,122 @@
+# PAUL Handoff
+
+**Date:** 2026-03-25
+**Status:** paused — Phase 5 APPLY in progress, checkpoint pending
+
+---
+
+## READ THIS FIRST
+
+You have no prior context. This document tells you everything.
+
+**Project:** Carei — Formularz rezerwacji samochodu jako plugin Elementor, zintegrowany z Softra Rent API
+**Core value:** Klient klika "Złóż zapytanie o rezerwację" → modal z formularzem → dane z API Softra → rezerwacja
+
+---
+
+## Current State
+
+**Milestone:** v0.1 Formularz Rezerwacji MVP
+**Phase:** 5 of 5 — Admin Panel — Historia Formularzy
+**Plan:** 05-01 — APPLY in progress (2/3 tasks done, checkpoint pending)
+
+**Loop Position:**
+```
+PLAN ──▶ APPLY ──▶ UNIFY
+  ✓        ◐        ○     [APPLY in progress — checkpoint pending]
+```
+
+---
+
+## What Was Done
+
+**This session (Phase 4 + Phase 5):**
+
+### Phase 4: Polish & Integration Testing ✅ COMPLETE
+- Token retry on 401/403 (auto-retry 1x)
+- AbortController timeout 15s + Polish error messages
+- Network error detection (TypeError → retry → user message)
+- Extended reject reason translations (6 codes)
+- Animated step transitions: form ↔ summary ↔ success (fade+translate 250ms)
+- Modal open/close animations (fade + scale)
+- ARIA dialog with focus trap and focus management
+- aria-live announcements for screen readers
+- CSS bug fix (orphaned media query styles)
+- Fix: inline display:none vs CSS class conflict (auto-fixed during checkpoint)
+
+### Phase 5: Admin Panel (in progress)
+- Created `includes/class-admin-panel.php` — full admin panel:
+  - CPT `carei_reservation` registered (menu "Rezerwacje", dashicons-car)
+  - Admin columns: Nr rezerwacji, Klient, Segment, Daty, Oddział, Status, Data
+  - Status filter dropdown above list
+  - Meta box "Szczegóły rezerwacji" with full data table
+  - Status dropdown (nowe/przeczytane/zrealizowane) with colored badges
+  - Auto-mark-read on post edit open
+  - Inline admin CSS for badges and meta table
+  - Static `save_reservation()` method for fire-and-forget save
+- Modified `class-rest-proxy.php` — `make_booking()` calls `save_reservation()` on success
+- Modified `carei-reservation.php` — includes + initializes `Carei_Admin_Panel`
+- All PHP syntax verified clean
+
+---
+
+## What's In Progress
+
+- **Phase 5 Plan 05-01 checkpoint:** Human verification in wp-admin pending
+  - All code written, PHP syntax OK
+  - Need user to test: CPT in menu, submit reservation, check admin list, meta box, status changes
+
+---
+
+## What's Next
+
+**Immediate:** Resume Phase 5 checkpoint verification
+1. User tests admin panel on carei.pagedev.pl
+2. If approved → `/paul:unify .paul/phases/05-admin-panel/05-01-PLAN.md`
+3. Unify closes Phase 5 → Milestone v0.1 complete!
+
+**After milestone:**
+- Backlog: ubezpieczenie + wyjazd zagraniczny (czeka na nową wersję API Softra)
+
+---
+
+## Key Decisions Made
+
+| Decision | Rationale |
+|----------|-----------|
+| CPT + post_meta (not custom table) | WordPress-native, simpler for MVP, full admin UI for free |
+| Fire-and-forget save | Never block user response — rezerwacja already in Softra |
+| Meta-based status (not taxonomy) | Simple 3-value enum, no UI overhead |
+| Auto-mark-read on edit | Reduce manual clicks, natural workflow |
+| Hidden title input | Title auto-generated, not user-editable |
+| style.display for step transitions | Inline display:none overrides CSS classes |
+
+---
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `.paul/STATE.md` | Live project state |
+| `.paul/ROADMAP.md` | Phase overview (1-4 ✅, 5 in progress) |
+| `.paul/phases/05-admin-panel/05-01-PLAN.md` | Phase 5 plan (checkpoint pending) |
+| `.paul/phases/04-polish-testing/04-01-SUMMARY.md` | Phase 4 summary |
+| `wp-content/plugins/carei-reservation/` | Plugin directory (all code) |
+| `includes/class-admin-panel.php` | **NEW** — Admin panel CPT + columns + meta box |
+| `includes/class-rest-proxy.php` | Modified — save_reservation() call |
+| `includes/class-elementor-widget.php` | ARIA attrs (Phase 4) |
+| `assets/js/carei-reservation.js` | Edge cases + animations + a11y (Phase 4) |
+| `assets/css/carei-reservation.css` | Transitions + CSS fix (Phase 4) |
+
+---
+
+## Resume Instructions
+
+1. Read `.paul/STATE.md` for latest position
+2. Phase 5 APPLY in progress — checkpoint pending
+3. Run `/paul:resume` — will route to checkpoint verification
+4. After approved → `/paul:unify` → milestone complete
+
+---
+
+*Handoff created: 2026-03-25*
--- a/.paul/handoffs/archive/HANDOFF-2026-03-25.md
+++ b/.paul/handoffs/archive/HANDOFF-2026-03-25.md
@@ -0,0 +1,112 @@
+# PAUL Handoff
+
+**Date:** 2026-03-25
+**Status:** paused — checkpoint human-verify pending (awaiting deploy + test)
+
+---
+
+## READ THIS FIRST
+
+You have no prior context. This document tells you everything.
+
+**Project:** Carei — Formularz rezerwacji samochodu jako plugin Elementor, zintegrowany z Softra Rent API
+**Core value:** Klient klika "Złóż zapytanie o rezerwację" → modal z formularzem → dane z API Softra → rezerwacja
+
+---
+
+## Current State
+
+**Milestone:** v0.1 Formularz Rezerwacji MVP
+**Phase:** 2 of 4 — Form UI Krok 1 (Formularz)
+**Plan:** 02-01 — APPLY in progress (Tasks 1+2 done, Task 3 checkpoint pending)
+
+**Loop Position:**
+```
+PLAN ──▶ APPLY ──▶ UNIFY
+  ✓        ◐        ○     [Apply in progress — checkpoint:human-verify waiting]
+```
+
+---
+
+## What Was Done
+
+**Phase 1 (complete):**
+- Plugin `carei-reservation` z natywnym cURL proxy do Softra Rent API
+- 10 WP REST endpoints w namespace `carei/v1`
+- Widget Elementor z przyciskiem CTA + modal overlay
+- Fix: widget require_once przeniesiony do hooka elementor/widgets/register
+- Fix: zamiana wp_remote_post na natywny cURL (matching softra-test.php)
+
+**Phase 2 (in progress — Tasks 1+2 done):**
+- HTML formularza z wszystkimi sekcjami z Figmy (widget render)
+- CSS 541 linii (responsive, custom checkboxy, karty opcji, walidacja)
+- JS 580+ linii (API integration, walidacja, interakcje)
+- Nowy endpoint GET /car-classes-all (listAll) — segmenty ładują się od razu bez wymagania oddziału
+- Opcje dodatkowe ładowane dynamicznie z cennika API
+
+---
+
+## What's In Progress
+
+- **Task 3 checkpoint:human-verify** — użytkownik musi wgrać pliki na serwer i przetestować wizualnie
+- Pliki do wgrania:
+  - `includes/class-softra-api.php` (natywny cURL + get_all_car_classes)
+  - `includes/class-rest-proxy.php` (nowy endpoint car-classes-all)
+  - `includes/class-elementor-widget.php` (pełny HTML formularza)
+  - `assets/css/carei-reservation.css` (kompletne style)
+  - `assets/js/carei-reservation.js` (logika + API)
+
+---
+
+## What's Next
+
+**Immediate:** Wgrać pliki na serwer → przetestować formularz → "approved" lub opisać problemy
+
+**After that:**
+- Jeśli approved → /paul:unify → Phase 3 (Overlay/podsumowanie + submit rezerwacji do API)
+- Jeśli issues → fix → re-verify
+
+**Remaining phases:**
+- Phase 3: Form UI Krok 2 (Overlay z podsumowaniem, tworzenie klienta, booking)
+- Phase 4: Polish & integration testing
+
+---
+
+## Key Decisions Made
+
+| Decision | Rationale |
+|----------|-----------|
+| Natywny cURL zamiast wp_remote_post | softra-test.php działa z cURL, WP HTTP API timeout |
+| GET /car/class/listAll dla segmentów | Segment jest pierwszym polem w Figmie, nie powinien wymagać oddziału |
+| Osobny plugin carei-reservation | Czystsza separacja od elementor-addon |
+| sslverify nie ustawiane (domyślne cURL) | Tak jak w softra-test.php który działa na produkcji |
+
+---
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `.paul/STATE.md` | Live project state |
+| `.paul/ROADMAP.md` | Phase overview (Phase 1 ✅, Phase 2-4 ⬜) |
+| `.paul/phases/02-form-ui-step1/02-01-PLAN.md` | Current plan |
+| `.paul/phases/01-reservation-form-plugin/01-01-SUMMARY.md` | Phase 1 summary |
+| `wp-content/plugins/carei-reservation/` | Plugin directory (all code) |
+| `docs/figma-formularz/README.md` | Figma design spec |
+| `docs/figma-formularz/screenshot-desktop.png` | Desktop reference |
+| `docs/figma-formularz/screenshot-mobile.png` | Mobile reference |
+| `softra-test.php` | Working Softra API test (reference for cURL config) |
+| `.env` | API credentials (url, username, password) |
+
+---
+
+## Resume Instructions
+
+1. Read `.paul/STATE.md` for latest position
+2. User needs to deploy files to server and test
+3. After test: "approved" → run `/paul:unify` then `/paul:plan` for Phase 3
+4. Or run `/paul:resume` or `/paul:progress`
+
+---
+
+*Handoff created: 2026-03-25*