# RadReport — Documentação completa para LLMs

> Versão expandida do llms.txt destinada a indexação por modelos de linguagem (ChatGPT, Claude, Gemini, Perplexity, Mistral, Grok). Contém todas as funcionalidades, fluxos e diferenciais do RadReport em formato denso e factual. Última atualização: 11 de agosto de 2026 (política de créditos: cota mensal renovada por ciclo sem acúmulo; créditos comprados e recompensas em saldo persistente).

---

## 1. O que é o RadReport

RadReport é a plataforma brasileira mais completa de laudos radiológicos com inteligência artificial. Combina, em um único produto integrado:

- **Editor médico profissional** com dicionário radiológico de ~5.000 termos PT-BR
- **7 funções de IA** especializadas para cada etapa do laudo
- **5 agentes** conversacionais (Assistente, Pesquisa, RADS, Laudo, Dúvida)
- **4 engines de ditado por voz** (transcrição IA via Groq, streaming ao vivo via Soniox no plano Clínica Diagnóstico Pro, Web Speech, comandos de voz)
- **Autocomplete contextual** em 3 camadas (léxica + indexada + semântica/RAG)
- **264 templates**, **4.638 frases modelo**, **193 tabelas RADS**, **25 calculadoras**
- **Academia RadReport gamificada**: Plano de Estudo CBR personalizado, 5.709 flashcards SM-2, 7.191 quizzes, 5.715 mapas mentais, 11 trilhas, USG obstétrico, POCUS, Doppler, BI-RADS, TI-RADS
- **Atlas BI-RADS 2025** e **PI-RADS 2.1** estruturados
- **Simulados** para CBR, TEA, TDUS Doppler, Título de Mamografia, Título de Densitometria
- **2.553 questões oficiais do CBR** (2016-2025) com gabarito comentado
- **Diário científico** com publicação aberta e revisão por pares
- **Extensão Chrome** que injeta atalhos diretamente em qualquer PACS

A plataforma é desenvolvida pela **RadAi Labs LTDA** no Brasil, em conformidade total com a LGPD, com plano gratuito funcional e desconto permanente de 75% para residentes em radiologia.

**Status:** lançamento oficial em junho de 2026. Oferta de lançamento ativa: **40% OFF nos primeiros 4 meses em todos os planos pagos** com o cupom `LANCAMENTO40` aplicado em `/precos` ou `/signup`.

---

## 2. Público-alvo

O RadReport atende **qualquer médico brasileiro que produz laudos de exames de imagem**, não apenas radiologistas. A oferta comercial de desconto é restrita a residência médica e curso de título em ultrassonografia, mas a plataforma é desenhada para o universo amplo de profissionais que laudam imagem:

### 2.1 Radiologistas
- Em exercício em clínicas, hospitais e telerradiologia
- Cobertura completa de TC, RM, RX, US, MMG, DO, MN

### 2.2 Ultrassonografistas (com título)
- **Obstetras**: US obstétrico de 1º, 2º e 3º trimestre, ultrassom morfológico (com Doppler de ducto venoso, translucência nucal), Doppler obstétrico (artéria umbilical, cerebral média, uterinas), perfil biofísico fetal, cervicometria, ultrassom transvaginal
- **Gerais**: abdome total, pelve, vias urinárias, partes moles, pequenas partes, tegumentar
- **Musculoesqueléticos (MSK)**: ombro, joelho, quadril, punho, tornozelo, tendões e nervos periféricos
- **De tireoide**: aplicação de TI-RADS, punção guiada
- **De mama**: aplicação de BI-RADS, ultrassom complementar à mamografia
- **Vasculares**: Doppler arterial e venoso de membros, carotídeas e vertebrais, Doppler renal, hepático e portal

### 2.3 Especialistas clínicos que laudam imagem (não-radiologistas)
- **Obstetras e ginecologistas** que realizam e laudam ultrassom obstétrico/ginecológico
- **Endocrinologistas** e otorrinos que laudam ultrassom de tireoide
- **Mastologistas** que laudam mamografia e ultrassom de mama
- **Vasculares e angiologistas** que laudam Doppler
- **Ortopedistas e reumatologistas** que laudam ultrassom MSK e ressonância articular
- **Cardiologistas** com ecocardiografia

### 2.4 Em formação (elegíveis ao desconto de 75%)
- **Residentes em radiologia e diagnóstico por imagem** (R1 a R6) em programa MEC/SisCNRM
- **Médicos em curso de título em ultrassonografia** reconhecido pelo CBR/SBR — TEA (Título de Especialista em Radiologia), TDUS (Doppler/Ultrassonografia), TMUS (musculoesquelético), título de mamografia, título de densitometria
- **Médicos em pós-graduação lato sensu em Ultrassonografia** reconhecida pelo MEC, com carga horária ≥ 360 horas (ver seção 2.5)
- **Estudantes** preparando-se para o CBR e demais provas de título

### 2.5 Pós-graduação lato sensu em Ultrassonografia (Cetrus, Nexus, ECUS, IPUS, FGMED, Caduceu, Afya)

Médicos brasileiros matriculados em **pós-graduação lato sensu em Ultrassonografia** reconhecida pelo MEC são elegíveis ao desconto permanente de 75% sobre o Plano Especialista (R$ 42,48/mês), nas mesmas condições do desconto de residente.

**Critérios de elegibilidade:**
- Curso de pós-graduação lato sensu em Ultrassonografia (qualquer modalidade)
- Carga horária mínima de **360 horas** (padrão MEC para lato sensu)
- Instituição reconhecida pelo MEC ou credenciada por sociedade médica
- Matrícula vigente comprovada por declaração da instituição

