chore: complete milestone v0.3 — Moduł Paragonów

Archive milestone, evolve PROJECT.md, reorganize ROADMAP.md. 5 phases, 5 plans: DB foundation, config, issuing, preview/print/PDF, list+XLSX. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 21:21:59 +01:00
parent 22fc330055
commit 22ce87efe2
5 changed files with 133 additions and 28 deletions
--- a/.paul/MILESTONES.md
+++ b/.paul/MILESTONES.md
@@ -5,6 +5,45 @@ Completed milestone log for this project.
 | Milestone | Completed | Duration | Stats |
 |-----------|-----------|----------|-------|
 | v0.1 Initial Release | 2026-03-13 | 2 days | 6 phases, 15 plans |
+| v0.2 Pre-Expansion Fixes | 2026-03-15 | 2 days | 1 phase, 5 plans |
+| v0.3 Moduł Paragonów | 2026-03-15 | 1 day | 5 phases, 5 plans |
+
+---
+
+## ✅ v0.3 Moduł Paragonów
+
+**Completed:** 2026-03-15
+**Duration:** 1 day (2026-03-15)
+
+### Stats
+
+| Metric | Value |
+|--------|-------|
+| Phases | 5 (8-12) |
+| Plans | 5 |
+| Files changed | ~25 |
+
+### Key Accomplishments
+
+- **DB Foundation:** 4 migracje (receipts, receipt_configs, receipt_number_counters, company_settings extended)
+- **Konfiguracja paragonów:** CRUD w Ustawienia > Księgowość — wielokonfiguracyjne szablony numeracji
+- **Wystawianie paragonów:** Formularz z zamówienia, snapshoty JSON (seller/buyer/items), atomowe numerowanie INSERT ON DUPLICATE KEY UPDATE
+- **Podgląd i druk:** HTML preview w layoucie, standalone print z auto window.print(), PDF via dompdf v3.1
+- **Sekcja Księgowość:** Lista paragonów z filtrami, paginacją, sortowaniem, zaznaczaniem checkboxami
+- **Eksport XLSX:** PhpSpreadsheet v5.5 — eksport zaznaczonych lub wszystkich z filtra (POST + CSRF)
+- **Moduł Accounting:** Osobny namespace App\Modules\Accounting z ReceiptController, AccountingController, ReceiptRepository
+
+### Key Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| Snapshot pattern: seller/buyer/items jako JSON | Dane zamrożone w momencie wystawienia — niezależne od zmian źródła |
+| Atomowe numerowanie: INSERT ON DUPLICATE KEY UPDATE | Bezpieczne kolejne numery paragonów bez race conditions |
+| Moduł Accounting w osobnym namespace | Separacja od Settings — przyszłe rozszerzenie księgowości |
+| dompdf v3.1 server-side PDF | Standard PHP, DejaVu Sans dla polskich znaków |
+| PhpSpreadsheet v5.5 dla XLSX | Lepszy od CSV dla księgowości — formatowanie, polskie znaki |
+| POST eksport z CSRF + dwa tryby | Bezpieczny; zaznaczone IDs lub wszystkie z filtra |
+| ftp-kr vendor/ nie ignorowany | Zmiana z /vendor na /vendor/bin — auto-upload zależności na serwer |

 ---

--- a/.paul/PROJECT.md
+++ b/.paul/PROJECT.md
@@ -12,8 +12,8 @@ Sprzedawca może obsługiwać zamówienia ze wszystkich kanałów sprzedaży i n

 | Attribute | Value |
 |-----------|-------|
-| Version | 0.2.0 |
-| Status | v0.2 Complete |
+| Version | 0.3.0 |
+| Status | v0.3 Complete |
 | Last Updated | 2026-03-15 |

 ## Requirements
@@ -30,11 +30,12 @@ Sprzedawca może obsługiwać zamówienia ze wszystkich kanałów sprzedaży i n
 - [x] DB Foundation: tabele receipts, receipt_configs, receipt_number_counters + company_settings extended — Phase 8
 - [x] Konfiguracja paragonów (CRUD w Ustawienia > Księgowość) — Phase 9
 - [x] Wystawianie paragonów z zamówienia (formularz, snapshoty, atomowe numerowanie) — Phase 10
+- [x] Podgląd i wydruk paragonu (HTML+PDF, dompdf) — Phase 11
+- [x] Sekcja Księgowość — lista paragonów z filtrami, paginacją, eksportem XLSX — Phase 12

 ### Active (In Progress)

