Console Health Audit — visão geral

Carimba um XML TISS com ans_glosas e booleanos explícitos de glosa aplicada/sugestão, cria idempotentemente uma trilha persistente de revisão (exception_only: só os achados que o motor marca como revisão manual ficam pendentes) e retorna run_id e poll_url.

Dispara o pipeline de auditoria (ingestão + regras + glosa) a partir do XML TISS.

Alias compatível para integrações antigas: aceita o request histórico, mas executa e retorna exatamente o contrato canônico de /stamp, incluindo ans_glosas, routing, statistics, run_id e poll_url.

Sugere contratos compatíveis para um XML TISS (score de roteamento).

Audita um XML TISS contra um contrato específico.

Lista execuções de auditoria (filtra por status de revisão e limite).

Detalhe de uma execução: itens, glosas, snapshot e trilha de revisão (inspeção read-only).

Submete decisões profissionais (disposição + justificativa) para uma execução.

Serve o XML TISS que a execução auditou, pelo run_id. Complementa as rotas escopadas por contrato: elas leem o store content-addressed, e execuções sem contrato resolvido (match="none") não são alcançáveis por lá — medido em produção, 32 de 112 XMLs. Aceita ?pretty=1.

Emite o demonstrativo TISS real de análise de conta do run, na mesma versão do lote de entrada, usando apenas glosas adjudicadas e aplicadas; com ?validate=1 valida contra o XSD oficial ANS da versão da guia antes de baixar.

Recarimba execuções armazenadas a partir do XML TISS arquivado — sem reenviar o XML. Seleção por run_ids OU filter (contract_id, run_type, status, created_after/before); contract_ref redireciona o contrato; dry_run calcula o delta antes/depois sem persistir; background move lotes grandes para um job com job_id. Requer ha:stamp:run ou ha:glosa:manage.

Progresso e resultados de um job de recarimbo em lote (background=true): processed/eligible e o delta por execução.

Exclui uma execução de auditoria (estado Redis, linha durável, projeção JSON e XML de entrada); a trilha de governança é preservada. Requer ha:glosa:manage.

Fila interna de revisão pendente.

Audita linhas faturadas contra o SIGTAP via reasoner de glosa (Crepe) do gateway.

Compila proposta de pacote de defesa de glosa para uma conta reconciliada.

Catálogo público de contratos vigentes (visível conforme tenant).

Busca rápida de contratos em memória (⌘K e página /contracts).

Detalhe do contrato: limites de preço, regras estruturadas e documentos. Aceita CNPJ, ANS, contract_id ou relationship_key.

Lista documentos-fonte (PDF/XLSX/DOCX) do contrato.

Lista as contribuições independentes de contrato e aditivos, com estado ativo e contagens derivadas.

Stream do binário do documento (PDF inline com Range; demais como download).

Renderiza uma página do PDF do contrato como PNG (pano de fundo dos overlays de preço).

Bounding boxes dos preços extraídos no documento-fonte (provenance visual).

PDF do contrato com os bounding boxes dos preços solicitados desenhados.

Log de eventos append-only do contrato (provenance git-like).

Estado de processamento/ingestão de um contrato.

XML TISS armazenado de uma auditoria do contrato (viewer de fonte).

XML TISS de auditoria sem escopo de contrato, por SHA-256.

Protocolos/lotes escopados a um relacionamento operadora↔prestador.

Ingere PDF de contrato (OCR + extração de regras; job assíncrono, 202).

Materializa limites de preço CBHPM e mescla no contrato existente.

Redefine a operadora de um contrato/relacionamento existente.

Ativa ou desativa uma fonte do contrato e recompõe os preços e regras derivados.

Informa a vigência (AAAA-MM-DD) de um documento do contrato quando nenhuma foi lida dele; sem vigência legível o contrato não é aplicado na auditoria.

Remove uma contribuição de fonte e recompõe o contrato sem excluir o relacionamento.

