diff --git a/.paul/MILESTONES.md b/.paul/MILESTONES.md index e9251e5..a87c76d 100644 --- 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 | --- diff --git a/.paul/PROJECT.md b/.paul/PROJECT.md index 7c959db..1606364 100644 --- 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)* diff --git a/.paul/ROADMAP.md b/.paul/ROADMAP.md index f174596..5d1691f 100644 --- 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 +
+v0.3 Moduł Paragonów — 2026-03-15 (5 phases, 5 plans) + +| 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` + +
+
v0.2 Pre-Expansion Fixes — 2026-03-15 (1 phase, 5 plans) @@ -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* diff --git a/.paul/STATE.md b/.paul/STATE.md index 7d3728c..28232d5 100644 --- 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 --- diff --git a/.paul/milestones/v0.3-ROADMAP.md b/.paul/milestones/v0.3-ROADMAP.md new file mode 100644 index 0000000..f174596 --- /dev/null +++ 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 + +
+v0.2 Pre-Expansion Fixes — 2026-03-15 (1 phase, 5 plans) + +| 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/` + +
+ +
+v0.1 Initial Release — 2026-03-13 (6 phases, 15 plans) + +| 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` + +
+ +--- +*Roadmap created: 2026-03-12* +*Last updated: 2026-03-15 — phase 11 complete*