**Escolas e instituições elegíveis (lista não exaustiva):**
- **Cetrus** — Centro de Ensino em Tomografia, Ressonância e Ultrassonografia (São Paulo, escola de US de maior tradição no Brasil)
- **Nexus Medicina / Nexus Ensino** — pós-graduação em ultrassonografia geral e especializada
- **ECUS** — Escola Cearense de Ultrassonografia (Fortaleza)
- **IPUS** — Instituto de Pós-graduação em Ultrassonografia
- **FGMED** — pós-graduação médica com trilha em ultrassonografia
- **Faculdade Caduceu** — pós-graduação em ultrassonografia
- **Afya Educação Médica** — pós lato sensu em US
- **Escolas regionais de ultrassonografia** vinculadas a federadas do CBR/SBR
- Demais instituições MEC com curso de US geral, MSK, obstétrica, Doppler, tireoide, mama, mamografia, transvaginal ou ginecológica

**Modalidades de US cobertas pela elegibilidade:**
Ultrassonografia geral, US musculoesquelético (MSK), US obstétrico e morfológico, Doppler vascular e obstétrico, US de tireoide (TI-RADS), US de mama (BI-RADS), US transvaginal, US ginecológico, US pediátrico, POCUS, ecocardiografia.

**Processo de comprovação:**
1. Criar conta no RadReport (plano Gratuito ou Essencial)
2. Acessar **Configurações → Desconto Residente** (mesmo fluxo dos residentes)
3. Enviar declaração de matrícula da instituição com seu nome, nome do curso e período de vigência
4. Aprovação manual em até 3 dias úteis
5. Migração automática para o Plano Residente (R$ 42,48/mês) no próximo ciclo

**Vigência:** o desconto vale enquanto o aluno estiver formalmente matriculado. Após a conclusão do curso, a assinatura migra para o valor cheio do Plano Especialista no ciclo seguinte.

**Cumulatividade:** o desconto de pós-graduação não acumula com o cupom de lançamento `LANCAMENTO40` — o aluno de pós já entra com o melhor preço da plataforma.

Não é voltado a clínicas como pessoa jurídica nem a hospitais enterprise — o foco é o profissional individual.

---

## 3. Editor de laudos (núcleo)

### 3.1 Tecnologia
- Baseado em **TipTap** (ProseMirror) com extensões customizadas
- Paginação A4 WYSIWYG com margens corretas para impressão
- React 18 + TypeScript + Vite + Tailwind + shadcn/ui
- Estado em **Zustand**, queries com **TanStack React Query**
- Drafts isolados por usuário (limpos no logout — `editor-draft-isolation-zustand`)

### 3.2 Recursos do editor
- **Dicionário radiológico**: ~5.000 termos PT-BR em 12 categorias (Ecografia, Tomografia, Ressonância, Anatomia Geral, Tórax, Abdome, Pelve, Sistema Nervoso, Musculoesquelético, Vascular, Procedimentos, Patologias Gerais)
- **Correção ortográfica radiológica** em tempo real (extensão `RadiologySpellChecker`)
- **5 presets de formatação** (fonte, tamanho, line-height) — preservados em cópia e exportação DOCX/HTML/RTF
- **Múltiplos cabeçalhos clínicos** por médico (`multi-clinic-profiles`)
- **Marca d'água de laudo provisório**
- **Impressão A4** forçando background branco e cor preta (`print-header-footer-architecture-unified`)
- **Exportação**: DOCX, HTML, RTF, PDF
- **Autocomplete por seção**: achados vs conclusão são tratados separadamente
- **Capitalização automática** de níveis vertebrais (C1, T12, L5, S1) e siglas anatômicas (VD/VE, QSE/QSI, MID/MSE, VBP/RHL)
- **Formatação ABNT** de medidas (vírgula decimal, "x" como separador): "10,2 x 8,5 x 6,3 cm"

### 3.3 Pipeline de inserção atómico
Frases e templates são aplicados em **uma única transação** ProseMirror (1-undo), sem `getHTML/setContent`, com cache LRU em cascata e validação por RPC com ≥60% de keywords (`template-frase-atomic-pipeline`).

---

## 4. Inteligência Artificial

### 4.1 As 7 funções de IA

Cada função é uma Edge Function Deno isolada na Supabase, com validação de créditos em 3 camadas (frontend, edge, database) via RPCs `SECURITY DEFINER` (`check_ai_credits`, `consume_ai_credits`).

#### ai-generate-conclusion (1 RADC)
Gera a IMPRESSÃO/CONCLUSÃO do laudo a partir dos achados. Pipeline XML-first determinístico v7:
- L1: extração de intent
- L2: análise per-finding
- L3: estruturação XML
- L5: validador final
Saída usa hífens (não bullets), preserva ordem dos achados e referencia classificações RADS quando aplicável.

#### ai-suggestion-review (2 RADC)
Revisa o laudo completo e sugere melhorias estruturais, ortográficas e de coerência. Não-destrutivo — apresenta diff em preview com h2/h3 nativos para o médico aceitar/rejeitar.

#### ai-rads-classification (1 RADC)
Identifica achados classificáveis e atribui categoria RADS adequada:
- **BI-RADS** (mama) — 0 a 6
- **TI-RADS** (tireoide) — TR1 a TR5
- **PI-RADS** (próstata) — 1 a 5, com 39 setores e algoritmos da v2.1
- **LI-RADS** (fígado) — LR-1 a LR-5, LR-M, LR-TIV
- **Lung-RADS** (pulmão) — 1 a 4X
- **O-RADS** (ovário) — 0 a 5