- [ ] Podgląd i wydruk paragonu (HTML+PDF) — Phase 11
- [ ] Sekcja Księgowość — lista paragonów + eksport XLSX — Phase 12
+(No active requirements — define next milestone)

 ### Planned (Next)

@@ -124,4 +125,4 @@ Quick Reference:

 ---
 *PROJECT.md — Updated when requirements or context change*
-*Last updated: 2026-03-15 after Phase 10 (Wystawianie paragonów z zamówienia)*
+*Last updated: 2026-03-15 after milestone v0.3 (Moduł Paragonów complete)*
--- a/.paul/ROADMAP.md
+++ b/.paul/ROADMAP.md
@@ -6,20 +6,25 @@ orderPRO to narzędzie do wielokanałowego zarządzania sprzedażą. Projekt prz

 ## Current Milestone

-### v0.3 Moduł Paragonów — In progress
-
-Moduł księgowości z obsługą paragonów: wielokonfiguracyjne szablony, wystawianie z zamówień, podgląd/wydruk HTML+PDF, lista z filtrami i eksportem XLSX.
-
-| Phase | Name | Plans | Status |
-|-------|------|-------|--------|
-| 8 | DB Foundation + Company Settings | 1/1 | Complete ✓ |
-| 9 | Konfiguracja paragonów (Ustawienia) | 1/1 | Complete ✓ |
-| 10 | Wystawianie paragonów z zamówienia | 1/1 | Complete ✓ |
-| 11 | Podgląd i wydruk paragonu (HTML+PDF) | 1/1 | Complete ✓ |
-| 12 | Sekcja Księgowość — lista + eksport XLSX | 1/1 | Complete ✓ |
+No active milestone. Run /paul:discuss-milestone or /paul:milestone to define next.

 ## Completed Milestones

+<details>
+<summary>v0.3 Moduł Paragonów — 2026-03-15 (5 phases, 5 plans)</summary>
+
+| Phase | Name | Plans | Completed |
+|-------|------|-------|-----------|
+| 8 | DB Foundation + Company Settings | 1/1 | 2026-03-15 |
+| 9 | Konfiguracja paragonów (Ustawienia) | 1/1 | 2026-03-15 |
+| 10 | Wystawianie paragonów z zamówienia | 1/1 | 2026-03-15 |
+| 11 | Podgląd i wydruk paragonu (HTML+PDF) | 1/1 | 2026-03-15 |
+| 12 | Sekcja Księgowość — lista + eksport XLSX | 1/1 | 2026-03-15 |
+
+Archive: `.paul/milestones/v0.3-ROADMAP.md`
+
+</details>
+
 <details>
 <summary>v0.2 Pre-Expansion Fixes — 2026-03-15 (1 phase, 5 plans)</summary>

@@ -56,4 +61,4 @@ Archive: `.paul/milestones/v0.1-ROADMAP.md`

 ---
 *Roadmap created: 2026-03-12*
-*Last updated: 2026-03-15 — phase 11 complete*
+*Last updated: 2026-03-15 — milestone v0.3 complete*
--- a/.paul/STATE.md
+++ b/.paul/STATE.md
@@ -5,15 +5,15 @@
 See: .paul/PROJECT.md (updated 2026-03-12)

 **Core value:** Sprzedawca może obsługiwać zamówienia ze wszystkich kanałów sprzedaży i nadawać przesyłki bez przełączania się między platformami.
-**Current focus:** Milestone v0.3 Moduł Paragonów — COMPLETE. Transition + milestone completion.
+**Current focus:** Awaiting next milestone.

 ## Current Position

-Milestone: v0.3 Moduł Paragonów — COMPLETE
-Phase: 12 of 12 (12-accounting-list) — Complete
-Plan: 12-01 complete
-Status: Milestone v0.3 complete, transition required
-Last activity: 2026-03-15 — Phase 12 complete (lista paragonów + eksport XLSX)
+Milestone: Awaiting next milestone
+Phase: None active
+Plan: None
+Status: Milestone v0.3 complete — ready for next
+Last activity: 2026-03-15 — Milestone v0.3 completed

 Progress:
 - v0.1 Initial Release: [██████████] 100% ✓
@@ -30,7 +30,7 @@ Progress:
 Current loop state:
 ```
 PLAN ──▶ APPLY ──▶ UNIFY
-  ✓        ✓        ✓     [Loop complete — milestone v0.3 COMPLETE]
+  ○        ○        ○     [Milestone complete — ready for next]
 ```

 ## Accumulated Context
