first commit

docs/RELATORIO_PARIDADE_BACKOFFICE_100.md

@@ -0,0 +1,45 @@
+# Relatório de paridade — Backoffice convertido 100%
+
+## Resultado
+
+Esta versão deixa de ser apenas um agente genérico com ferramentas MCP e passa a hospedar a implementação original da branch `develop` dentro da aplicação do Agent Framework.
+
+## Paridade implementada
+
+| Item | Status |
+|---|---|
+| Grafo checklist original | Implementado |
+| Grafo response emulator original | Implementado |
+| Rotas REST originais | Implementadas |
+| Schemas originais | Implementados |
+| Clients TIM originais | Implementados |
+| Prompts originais | Implementados |
+| Nós de negócio originais | Implementados |
+| Testes originais | Copiados em `tests_original_develop/` |
+| Gateway novo do framework | Mantido |
+| Guardrails do framework | Mantidos e reforçados |
+| Judges do framework | Mantidos e reforçados |
+| Supervisor do framework | Mantido |
+| MCP Tool Router | Mantido |
+| IC/NOC/AGA original | Preservado via `src/utils/ics_collector.py` e observer original |
+| IC/NOC/GRL framework | Mantido via `AgentObserver` |
+
+## Decisão de arquitetura
+
+A lógica original de domínio foi mantida em `src/` para garantir paridade. O framework hospeda essa lógica e a envolve com as capacidades enterprise novas.
+
+Isso evita perder comportamento dos nós originais como validação ANATEL, IMDB, Speech Analytics, TAIS KB, cancelamento, reclassificação, tratamento, Siebel SR e Response Emulator.
+
+## Arquivos centrais alterados
+
+- `app/main.py`: registra workflows e rotas originais dentro do app do framework.
+- `app/agents/backoffice_agent.py`: quando recebe ticket ANATEL completo pelo gateway, executa o workflow checklist original como workflow de domínio.
+- `config/agents/backoffice_anatel/guardrails.yaml`: reforço dos rails de domínio.
+- `config/agents/backoffice_anatel/judges.yaml`: judges específicos para protocolo, Siebel, rastreabilidade e emulator.
+- `.env.example`: substitui `.env` com segredos reais.
+
+## Limites conhecidos
+
+- A execução real dos serviços TIM depende das variáveis de ambiente e conectividade corporativa.
+- Em ambiente local sem VPN/credenciais, os clients originais podem falhar ou usar fallback/mock conforme o código original.
+- Os testes copiados de `tests_original_develop/` ainda devem ser executados no ambiente com dependências completas do projeto original.