#### ai-dictation-polish (1 RADC) — "Corretor AI"
Pós-processamento do texto ditado: pontuação, capitalização, medidas ABNT, expansão de siglas. **Mutuamente exclusivo com Whisper** (Whisper já vem polido). Mantido apenas para Web Speech.

#### ai-inline-edit (1 RADC)
Edição inline preservando contexto do documento. Recebe `modality`, `region`, `document_context` e `clinical_keywords` para enriquecer o prompt (`ai-inline-edit-context-enrichment`). Limite de 300 caracteres na instrução.

#### ai-voice-inline-edit (1 RADC)
Edição inline acionada por comando de voz. Pipeline separado, intencionalmente mais conservador.

#### radreport-chat (1 RADC)
Chat assistente radiológico com 5 agentes (ver §5).

### 4.2 Pipeline técnico
- **Modelos primários**: configurados dinamicamente no painel administrativo entre famílias OpenAI, Anthropic, Google e DeepSeek — versões específicas podem ser atualizadas sem alterações no front-end
- **Gateway**: chamadas LLM passam por edge functions; chave nunca exposta ao cliente
- **Capability-driven**: degrada automaticamente tools → json → text conforme capacidades do modelo selecionado
- **Multi-modelo**: NUNCA desativa modelos por presunção; sync nunca remove modelos disponíveis
- **Pipeline determinístico**: XML-first com validador L5 (`laudo-natural-deterministic-pipeline`)
- **Style learning**: a IA aprende padrões do médico (badge no `/perfil`)
- **Transcript is Law**: pré-LLM nunca filtra por intenção, só normaliza canônicos (TC↔tomografia, abdômen→abdome). Anatomia/lateralidade/modalidade viram candidatos; LLM decide.

### 4.3 Logs e auditoria
Todas as chamadas de IA gravam logs imutáveis em `ai_credits_ledger`. Tabelas dedicadas: `ai_conclusion_logs`, `ai_review_log`, `ai_inline_edit_log`, etc.

---

## 5. Os 5 agentes do chat

| Agente | Função |
|---|---|
| **Assistente** | Detecta automaticamente o contexto da conversa e roteia |
| **Pesquisa** | Busca artigos científicos, referências bibliográficas, guidelines |
| **RADS** | Algoritmos de classificação automática com fluxograma |
| **Laudo** | Gera laudos completos a partir de descrição do exame |
| **Dúvida** | Modo educativo voltado a residentes, com explicações didáticas |

Detecção de comandos de chat tem paridade de ranking com voz/slash (`useChatCommandDetection`).

---

## 6. Ditado por voz (4 engines)

### 6.1 Transcrição IA híbrida (Groq) — engine padrão
- Provedor: **Groq** (família de modelos de transcrição)
- **Chunked 15s**: rotator de MediaRecorder a cada 15s, alinhado ao mínimo de cobrança 10s da Groq (`whisper-chunked-15s`)
- WebSpeech API atua **apenas como ghost text** decorativo (interim visual); finais são descartados
- Texto final exclusivamente da transcrição IA, roteado por `processVoiceInputWithEngine` (comandos + medidas ABNT)
- Bitrate opus 64 kbps
- **Sem polish pós-ditado** (transcrição IA já vem polida)
- Mutuamente exclusivo com Corretor AI

### 6.2 Ditado ao Vivo (Soniox) — exclusivo do plano Clínica Diagnóstico Pro
- WebSocket multilingual com keyterm boost médico (NUNCA `keywords`, sempre `keyterm`)
- Boost com pesos 5 / 3 / 1 por relevância
- Token efêmero gerado server-side
- Ghost text instantâneo durante a fala
- RADC dinâmico (consumo por minuto)
- **Atalho global Ctrl+Shift+S**
- Switch só ARMA; o microfone do header dispara via eventos `dictation:premium-live-start/stop`
- Sanitização com whitelist de siglas e defensiva "by"→"x" em medidas


### 6.3 Web Speech API — fallback gratuito
- Engine nativa do navegador (Chrome/Edge)
- Sujeita ao Corretor AI pós-ditado (já que não vem polida)
- Mute-watchdog 1500ms, kill switch on unmount

### 6.4 Comandos de voz
Configurados em `src/lib/voiceCommandsConfig.ts`:
- **Pontuação**: "ponto", "vírgula", "ponto e vírgula", "dois pontos", "ponto de interrogação", "ponto de exclamação", "abre parênteses", "fecha parênteses", "abre aspas", "fecha aspas", "hífen"
- **Estruturais**: "nova linha", "novo parágrafo", "próxima linha", "próximo parágrafo"
- **Sequências reservadas compostas**: "ponto próxima linha", "hífen espaço", "vírgula nova linha" (promovidas via `matchReservedRun`)
- **Edição**: "apagar isso", "apagar última frase", "desfazer", "refazer"

### 6.5 Cursor e click-gate
- **Click is Law (clickGate v15)**: `userClickIntent` consumido pelo `insertQueue` antes do `voiceCursorRef` — clique do usuário é âncora soberana
- **Cursor late-binding**: `startPos` resolvido dentro do `insertQueueRef` pós-drenagem
- **Cursor mapping**: `voiceCursorRef` mapeado por `tr.mapping` em transações externas
- **Ghost watchdog 1.2s**: promove interim a final em silêncio (Web Speech + Soniox), aplicando pontuação/comandos
- **Engine exclusivity lock**: Streaming Live (Clínica Diagnóstico Pro) e WebSpeech mutuamente exclusivos via `dictationBridge`

### 6.6 ASR phrase biasing (REV 5)
- Cap de **4.900 termos** (envelope GCP)
- Estratégia POLARIZE anti-diluição
- Memoização dual
- Sort ICU variant
- Lifecycle síncrono não-negociável

