# Roadmap: orderPRO

## Overview

orderPRO to narzedzie do wielokanalowego zarzadzania sprzedaza. Projekt przechodzi od podstawowych integracji z marketplace'ami i generowania etykiet, przez rozbudowe o nowe zrodla zamowien i przewoznikow, az do pelnego zarzadzania produktami i stanami magazynowymi.

## Current Milestone

v3.8 Erli Marketplace Integration — In progress

Pelna integracja z erli.pl wzorowana na istniejacej integracji Allegro: konfiguracja konta/API, pobieranie zamowien, mapowanie i synchronizacja statusow, generowanie etykiet, tracking oraz wlaczenie Erli w istniejace przeplywy automatyzacji, statystyk i obslugi zamowien.

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 127 | Erli Integration Foundation | 1/1 | Complete (2026-05-15; migration/manual Erli API smoke pending operator) |
| 128 | Erli Orders Import | TBD | Not started |
| 129 | Erli Status Mapping + Sync | TBD | Not started |
| 130 | Erli Shipments + Labels | TBD | Not started |
| 131 | Erli Tracking + Automation Hooks | TBD | Not started |
| 132 | Erli Hardening, Observability + Docs | TBD | Not started |

### Phase 127: Erli Integration Foundation

Focus: Dodac podstawowy typ integracji Erli: migracje konfiguracji, szyfrowanie sekretow, klient API, test polaczenia, karta w hubie integracji i routing/settings zgodne z wzorcami Allegro/shopPRO.
Plans: 127-01 (complete)

### Phase 128: Erli Orders Import

Focus: Pobieranie nowych zamowien Erli przez cron i import reczny, mapper do wspolnego modelu orderPRO, state cursor, delta-only re-import, adresy/pozycje/platnosci/notatki oraz flaga faktury/NIP tam, gdzie API Erli daje dane firmowe.
Plans: TBD (defined during $paul-plan)

### Phase 129: Erli Status Mapping + Sync

Focus: Osobne mapowanie pull/push statusow Erli, auto-discovery nieznanych statusow, cron synchronizacji orderPRO -> Erli i ochrona lokalnych statusow przy re-imporcie analogicznie do Allegro/shopPRO.
Plans: TBD (defined during $paul-plan)

### Phase 130: Erli Shipments + Labels

Focus: Generowanie etykiet dla zamowien Erli, mapowanie metod dostawy Erli na dostepne providery, zapis paczek w `shipment_packages`, pobieranie labeli i integracja z kolejka zdalnego druku.
Plans: TBD (defined during $paul-plan)

### Phase 131: Erli Tracking + Automation Hooks

Focus: Tracking przesylek Erli, aktualizacja delivery statusow, zdarzenia automatyzacji (`order.imported`, `shipment.created`, `shipment.status_changed`) i zachowanie kompatybilnosci z szablonami e-mail/SMS oraz statystykami.
Plans: TBD (defined during $paul-plan)

### Phase 132: Erli Hardening, Observability + Docs

Focus: Testy jednostkowe mapperow/klientow, logi integracji i bledow API, retry/idempotencja, manual smoke checklist na zywej konfiguracji oraz aktualizacja `DOCS/DB_SCHEMA.md`, `DOCS/ARCHITECTURE.md` i `DOCS/TECH_CHANGELOG.md`.
Plans: TBD (defined during $paul-plan)

## Previous Milestone (transition pending)

v3.7 Invoices (Fakturownia integration) — Complete in code, transition/follow-ups pending

