update

.paul/ROADMAP.md

@@ -1,42 +1,43 @@
-# Roadmap: crmPRO
+# Roadmap: crmPRO
 
 ## Overview
-Stabilizacja i poprawa jakości kodu crmPRO — identyfikacja i naprawa błędów, analiza jakości kodu przez SonarQube.
+Stabilizacja i poprawa jakosci kodu crmPRO oraz rozwoj finansow o automatyczny import faktur z Fakturowni.
 
 ## Current Milestone
-**v0.1 Stabilizacja i jakość kodu** (v0.1.0)
+**v0.1 Stabilizacja i jakosc kodu + import finansow** (v0.1.0)
 Status: In progress
-Phases: 1 of 4 complete
+Phases: 1 of 5 complete
 
 ## Phases
 
 | Phase | Name | Plans | Status | Completed |
 |-------|------|-------|--------|-----------|
-| 1 | Konfiguracja SonarQube i baseline | 1/1 | ✅ Complete | 2026-03-15 |
-| 2 | Naprawa błędów krytycznych | TBD | 🔵 Next | - |
-| 3 | Naprawa błędów głównych | TBD | Not started | - |
+| 1 | Konfiguracja SonarQube i baseline | 1/1 | Complete | 2026-03-15 |
+| 2 | Naprawa bledow krytycznych | TBD | Next | - |
+| 3 | Naprawa bledow glownych | TBD | Not started | - |
 | 4 | Poprawa pokrycia testami | TBD | Not started | - |
+| 5 | Import finansow z Fakturowni | 0/1 | Planning | - |
 
 ## Phase Details
 
-### Phase 1: Konfiguracja SonarQube i baseline ✅
+### Phase 1: Konfiguracja SonarQube i baseline
 
-**Goal:** Skonfigurować projekt w SonarQube, uruchomić pierwszy skan i uzyskać baseline jakości kodu
+**Goal:** Skonfigurowac projekt w SonarQube, uruchomic pierwszy skan i uzyskac baseline jakosci kodu
 **Depends on:** Nothing (first phase)
 **Completed:** 2026-03-15
 
 **Results:**
 - sonar-project.properties skonfigurowany
-- Pierwszy skan: 88 plików, 9356 LoC
+- Pierwszy skan: 88 plikow, 9356 LoC
 - Baseline: 58 bugs, 1649 code smells, 0% coverage, 5.6% duplikacji
 - Reliability: D, Security: A, Maintainability: A
 
 **Plans:**
-- [x] 01-01: Konfiguracja SonarQube i analiza wyników pierwszego skanu
+- [x] 01-01: Konfiguracja SonarQube i analiza wynikow pierwszego skanu
 
-### Phase 2: Naprawa błędów krytycznych
+### Phase 2: Naprawa bledow krytycznych
 
-**Goal:** Naprawić wszystkie bugs i vulnerabilities o priorytecie Critical/Blocker
+**Goal:** Naprawic wszystkie bugs i vulnerabilities o priorytecie Critical/Blocker
 **Depends on:** Phase 1 (wyniki skanu)
 **Research:** Unlikely
 
@@ -46,11 +47,11 @@ Phases: 1 of 4 complete
 - Reskan po naprawach
 
 **Plans:**
-- [ ] 02-01: TBD (na podstawie wyników Phase 1)
+- [ ] 02-01: TBD (na podstawie wynikow Phase 1)
 
-### Phase 3: Naprawa błędów głównych
+### Phase 3: Naprawa bledow glownych
 
-**Goal:** Naprawić bugs o priorytecie Major i code smells wpływające na stabilność
+**Goal:** Naprawic bugs o priorytecie Major i code smells wplywajace na stabilnosc
 **Depends on:** Phase 2
 **Research:** Unlikely
 
@@ -60,21 +61,36 @@ Phases: 1 of 4 complete
 - Reskan po naprawach
 
 **Plans:**
-- [ ] 03-01: TBD (na podstawie wyników Phase 2)
+- [ ] 03-01: TBD (na podstawie wynikow Phase 2)
 
 ### Phase 4: Poprawa pokrycia testami
 
-**Goal:** Dodać testy dla kluczowych modułów zidentyfikowanych przez SonarQube
+**Goal:** Dodac testy dla kluczowych modulow zidentyfikowanych przez SonarQube
 **Depends on:** Phase 3
 **Research:** Unlikely
 
 **Scope:**
-- Testy dla modułów o najniższym pokryciu
-- Testy regresji dla naprawionych bugów
+- Testy dla modulow o najnizszym pokryciu
+- Testy regresji dla naprawionych bugow
 
 **Plans:**
-- [ ] 04-01: TBD (na podstawie wyników Phase 3)
+- [ ] 04-01: TBD (na podstawie wynikow Phase 3)
+
+### Phase 5: Import finansow z Fakturowni
+
+**Goal:** Wdrozyc automatyczny import faktur przychodowych i kosztowych z Fakturowni do finansow crmPRO
+**Depends on:** None (moze byc realizowane niezaleznie od prac SonarQube)
+**Research:** Likely (szczegoly endpointow API i semantyka pol dokumentow)
+
+**Scope:**
+- Integracja API Fakturownia (dane z `.env` + data startu importu)
+- Trwale mapowanie klientow i produktow/uslug do struktur finansowych CRM
+- Import cykliczny przez cron z idempotencja i obsluga bledow
+- Panel mapowania brakow w `/finances/main_view/`
+
+**Plans:**
+- [ ] 05-01: Integracja Fakturownia i automatyczny import do finansow
 
 ---
 *Roadmap created: 2026-03-15*
-*Last updated: 2026-03-15 — Phase 1 complete*
+*Last updated: 2026-04-02 - Phase 5 planned*