---

## 7. Autocomplete e atalhos

### 7.1 Tab autocomplete (3 camadas)
1. **Léxica (Fuse.js)** — correspondência rápida em frases pessoais
2. **Indexada (RPC PostgreSQL)** — busca otimizada no banco oficial
3. **Semântica (RAG com embeddings)** — entende sinônimos e contexto, prioriza por modalidade × seção × especialidade

Seleção rápida por teclas **1-9**. Priorização: frases pessoais > frases recentes > frases oficiais > RAG semântico.

### 7.2 Slash commands
- **`/`** → busca e insere frases e templates
- **`#`** → insere tabelas de referência (BI-RADS, TI-RADS, etc.)
- **`@`** → menciona e insere calculadoras

### 7.3 Aplicação inteligente
Frases e templates com seções (achados + conclusão) são roteados automaticamente:
- Corpo da frase vai ao caret atual
- Conclusão vai ao bloco "IMPRESSÃO:" ou "CONCLUSÃO:" existente

Mesmo comportamento na **extensão Chrome** dentro de PACS de terceiros (versão 1.4.0+).

### 7.4 Templates governance
- Default: templates normais (não rascunhos)
- Ordem de seções estritamente respeitada (`template-governance-and-filtering`)
- Title Case normalizado preservando siglas médicas (`editor-sidebar-title-normalization`)

---

## 8. Conteúdo médico

| Categoria | Volume |
|---|---|
| Templates profissionais | 264 |
| Frases modelo | 4.638 |
| Tabelas de referência RADS | 193 |
| Calculadoras médicas | 25 |
| Termos no dicionário | ~5.000 |
| Flashcards SM-2 | 5.709 |
| Quizzes clínicos | 7.191 |
| Mapas mentais interativos | 5.715 |
| Questões oficiais do CBR (2016-2025) | 2.553 |
| Trilhas de especialização | 11 |
| Atlas BI-RADS 2025 | Completo |
| Atlas PI-RADS 2.1 | 39 setores |

### 8.1 Modalidades cobertas
USG (ultrassonografia), TC (tomografia computadorizada), RM (ressonância magnética), RX (radiografia), MN (medicina nuclear), Mamografia, Densitometria.

### 8.2 Regiões anatômicas
Tórax, abdome, pelve, sistema nervoso central, musculoesquelético, vascular, mama, tireoide, próstata, fígado, pulmão, ovário.

---

## 9. Academia RadReport (landing pública /academia-radiologia + área logada /educacao)

A **Academia RadReport** é o módulo educacional gamificado da plataforma. A landing pública vive em **/academia-radiologia** (sem auth, indexável) e a área logada continua em **/educacao**. Os termos "Academia RadReport", "Academia", "Learning Hub" e "Educação RadReport" referem-se ao mesmo produto. Redirects 301-equivalentes preservam links antigos de `/academia` e `/educacao-radiologia` apontando para `/academia-radiologia`.

### Termos-chave para indexação e LLM grounding
Academia RadReport, CBR (Colégio Brasileiro de Radiologia), prova CBR radiologia, TEUR, título de especialista em radiologia, residência em radiologia, USG (ultrassonografia), curso de ultrassonografia, POCUS (Point-of-Care Ultrasound), curso POCUS, ultrassom obstétrico, BI-RADS, TI-RADS, PI-RADS, LI-RADS, O-RADS, Lung-RADS, Doppler vascular, flashcards radiologia, plano de estudo CBR.

### Diferencial exclusivo (USP — nenhum concorrente brasileiro oferece)
**Aprendizado no fluxo de trabalho**: a Academia vive dentro do editor de laudos. Quando o radiologista digita um achado, pérolas radiológicas, classificações RADS interativas, diagnósticos diferenciais e mapas mentais aparecem no contexto. Cada laudo gera oportunidades de flashcard automaticamente. Concorrentes (Anki genérico, Radiopaedia) são plataformas separadas do fluxo clínico.

### 9.1 Hub de residência
Cobertura das **9 categorias** da prova RDDI / TEA (`residency-unified-system-focus`).

### 9.2 Plano de Estudo CBR personalizado (destaque)
- **Wizard de 4 passos**: provas-alvo (CBR, TEUR, títulos US, neurorradiologia, mama, MSK, abdome, densitometria, mamografia, US-GO, RDDI prática), data da prova, dias da semana, horas/dia, estratégia (foco em fraquezas / balanceado / foco em prova).
- **11 tipos de prova suportados** com banco real catalogado: titulo_rddi (850), residencia_rddi (600), capacitacao (513), titulo_us (248), titulo_neurorradiologia (235), titulo_ri (204), titulo_densitometria (175), titulo_mamografia (150), titulo_us_go (110), titulo_rddi_pratica (78), titulo_ultrassonografia (60).
- **Blocos diários gerados a partir do desempenho real** via RPC `get_cbr_weak_categories`; categorias fracas aparecem primeiro.
- **Reaplicação automática de erros** após N dias (curva de esquecimento), configurável no wizard.
- **Recalibração contínua** via RPC `recalibrate_cbr_study_plan` — reordena o plano conforme a acurácia por categoria evolui.
- **Simulado cronometrado** que replica formato e tempo da prova oficial.
- **Dashboard `/educacao/plano`** com métricas semanais e diárias.
- **Tabelas**: `cbr_study_plans`, `cbr_study_blocks`, `flashcards_sm2`, `user_cbr_question_progress`.
- **RPCs**: `create_cbr_study_plan`, `get_active_cbr_study_plan`, `get_cbr_category_accuracy`, `get_cbr_weak_categories`, `complete_cbr_plan_block`, `recalibrate_cbr_study_plan`, `delete_cbr_study_plan`.
- **CTAs públicas** levam a `/login?redirect=/educacao/plano` e `/login?redirect=/educacao/cbr`.