Wystawianie faktur dla klientow z NIP poprzez integracje z Fakturownia (app.fakturownia.pl). Numeracja lokalna z opcja delegacji do Fakturowni, rozdzielenie przyciskow "Wystaw paragon" / "Wystaw fakture", osobne podstrony edycji konfiguracji paragonow i faktur.

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 113 | Fakturownia Integration Foundation | 1/1 | Complete (2026-05-10) |
| 114 | Accounting Configs Refactor (hub + osobne podstrony receipts/invoices) | 1/1 | Complete (2026-05-10) |
| 115 | Wystawianie faktury z zamowienia (lokalne + delegacja Fakturownia + NIP lookup MF Biala Lista) | 1/1 | Complete (2026-05-10) |
| 116 | HostedSMS Integration Settings + Test SMS | 1/1 | Complete (2026-05-12) |
| 117 | SMSPLANET Integration Settings + Test SMS | 1/1 | Complete (2026-05-12; migration/manual SMS verification pending) |
| 118 | Fakturownia Single Instance | 1/1 | Complete (2026-05-12; migration/manual Fakturownia verification pending) |
| 119 | Re-import total_paid Protection | 1/1 | Complete (2026-05-12; phpunit run + manual shoppro smoke pending env) |
| 120 | Alert Component Unification | 1/1 | Complete (2026-05-12; CSS rebuilt; smoke tests pending operator) |
| 121 | SMSPLANET Conversation + Notifications | 1/1 | Complete (2026-05-12; live SMS/browser smoke pending operator) |
| 122 | SMSPLANET Default SMS Footer | 1/1 | Complete (2026-05-12; live SMS smoke + over-limit UI test pending operator) |
| 123 | Receipts Export VAT Breakdown | 1/1 | Complete (2026-05-12; manual XLSX smoke pending operator) |
| 124 | SMS Templates | 1/1 | Complete (2026-05-13; migration + manual SMS smoke pending operator) |
| 125 | invoice_requested Import Fix (shopPRO+Allegro NIP detection, drop legacy is_invoice column) | 1/1 | Complete (2026-05-13; migration + manual smoke pending operator) |
| 126 | Invoice GUS Field Mapping Fix (KRS-based heuristic: JDG → name do "Imię i nazwisko", spółka → "Nazwa firmy") | 1/1 | Complete (2026-05-13; manual smoke pending operator) |

Planowane kolejne fazy v3.7 (kandydaci, do rozplanowania):
- Eksport XLSX listy wystawionych faktur (analogicznie do paragonow)
- Idempotencja podwojnego POST do Fakturowni (INVOICE-IDEMP-115)
- Event automatyzacji `invoice.created` (jezeli operator chce wysylac faktury mailem)
- Automatyzacje SMS / odbior odpowiedzi SMS po aktywacji HostedSMS
- SMSPLANET conversation mode: wybor nadpis/numer 2WAY, odbior odpowiedzi, historia SMS w zamowieniu i notification center - Phase 121 planning
- Manualne potwierdzenie SMSPLANET na zywej bazie i danych produkcyjnych
- Backfill `curl_close()` w `ShopproIntegrationsRepository` (PHP 8.5 compat, poza zakresem 115)

## Next Milestone

Kandydaci w kolejce (po v3.8):
- Mobile Orders List / Mobile Order Details / Mobile Settings
- Zarzadzanie produktami
- Zarzadzanie stanami magazynowymi
- STAT-NET (netto shopPRO bez fallbacku 23%)
- Phase 68 — Code Deduplication Refactor

## Completed Milestones

<details>
<summary>v3.6 Re-import Data Protection - 2026-05-07 (1 phase, 1 plan)</summary>

Re-import istniejacego zamowienia (Allegro + shopPRO) jest delta-only: `replaceAddresses/Items/Notes` wywolywane wylacznie przy pierwszym imporcie, nowy `updateOrderDelta()` aktualizuje tylko pola realnie zmieniajace sie ze zrodla. Stabilne `order_items.id` chronia `project_generated` (Phase 97) i flow generowania PSD. Dodatkowo: propagacja anulowania ze zrodla (override niezalezny od statusOverwriteAllowed) i identical-payload no-op guard. Naprawa case #882 (znikajaca flaga "Projekt" po re-imporcie wymuszanym przez `payment.status_changed` z Phase 111).

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 112 | Re-import Data Protection | 1/1 | Complete |

Archive: `.paul/phases/112-reimport-data-protection/`

</details>

<details>
<summary>v3.5 Payment Transition Event - 2026-05-05 (1 phase, 1 plan)</summary>

Naprawa luki w re-imporcie zamowien Allegro/shopPRO: po potwierdzeniu platnosci re-import emituje `payment.status_changed`, co przez chain reguly #7 zmienia status na `w_realizacji`. Eliminuje przypadki zamowien zaimportowanych przed potwierdzeniem platnosci utykajacych w `nieoplacone` (case #864).

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 111 | Payment Transition Event | 1/1 | Complete |

