Files
crmPRO/.paul/PROJECT.md
Codex 7acf22c71a feat(05-finances-fakturownia-import): complete Fakturownia mapping corrections
Phase 5 complete:
- add category mapping edit from operation edit for Fakturownia operations
- update current operation category immediately after mapping change
- support optional bulk update for matching imported operations
- close 05-05 and 05-06 PAUL summaries

Co-Authored-By: Codex <noreply@openai.com>
2026-05-04 22:57:55 +02:00

63 lines
2.4 KiB
Markdown

# Project: crmPRO
## Description
Autorski system CRM do zarządzania projektami, zadaniami, klientami, finansami i śledzeniem czasu pracy. Zbudowany w PHP + MySQL z Bootstrap, jQuery i własnym systemem szablonów.
## Core Value
Użytkownicy mogą efektywnie zarządzać projektami, zadaniami i klientami w jednym systemie CRM.
## Current State
| Metric | Value | Source |
|--------|-------|--------|
| Version | v0.1.0 (in progress) | Milestone |
| Status | Phase 1 and Phase 5 complete, Phase 2 next | STATE.md |
| Lines of Code | 9 356 | SonarQube baseline |
| Bugs | 58 | SonarQube baseline |
| Code Smells | 1 649 | SonarQube baseline |
| Coverage | 0% | SonarQube baseline |
| Technical Debt | ~127h | SonarQube baseline |
| Reliability | D | SonarQube baseline |
| Security | A | SonarQube baseline |
## Requirements
### Validated
- ✓ SonarQube baseline — Phase 1: projekt skonfigurowany, skan wykonany, metryki udokumentowane
- ✓ Import finansow z Fakturowni — Phase 5: automatyczny import faktur przychodowych/kosztowych, mapowanie po NIP, filtr proforma, skip-list pozycji, edycja dopasowania kategorii
### Active
- [ ] Naprawić 58 bugów (priorytet: 3 CRITICAL, 35 MAJOR)
- [ ] Zredukować 780 CRITICAL code smells
- [ ] Zwiększyć coverage z 0%
- [ ] Zredukować technical debt (~127h)
### Out of Scope
- (none yet)
## Constraints
- PHP 7.4 na serwerze
- SonarQube @ https://sonar.project-pro.pl
## Key Decisions
| Decision | Phase | Impact |
|----------|-------|--------|
| SonarQube URL: https://sonar.project-pro.pl | Phase 1 | Konfiguracja skanera |
| Skan automatyczny CLI + MCP | Phase 1 | Nie wymaga ręcznego uruchomienia |
| Mapowanie klientow po NIP (tax:) z fallback na id: | Phase 5 | Kompatybilnosc z historycznymi mapowaniami |
| Filtr proforma: kind + prefiks FP | Phase 5 | Proformy nie trafiaja do finansow |
| Edycja dopasowania Fakturownia tylko dla operacji importowanych | Phase 5 | Reczne operacje pozostaja przy standardowej edycji kategorii |
| Zmiana dopasowania moze masowo przepiac pasujace operacje | Phase 5 | Szybka korekta blednej kategorii dla powtarzalnych pozycji faktur |
## Success Criteria
- Użytkownicy mogą efektywnie zarządzać projektami, zadaniami i klientami w jednym systemie CRM
- Reliability rating: A (currently D)
- Technical debt < 50h (currently 127h)
- Coverage > 30% (currently 0%)
---
*Created: 2026-03-15*
*Last updated: 2026-05-04 after Phase 5*