Correção ortográfica — Check Spelling
A correção ortográfica utiliza um provider de IA para revisar o conteúdo do laudo, corrigindo ortografia, gramática e terminologia sem alterar o sentido clínico. Diferente da RevisIA, esta funcionalidade não aponta inconsistências médicas — apenas a correção ortográfica e anotações sobre as alterações realizadas.
A funcionalidade está disponível na tela de laudário do portal legado, acionada por um botão dedicado.
Para quem é
| Persona | Quem é | O que faz aqui |
|---|---|---|
| Gestor | perfil administrativo da unidade | pode utilizar a correção ortográfica no laudário, conforme permissões |
| Proprietário | perfil com acesso ampliado | pode utilizar a correção ortográfica no laudário |
| Médico | radiologista / laudador | corrige ortografia do laudo em edição antes de assinar |
| Residente | médico em formação | corrige ortografia do laudo em edição, conforme permissões |
Pré-requisitos
- Portal legado com laudário aberto para um exame.
- Termo de uso de IA aceito (unidade e/ou usuário, conforme escopo da configuração).
- Funcionalidade Check Spelling ativa e configurada:
- na unidade — ver Configuração por empresa;
- no usuário — ver Configuração por usuário.
- Provider, modelo e token válidos para a funcionalidade.
- Laudo com conteúdo preenchido (corpo do documento não pode estar vazio).
Diagrama de sequência
Fluxo principal ao clicar em Correção ortográfica:
Etapas
1. Abrir o laudário
Na lista de exames do portal legado, localize o exame e clique em Abrir Laudário.
2. Acionar a correção ortográfica
Com o laudário aberto e o laudo preenchido, clique no botão Correção ortográfica. A interface envia o conteúdo do documento para a AI-API.
Dados enviados (exemplo):
| Grupo | Campos |
|---|---|
| Unidade | companyId |
| Laudo | reports[].reportId, body, date |
| Exame | modalidade, descrição do estudo, preparação (marcações) |
| Paciente | sexo, idade |
| Idioma | language (pt-BR, es-ES, en-US) |
3. Visualizar resultado no modal
Após resposta bem-sucedida da API, um modal exibe:
- Laudo corrigido — texto com ortografia, gramática e terminologia revisadas;
- Observações — anotações sobre as correções ortográficas realizadas (sem análise de inconsistências médicas).
4. Aplicar no documento (opcional)
O usuário pode aceitar o laudo corrigido para substituir ou incorporar o conteúdo no editor do laudário.
Campos / entradas
| Campo / origem | Descrição |
|---|---|
companyId | ID da unidade (empresa) |
reports[].reportId | ID do laudo |
reports[].body | Conteúdo do laudo em edição |
reports[].date | Data do laudo |
reports[].context.modality | Modalidade do exame |
reports[].context.studyDescription | Descrição do estudo |
reports[].context.studyPreparation | Preparação / marcações clínicas |
reports[].context.patient.sex | Sexo do paciente (M / F) |
reports[].context.patient.age | Idade do paciente |
language | Idioma da resposta (pt-BR, es-ES, en-US) |
Saída esperada
| Campo | Descrição |
|---|---|
check[].body | Laudo com ortografia corrigida |
check[].observations | Observações sobre correções ortográficas realizadas |
Endpoints utilizados
| Endpoint | Descrição |
|---|---|
AI_API POST /check/spelling | Envia o laudo; retorna texto corrigido e observações ortográficas. |
AI_API POST /reformulate/response | Reformula a verificação com um novo prompt informado pelo usuário no modal. |
→ Detalhe técnico: Check Spelling — OpenAPI
Regras de negócio
| ID | Regra | Comportamento esperado |
|---|---|---|
| RN-01 | Laudo vazio | A verificação não é enviada; exibe toast de atenção. |
| RN-02 | Configuração ausente | Toast indicando ausência de configuração (unidade, usuário ou genérica). |
| RN-03 | Sucesso parcial | Modal abre com erro em vermelho na área do laudo; botões de usar/reformular seguem regra de “houve correção”. |
| RN-04 | Reformular | Novo prompt não pode estar vazio. |
| RN-05 | Escopo clínico | A IA corrige ortografia/terminologia sem alterar o sentido clínico do laudo. |
| RN-06 | Escopo | Portal legado; laudário. |
Mapeamento de erros
| Situação | Resposta da API | Comportamento |
|---|---|---|
| Clicar em correção ortográfica com laudo vazio | Toast de atenção: o laudo não pode estar vazio. A verificação não é enviada. | |
| API de ortografia retorna resposta vazia / sem dados | AI_API POST /check/spelling | Toast de atenção dizendo que não foi possível verificar o laudo. O modal não abre. |
| API de ortografia falha (erro HTTP / integração) | AI_API POST /check/spelling | Toast de erro traduzido pelo resolvedor de erros da IA (ou mensagem padrão de falha na verificação). O modal não abre. |
| Configuração da funcionalidade não encontrada (unidade) | AI_API POST /check/spelling | Toast de atenção indicando ausência de configuração na unidade. |
| Configuração da funcionalidade não encontrada (usuário) | AI_API POST /check/spelling | Toast de atenção indicando ausência de configuração do usuário. |
| Configuração de IA não encontrada (genérico / companyId) | AI_API POST /check/spelling | Toast de atenção dizendo que a configuração não foi encontrada. |
| Provider/modelo inválido ou descontinuado | AI_API POST /check/spelling | Toast de erro específico de modelo inválido/descontinuado (pode citar o modelo). |
| Token / chave de API inválida ou rejeitada pelo provider | AI_API POST /check/spelling | Toast de erro da integração IA (título pode incluir o provider). |
| Erro genérico do provider / BadRequest | AI_API POST /check/spelling | Toast com a mensagem tratada pelo resolvedor (ou a mensagem bruta do provider, conforme o tipo). |
| Timeout / job da IA estoura (pooling) | AI_API POST /check/spelling | Toast de erro de operação / timeout do processamento. |
Ortografia “sucesso parcial”: item check[0] com success: false | AI_API POST /check/spelling | O modal abre, mas o conteúdo mostra o erro em vermelho dentro da área do laudo (prefixo de erro da IA). Botões de usar/reformular seguem a regra de “houve correção”. |
| Reformular verificação com prompt vazio | Toast de atenção: o novo prompt não pode estar vazio. Nada é enviado. | |
| Reformular verificação — API falha | AI_API POST /reformulate/response | Toast de erro (resolvedor da IA ou mensagem padrão de falha na verificação). O laudo do modal não muda. |
| Reformular verificação — resposta vazia | AI_API POST /reformulate/response | Toast de atenção dizendo que não foi possível verificar o laudo. O conteúdo do modal permanece o anterior. |
Relacionado
- 📄 RevisIA — Check My Reports (revisão com inconsistências médicas)
- ⚙️ Configurar funcionalidade de IA — Empresa
- ⚙️ Configurar funcionalidade de IA — Usuário
- 📄 API: Check Spelling