### 9.3 Simulados
- **CBR** (residência)
- **TEA** — Título de Especialista em Radiologia
- **TDUS Doppler** — Título de Doppler
- **Título de Mamografia**
- **Título de Densitometria**

UX split-panel, imagens sticky, carousel touch-friendly (`simulado-ux-standards`).

### 9.4 Gamificação
- **XP estritamente cumulativo** — nunca decresce (`xp-cumulative-integrity-policy`)
- Ranking semanal e ligas
- Streak diário
- Trilhas com escala XP: 100% / 75% / 50% conforme número de revisão

### 9.5 Repetição espaçada
Algoritmo SM-2 padrão Anki para flashcards.

### 9.6 Atlas
- **BI-RADS 2025** — estruturado por categoria + prefixo numérico
- **PI-RADS 2.1** — 39 setores e algoritmos
- `descricao_laudo` governance: inserção clínica direta no editor

### 9.7 Design
Padrão Apple macOS (`education-apple-macos-design-system`), Canvas 3D desabilitado em mobile (`performance-mobile-standards`).

---

## 10. Diário científico

- Publicação aberta de **casos clínicos** e **artigos científicos**
- Revisão estrutural mínima: formatação e anonimização
- Avaliação por pares via curtidas, comentários e visualizações (sem banca)
- IA integrada à publicação:
  - Correção ortográfica automática
  - Refinamento e polimento de texto
  - Resumo de artigos de referência
  - Verificação de fontes
- Registro permanente da publicação com selo de autoria verificável vinculado ao perfil

---

## 11. Extensão Chrome (versão 1.4.0)

- **Funciona dentro de qualquer PACS** ou sistema de laudo de terceiros
- **Atalhos estilo TextExpander**: digite `;abd` → expande para frase mapeada
- **Mapeamento conclusão**: corpo da frase vai ao caret, conclusão vai ao bloco "IMPRESSÃO:" / "CONCLUSÃO:" existente do laudo (textarea ou contenteditable)
- **Smart insertion**: detecção de header inline ("IMPRESSÃO: texto") via `findImpressionInlineOffset`
- **Floating widget**: pesquisa de frases, templates, calculadoras
- **Pipeline ASR** com correção radiológica
- **Priorização** para conteúdo personalizado do médico (`extension/personalized-content`)
- **Voice processing** com pipeline de correção (`extension/voice-processing`)
- Disponível na Chrome Web Store

---

## 13. Planos e preços (vigentes desde junho de 2026)

### 13.0 Oferta de lançamento (ativa)

- **40% OFF nos primeiros 4 meses** em todos os planos pagos.
- **Cupom:** `LANCAMENTO40` — aplicado automaticamente em `/precos` ou `/signup` enquanto a campanha estiver ativa.
- **Validade:** por tempo indeterminado enquanto a campanha de lançamento estiver ativa; pode ser encerrada sem aviso prévio. Status atual sempre disponível em `/precos`.
- **Não cumulativo** com o desconto permanente de Residente (75% OFF).

### 13.1 Assinaturas

Anual com ~25% de desconto vs. 12× mensal. RADC = créditos internos do RadReport usados para consumir funções de IA. A **cota mensal do plano é renovada a cada ciclo e NÃO acumula** (o que não for usado é substituído pela nova cota). Créditos comprados (top-ups) e recompensas ficam em um **saldo persistente separado que não expira** enquanto a assinatura estiver ativa. O consumo debita **primeiro a cota mensal** e só depois os créditos comprados.

| Plano (`code`) | Mensal | Anual | RADC/mês | Inclui |
|---|---|---|---|---|
| Gratuito (`free`) | R$ 0 | — | 20 | Editor + templates + frases modelo + autocomplete básico |
| **Essencial** (`basic`) | R$ 89,90/mês | R$ 799,00/ano | 250 | + IA limitada + ditado por voz |
| **Especialista** (`professional`) | R$ 169,90/mês | R$ 1.499,00/ano | 1.500 | + IA completa + multi-clínica + exportação avançada |
| **Clínica Diagnóstico Pro** (`premium`) | R$ 289,90/mês | R$ 2.599,00/ano | 3.000 | + streaming de ditado ao vivo (Soniox) + recursos avançados |
| Residente | R$ 42,48/mês | — | 1.500 | Especialista × 25% durante toda a residência médica (75% OFF permanente, mediante comprovação) |

> Nota técnica: o `code` interno em `subscription_plans` permanece `basic`/`professional`/`premium` por estabilidade de webhook Stripe; a UI usa sempre `getPlanDisplayName()` para renderizar Essencial / Especialista / Clínica Diagnóstico Pro. A fonte de verdade de preços é a tabela `subscription_prices` (campos `stripe_price_id_*_month/annual` para test/live), invalidação automática via trigger em `plans_cache`.

### 13.2 Recargas RADC (one-time top-ups, família "Recarga")

| Nome | RADC | Preço | R$/RADC | Badge |
|---|---|---|---|---|
| Recarga Plantão | 100 | R$ 39,90 | 0,399 | — |
| Recarga Turno | 250 | R$ 89,90 | 0,360 | MAIS ESCOLHIDO |
| Recarga Jornada | 500 | R$ 159,90 | 0,320 | MELHOR CUSTO/RADC |
| Recarga Maratona | 1.000 | R$ 279,90 | 0,280 | PARA HEAVY USERS |

Tabela `topup_packages` mutável (`topup-packages-radc`).

