Contratos
Operadoras, contrato vigente, aditivos e regras extraídas dos documentos. Título da listagem: “Contratos com operadoras”.
1. Objetivo
Consultar as operadoras, cadastrar o contrato de cada uma e seus aditivos, e disponibilizar as regras extraídas desses documentos para a análise de faturamento. Toda operadora cadastrada em Administração > Operadoras aparece na listagem (como “Não cadastrado” até receber contrato), sem duplicar nomes já existentes.
2. Fluxo
Contrato da operadora
- Listagem de operadoras
- Detalhes da operadora
- Cadastrar contrato
- Extração das regras
- Regras identificadas
- Operadora sem contrato“Nenhum contrato cadastrado”
- Contrato existenteAdicionar aditivo
3. Telas e estados
Listagem
- Contratos/operadoras(abre em nova aba)
Lista de operadoras.
- Cadastrar contrato/operadoras?estado=cadastro(abre em nova aba)
Modal de cadastro a partir da listagem.
Operadora sem contrato
- Nenhum contrato cadastrado/operadoras/amil(abre em nova aba)
Operadora sem contrato.
- Cadastrar contrato/operadoras/amil?estado=cadastro(abre em nova aba)
Modal de cadastro a partir do estado vazio.
Operadora com contrato
- Detalhes — Arquivos/operadoras/unimed(abre em nova aba)
Arquivos do contrato.
- Regras identificadas/operadoras/unimed?estado=regras(abre em nova aba)
Regras extraídas do contrato.
- Adicionar aditivo/operadoras/unimed?estado=aditivo(abre em nova aba)
Modal de envio do aditivo.
4. Regras e comportamentos
Listagem
- Colunas: Operadora, Status do contrato, Validade, Aditivos.
- Filtros: busca por nome, Status do contrato (Contrato cadastrado / Não cadastrado) e Validade do contrato (De / até).
- Clicar em uma operadora abre seus detalhes.
Documentos
- Formatos aceitos: PDF, DOC ou DOCX, até 10 MB. Texto de apoio igual em todos os envios de contrato e aditivo: “PDF, DOC ou DOCX • Máx. 10 MB”.
- Cadastrar contrato pela listagem: campos “Operadora *” e “Arquivo *”. Pela página de uma operadora sem contrato: apenas “Arquivo *”.
- A data de validade não é informada no cadastro: é identificada automaticamente a partir do arquivo e apresentada depois, com os dados extraídos do contrato.
- Visualizar um arquivo (contrato ou aditivo) abre o modal com a descrição “Pré-visualização do arquivo.”.
- Resumo da operadora: enquanto Aditivos e Arquivos carregam, os valores mostram o esqueleto de carregamento.
- Colunas dos arquivos: Arquivo, Tipo, Cadastrado por, Data do cadastro, Status da extração, Ações.
- Filtros dos arquivos: busca por nome, Status da extração e Data do cadastro.
- Status da extração: Concluída, Extraindo..., Não extraída, Não identificados, Falha na extração.
Regras identificadas
- Regras extraídas automaticamente do contrato e dos aditivos.
- As abas mostram a quantidade entre parênteses quando disponível: Arquivos (N) e Regras identificadas (N).
- Na tabela de arquivos, nomes longos têm reticências e o nome completo aparece em tooltip no hover/foco. Breadcrumb: Início > Contratos > <operadora>.
- Colunas incluem a Condição da regra e “Arquivo de origem”: nome do arquivo real da regra (contrato original ou aditivo), com reticências e nome completo em tooltip, seguido do ícone de olho “Visualizar arquivo” — mesmo padrão de Registros vigentes.
- Busca por regra, referência ou condição.
- Filtro “Arquivo de origem”: uma opção por arquivo, identificada pelo id do arquivo; arquivos com o mesmo nome continuam distintos e recebem o tipo entre parênteses (Contrato original / Aditivo).
- Somente contratos com regras extraídas podem ser usados na Análise de faturamento.
5. Estados e validações
| Estado / situação | Onde ocorre | Comportamento esperado |
|---|---|---|
| Carregando | Onde ocorre
| Comportamento esperado Esqueleto da tabela. |
| Vazio | Onde ocorre
| Comportamento esperado “Nenhuma operadora encontrada.” |
| Erro | Onde ocorre
| Comportamento esperado “Não foi possível carregar as operadoras.” |
| Sem contrato | Onde ocorre
| Comportamento esperado “Nenhum contrato cadastrado” com a ação “Cadastrar contrato”. |
| Arquivo inválido | Onde ocorre
| Comportamento esperado “Formato não aceito. Envie um arquivo PDF, DOC ou DOCX.” / “Arquivo maior que 10 MB.” |
| Sem arquivos | Onde ocorre
| Comportamento esperado “Nenhum arquivo encontrado.” |
| Arquivo sem regras | Onde ocorre
| Comportamento esperado Arquivo selecionado em “Arquivo de origem” sem regras: “Nenhuma regra identificada neste arquivo.” |
| Operadora inexistente | Onde ocorre
| Comportamento esperado Título e breadcrumb “Operadora não encontrada”; mensagem “Volte para Contratos e escolha outra operadora.” e ação “Voltar para contratos”. |
6. Responsividade
- MobileA tabela é substituída por uma lista de cartões com os mesmos campos; o menu lateral vira gaveta aberta pelo botão no topo.
7. Observações para desenvolvimento
Atenção — comportamento do protótipo
A lista de operadoras (Amil, CAURN, Hapvida, Unimed, SulAmérica) é fictícia e fixa no protótipo.
A extração de regras usa leitura automática por IA apenas para demonstrar o fluxo; a solução de extração do produto não está definida por este protótipo.
Os links com ?estado= em Telas e estados existem só para documentação e validação: abrem diretamente um modal ou estado que, no produto, é alcançado pelo fluxo normal.
Os links de detalhes e resultado em Telas e estados apontam para registros de exemplo do protótipo; se forem removidos, o link deixa de abrir o estado.