update

.paul/phases/70-receipt-shipping-cost/70-01-SUMMARY.md

@@ -0,0 +1,97 @@
+---
+phase: 70-receipt-shipping-cost
+plan: 01
+subsystem: accounting
+tags: [receipts, delivery, shipping-cost]
+
+requires:
+  - phase: 10-receipt-issuing
+    provides: ReceiptService, buildItemsSnapshot, receipt creation flow
+provides:
+  - Shipping cost included as receipt line item
+  - delivery_price reflected in receipt total
+affects: []
+
+tech-stack:
+  added: []
+  patterns: []
+
+key-files:
+  created: []
+  modified:
+    - src/Modules/Accounting/ReceiptService.php
+    - src/Modules/Accounting/ReceiptController.php
+    - resources/views/orders/receipt-create.php
+
+key-decisions:
+  - "Shipping cost added as regular line item in items_json (same structure as product items)"
+
+patterns-established: []
+
+duration: 5min
+started: 2026-04-06T00:00:00Z
+completed: 2026-04-06T00:05:00Z
+---
+
+# Phase 70 Plan 01: Receipt Shipping Cost Summary
+
+**Bugfix: paragony zawieraja teraz pozycje "Koszt wysylki" gdy zamowienie ma delivery_price > 0**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~5min |
+| Tasks | 2 completed |
+| Files modified | 3 |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: Koszt wysylki jako pozycja paragonu | Pass | buildItemsSnapshot dodaje wiersz gdy delivery_price > 0 |
+| AC-2: Brak pozycji wysylki gdy delivery_price = 0/NULL | Pass | Warunek `if ($deliveryPrice > 0)` chroni |
+| AC-3: Podglad formularza wystawienia paragonu | Pass | Widok wyswietla wiersz "Koszt wysylki" warunkowo |
+
+## Accomplishments
+
+- `buildItemsSnapshot()` rozszerzony o parametr `$order` — dodaje pozycje "Koszt wysylki" do snapshot i total
+- `calculateTotalGross()` rozszerzony o opcjonalny `$deliveryPrice` — kontroler przekazuje wartosc do widoku
+- Widok `receipt-create.php` wyswietla wiersz kosztu wysylki w tabeli pozycji
+
+## Files Created/Modified
+
+| File | Change | Purpose |
+|------|--------|---------|
+| `src/Modules/Accounting/ReceiptService.php` | Modified | buildItemsSnapshot($items, $order) + calculateTotalGross($items, $deliveryPrice) |
+| `src/Modules/Accounting/ReceiptController.php` | Modified | Przekazuje deliveryPrice do widoku i calculateTotalGross |
+| `resources/views/orders/receipt-create.php` | Modified | Warunkowy wiersz "Koszt wysylki" w tabeli pozycji |
+
+## Decisions Made
+
+| Decision | Rationale | Impact |
+|----------|-----------|--------|
+| Koszt wysylki jako zwykly item w items_json | Taka sama struktura jak produkty — widoki show/print automatycznie pokaza nowa pozycje | Brak zmian w widokach podgladu/wydruku paragonu |
+
+## Deviations from Plan
+
+None — plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## Next Phase Readiness
+
+**Ready:**
+- Istniejace widoki podgladu/wydruku paragonow czytaja z items_json i automatycznie pokaza pozycje wysylki
+
+**Concerns:**
+- None
+
+**Blockers:**
+- None
+
+---
+*Phase: 70-receipt-shipping-cost, Plan: 01*
+*Completed: 2026-04-06*