@medc-com-br/ngx-jaimes-scribe 0.1.8 → 0.1.12

package/README.md

@@ -5,16 +5,16 @@ Biblioteca Angular para transcrição de áudio em tempo real com suporte a diar
 ## Instalação
 
 ```bash
-npm install @jaimes/ngx-jaimes-scribe
+npm install @medc-com-br/ngx-jaimes-scribe
 # ou
-pnpm add @jaimes/ngx-jaimes-scribe
+pnpm add @medc-com-br/ngx-jaimes-scribe
 ```
 
 ## Uso Básico
 
 ```typescript
 import { Component } from '@angular/core';
-import { RecorderComponent } from '@jaimes/ngx-jaimes-scribe';
+import { RecorderComponent } from '@medc-com-br/ngx-jaimes-scribe';
 
 @Component({
   selector: 'app-consultation',
@@ -66,8 +66,11 @@ export class ConsultationComponent {
 |-------|------|-------------|---------|-----------|
 | `wsUrl` | `string` | ✅ Sim* | - | URL do WebSocket do serviço de streaming |
 | `token` | `string` | Não | `''` | Token JWT para autenticação |
-| `premium` | `boolean` | Não | `false` | Ativa tier premium (ElevenLabs + Sonnet) |
+| `premium` | `boolean` | Não | `false` | Ativa tier premium (Deepgram Nova-3) |
 | `speakerLabels` | `Record<number, string>` | Não | `{}` | Labels customizados para speakers |
+| `doctorName` | `string` | Não | `''` | Nome do médico (exibido quando speaker é identificado como doctor) |
+| `patientName` | `string` | Não | `''` | Nome do paciente (exibido quando speaker é identificado como patient) |
+| `companionName` | `string` | Não | `''` | Nome do acompanhante (exibido quando speaker é identificado como companion) |
 | `templates` | `TemplateOption[]` | Não | `[]` | Lista de templates para geração de documentos |
 | `lambdaUrl` | `string` | Não | `''` | URL base do Lambda para geração de documentos |
 | `apiUrl` | `string` | Não | `''` | URL base da API para carregar sessões anteriores |
@@ -102,12 +105,12 @@ Token JWT para autenticação. Usado tanto na conexão WebSocket quanto nas cham
 #### `premium`
 
 Quando `true`, ativa o tier premium:
-- **Transcrição**: ElevenLabs Scribe v2 (ou Deepgram Nova-3 via env)
+- **Transcrição**: Deepgram Nova-3
 - **LLM**: Claude Sonnet 4.5
 
 Quando `false` (default):
 - **Transcrição**: Deepgram Enhanced
-- **LLM**: Claude Sonnet 4.5
+- **LLM**: Claude Haiku 4.5
 
 ```html
 <!-- Tier Standard -->
@@ -142,12 +145,75 @@ speakerLabels: Record<number, string> = {
 - `2`: "Pessoa 3"
 - `3`: "Pessoa 4"
 
+#### `doctorName`, `patientName`, `companionName`
+
+Nomes para exibir na UI quando os speakers são identificados automaticamente. A identificação usa Claude Sonnet para analisar o conteúdo da conversa e determinar quem é médico, paciente ou acompanhante.
+
+```html
+<ngx-jaimes-scribe-recorder
+  [wsUrl]="wsUrl"
+  [token]="token"
+  [doctorName]="'Dr. João Silva'"
+  [patientName]="'Maria Santos'"
+  [companionName]="'José Santos'"
+/>
+```
+
+**Na UI**: Exibe "Dr. João Silva", "Maria Santos", etc.
+**Na API/Resumo**: Usa labels genéricos "Médico", "Paciente", "Acompanhante".
+
+---
+
+## Identificação Automática de Speakers
+
+O componente identifica automaticamente quem é cada speaker (Médico, Paciente, Acompanhante) usando IA.
+
+### Fluxo
+
+1. **Gravação em andamento**: Diarização ativa (Deepgram retorna speaker IDs 0, 1, 2...)
+2. **Acumulação**: Sistema aguarda 2+ speakers com pelo menos 100 caracteres cada
+3. **Identificação automática**: Envia amostra para `/identify-speakers` → Claude Sonnet analisa contexto
+4. **Atualização da UI**: Labels mudam de "Pessoa 1" → "Dr. João Silva" (ou "Médico" se nome não fornecido)
+5. **Re-identificação**: Se novo speaker aparecer, identifica novamente incluindo o novo
+
+### Correção Manual
+
+O médico pode clicar no label de qualquer speaker para corrigir a identificação:
+
+```
+[Clica no label "Médico"]
+        ↓
+[Dropdown aparece]
+├── 🩺 Médico
+├── 🙋 Paciente
+├── 👥 Acompanhante
+└── ✏️ Outro...
+```
+
+### Indicador de Baixa Confiança
+
+Quando a IA tem confiança < 70%, aparece um indicador ⚠️ para o médico revisar.
+
+### Persistência
+
+O mapeamento de speakers é salvo automaticamente no Jaimes (S3) e retornado via `GET /session/{sessionId}`. Não é necessário persistir no EHR.
+
+### Labels na Geração de Anamnese
+
+Quando o documento é gerado, o Lambda `/generate` usa os roles identificados:
+
+```
+[Médico]: Bom dia, como posso ajudá-lo?
+[Paciente]: Doutor, estou com dor nas costas há duas semanas...
+[Acompanhante]: Ele também tem dormido mal por causa disso.
+```
+
 #### `templates`
 
 Lista de templates disponíveis para geração de documentos. O botão "Gerar Resumo" só aparece se houver templates configurados e uma sessão finalizada.
 
 ```typescript
-import { TemplateOption } from '@jaimes/ngx-jaimes-scribe';
+import { TemplateOption } from '@medc-com-br/ngx-jaimes-scribe';
 
 templates: TemplateOption[] = [
   {
@@ -355,7 +421,7 @@ onSessionFinished(result: { transcript: string; entries: TranscriptEntry[] }): v
 Emitido após a geração bem-sucedida de um documento via Lambda.
 
 ```typescript
-import { GeneratedDocument } from '@jaimes/ngx-jaimes-scribe';
+import { GeneratedDocument } from '@medc-com-br/ngx-jaimes-scribe';
 
 onDocumentGenerated(doc: GeneratedDocument): void {
   console.log('Template usado:', doc.templateId);
@@ -557,7 +623,7 @@ import {
   RecorderComponent,
   TemplateOption,
   GeneratedDocument
-} from '@jaimes/ngx-jaimes-scribe';
+} from '@medc-com-br/ngx-jaimes-scribe';
 
 @Component({
   selector: 'app-medical-consultation',
@@ -771,10 +837,10 @@ export class MedicalConsultationComponent {
 │  ┌──────────────┐    ┌─────────────────────────────────────┐    │
 │  │    ALB       │───►│ ECS Fargate (Stream Service)        │    │
 │  └──────────────┘    │                                     │    │
-│                      │  ┌─────────────┐  ┌─────────────┐   │    │
-│                      │  │ Deepgram    │  │ ElevenLabs  │   │    │
-│                      │  │ (Standard)  │  │ (Premium)   │   │    │
-│                      │  └─────────────┘  └─────────────┘   │    │
+│                      │  ┌───────────────────────────────┐   │    │
+│                      │  │ Deepgram                      │   │    │
+│                      │  │ Nova-3 (Premium) / Enhanced   │   │    │
+│                      │  └───────────────────────────────┘   │    │
 │                      │                                     │    │
 │                      │  ┌─────────────────────────────┐    │    │
 │                      │  │ SessionManager              │    │    │