Apoio · Documentação técnica

Toda a documentação produzida.

Manuais, análises, relatórios de implementação, knowledge base e guias operacionais. Tudo que foi escrito durante o contrato para apoiar a equipe interna na continuidade.

Documentos principais

Documentação técnica geral

  • DOCUMENTACAO_TECNICA.md — Arquitetura completa: serviços, banco, integrações, deploy, troubleshooting
  • MANUAL_OPERACIONAL.md — Como operar o sistema no dia a dia: subir/descer serviços, conferir status, resolver problemas comuns
  • RELATORIO_ENTREGA_FASE2.md — Marco de entrega do MVP funcional

Deploy e operação

  • irb-whatsapp-ai/DEPLOY_DOCUMENTATION.md — Procedimento passo a passo de deploy
  • irb-whatsapp-ai/AUDIT_COMPLETE.txt — Resultado da auditoria completa (14 bugs + 3 prioridade-1)

Fluxos e análises

  • docs/relatorios/RELATORIO_FLUXO_CONVERSACIONAL.md — Como a IA conduz a conversa, com exemplos
  • docs/relatorios/RELATORIO_INTEGRACAO_IGS_KLINGO.md — Como funciona a sincronização IGS↔Klingo
  • docs/relatorios/Análise do Atendimento IRB Prime Care.pdf — Diagnóstico inicial (Fase 1)
  • irb-whatsapp-ai/ANALISE_BOTOES_FLUXO.md — Análise dos botões interativos WhatsApp
  • irb-whatsapp-ai/BOTOES_FIX_IMPLEMENTED.md — Correções aplicadas
  • irb-whatsapp-ai/BOTOES_QUICK_REFERENCE.md — Guia rápido de uso

Klingo sync

Conjunto de documentos sobre a sincronização com a Klingo:

  • KLINGO_SYNC_IMPLEMENTATION.md — Implementação técnica
  • KLINGO_SYNC_README.md — Visão geral
  • KLINGO_SYNC_CHANGELOG.md — Histórico de mudanças
  • KLINGO_SYNC_STATUS.html — Status visual
  • KLINGO_SYNC_SUMMARY.txt — Resumo executivo
  • KLINGO_INDEX.md — Índice geral
  • DIRETORIA_KLINGO_SYNC.md — Resumo para diretoria

Knowledge base da IA

  • irb-whatsapp-ai/knowledge-base-rag.md — Base de conhecimento consultada pela IA via RAG
  • irb-whatsapp-ai/playbook.html — Playbook visual da operação
  • irb-whatsapp-ai/COPY_ENCANTADORA.md — Diretrizes de tom de voz da assistente

Módulos específicos

  • PHARMACY_MODULE_SUMMARY.md + PHARMACY_SCHEMA_ADDITIONS.md — Módulo de farmácia
  • Resposta_SOL-IGS-0415.docx — Sprint de periodicidade flexível
  • RELATORIO_SOL-IGS-0422.html — Sprint isActive + OCR + KPIs

Fiscal REINF

  • irb-reinf/data/output/relatorios/relatorio-producao-2025-12-20260508-1554.md — Relatório do fechamento dez/2025
  • irb-reinf/data/output/relatorios/relatorio-entrega-irb-reinf-12-2025.pdf — Versão formal

Encerramento

  • docs/relatorios/TERMO_ENCERRAMENTO_PRESTACAO_SERVICOS_IRB_2026-05-12.md (e versões .docx, .html, .pdf) — Termo formal de encerramento do contrato

Onde tudo está

Todos os documentos estão versionados no repositório local em ~/Documents/IRB/. Eles serão entregues à IRB junto com os repositórios via:

  • Repositórios Git completos (com histórico)
  • Pacote ZIP com toda a documentação
  • Esta página web servida em entrega.irb.saraiva.ai

Critério editorial

A documentação foi escrita com dois leitores em mente:

  1. Pessoa técnica que assume a continuidade — precisa saber onde está cada coisa, como rodar, como fazer deploy, como resolver problemas
  2. Pessoa de gestão — precisa entender o que foi entregue, o resultado, o estado atual

Quando houve conflito entre os dois, optei pela clareza para o leitor de gestão e adicionei um bloco técnico separado para quem precisa do detalhe.