feat(127): erli integration foundation

Phase 127 complete:

- add global Erli settings schema and encrypted API key repository

- add real read-only Erli API connection test and settings UI

- expose Erli in integrations hub and update PAUL/docs state

.paul/ROADMAP.md

@@ -6,7 +6,52 @@ orderPRO to narzedzie do wielokanalowego zarzadzania sprzedaza. Projekt przechod
 
 ## Current Milestone
 
-v3.7 Invoices (Fakturownia integration) — In progress
+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.
 
@@ -38,7 +83,7 @@ Planowane kolejne fazy v3.7 (kandydaci, do rozplanowania):
 
 ## Next Milestone
 
-Kandydaci w kolejce (po v3.7):
+Kandydaci w kolejce (po v3.8):
 - Mobile Orders List / Mobile Order Details / Mobile Settings
 - Zarzadzanie produktami
 - Zarzadzanie stanami magazynowymi
@@ -508,4 +553,4 @@ Archive: `.paul/milestones/v0.1-ROADMAP.md`
 
 ---
 *Roadmap created: 2026-03-12*
-*Last updated: 2026-05-13 - Phase 126 UNIFY closed*
+*Last updated: 2026-05-15 - Phase 127 UNIFY closed*