Archive: `.paul/phases/111-payment-transition-event/`

</details>

<details>
<summary>v3.4 Statistics Summary - 2026-04-28 (1 phase, 1 plan)</summary>

Dodano pierwsza pozycje `Statystyki -> Podsumowanie` z miesiecznymi wykresami liczby i wartosci zamowien. Kazda integracja ma osobna serie, a dodatkowa seria `Razem` sumuje miesiac. Domyslny start historii to `04-2026`.

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 110 | Statistics Summary | 1/1 | Complete |

Archive: `.paul/phases/110-statistics-summary/`

</details>

<details>
<summary>v3.3 UI Filters - 2026-04-28 (1 phase, 1 plan)</summary>

Usprawnienie wielokrotnego wyboru w filtrach: natywne selecty multiple na `/statistics/orders` zostaly zastapione kompaktowym dropdownem z checkboxami, bez zmiany kontraktu GET i backendu statystyk.

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 109 | Checkbox Multiselect Filters | 1/1 | Complete |

Archive: `.paul/phases/109-checkbox-multiselect-filters/`

</details>

<details>
<summary>v3.2 Delivery Status Management - 2026-04-27 (1 phase, 2 plans)</summary>

Wyniesienie znormalizowanych statusow przesylek do tabeli DB z CRUD panelem oraz pelna integracja DB-driven w dropdownach automatyzacji.

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 108 | Delivery Status Management | 2/2 | Complete |

Archive: `.paul/phases/108-delivery-status-management/`

</details>

<details>
<summary>v3.1 Operational Enhancements - 2026-04-27 (2 phases, 2 plans)</summary>

Usprawnienia operacyjne: alert o kliencie z historia zwrotow oraz idempotentna jednorazowa wysylka e-mail per zamowienie.

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 106 | Customer Return Alert | 1/1 | Complete |
| 107 | Automation Email Send Once | 1/1 | Complete |

Archive: `.paul/phases/106-customer-return-alert/`, `.paul/phases/107-automation-email-send-once/`

</details>

<details>
<summary>v3.0 Mobile Responsive - 2026-04-19 (52 phases shipped, 55 plans)</summary>

Wersja mobilna aplikacji plus pelny zestaw usprawnien operacyjnych: automation events, tracking push/pull, personalizacja pozycji, resilient print pipeline, project generation PSD oraz raport statystyk zamowien.

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 52 | Mobile Main Menu | 1/1 | Complete |
| 53 | Mobile Status Panel Toggle | 1/1 | Complete |
| 54 | Order Detail Image Hover | 1/1 | Complete |
| 55 | Desktop Collapsed Sidebar Fix | 1/1 | Complete |
| 56 | Order Payments | 1/1 | Complete |
| 57 | Payment Automation Event | 1/1 | Complete |
| 58 | Automation Form Preserve | 1/1 | Complete |
| 59 | Order Status Automation Event | 1/1 | Complete |
| 60 | Order Status Aged Event | 1/1 | Complete |
| 61 | Payment Button Activation | 1/1 | Complete |
| 62 | Import Re-import Safety | 1/1 | Complete |
| 63 | Order Item Personalization | 1/1 | Complete |
| 64 | Receipt Datetime Precision | 1/1 | Complete |
| 65 | PAUL Delegated Apply | 1/1 | Complete |
| 66 | Allegro Delivery Tracking | 2/2 | Complete |
| 67 | PAUL Codex Executor | 1/1 | Complete |
| 68 | Code Deduplication Refactor | 0/2 | Deferred |
| 69 | Allegro Tracking English Statuses | 1/1 | Complete |
| 70 | Receipt Shipping Cost | 1/1 | Complete |
| 71 | Attributes Import | 1/1 | Complete |
| 72 | Per Page Persistence | 1/1 | Complete |
| 73 | Search by Product | 1/1 | Complete |
| 74 | Reverse Status Mapping | 1/1 | Complete |
| 75 | Pull Status Mapping | 1/1 | Complete |
| 76 | Shipment Receiver Fallback | 1/1 | Complete |
| 77 | COD Amount Fix | 1/1 | Complete |
| 78 | Preset Auto Submit | 1/1 | Complete |
| 79 | Personalization Message Field | 1/1 | Complete |
| 80 | Status Change Reload | 1/1 | Complete |
| 81 | Global Search Bar | 1/1 | Complete |
| 82 | Product Title Tooltip | 1/1 | Complete |
| 83 | Allegro Pull Status Mapping | 1/1 | Complete |
| 84 | Order Imported Automation Event | 1/1 | Complete |
| 85 | Status Group Filter | 1/1 | Complete |
| 86 | Apaczka COD Bank Account | 1/1 | Complete |
| 87 | Shipment Delete | 1/1 | Complete |
| 88 | Allegro User-Agent | 1/1 | Complete |
| 89 | Allegro Info Page | 1/1 | Complete |
| 90 | Delivery Price Import Fix | 1/1 | Complete |
| 91 | Print Client Timeout Resilience | 1/1 | Complete |
| 92 | Buyer Name Copy | 1/1 | Complete |
| 93 | Remember Me Login | 1/1 | Complete |
| 94 | Order Preview Popup | 1/1 | Complete |
| 95 | AJAX Table Refresh | 1/1 | Complete |
| 96 | Automation Payment Method Condition | 1/1 | Complete |
| 97 | Project Generation | 1/1 | Complete |
| 98 | Order Imported First Only | 1/1 | Complete |
| 99 | Order Delivery & Payment Edit | 0/1 | Cancelled |
| 100 | Preset Scope & Print UX | 1/1 | Complete |
| 101 | Aged Orders Row Highlight | 1/1 | Complete |
| 102 | Apaczka Receiver Street Length | 1/1 | Complete |
| 103 | Print Autoclick Fix | 1/1 | Complete |
| 104 | Apaczka Weekend Delivery | 1/1 | Complete |
| 105 | Orders Statistics | 1/1 | Complete |