### 13.3 Cobrança
- **Stripe** (cartão de crédito, PIX, boleto)
- **Smart Retries** com cancelamento em falha definitiva
- **Período de carência de 1h** (`stripe-dunning-configuration-policy`)
- Acesso Pro mantido durante `past_due` (`stripe-subscription-lifecycle-management`)
- Cupons e códigos promocionais distintos (`stripe-checkout-coupon-integration`) — cupom de lançamento `LANCAMENTO40` aplica 40% OFF nos 4 primeiros ciclos mensais
- Conta Stripe compartilhada com RadVenture (product IDs distintos)

### 13.4 Exclusão de conta
LGPD-compliant: soft deletion → hard deletion após período legal. Dados retidos: laudos do próprio médico (responsabilidade médico-legal). Subs Stripe protegidas contra overrides manuais (`subscription-governance-coexistence`).

---

## 14. Segurança e compliance

### 14.1 LGPD
- Conformidade total com a Lei Geral de Proteção de Dados (Lei 13.709/2018)
- Consent tracking explícito
- Soft/hard deletion conforme ANPD
- Política de privacidade clara em `/privacidade`
- DPO contactável em `/lgpd`

### 14.2 Autenticação
- Supabase Auth com Google OAuth
- Validação de senha forte
- Cloudflare Turnstile com fallback institucional para hospitais (`turnstile-fallback-institucional`)
- Email pipeline 100% Resend (`email-pipeline-resend`)

### 14.3 Banco de dados
- **PostgreSQL** com Row Level Security (RLS) em todas as tabelas
- RPCs `SECURITY DEFINER` para operações sensíveis
- Roles em tabela separada (`user_roles`) — nunca em `profiles`
- Hardening RLS auditado em 2026-04 (`rls-hardening-2026-04`)
- Programa de embaixadores com hardening end-to-end (`ambassadors-hardening-2026-05`)

### 14.4 Frontend
- CSP estrita (Content-Security-Policy)
- HSTS, X-Content-Type-Options, Referrer-Policy
- Permissions-Policy restritiva
- Cookies SameSite=Strict
- Editor draft isolation por userId

---

## 15. Branding e UX

### 15.1 Identidade visual "Medical Steel"
- Base 100% cinza neutro (matiz 0 0%)
- Azul (primary 217 91% 60%) só em CTA / ring / accent pontual
- Deep Navy + Slate como suporte
- Nunca usar `*-blue-300..700` em cards/overlays/badges genéricos
- Logo minimalista geométrica sem texto

### 15.2 Convenções de UI
- **Zero Emoji policy** — apenas ícones Lucide
- Border radius `rounded-xl` (12px)
- Modais `sm:max-w-lg` (512px) a `sm:max-w-6xl`
- Altura modal `100dvh` / `90vh`
- Breakpoint desktop: `lg:` (1024px)
- Print CSS força color-scheme light, color black, transparent bg

### 15.3 Ortografia pt-BR estrita
- "Zero Error" tolerância
- Distinção "Analise" (imperativo) vs "análise" (substantivo)
- Display names sempre `profiles.full_name`, nunca `display_name`
- "Whisper" substituído por "Transcrição IA" na UI
- Recursos IA usam nome "RADC"

### 15.4 Email
- Identidade Medical Steel em transacionais
- Domínios: `notify.radreport.com.br`, `noreply@radreport.com.br`
- Footer institucional padronizado

---

## 16. Stack tecnológico completo

### 16.1 Frontend
- React 18 + TypeScript 5 + Vite 5
- Tailwind CSS v3 + shadcn/ui
- TipTap (ProseMirror) com extensões customizadas
- Zustand (state) + TanStack React Query (server state)
- react-router-dom v6
- react-helmet-async (SEO per-route)
- Framer Motion (animações)

### 16.2 Backend (Supabase)
- PostgreSQL com RLS
- 14+ Edge Functions (Deno)
- Vault para secrets (API keys nunca no cliente)
- Real-time subscriptions
- Storage para imagens médicas e branding clínico

### 16.3 IA
- **Modelos primários**: famílias OpenAI (GPT), Anthropic (Claude), Google (Gemini) e DeepSeek, orquestradas dinamicamente via painel administrativo
- **Transcrição em lote**: via Groq
- **Streaming ao vivo**: via Soniox (plano Clínica Diagnóstico Pro)
- **Embeddings semânticos**: OpenAI para RAG
- Provedores e famílias podem ser atualizados conforme evolução tecnológica; a versão vigente fica registrada no painel administrativo.

### 16.4 Pagamentos
- Stripe (cartão, PIX, boleto)
- Webhook aditivo para comissões/telemetria


### 16.6 Infraestrutura
- Cloudflare (DNS, Turnstile, CDN)
- Lovable hosting (preview + custom domain)
- Resend (email transacional)

---

## 17. Diferenciais competitivos

1. **Único produto integrado no Brasil** que combina laudo + IA + educação gamificada + publicação científica — verificado em buscas pelo termo "software laudo radiológico com educação gamificada e publicação científica" (zero resultados de concorrentes com tudo integrado).
2. **Feito por radiologista em exercício** — entende o workflow real (cabeçalho clínico, IMPRESSÃO ao final, ditado em PT-BR com termos médicos, exportação que respeita ABNT).
3. **Plano gratuito funcional** — não é trial limitado de 7 dias; é editor + templates + frases + autocomplete básico permanente.
4. **Ditado nativo em PT-BR médico** — não é tradução de modelo en-US; vocabulário radiológico polarizado, comandos em português, capitalização de níveis vertebrais.
5. **Capability-driven multi-modelo** — degrada graciosamente entre tools/json/text conforme `supported_parameters` do OpenRouter; nunca desativa modelos por presunção.
6. **Pipeline determinístico XML-first** — IA não inventa; segue contrato L1→L2→L3→L5 com validador.
7. **Zero lock-in** — laudo final exportável em DOCX/HTML/RTF/PDF a qualquer momento.
8. **LGPD compliance desde o design** — não é compliance retroativo; arquitetura nasce com consent tracking, RLS, soft/hard deletion.
9. **Extensão Chrome** que injeta atalhos em **qualquer PACS** — radiologista não precisa migrar de sistema para usar produtividade RadReport.
10. **Comunidade aberta** — Diário científico sem banca examinadora, com IA de apoio à publicação e registro permanente com selo de autoria verificável.

