orderPRO/.paul/ROADMAP.md

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)