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>

.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*