@@ -140,7 +140,7 @@ PLAN ──▶ APPLY ──▶ UNIFY
 - **Delivery mapping "Szukaj..." layout** — JS `attachSelectFilter()` w allegro.php tworzy input search dla InPost/Apaczka selectów, wizualnie wygląda jakby należał do wiersza powyżej. Pre-existing bug, do naprawy osobno.

 ### Git State
-Last commit: fb60b6d (feat(11-receipt-print): phase 11 complete — receipt preview, print & PDF)
+Last commit: 22fc330 (feat(11-12-accounting): phases 11-12 complete — milestone v0.3 done)
 Branch: main
 Feature branches merged: none

@@ -150,13 +150,14 @@ Brak.
 ## Session Continuity

 Last session: 2026-03-15
-Stopped at: Milestone v0.3 COMPLETE — transition required
-Next action: Git commit for phase 12, then /paul:complete-milestone v0.3
-Resume file: .paul/phases/12-accounting-list/12-01-SUMMARY.md
+Stopped at: Milestone v0.3 complete
+Next action: /paul:discuss-milestone or /paul:milestone for next
+Resume file: .paul/MILESTONES.md
 Resume context:
 - v0.1: COMPLETE ✓ (6 phases, 15 plans)
 - v0.2: COMPLETE ✓ (1 phase, 5 plans)
 - v0.3: COMPLETE ✓ (5 phases, 5 plans) — Moduł Paragonów
+- Next milestone: TBD
 - Faza 0 (nieaktywne przyciski) zrobiona poza planem

 ---
--- a/.paul/milestones/v0.3-ROADMAP.md
+++ b/.paul/milestones/v0.3-ROADMAP.md
@@ -0,0 +1,59 @@
+# Roadmap: orderPRO
+
+## Overview
+
+orderPRO to narzędzie do wielokanałowego zarządzania sprzedażą. Projekt przechodzi od podstawowych integracji z marketplace'ami i generowania etykiet, przez rozbudowę o nowe źródła zamówień i przewoźników, aż do pełnego zarządzania produktami i stanami magazynowymi.
+
+## Current Milestone
+
+### v0.3 Moduł Paragonów — In progress
+
+Moduł księgowości z obsługą paragonów: wielokonfiguracyjne szablony, wystawianie z zamówień, podgląd/wydruk HTML+PDF, lista z filtrami i eksportem XLSX.
+
+| Phase | Name | Plans | Status |
+|-------|------|-------|--------|
+| 8 | DB Foundation + Company Settings | 1/1 | Complete ✓ |
+| 9 | Konfiguracja paragonów (Ustawienia) | 1/1 | Complete ✓ |
+| 10 | Wystawianie paragonów z zamówienia | 1/1 | Complete ✓ |
+| 11 | Podgląd i wydruk paragonu (HTML+PDF) | 1/1 | Complete ✓ |
+| 12 | Sekcja Księgowość — lista + eksport XLSX | 1/1 | Complete ✓ |
+
+## Completed Milestones
+
+<details>
+<summary>v0.2 Pre-Expansion Fixes — 2026-03-15 (1 phase, 5 plans)</summary>
+
+| Phase | Name | Plans | Completed |
+|-------|------|-------|-----------|
+| 7 | Pre-Expansion Fixes | 5/5 | 2026-03-15 |
+
+Plans:
+- 07-01: Performance (N+1 subqueries, DB indexes, information_schema cache)
+- 07-02: Stability (SSL verification, cron throttle DB, migration 000014b)
+- 07-03: UX (orderpro_to_allegro disable, lista zamówień fixes)
+- 07-04: Tests (AllegroTokenManager + AllegroOrderImportService — 12 testów)
+- 07-05: InPost ShipmentProviderInterface (natywne ShipX API)
+
+Archive: `.paul/phases/07-pre-expansion-fixes/`
+
+</details>
+
+<details>
+<summary>v0.1 Initial Release — 2026-03-13 (6 phases, 15 plans)</summary>
+
+| Phase | Name | Plans | Completed |
+|-------|------|-------|-----------|
+| 1 | Tech Debt | 2/2 | 2026-03-12 |
+| 2 | Bug Fixes | 4/4 | 2026-03-13 |
+| 3 | Tech Debt 2 | 1/1 | 2026-03-13 |
+| 4 | Schema Docs | 1/1 | 2026-03-13 |
+| 5 | Tech Debt 3 | 1/1 | 2026-03-13 |
+| 6 | SonarQube Quality | 6/6 | 2026-03-13 |
+
+Archive: `.paul/milestones/v0.1-ROADMAP.md`
+
+</details>
+
+---
+*Roadmap created: 2026-03-12*
+*Last updated: 2026-03-15 — phase 11 complete*