Archive: `.paul/milestones/v3.0-ROADMAP.md`

</details>

<details>
<summary>v2.3 Email HTML Layout - 2026-03-28 (1 phase, 1 plan)</summary>

HTML header/footer per skrzynka pocztowa z dual-mode edytorem (Quill WYSIWYG + HTML source) i kompozycja email header+body+footer.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 51 | Email HTML Layout | 1/1 | 2026-03-28 |

Archive: `.paul/phases/51-email-html-layout/`

</details>

<details>
<summary>v2.2 Allegro Shipment Waybill Push - 2026-03-28 (1 phase, 1 plan)</summary>

Automatyczne przekazywanie waybilla do Allegro checkout forms przy tworzeniu przesylki, ograniczone do zamowien `source=allegro` i odporne na bledy API Allegro.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 50 | Allegro Shipment Waybill Push | 1/1 | 2026-03-28 |

Archive: `.paul/phases/50-allegro-shipment-waybill-push/`

</details>

<details>
<summary>v2.1 Automation History & Observability - 2026-03-28 (1 phase, 1 plan)</summary>

Rozdzielenie Ustawienia > Zadania automatyczne na taby Ustawienia i Historia, wdrozenie audytu wykonan regul (filtry + paginacja), retencja 30 dni oraz akcja update_order_status.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 49 | Automation History Tab | 1/1 | 2026-03-28 |

Archive: .paul/phases/49-automation-history-tab/

</details>


<details>
<summary>v2.0 Email Template Shipment Variables - 2026-03-28 (1 phase, 1 plan)</summary>

Rozszerzenie szablonow e-mail o zmienne przesylki (`przesylka.numer`, `przesylka.link_sledzenia`) oraz provider-aware budowanie linku sledzenia.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 48 | Email Template Shipment Variables | 1/1 | 2026-03-28 |

Archive: `.paul/phases/48-email-template-shipment-variables/`

</details>

<details>
<summary>v1.9 Shipment Automation Immediate Trigger - 2026-03-28 (1 phase, 1 plan)</summary>

Wdrozenie natychmiastowego eventu automatyzacji po utworzeniu przesylki oraz nowej akcji automatyzacji do zmiany statusu przesylki.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 47 | Shipment Creation Automation | 1/1 | 2026-03-28 |

Archive: `.paul/phases/47-shipment-created-automation/`

</details>

<details>
<summary>v1.8 Allegro Status Push - 2026-03-28 (1 phase, 1 plan)</summary>

