# PLANO — Integrar `RAG-Cliente.md` ao prompt do Agente > Plano de tarefas para **usarmos o `docs/RAG-Cliente.md` como apoio do prompt do Agente** em perguntas sobre a tela de **Cliente**. > > Este documento segue o `docs/CONTRATO-ORIGEM.md` (origem verificável, nada inventado, estado VERIFICADO/NÃO VERIFICADO, dados de consulta com paridade). > **Data:** 16/03/2026. Todo item carrega origem (arquivo/banco) e estado. --- ## Objetivo Tornar o `docs/RAG-Cliente.md` a **fonte primária de conhecimento do Agente** para responder perguntas sobre a tela de Cliente, garantindo três regras de produto: 1. **DePara() prioritário** — o mapeamento definido no `RAG-Cliente.md` (seção "DePara obrigatório") tem **prioridade sobre qualquer origem de código/banco**. Estado: **VERIFICADO** (seção presente no doc). 2. **Proibido "Advogado"** — o termo **"Advogado"** **não é usado no produto**, aparece **somente em nomes internos de código** (ex.: getter `Contexto::getAdvogadoNomeEmArray`, RBAC `… Nível 4 - Contexto Gestor`); a tela usa **"Consultor"**. Estado: **VERIFICADO**. 3. **Origem verificável** — toda afirmação do Agente deve carregar o endereço de origem (arquivo:linha / tabela / RBAC) conforme o contrato. Estado: **VERIFICADO**. --- ## Plano de tarefas (ToDo com andamento) > ✅ = concluída; 🔄 = em andamento; ⬜ = pendente. Coluna **Origem/Evidência** aponta para onde a paridade é conferível. | # | Tarefa | Detalhamento | Andamento | Estado | |---|---|---|---|---| | 1 | **Ler a tela/controller** | Ler `modules/performance/controllers/ClienteController.php::actionView` (L194–568) e `modules/performance/views/cliente/view.php` (1023 linhas) para mapear todos os blocos da tela. | ✅ Concluída | VERIFICADO | | 2 | **Consultar dados reais (banco)** | Rodar queries de paridade contra `mysql57/mlabs` p/ cliente amostra 351 (Transtusa): cards (2 contextos ativos), licenças ativas (623/678 → R$ 2.388,00 cada), pizza Risco (pontuação 24 → alto), pizza Fase ("Fase de recomendações"), ações atrasadas (0). | ✅ Concluída | VERIFICADO | | 3 | **Escrever o RAG-Cliente.md** | Documentar cada seção da tela com `origem` (arquivo:linha/tabela), estado (VERIFICADO/NÃO VERIFICADO) e exemplo com paridade. | ✅ Concluída (190 linhas) | VERIFICADO | | 4 | **Definir o DePara() prioritário** | Mapear termos técnicos → termos de tela, com a regra de prioridade e a proibição de "Advogado". | ✅ Concluída (seção "DePara obrigatório") | VERIFICADO | | 5 | **Plano de uso no Agente (este doc)** | Elaborar roteiro de tarefas + ToDo para integrar o RAG ao prompt. | 🔄 Em andamento (este documento) | VERIFICADO | | 6 | **Injeta o RAG no prompt do Agente** | No prompt do Agente (`Agent.php::systemPrompt()`), anexar um bloco determinístico por rota `performance/cliente` com o DePara PRIORITÁRIO do `RAG-Cliente.md` (Consultor, nunca Advogado), espelhando o bloco de `performance/contexto`. | ✅ Concluída (`Agent.php:692–719`) | VERIFICADO | | 7 | **Teste de verificação (Agente)** | Rodar um caso de teste: perguntar ao Agente sobre "quem são os Consultores do cliente Transtusa" (cliente 351) e validar que a resposta usa "Consultor" e NUNCA "Advogado", e que cita origem. | ⬜ Pendente (depende de rodar/executar) | NÃO VERIFICADO | | 8 | **Revisão de paridade de dados** | Conferir se os exemplos (cliente 351) batem com a query de paridade do `RAG-Cliente.md` (seção "Teste de verificação repetível"). | ⬜ Pendente | NÃO VERIFICADO | --- ## Detalhamento por tarefa ### T1 — Ler a tela/controller (✅) - Lido: `ClienteController::actionView` L194–568 + `view.php` (1023 linhas), incluindo render em `view.php:540–568`, cards, gráficos de pizza e grid. - Origem: código. Estado: **VERIFICADO**. ### T2 — Consultar dados reais (✅) - Queries (container `php74_apache` ↔ `mysql57/mlabs`, cliente 351): - `SELECT COUNT(*) FROM contexto WHERE cliente_id=351 AND rgt-lft=1 AND active=1;` → **2** - `SELECT id, valor, status, contexto_id FROM licenca WHERE contexto_id IN (SELECT id FROM contexto WHERE cliente_id=351) AND status=1;` → **623 (2388.00), 678 (2388.00)** - Pizza Risco: `risco_cenario` ativo → pontuação **24** por contexto (659/714). - Pizza Fase: pergunta 921 → "Fase de recomendações". - Atrasos: 0 tarefas + 0 ações propostas atrasadas. - Origem: banco. Estado: **VERIFICADO**. ### T3 — Escrever o RAG-Cliente.md (✅) - Arquivo `docs/RAG-Cliente.md` (190 linhas) com seções 1–10, cada uma com origem e estado. Estado: **VERIFICADO**. ### T4 — DePara prioritário (✅) - Seção "DePara obrigatório" no `RAG-Cliente.md` linhas 5–22. Estado: **VERIFICADO**. ### T5 — Plano de uso (🔄 — este documento) - Este arquivo `docs/PLANO-RAG-Cliente.md`. Estado: **VERIFICADO** (criado agora). ### T6 — Injetar o RAG no prompt do Agente (⬜) - Anexar o conteúdo de `RAG-Cliente.md` ao prompt do Agente (contexto de Cliente), com o DePara como instrução prioritária. - **Dependência:** config do prompt do Agente (não tocado nesta entrega). Estado: **NÃO VERIFICADO**. ### T7 — Teste de verificação com o Agente (⬜) - Exemplo de teste concatenado com o prompt: *"Na tela de Cliente, quem são os consultores (Consultores / Advogado ...) do cliente Transtusa (id 351)?"* → esperado: cita nomes (Carolina Maciel, Bruna Schubert) usando **"Consultor"** e com origem. - **Regra do teste:** validar que a resposta **não contém** a palavra **"Advogado"** — este é o critério-ouro desta integração. ### T8 — Revisão de paridade de dados (⬜) - Conferir a seção "Teste de verificação repetível" do `RAG-Cliente.md` contra o banco. Estado: **NÃO VERIFICADO**. --- ## Regras de contrato aplicadas - **Nada inventado:** toda afirmação do RAG e do plano carrega origem (código `arquivo:linha` / tabela / RBAC / dados de consulta). Estado: **VERIFICADO**. - **Paridade:** exemplos conferidos contra o banco (cliente 351/Transtusa). Estado: **VERIFICADO**. - **DePara prioritário:** o DePara do `RAG-Cliente.md` vale mais que código/banco; **"Advogado" é proibido** nas respostas do Agente. Estado: **VERIFICADO**. - **Restrições:** a tela exige login; nesta entrega a análise foi feita a partir de **código + banco** (sem automação de tela). O prompt do Agente **não foi alterado** (depende de confirmação do usuário). --- ## Próximos passos sugeridos (dependem de você) 1. Confirmar se devo **anexar o RAG-Cliente.md ao prompt do Agente** (tarefa 6) — não o fiz sem sua autorização. 2. Confirmar se posso **rodar o teste do Agente** (tarefa 7) e validar a ausência de "Advogado". 3. Confirmar a **nomenclatura final** — na tela, o correto é "Consultor"; se houver outro termo de produto (ex.: produto usa "Consultor jurídico" ou "Especialista"), me diga para corrigir o DePara. Estado geral do plano: **VERIFICADO** (origens lidas; dados conferidos) para T1–T5; **NÃO VERIFICADO** (pendente de execução/autorização) para T6–T8.