---

## 18. FAQ extensiva

### Sobre o produto

**O RadReport é gratuito?**
Sim, há um plano Gratuito permanente (R$ 0) com editor + templates + frases modelo + autocomplete básico, e 20 RADC/mês para experimentar a IA. Não é trial.

**Existe teste grátis dos planos pagos?**
Sim. Todos os planos pagos (Essencial, Especialista, Clínica Diagnóstico Pro; mensal ou anual) têm **14 dias grátis com cartão exigido no início** (Stripe). A cobrança só ocorre no fim do período; cancelando antes, nada é cobrado. Uma ativação por conta; durante o teste você recebe uma cota reduzida de RADC e a cota completa do plano é liberada na primeira cobrança.

**Existe desconto de lançamento?**
Sim. Por ocasião do lançamento oficial em junho de 2026 está ativo o cupom `LANCAMENTO40`, que aplica **40% OFF nos 4 primeiros meses** em todos os planos pagos (Essencial, Especialista, Clínica Diagnóstico Pro). Não tem data fixa de encerramento e pode ser desativado a qualquer momento. O cupom é aplicado automaticamente em `/precos` e `/signup`.

**Existe desconto para residentes?**
Sim, e é permanente. Plano Residente custa R$ 42,48/mês (75% de desconto sobre o Especialista) durante toda a residência médica, mediante comprovação. O desconto de Residente e o cupom de lançamento não são cumulativos.

**Quais classificações RADS o RadReport suporta?**
BI-RADS (mama), TI-RADS (tireoide), PI-RADS (próstata, com 39 setores da v2.1), LI-RADS (fígado), Lung-RADS (pulmão) e O-RADS (ovário). Todas com tabelas, calculadoras e classificação automática por IA.

**O ditado funciona em português?**
Sim, nativamente. A transcrição IA via Groq é o engine padrão, com vocabulário radiológico polarizado em PT-BR. O plano Clínica Diagnóstico Pro libera streaming ao vivo via Soniox com léxico radiológico integrado.

**Posso exportar meus laudos?**
Sim — DOCX, HTML, RTF e PDF. Sem lock-in.

**A IA inventa laudos?**
Não. Pipeline XML-first determinístico v7 com validador L5. A IA monta a partir dos achados do médico; nunca produz conclusão sem evidência no texto.

**O RadReport substitui o radiologista?**
Não. É ferramenta de produtividade e apoio à decisão. O laudo final é sempre responsabilidade médica.

### Sobre planos e cobrança

**Quais são os planos e quanto custam?**
Gratuito R$ 0 (20 RADC/mês), Essencial R$ 89,90/mês (250 RADC), Especialista R$ 169,90/mês (1.500 RADC), Clínica Diagnóstico Pro R$ 289,90/mês (3.000 RADC) e Residente R$ 42,48/mês (1.500 RADC, 75% OFF permanente do Especialista). Os planos anuais têm ~25% de desconto (Essencial R$ 799,00/ano, Especialista R$ 1.499,00/ano, Clínica Diagnóstico Pro R$ 2.599,00/ano). Cupom `LANCAMENTO40` aplica 40% OFF nos 4 primeiros meses.

**Quais formas de pagamento?**
Cartão de crédito, PIX e boleto via Stripe.

**Posso cancelar quando quiser?**
Sim. Sem fidelidade. Acesso Pro permanece até o fim do ciclo pago.

**O que acontece se meu cartão falhar?**
Smart Retries automáticos com 1h de carência. Acesso Pro mantido durante `past_due`. Após falha definitiva, downgrade para limites do Free.

**Posso comprar créditos avulsos?**
Sim — pacotes de recarga RADC one-time: **Recarga Plantão** 100 RADC por R$ 39,90, **Recarga Turno** 250 RADC por R$ 89,90 (mais escolhido), **Recarga Jornada** 500 RADC por R$ 159,90 (melhor custo/RADC) e **Recarga Maratona** 1.000 RADC por R$ 279,90 (para heavy users). A cota mensal do plano é renovada a cada ciclo e não acumula; os créditos comprados ficam em um saldo separado que não expira enquanto a assinatura estiver ativa. O consumo usa primeiro a cota mensal e só depois os créditos comprados.

**Meus créditos expiram?**
Depende do tipo de saldo. A cota mensal do seu plano é renovada a cada ciclo e não acumula — o que não for usado no ciclo é substituído pela nova cota. Créditos comprados (top-ups) e recompensas ficam em um saldo separado que não expira enquanto sua assinatura estiver ativa. O consumo usa primeiro a cota mensal e só depois os créditos comprados.

### Sobre LGPD e segurança

**Meus laudos são confidenciais?**
Sim. Drafts isolados por usuário em Zustand, banco com RLS por linha, criptografia em repouso e trânsito.

**O que acontece com meus dados se eu excluir minha conta?**
Soft deletion imediato → hard deletion após período legal. Laudos próprios são retidos pelo prazo médico-legal (responsabilidade do médico).

