# Roadmap: crmPRO

## Overview
Stabilizacja i poprawa jakosci kodu crmPRO oraz rozwoj finansow o automatyczny import faktur z Fakturowni.

## Current Milestone
**v0.1 Stabilizacja i jakosc kodu + import finansow** (v0.1.0)
Status: In progress
Phases: 2 of 5 complete

## Phases

| Phase | Name | Plans | Status | Completed |
|-------|------|-------|--------|-----------|
| 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 | 6/6 | Complete | 2026-05-04 |

## Phase Details

### Phase 1: Konfiguracja SonarQube i baseline

**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 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 wynikow pierwszego skanu

### Phase 2: Naprawa bledow krytycznych

**Goal:** Naprawic wszystkie bugs i vulnerabilities o priorytecie Critical/Blocker
**Depends on:** Phase 1 (wyniki skanu)
**Research:** Unlikely

**Scope (based on Phase 1 baseline):**
- Naprawa 3 CRITICAL bugs i 35 MAJOR bugs
- 17 Security Hotspots do review
- Reskan po naprawach

**Plans:**
- [ ] 02-01: TBD (na podstawie wynikow Phase 1)

### Phase 3: Naprawa bledow glownych

**Goal:** Naprawic bugs o priorytecie Major i code smells wplywajace na stabilnosc
**Depends on:** Phase 2
**Research:** Unlikely

**Scope:**
- Naprawa Major bugs
- Naprawa krytycznych code smells (S121: 664, S1192: 84, S3776: 24)
- Reskan po naprawach

**Plans:**
- [ ] 03-01: TBD (na podstawie wynikow Phase 2)

### Phase 4: Poprawa pokrycia testami

**Goal:** Dodac testy dla kluczowych modulow zidentyfikowanych przez SonarQube
**Depends on:** Phase 3
**Research:** Unlikely

**Scope:**
- Testy dla modulow o najnizszym pokryciu
- Testy regresji dla naprawionych bugow

**Plans:**
- [ ] 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:**
- [x] 05-01: Integracja Fakturownia i automatyczny import do finansow
- [x] 05-02: Mapowanie klienta po NIP + kompatybilnosc mapowan historycznych
- [x] 05-03: Filtr proforma — pomijanie faktur proforma (FP*) w imporcie
- [x] 05-04: Bugfix — brak faktur kosztowych z /invoices.json?income=no (np. 486639934) + obsluga wydatkow z KSeF (odwrocone role seller/buyer)
- [x] 05-05: Skip-list pozycji — mozliwosc oznaczenia wybranej pozycji faktury jako pomijanej (nie trafia do finance_operations)
- [x] 05-06: Edycja dopasowania kategorii z poziomu operation_edit + opcjonalne masowe przepiecie operacji z tym samym itemem Fakturownia

---
*Roadmap created: 2026-03-15*
*Last updated: 2026-05-04 - Phase 5 complete (05-01..05-06)*




