Module Visios — guide produit

Le module Visios capture les RDV & visioconférences du cabinet, les structure via des templates cabinet, et laisse l'IA Claude produire un rapport, une scorecard et un email prêt à envoyer.

---

1. Où capturer un RDV ?

Il y a 4 entrées pour créer une visio :

1. Sur la fiche dossier (/[dossierId]/dossier-permanent → section « 🎥 RDV & visioconférences »)
   • Bouton « Upload texte / visio » (capture rapide : colle le texte, l'IA détecte le template)
   • Bouton « + Nouveau RDV » (wizard complet)
2. Depuis la page transverse /visios
   • Toutes les visios du cabinet groupées par dossier
   • Section ambre « À rattacher » pour les orphelines
3. Depuis le dashboard cabinet /
   • Widget « RDV & visios — ta semaine » (tabs À rédiger / Cette semaine / Scorecards)
   • Bouton « + Capture »
4. Capture orpheline /visios/nouveau (3 étapes : template → rédaction → rattachement optionnel)

---

2. Où sont stockés les templates ?

Table Supabase : visio_templates

• 7 templates système seed (non supprimables, éditables) :
  • 🎯 rdv_prospect · 📊 rdv_bilan · 🔄 rdv_suivi · 🧠 rdv_conseil · 🔍 rdv_revision · ⚠️ rdv_risque · 📝 libre
• Templates cabinet custom (is_system=false, créés via le bouton « ✦ Nouveau modèle IA »)

Accès édition : /parametres/modeles-visios (hub /parametres → card « Modèles de visios »).

---

3. Les 6 facettes d'un template

Chaque template est un prompt hub avec 6 onglets :

Facette	Rôle	Stockage
🤖 Automation	Trigger prompt — permet à l'IA de détecter quel template appliquer à une transcription	trigger_prompt
📄 Rapport	Liste des sections du compte-rendu, chaque section a un prompt descriptif (quoi extraire, comment formater)	rapport_spec.sections[]
📊 Scorecard	Grille d'évaluation textuelle — chaque critère a un « niveau 5/5 attendu » décrit	scorecard_spec.criteres[]
🎬 Clips	Prompt d'extraction des moments clés (citations avec observation)	clips_spec.prompt_extraction
📧 Emails	Prompt de génération du draft email post-RDV + toggle auto-draft	emails_spec.prompt_generation · emails_spec.auto_draft
📐 Directives	Règles cabinet globales (ton, compliance, brand voice) appliquées à toutes les sorties IA	cabinet_guidelines (table séparée)

Édition inline

Sur /parametres/modeles-visios, tu tapes dans les textareas — au bout de 600 ms l'indicateur « Enregistrement… » apparaît puis « ✓ Enregistré ». C'est du PATCH automatique vers l'API, pas de bouton à cliquer.

Les modifications sont instantanées : la prochaine capture qui utilise ce template appliquera tes nouveaux prompts.

---

4. Les 5 endpoints IA Claude

Toutes les opérations IA passent par Claude (via @anthropic-ai/sdk). Les endpoints :

Bouton	Endpoint	Ce que ça fait
🤖 Auto (debounced 800 ms)	POST /api/visios/templates/suggest	Détermine le meilleur template pour un contenu
📄 Structurer le rapport	POST /api/dossier/:id/visios/:vid/generate-rapport	Transcription + rapport_spec.sections → rapport_md structuré
📊 Évaluer (scorecard)	POST /…/generate-scorecard	Rapport + scorecard_spec.criteres → score global + axes + citations
✉ Générer email	POST /…/generate-email	Rapport + emails_spec → draft email avec Objet + corps
✦ Nouveau modèle IA	POST /api/visios/templates/generate	Description + PDF → template complet (6 facettes)

Pipeline recommandé

1. Capture : colle texte ou upload .txt/.vtt/.srt → l'IA suggère un template
2. Structurer : clic « 📄 Structurer » → rapport_md rédigé selon les sections
3. Évaluer : clic « 📊 Évaluer » → scorecard 0-100 + critique par axe
4. Email : clic « ✉ Générer email » → draft prêt à copier

Temps total observé sur un RDV bilan (49 k caractères) : ~1 min 40 s pour les 3 IA en séquence.

---

5. Comment améliorer un template ?

Règle d'or : plus le prompt est précis, meilleure est la sortie

Mauvais : « parle de la fiscalité » Bon : « Liste les régimes fiscaux actifs (IS, IR, TVA). Inclure les échéances déclaratives à 12 mois, les risques de redressement identifiés, les options non levées. Format à puces. »

Onglet Rapport

Pour chaque section :

• Titre : unique, descriptif (ex : ## Décisions prises)
• Prompt : quoi extraire + comment formater + format de sortie (puces / tableau / paragraphe)

Onglet Scorecard

Pour chaque critère :

• Titre : court (ex : Précision et exhaustivité)
• Niveau 5/5 attendu : décris ce qui serait un travail EXCEPTIONNEL — pas juste « bon ». Plus le niveau 5/5 est exigeant, plus la scorecard sera discriminante.

Onglet Emails

• Précise : longueur (ex : 150-200 mots) · ton (professionnel chaleureux / factuel / technique) · format (objet + 3 bullets + clôture) · signature (Alexandre ASSOR)
• Toggle auto-draft : à activer si tu veux qu'un brouillon apparaisse automatiquement dans la boîte de réception après le save (prochainement wired vers Gmail/Outlook)

Onglet Automation — Trigger prompt

C'est la phrase qui dit à l'IA quand appliquer ce template. Exemple pour rdv_bilan :

« Présentation du bilan annuel au dirigeant avec examen des comptes, validation des écritures, identification des échéances fiscales et points de synthèse. »

Plus le trigger est spécifique, meilleure est la classification automatique.

---

6. Créer un nouveau modèle custom

Depuis /parametres/modeles-visios → bouton violet « ✦ Nouveau modèle IA » :

1. Description (min 20 car.) : quel type de RDV, quelle audience, quels livrables produire
2. Fichier source (optionnel) : un ancien compte-rendu PDF/DOCX/TXT que l'IA va imiter
3. Générer : Claude rédige les 6 facettes en ~30 s
4. Raffiner : l'édition inline te permet d'ajuster chaque prompt ensuite

Cas typiques à modéliser

• rdv_transmission · cession/reprise entreprise (pacte Dutreil, valorisation, LBO…)
• rdv_arbitrage_juridique · passage SCI/SARL, option IS, démembrement
• rdv_alerte · contrôle fiscal entrant, litige prud'homal, suspicion fraude
• rdv_preproduction · kickoff nouveau client post-signature

---

7. Rattacher une visio orpheline à un dossier

Capture orpheline = visio créée sans dossier (parce que tu ne sais pas encore lequel). Depuis /visios :

1. Section ambre « ⚠ À rattacher (N) » en tête de page
2. Clic « Rattacher → » sur une card
3. Dialog avec recherche dossier
4. Clic sur le dossier → rattachement immédiat (mise à jour dossier_id + is_orphan=false + rattached_at)

---

8. Tables DB concernées

Table	Rôle
dossier_visios	Captures individuelles (rapport, transcription, scorecard_result, email_draft, clips_extracted)
visio_templates	Bibliothèque de templates système + cabinet (6 facettes en jsonb)
cabinet_guidelines	Directives globales (appliquées à toutes les sorties IA via system prompt)

---

9. Évolutions prévues

• Upload audio/vidéo (bucket Supabase Storage) — colonnes audio_url/video_url déjà prêtes
• Tab Chat IA pour poser des questions à une transcription (Noota-like)
• Intégrations push Notion/Slack au save
• Dashboard progression scorecards par collaborateur (learning loop)
• Clips extractifs réels (citations ancrées dans la transcription)

---

Document maintenu en même temps que le code. Dernière mise à jour : 2026-04-22.