# 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.1 Initial Release** (v0.1.0)
Status: In progress
Phases: 3 complete, Phase 4 planning

## Phases

| Phase | Name | Plans | Status | Completed |
|-------|------|-------|--------|-----------|
| 1 | Tech Debt | 2/2 | ✅ Complete | 2026-03-12 |
| 2 | Bug Fixes | 4/4 | ✅ Complete | 2026-03-13 |
| 3 | Tech Debt 2 | 1/1 | ✅ Complete | 2026-03-13 |
| 4 | Schema Docs | 1/1 | ✅ Complete | 2026-03-13 |
| 5 | Tech Debt 3 | 1/1 | ✅ Complete | 2026-03-13 |

## Phase Details

### Phase 1 — Tech Debt
Naprawa krytycznych problemów technicznych zidentyfikowanych w mapie kodu (`.paul/codebase/CONCERNS.md`).

- **Plan 01-01** — Extract AllegroTokenManager (OAuth duplication HIGH × 4 classes) — *Complete*
- **Plan 01-02** — Extract StringHelper (duplicated helpers HIGH × 15 classes) — *Complete*

### Phase 2 — Bug Fixes
Naprawa zidentyfikowanych błędów z `.paul/codebase/CONCERNS.md`.

- **Plan 02-01** — Naprawa martwego warunku ZPL page size w AllegroShipmentService — *Complete*
- **Plan 02-02** — Kursor `last_status_checked_at` w AllegroStatusSyncService (no time-based cursor) — *Complete*
- **Plan 02-03** — `ShopproOrdersSyncService` używa `AllegroOrderSyncStateRepository` (błędna zależność) — *Complete*
- **Plan 02-04** — `Application.php` ręcznie buduje graf obiektów crona (duplikacja, rozbieżność z bin/cron.php) — *Complete*

### Phase 3 — Tech Debt 2
Ustandaryzowanie niespójności technicznych zidentyfikowanych w `.paul/codebase/CONCERNS.md`.

- **Plan 03-01** — CSRF Token Field Name Inconsistency — `_csrf_token` → `_token` w OrdersController, ShipmentController i ich widokach — *Complete*

### Phase 4 — Schema Docs
Adnotacja 5 migracji kompensujących `ensure_*` i aktualizacja dokumentacji schematu.

- **Plan 04-01** — Annotate ensure_* compensating migrations — *Complete*

### Phase 5 — Tech Debt 3
Migracja flash messages z bezpośrednich zapisów `$_SESSION` do abstrakcji `Flash::set()`/`Flash::get()`.

- **Plan 05-01** — Migrate $_SESSION flash writes to Flash class in OrdersController and ShipmentController — *Complete*

---
*Roadmap created: 2026-03-12*
*Last updated: 2026-03-13 after Phase 5 (Tech Debt 3 — Flash migration)*