Lista interna dos contratos do tenant com identificação, operadora, vigência e número de limites de preço (plano de regras).

Mesmo detalhe de GET /contracts/{ref}, no plano interno, sob a permissão de leitura de regras.

Cria ou atualiza um contrato (upsert de regras e limites de preço).

Ingere um pacote (bundle) de documentos de contrato de uma vez.

Atualiza um contrato existente (identidade, label, disabled_rule_types e rule_overrides validados).

Configuração efetiva de regras do relacionamento (pack ← perfil de operadora ← rule_overrides) com proveniência de cada decisão.

Remove um contrato.

Remove o sidecar de status de um contrato.

Limites de preço globais (aplicáveis a todos os contratos).

Atualiza os limites de preço globais.

Remove um limite de preço global por código.

Sincroniza contratos para o grafo TTL.

Registry canônico de regras (KB e glosa) com origem, família, escopo e modo.

Detalhe de uma regra do registry.

Inventário canônico de seleção, observação e aplicação de regras.

Lista overrides aplicados sobre regras do registry.

Cria um override de regra.

Remove um override de regra.

Simula o efeito de regras contra um conjunto de itens (dry-run, sem persistir).

Regras de referência do appliance em Turtle (TTL), por plano de conhecimento (kb, glosa ou all).

Salva regras de referência do appliance (compartilhadas por design).

Cria uma regra governada — sempre persiste como status=draft (proposta).

Ingere feedback operacional (arquivo) como observações imutáveis — nunca ativa nem altera regras.

Lista regras governadas.

Versões de uma regra governada.

Edita uma regra draft (regra active é imutável — use supersede).

Único caminho para status=active — revalida os shapes SHACL.

Substitui uma regra ativa por uma nova (a antiga é aposentada).

Soft-delete: status=retired — nunca é apagada, preservando referências de auditoria.

Ordem determinística de precedência entre as regras ativas.

Substitui atômica e integralmente a precedência de regras em rascunho; regras ativas permanecem imutáveis como evidência. Requer JWT autenticado com ha:rules:manage.

Regras ativas que cobrem um código (procedimento, código co-cobrado ou TUSS), na ordem de disparo — precedência e depois rule_id. Retorna matched_key indicando de que lado do par excludente o código está; todas as regras listadas disparam, e só há vencedor onde o conflito foi declarado por um humano.

Linhagem de uma regra (draft → active → superseded).

Dry-run com precedência contra o ruleset ativo (nada é persistido).

Grafo de shapes SHACL usado na validação de regras.

Linhas de proveniência de uma execução de auditoria, em ordem determinística de disparo.

Cadeia de prova completa de um finding: regra (IRI, versão), evidência e a linha do XML (guia, sequencialItem). Passe run_id (e item_id): ids de finding se repetem entre execuções.

Converte um workbook de regras em propostas DRAFT no governance store.

Dry-run: quantas propostas DRAFT cada workbook geral renderia.

Lista regras lógicas (RuleIR) do tenant, com filtros por status, autoridade e rule_iri.

Importa regras lógicas em lote com origem e autoridade declaradas; valida cada RuleIR e reporta inseridas vs ignoradas.

Aprova uma regra lógica para status=active com autoridade human_approved ou regulatory_signed.

Compila um rule pack: manifesto versionado (pack_sha256) de regras lógicas ACTIVE, ancorado ao catálogo de referência e ao commit-fonte.

Manifesto de um rule pack compilado, por pack_id.

Registra uma ativação do rule pack (modo shadow por padrão) com vigência efetiva e motivo.

Estúdio visual interativo do motor de governança: overlay de bounding box OCR, matriz ALU de 64 bits, LinUCB confidence intervals e simulador Datalog.

Dados consolidados do estúdio visual: layout dos blocos OCR, vetores de atributos e grafo conceitual Galois FCA.

Simula a execução de regras de glosa com geração de prova Datalog e rastreabilidade em tempo real.