Wdrozenie synchronizacji statusow zamowien w kierunku orderPRO -> Allegro oraz aktywacja opcji kierunku w ustawieniach integracji Allegro.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 46 | Allegro Status Push | 1/1 | 2026-03-28 |

Archive: `.paul/phases/46-allegro-status-push/`

</details>

<details>
<summary>v1.7 ShopPRO Status Push - 2026-03-27 (1 phase, 1 plan)</summary>

Implementacja synchronizacji statusow zamowien w kierunku orderPRO -> shopPRO. Cron pushuje zmiany statusow do shopPRO API (PUT /api.php?endpoint=orders&action=change_status).

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 45 | ShopPRO Status Push | 1/1 | 2026-03-27 |

Archive: `.paul/phases/45-shoppro-status-push/`

</details>

<details>
<summary>v1.6 Quick Status Change - 2026-03-27 (1 phase, 1 plan)</summary>

Szybka zmiana statusu zamówienia bezpośrednio z listy zamówień — klikalny dropdown w kolumnie statusu, zmiana przez AJAX bez przeładowania strony.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 44 | Inline Status Change | 1/1 | 2026-03-27 |

Archive: `.paul/phases/44-inline-status-change/`

</details>

<details>
<summary>v1.5 Operational Workflow Cleanup - 2026-03-25 (4 phases, 4 plans)</summary>

Usprawnienia operacyjne: usunięcie bulk print, ograniczenie szumu logów importu Allegro, automatyzacja shipment.status_changed, usuwanie wpisów z kolejki druku.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 40 | Remove Order List Bulk Print | 1/1 | 2026-03-25 |
| 41 | Allegro Import Log Rationalization | 1/1 | 2026-03-25 |
| 42 | Automation Shipment Status Event | 1/1 | 2026-03-25 |
| 43 | Print Queue Entry Removal | 1/1 | 2026-03-25 |

Archive: `.paul/phases/40-*`, `.paul/phases/41-*`, `.paul/phases/42-*`, `.paul/phases/43-*`

</details>

<details>
<summary>v1.4 UI Readability Tweaks - 2026-03-25 (1 phase, 1 plan)</summary>

Rozdzielenie semantyki kolorow UI: glowny kolor przyciskow akcji zostal oddzielony od koloru naglowkow sekcji, aby poprawic czytelnosc i szybkosc skanowania interfejsu.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 30 | Button Primary Color Distinction | 1/1 | 2026-03-25 |

Archive: `.paul/phases/30-button-primary-color/`

</details>

<details>
<summary>v1.3 Konfiguracja Ĺ›ledzenia przesyĹ‚ek â€” 2026-03-23 (1 phase, 1 plan)</summary>

Konfiguracja mapowania statusĂłw dostawy z API przewoĹşnikĂłw na znormalizowane statusy widoczne w aplikacji. UĹĽytkownik moĹĽe dostosowaÄ‡ tĹ‚umaczenia i przypisania statusĂłw bez zmian w kodzie.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 29 | Delivery Status Mapping UI | 1/1 | 2026-03-23 |

Archive: `.paul/phases/29-delivery-status-mapping-ui/`

</details>

<details>
<summary>v1.2 Ĺšledzenie przesyĹ‚ek â€” 2026-03-23 (2 phases, 2 plans)</summary>

Automatyczne Ĺ›ledzenie statusu dostawy przesyĹ‚ek przez API przewoĹşnikĂłw (InPost ShipX, Apaczka, Allegro WZA). Cykliczne odpytywanie przez cron z konfigurowalnym interwaĹ‚em. Dwupoziomowy system statusĂłw: znormalizowany + surowy z API. Badge'e w UI, linki Ĺ›ledzenia, ustawienia interwaĹ‚u.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 27 | Shipment Tracking Backend | 1/1 | 2026-03-23 |
| 28 | Shipment Tracking UI + Settings | 1/1 | 2026-03-23 |

Archive: `.paul/phases/27-shipment-tracking-backend/`, `.paul/phases/28-shipment-tracking-ui/`

</details>

<details>
<summary>v1.1 RÄ™czny numer przesyĹ‚ki â€” 2026-03-23 (1 phase, 1 plan)</summary>

