docs(20): capture phase context — Knowledge Base Cliente

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-19 18:26:02 +02:00
parent b7ff3fe430
commit 3e10f97215
2 changed files with 161 additions and 0 deletions
@@ -0,0 +1,50 @@
+# 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`).
+- **Ordinamento** — `call_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.