update

.paul/phases/94-order-preview-popup/94-01-SUMMARY.md

@@ -0,0 +1,125 @@
+---
+phase: 94-order-preview-popup
+plan: 01
+subsystem: ui
+tags: [modal, preview, clipboard, orders-list, ajax]
+
+requires: []
+provides:
+  - Order preview popup on orders list with copy-to-clipboard
+  - AJAX endpoint GET /api/orders/{id}/preview returning HTML fragment
+affects: []
+
+tech-stack:
+  added: []
+  patterns: [ajax-html-fragment-modal, copy-to-clipboard-svg-feedback]
+
+key-files:
+  created:
+    - resources/views/orders/partials/preview-content.php
+    - resources/views/orders/partials/preview-modal.php
+    - resources/scss/modules/_order-preview-modal.scss
+  modified:
+    - src/Modules/Orders/OrdersController.php
+    - routes/web.php
+    - resources/views/orders/list.php
+    - resources/scss/app.scss
+    - resources/lang/pl.php
+
+key-decisions:
+  - "Server-rendered HTML fragment (nie JSON) — prostsze wstawienie do modala"
+  - "Ikona oka w kolumnie order_ref (nie osobna kolumna akcji)"
+  - "Clipboard API + SVG copy/check feedback (ten sam pattern co Phase 92)"
+  - "Modal 820px szerokosci, 90vh wysokosci — wieksza przestrzen na dane"
+
+patterns-established:
+  - "AJAX preview modal: fetch HTML fragment, wstaw do body modala, delegacja eventow"
+
+duration: ~12min
+started: 2026-04-10
+completed: 2026-04-10
+---
+
+# Phase 94 Plan 01: Order Preview Popup Summary
+
+**Popup podgladu zamowienia na liscie zamowien z kopiowaniem danych, zdjeciami produktow, personalizacja i notatkami klienta**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~12min |
+| Started | 2026-04-10 |
+| Completed | 2026-04-10 |
+| Tasks | 3 completed |
+| Files modified | 10 |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: Przycisk podgladu widoczny | Pass | Ikona oka SVG w kolumnie order_ref |
+| AC-2: Popup z danymi zamowienia | Pass | AJAX fetch, HTML fragment, kupujacy/adres/produkty/kwoty/notatki |
+| AC-3: Kopiowanie do schowka | Pass | Clipboard API + checkmark feedback 1.5s |
+| AC-4: Zamykanie popupu | Pass | X / backdrop / Escape |
+| AC-5: Link do pelnych szczegolow | Pass | Przycisk "Pelne szczegoly" -> /orders/{id} |
+
+## Accomplishments
+
+- Popup podgladu zamowienia z danymi kupujacego, adresem dostawy, produktami (ze zdjeciami i personalizacja), notatkami klienta i podsumowaniem kwot
+- Kopiowanie do schowka kluczowych danych (nazwa kupujacego, email, nr zamowienia, caly adres, notatki)
+- Endpoint AJAX zwracajacy HTML fragment (server-rendered, bez layoutu)
+
+## Files Created/Modified
+
+| File | Change | Purpose |
+|------|--------|---------|
+| `resources/views/orders/partials/preview-content.php` | Created | Tresc podgladu (server-rendered HTML) |
+| `resources/views/orders/partials/preview-modal.php` | Created | Kontener modala overlay |
+| `resources/scss/modules/_order-preview-modal.scss` | Created | Style modala, miniaturek, personalizacji, notatek |
+| `src/Modules/Orders/OrdersController.php` | Modified | Metoda preview() + ikona oka w toTableRow() |
+| `routes/web.php` | Modified | Route GET /api/orders/{id}/preview |
+| `resources/views/orders/list.php` | Modified | Include modala + JS (fetch, kopiowanie, Escape) |
+| `resources/scss/app.scss` | Modified | Import order-preview-modal |
+| `resources/lang/pl.php` | Modified | Klucze orders.preview.* |
+| `public/assets/css/app.css` | Modified | Zbudowany z SCSS |
+
+## Decisions Made
+
+| Decision | Rationale | Impact |
+|----------|-----------|--------|
+| HTML fragment zamiast JSON | Prostsze — brak potrzeby budowania DOM w JS | Mniejszy JS, latwiejsze utrzymanie |
+| Modal 820px | Wiecej miejsca na zdjecia i personalizacje | Lepszy UX |
+| Notatki klienta w podgladzie | Czesto potrzebne do szybkiego skopiowania wiadomosci | Oszczednosc klikniec |
+
+## Deviations from Plan
+
+### Scope additions
+
+| Type | Count | Impact |
+|------|-------|--------|
+| Scope additions | 3 | Na prosbe uzytkownika — zdjecia produktow, personalizacja, notatki klienta |
+
+- Zdjecia produktow (miniaturki 36x36px) dodane na prosbe uzytkownika
+- Personalizacja pozycji wyswietlana pod nazwa produktu
+- Sekcja "Wiadomosc od klienta" z notatkami zamowienia
+- Modal powiekszony z 640px do 820px
+
+## Issues Encountered
+
+None.
+
+## Next Phase Readiness
+
+**Ready:**
+- Popup gotowy do uzycia, brak dalszych zmian potrzebnych
+
+**Concerns:**
+- None
+
+**Blockers:**
+- None
+
+---
+*Phase: 94-order-preview-popup, Plan: 01*
+*Completed: 2026-04-10*