From c2b78f6667491234f4a4c5a7445ad9177ab719a9 Mon Sep 17 00:00:00 2001 From: Gabriel Date: Thu, 27 Aug 2026 11:13:39 -0300 Subject: [PATCH] =?UTF-8?q?Corre=C3=A7=C3=A3o=20visual=20na=20tela=20de=20?= =?UTF-8?q?cadastro=20de=20regras=20especiais.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude/skills/importacao-plano-saude/SKILL.md | 2 +- .claude/skills/importacao-questor-plano-saude/SKILL.md | 2 ++ portal_api/planos_saude/CHANGELOG.md | 1 + templates/importacao-plano-saude.html | 2 +- 4 files changed, 5 insertions(+), 2 deletions(-) diff --git a/.claude/skills/importacao-plano-saude/SKILL.md b/.claude/skills/importacao-plano-saude/SKILL.md index b24e1dd..b2774b2 100644 --- a/.claude/skills/importacao-plano-saude/SKILL.md +++ b/.claude/skills/importacao-plano-saude/SKILL.md @@ -9,7 +9,7 @@ description: Guia de manutenção/extensão da etapa de leitura e validação da Este SKILL.md documenta a etapa **comum a qualquer sistema contábil de destino**: ler o relatório de faturamento de uma operadora de plano de saúde/odontológico, extrair beneficiários e valores, e aplicar as regras de negócio (custeio, "Regra empresa", nome divergente) que decidem quanto cada lançamento deve valer — tudo isso antes de qualquer formatação específica de sistema. É o complemento "por quê"/"cuidado com X" da documentação técnica, já exaustivamente descrita em `CLAUDE.md` (seção "Importação de Plano de Saúde (Utilitários)"). Antes de tocar em qualquer parser ou regra de custeio, ler os dois: `CLAUDE.md` pra arquitetura (models, endpoints, formato de `custeio_por_tipo`, "Regra empresa", "Vínculos de nome salvos"), este arquivo pra contexto de negócio e pra lista de gaps ainda não confirmados como equivalentes ao processo manual que a ferramenta substitui. -**Qual sistema contábil é o destino desta importação?** A ferramenta hoje só gera saída pro **Questor** — se for esse o caso (ou se não tiver sido dito o contrário), ler também a skill `importacao-questor-plano-saude` antes de tocar em Cadastro de Regras, planilha padrão, leiaute ou geração do CSV/ZIP final — isso é escopo dela, não deste arquivo. Se o destino for o **Contabit** (formato alternativo de rubricas 338/200/201), avisar o usuário que essa etapa ainda não foi implementada, nem a skill correspondente existe ainda — não inventar um leiaute Contabit sem confirmação explícita (ver gap 4 na seção 3). +**Se a tarefa é sobre Cadastro de Regras, planilha padrão, leiaute ou geração do CSV/ZIP final: pare aqui.** Esta skill não cobre isso — é escopo da skill específica do sistema contábil de destino. A ferramenta hoje só gera saída pro **Questor**: se for esse o caso (ou se não tiver sido dito o contrário), carregar `importacao-questor-plano-saude` antes de prosseguir. Se o destino for o **Contabit** (formato alternativo de rubricas 338/200/201), avisar o usuário que essa etapa ainda não foi implementada, nem a skill correspondente existe ainda — não inventar um leiaute Contabit sem confirmação explícita (ver gap 3 na seção 3). ## 1. Operadoras já parametrizadas hoje (fotografia em 25/08/2026) diff --git a/.claude/skills/importacao-questor-plano-saude/SKILL.md b/.claude/skills/importacao-questor-plano-saude/SKILL.md index 04b0b74..5b59ca1 100644 --- a/.claude/skills/importacao-questor-plano-saude/SKILL.md +++ b/.claude/skills/importacao-questor-plano-saude/SKILL.md @@ -9,6 +9,8 @@ description: Guia da etapa final específica do Questor na ferramenta "Importaç Este SKILL.md documenta a etapa **específica do Questor**: como a informação já extraída do arquivo da operadora e já com as regras de negócio de custeio aplicadas (ver skill `importacao-plano-saude` — leitura e regras de negócio genéricas, sempre o ponto de partida) vira, de fato, um lançamento no leiaute de importação do Questor. Complementa `CLAUDE.md` (models, endpoints, formato de `custeio_por_tipo`, seção "Planilha padrão via Questor (SQL)") com o "por quê"/"cuidado com X" desta etapa. +**Se a tarefa é adicionar/ajustar um parser de operadora (extração de um arquivo novo, casamento, regra de custeio negociada): pare aqui, esta skill não cobre isso.** Carregar `importacao-plano-saude` (seção 4 — checklist e regras de negócio) antes de escrever qualquer código ou fazer qualquer pergunta ao usuário sobre o arquivo-modelo. Esta skill só entra depois que o parser já existe e a extração/casamento já estão certos — ela é sobre Cadastro de Regras, planilha padrão e leiaute final, não sobre ler o arquivo da operadora. + **Hoje o Questor é o único sistema contábil de destino implementado** — se em algum momento surgir uma importação com destino Contabit, não usar este guia pra estruturar a saída; ele ainda não foi implementado (ver gap 3 na skill geral). ## 1. Empresas com "Cadastro de Regras" salvo (consultar ao vivo, não uma lista fixa aqui) diff --git a/portal_api/planos_saude/CHANGELOG.md b/portal_api/planos_saude/CHANGELOG.md index b92054c..f8e0a3e 100644 --- a/portal_api/planos_saude/CHANGELOG.md +++ b/portal_api/planos_saude/CHANGELOG.md @@ -296,3 +296,4 @@ Pedido do usuário: o escritório trabalha com mais de um sistema contábil (Que - **`importacao-questor-plano-saude`** (existente, esvaziada e focada): ficou só com o que é Questor de fato — "Cadastro de Regras" (por que o cadastro em si, ao contrário da decisão de custeio, nasce amarrado ao `codigo_empresa`/`codigo_operadora` resolvidos contra o banco do Questor) e a auditoria manual pós-importação contra o relatório de lançamentos do Questor. - Uma terceira skill pro Contabit ainda não existe — a skill geral só documenta o gap e avisa pra não inventar leiaute Contabit sem confirmação, e já registra uma ressalva: o "casamento" hoje (`matcher.py`/`LinhaSistema`) usa um formato de registro moldado no leiaute do Questor, então o Contabit provavelmente vai exigir mais que só uma geração de arquivo diferente — um `LinhaSistema`/matcher próprios também, quando essa frente for aberta. - Referências cruzadas atualizadas em `portal_api/planos_saude/CLAUDE.md` e `README.md` (skill única → as duas); aproveitado pra corrigir a contagem de parsers no `README.md`, que ainda dizia "9" (desatualizada desde as rodadas da Humana/Unimed Cascavel). +- **Redirecionamento reforçado, mesmo dia**: usuário perguntou o que aconteceria se a skill `importacao-questor-plano-saude` fosse chamada direto pra cadastrar uma operadora nova — o aviso original (uma frase solta na seção 0, tipo "ver skill X, sempre o ponto de partida") dependia de inferência, não era uma trava amarrada ao cenário específico. Trocado pelos dois lados por um "pare aqui" explícito logo no topo: a skill geral (`importacao-plano-saude`) avisa pra quem for mexer em Cadastro de Regras/planilha padrão/leiaute/geração de arquivo ir pra skill do Questor; a skill do Questor avisa pra quem for adicionar/ajustar parser de operadora ir pra skill geral (seção 4) **antes** de escrever qualquer código ou fazer qualquer pergunta ao usuário. Aproveitado pra corrigir uma referência cruzada errada (`importacao-plano-saude` apontava "gap 4" quando o gap do Contabit é o item 3 da seção 3). diff --git a/templates/importacao-plano-saude.html b/templates/importacao-plano-saude.html index 9e16b26..fa7f576 100644 --- a/templates/importacao-plano-saude.html +++ b/templates/importacao-plano-saude.html @@ -499,7 +499,7 @@