Fila de calibração de propostas de regras geradas por feedback humano ou evolução contínua.

Avalia o impacto de regras em calibração contra o histórico de contas do tenant.

Executa ação de governança (aprovar, rejeitar ou arquivar) em uma proposta de calibração.

Lista protocolos TISS (status, guias, valores informado e glosado).

Lista recursos de glosa TISS (status, motivo, resposta).

Resposta de um recurso de glosa.

Métricas agregadas de protocolos e recursos.

Demonstrativo de análise de um protocolo.

Ingere XML TISS (job assíncrono, 202).

Submete um lote TISS ao ledger de protocolos.

Submete um recurso de glosa.

Remove um protocolo do ledger TISS.

Remove um recurso (apelação) do ledger TISS.

Pré-autorização: submete uma guia TISS para análise (job assíncrono).

Status de um job de pré-autorização.

Valida um código TUSS (existência, tabela, termo, vigência).

Busca procedimentos TUSS por termo.

Detalhe de um procedimento TUSS por código.

Busca OPME (órteses, próteses e materiais especiais).

OPME por código (pode retornar múltiplos modelos).

OPME por número de registro ANVISA.

Distribuição de classes de risco OPME.

Busca medicamentos por termo.

Código CBO profissional.

Exigências de reporte ANS para um código TUSS.

Contagens de procedimentos, OPME, medicamentos e CBO.

Executa consulta SPARQL sobre o grafo de conhecimento (uso avançado).

Vizinhança de um IRI no grafo (nós e arestas) para exploração guiada.

Exporta o grafo de conhecimento em RDF.

Ficha TUSS enriquecida pelo grafo de conhecimento.

Lista datasets de referência consultáveis (contagem de linhas e colunas).

Lista versões imutáveis de Brasíndice/SIMPRO e seus ponteiros ativos.

Valida, compila e ativa atomicamente uma versão de catálogo Brasíndice ou SIMPRO.

Consulta um dataset de referência (filtros via query string).

Preço público de reembolso SIGTAP de um procedimento.

Validação de existência/vigência de um código SIGTAP.

Estado da base de dados brutos (pronta/pendente, contagem de arquivos).

Sincroniza dados brutos a partir de um source_path.

Ingestão sentinel agregada (contratos + auditoria + KB em uma chamada).

Status de uma tarefa de ingestão sentinel.

Catálogo da base de conhecimento.

Ingere documentos na base de conhecimento (job assíncrono).

Acompanha o status de um job de ingestão.

Reconstrói a treliça FCA a partir dos dados de glosa (job assíncrono).

Lista XMLs na caixa de entrada do health-audit.

Envia um arquivo para a caixa de entrada do health-audit.

LGPD — direito de acesso: categorias de dados em que o titular aparece.

LGPD — anonimização: substitui identificadores por token determinístico.

LGPD — direito de eliminação: registra o pedido; a purga segue a política de retenção.

Busca por substring em execuções, glosas e XML TISS do tenant (trigram/pg_trgm). Códigos parciais e fragmentos de CNPJ casam; mínimo de 3 caracteres. Requer ha:glosa:view.

Sinal barato e público de liveness do cartridge (sem diagnósticos internos).

Diagnóstico autenticado de prontidão das dependências (ontologia, regras, contratos).

Volumetria operacional (fail-soft): Postgres, Redis, RabbitMQ, host e processo da API.

Mesma leitura de /status/ops renderizada como página HTML autossuficiente (auto-refresh 120 s).

Busca no registro ANS (dados abertos) de operadoras ativas.

Backfill do tiss_xml_store a partir de XMLs processados em lote.

Backfill do governance store (cadeias de prova) a partir de runs existentes.

Re-dispacha runs de stamp cuja falha foi de infraestrutura (janelas de deploy), nunca rejeições de domínio. dry_run=true lista os candidatos sem tocar em nada.