Files
clienthub/.planning/phases/20-knowledge-base-cliente/20-DISCUSSION-LOG.md
T
2026-06-19 18:26:02 +02:00

2.4 KiB

Phase 20: Knowledge Base Cliente — Discussion Log

Audit trail only. Do not use as input to planning, research, or execution agents. Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.

Date: 2026-06-19 Phase: 20-knowledge-base-cliente Areas discussed: Lead-scoped o anche client?


Lead-scoped o anche client?

Q1 — FK scope della tabella

Option Description Selected
Solo lead per ora client_transcripts ha solo lead_id. Semplice, sufficiente per Phase 21. La FK client_id si aggiunge in futuro se serve.
Prepara entrambe le FK ora lead_id e client_id entrambi nullable nella tabella. Più lavoro ora, ma non serve una migration futura se vuoi trascrizioni anche per clienti esistenti.

User's choice: Prepara entrambe le FK ora Notes: L'utente preferisce prepararsi alla flessibilità futura con una sola migration ora.


Q2 — UI Phase 20 per client_id

Option Description Selected
Solo dal dettaglio lead per ora La FK client_id c'è nello schema ma non è esposta in UI in Phase 20. Si usa quando un lead è convertito — per dopo.
Anche dalla pagina admin cliente Phase 20 aggiunge il blocco transcript sia nel LeadDetail che in /admin/clients/[id]. Più lavoro, ma copre subito clienti esistenti senza lead.

User's choice: Solo dal dettaglio lead per ora Notes: L'UI Phase 20 è solo lato lead. client_id è nello schema ma non esposta.


Claude's Discretion

Le seguenti aree non sono state discusse e sono state lasciate al giudizio di Claude:

  • Metadati del transcript — Scelto: title (text, optional) + content (text, illimitato) + call_date (date). No enum tipo — il titolo libero è sufficiente.
  • Collocazione UI nel LeadDetail — Scelto: nuova sezione "Transcript" collassabile dopo le Attività, seguendo il pattern visivo esistente (Card + lista). Modal per aggiungere (come LogActivityModal).
  • Ordinamentocall_date DESC (chiamata più recente in cima).

Deferred Ideas

  • UI transcript nella pagina admin cliente (/admin/clients/[id]) — la FK è pronta, la UI è deferred post-v2.2.
  • Ricerca full-text sui transcript — fuori scope, i transcript vengono letti dall'AI in blocco.
  • Trascrizione automatica da audio — fuori scope v2.2.