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

2.8 KiB

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

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