126 lines
4.3 KiB
Markdown
126 lines
4.3 KiB
Markdown
---
|
|
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*
|