# 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.