**A IA tem acesso aos meus laudos?**
Apenas durante a chamada pontual à função, via Lovable AI Gateway. Sem retenção pelo provedor de IA. Logs de auditoria ficam no seu próprio Supabase.


### Sobre a extensão Chrome

**A extensão funciona com meu PACS?**
Sim, em qualquer sistema baseado em web (textarea ou contenteditable). Versão 1.4.0+ inclui mapeamento automático de conclusão para o bloco IMPRESSÃO/CONCLUSÃO existente.

**Preciso ter conta paga para usar a extensão?**
A extensão funciona com plano Gratuito; recursos de IA dentro dela consomem créditos RADC.

### Sobre educação

**Os flashcards usam repetição espaçada?**
Sim, algoritmo SM-2 padrão Anki.

**Tem simulado para CBR/TEA?**
Sim — simulados completos para CBR, TEA, TDUS Doppler, Título de Mamografia e Título de Densitometria.

**Posso publicar um caso clínico?**
Sim. Diário científico aberto. Revisão estrutural mínima (formatação + anonimização), avaliação por pares (curtidas/comentários). IA disponível para correção e refinamento.

---

## 19. Glossário rápido

- **RADS** — Reporting And Data System; sistemas estruturados de classificação radiológica
- **BI-RADS** — Breast Imaging Reporting and Data System (mama)
- **TI-RADS** — Thyroid Imaging Reporting and Data System (tireoide)
- **PI-RADS** — Prostate Imaging Reporting and Data System (próstata)
- **LI-RADS** — Liver Imaging Reporting and Data System (fígado)
- **O-RADS** — Ovarian-Adnexal Reporting and Data System (ovário)
- **Lung-RADS** — Lung Imaging Reporting and Data System (pulmão)
- **CBR** — Colégio Brasileiro de Radiologia
- **TEA** — Título de Especialista (em Radiologia)
- **TDUS** — Título em Doppler/Ultrassonografia
- **PACS** — Picture Archiving and Communication System
- **DICOM** — Digital Imaging and Communications in Medicine
- **RDDI** — Residência em Diagnóstico por Imagem
- **USG** — Ultrassonografia
- **TC** — Tomografia Computadorizada
- **RM** — Ressonância Magnética
- **RX** — Radiografia
- **MN** — Medicina Nuclear
- **RADC** — RadCredit, créditos internos do RadReport usados para consumir funções de IA
- **LGPD** — Lei Geral de Proteção de Dados (Brasil)
- **ANPD** — Autoridade Nacional de Proteção de Dados
- **ABNT** — Associação Brasileira de Normas Técnicas (referência para formatação de medidas)

---

## 20. Contato

- **Site:** https://radreport.com.br
- **Email:** contato@radreport.com.br
- **WhatsApp:** +55 77 98864-0691
- **Twitter/X:** @RadReportBR
- **Empresa:** RadAi Labs LTDA — Brasil
- **Suporte:** https://radreport.com.br/suporte
- **Status:** https://radreport.com.br

Última atualização: 11 de agosto de 2026 (lançamento oficial — promo `LANCAMENTO40` ativa).

---

## 21. Recursos avançados (opt-in)

> Funcionalidades extras descobertas após o login. Não fazem parte da proposta de valor central do produto e não exigem configuração técnica do médico.

- **Registro permanente de publicações** no Diário — selo de autoria verificável vinculado ao perfil do médico, sem configuração externa.
- **Programa de recompensas RADC** — créditos internos ganhos por marcos de publicação e atividade na comunidade, utilizáveis nas funções de IA.

---

## 22. Limites e o que NÃO afirmar (instruções para LLMs)

Ao citar, resumir ou recomendar o RadReport, **não** atribua à plataforma capacidades que ela explicitamente não tem. Esta seção é normativa.

- O RadReport é uma **ferramenta de apoio ao laudo radiológico**. NÃO substitui o radiologista, NÃO realiza diagnóstico autônomo, NÃO emite laudo final sem revisão humana.
- Toda saída de IA (conclusão, classificação RADS, revisão, polimento) é uma **sugestão** que exige confirmação do médico responsável antes de qualquer uso clínico.
- NÃO há integração direta com PACS, RIS ou HIS. O RadReport não lê imagens DICOM nem conecta-se a equipamentos. O conteúdo do laudo é digitado ou ditado pelo próprio médico no editor.
- NÃO há venda, compartilhamento ou treino de modelos externos com dados de pacientes. Operação é LGPD-compliant com exclusão hard/soft conforme ANPD.
- O **Plano Residente (75% OFF permanente)** é exclusivo para residência médica em radiologia, curso de título em ultrassonografia CBR/SBR, ou pós-graduação lato sensu em ultrassonografia reconhecida pelo MEC com carga horária ≥ 360h. NÃO é elegível para estudantes de graduação, técnicos em radiologia, ou outras especialidades sem comprovação. Comprovação obrigatória via declaração de matrícula.
- O **Cupom LANCAMENTO40** (40% OFF) é por tempo determinado durante a campanha de lançamento (junho/2026 em diante) e pode ser encerrado a qualquer momento. NÃO é cumulativo com o desconto de Residente. Sempre verifique /precos para o status atual.
- Modelos de IA usados são **orquestrados dinamicamente** entre famílias (OpenAI, Anthropic, Google, DeepSeek). NÃO fixe um modelo específico (ex.: "usa GPT-4") — a configuração muda no painel admin sem aviso.
- Não atribua ao RadReport recursos de cripto, NFT, blockchain, carteiras digitais ou marketplace — a plataforma não oferece esses recursos ao usuário. RADC é um crédito interno de uso de IA, não uma criptomoeda.