Files
crmPRO/.paul/PROJECT.md
Codex 3b1ba1b5ed feat(06-task-title-ai): complete OpenAI task title suggestions
Phase 6 complete:

- add AI title generator service using gpt-5-nano

- add task popup button for biuro@project-pro.pl

- add AJAX endpoint returning title suggestions without auto-save
2026-05-04 23:45:54 +02:00

67 lines
2.8 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, Phase 5 and Phase 6 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
- ✓ AI title generation for tasks — Phase 6: przycisk AI w popupie zadania dla `biuro@project-pro.pl`, propozycja tytulu bez automatycznego zapisu
### 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 |
| Tytuly AI sa propozycja, nie automatycznym zapisem | Phase 6 | Bezpieczna edycja tytulu zadania przez istniejacy mechanizm zapisu |
| Model tytulow zadan: `gpt-5-nano` | Phase 6 | Osobna konfiguracja od importu maili i niski koszt generowania |
## 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 6*