portal_publico/portal_api/nao_conformidades/README.md

Não Conformidades (Relatórios > Qualidade)

Ver CLAUDE.md nesta mesma pasta para o detalhamento técnico completo (models, pipeline, lógica de reabertura automática). Ver CLAUDE.md na raiz para arquitetura geral/transversal do Portal. Ver também projects/Controladoria - Analise NCs/analise-ncs_SKILL.md para a regra de negócio original (skill que esta ferramenta evolui).

Ferramenta da área de Qualidade — gestão contínua das ocorrências e ações do Sistema de Gestão da Qualidade (Sigsistem, ISO 9001), substituindo um relatório Excel estático que era gerado sob demanda por uma skill do Claude. A partir de dois arquivos exportados periodicamente do Sigsistem (ocorrências + ações), a ferramenta:

• Mantém cada ocorrência/ação como registro contínuo (upsert por código), não descarta nada entre importações.
• Sinaliza o que precisa de atenção: ocorrências sem análise, análises sem ação aberta, ações vencidas/vencendo em 7 dias, e acompanhamentos novos que a Qualidade ainda não tratou.
• Deixa a Qualidade marcar manualmente o que já foi tratado — e reabre sozinha se uma importação nova trouxer algo diferente do que existia quando foi tratado.
• Guarda o histórico completo de acompanhamentos de cada ação (não só o último).
• Oferece um dashboard com indicadores, motivos de abertura, e ranking de clientes/colaboradores com maior incidência.

Acesso restrito por padrão (só "Integração e Inovação" nasce com permissão) — é ferramenta de uma pessoa/área específica, liberada manualmente pra outros perfis pela tela de Perfis de Acesso.

Onde mexer

• portal_api/nao_conformidades/ — modelos.py (dataclasses), leiaute_ocorrencias.py/leiaute_acoes.py (parsing dos dois arquivos do Sigsistem), classificacao.py (vencimento/status de prazo), diff.py (reabertura automática), pipeline.py (orquestração).
• NaoConformidadeImportacao, NCOcorrencia, NCAcao, NCAcompanhamento (portal_api/models.py).
• nao-conformidades.html/static/js/nao-conformidades.js/static/css/nao-conformidades.css.