MoĹĽliwoĹ›Ä‡ rÄ™cznego dodania numeru Ĺ›ledzenia przesyĹ‚ki do zamĂłwienia (bez tworzenia przesyĹ‚ki przez API przewoĹşnika).

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 26 | Manual Tracking Number | 1/1 | 2026-03-23 |

Archive: `.paul/phases/26-manual-tracking-number/`

</details>

<details>
<summary>v1.0 Presety przesyĹ‚ek â€” 2026-03-22 (3 phases, 3 plans)</summary>

Customowe przyciski szybkiego wypeĹ‚niania formularza przygotowania przesyĹ‚ki. Presety globalne z nazwÄ… i kolorem â€” tworzenie, autofill, edycja, usuwanie.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 23 | Shipment Presets Backend | 1/1 | 2026-03-22 |
| 24 | Shipment Presets UI | 1/1 | 2026-03-22 |
| 25 | Shipment Presets Management | 1/1 | 2026-03-22 |

Archive: `.paul/phases/23-shipment-presets-backend/`, `.paul/phases/24-shipment-presets-ui/`, `.paul/phases/25-shipment-presets-management/`

</details>

<details>
<summary>v0.9 Poprawki ustawieĹ„ firmy â€” 2026-03-22 (1 phase, 1 plan)</summary>

Naprawa buga: pola REGON, BDO, KRS i logo nie zapisywaĹ‚y siÄ™ w ustawieniach firmy (kontroler nie przekazywaĹ‚ ich do repozytorium).

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 22 | REGON Save Fix | 1/1 | 2026-03-22 |

Archive: `.paul/phases/22-regon-save-fix/`

</details>

<details>
<summary>v0.8 Poprawki wyĹ›wietlania ĹşrĂłdĹ‚a zamĂłwieĹ„ â€” 2026-03-22 (1 phase, 1 plan)</summary>

Na liĹ›cie zamĂłwieĹ„ i stronie szczegĂłĹ‚Ăłw: wyĹ›wietlanie nazwy konkretnej integracji (z tabeli `integrations`) zamiast generycznego "shopPRO". Korekta kolejnoĹ›ci source/ID.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 21 | Order Source Display | 1/1 | 2026-03-22 |

Archive: `.paul/phases/21-order-source-display/`

</details>

<details>
<summary>v0.7 Zdalne drukowanie etykiet â€” 2026-03-22 (3 phases, 3 plans)</summary>

System zdalnego drukowania etykiet przesyĹ‚ek na drukarce termicznej. Aplikacja Windows w system tray odpytuje API orderPRO, pobiera zlecenia i drukuje etykiety A6.

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 18 | Print Queue Backend | 1/1 | 2026-03-22 |
| 19 | UI Integration | 1/1 | 2026-03-22 |
| 20 | Windows Client (C# WinForms) | 1/1 | 2026-03-22 |

Archive: `.paul/phases/18-print-queue-backend/`, `.paul/phases/19-ui-integration/`, `.paul/phases/20-windows-client/`

</details>

<details>
<summary>v0.6 Poprawki UX â€” 2026-03-22 (1 phase, 1 plan)</summary>

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 17 | Receipt duplicate guard | 1/1 | 2026-03-22 |

Archive: `.paul/phases/17-receipt-duplicate-guard/`

</details>

<details>
<summary>v0.5 ModuĹ‚ Automatyzacji â€” 2026-03-18 (1 phase, 2 plans)</summary>

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 16 | Zadania automatyczne | 2/2 | 2026-03-18 |

Archive: `.paul/phases/16-automated-tasks/`

</details>

<details>
<summary>v0.4 ModuĹ‚ E-mail â€” 2026-03-17 (3 phases, 4 plans)</summary>

| Phase | Name | Plans | Completed |
|-------|------|-------|-----------|
| 13 | DB + Skrzynki pocztowe | 1/1 | 2026-03-17 |
| 14 | Szablony wiadomoĹ›ci | 2/2 | 2026-03-17 |
| 15 | WysyĹ‚ka e-mail z zamĂłwieĹ„ | 1/1 | 2026-03-17 |

Archive: `.paul/milestones/v0.4-ROADMAP.md`

</details>

<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>

| 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-05-15 - Phase 127 UNIFY closed*
