51 lines
2.4 KiB
Markdown
51 lines
2.4 KiB
Markdown
# 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.
|