Auditoria, Fontes e Cobertura¶

Documento de auditoria técnica da documentação, registrando a base de código analisada, as fontes de verdade consultadas, convenções e status de cobertura dos componentes.

1. Baseline e Escopo Analisado¶

Repositório: GoGenetic Agente Digital
Branch base: fix/ajustes
Commit de referência: 175a0bd986675a75ef760349b123595bf9fe714d
Data da auditoria: 14 de setembro de 2026

Métricas da Base de Código Auditada¶

Estados da Máquina de Estados: 9 estados identificados (NEW, TRIAGEM, QUALIFICACAO, COLETA, CONFIRMACAO, HANDOFF, AGENDAMENTO, ATENDIMENTO_HUMANO, FINALIZADO).
Serviços no Catálogo: 15 serviços mapeados com regras de triagem e qualificação.
Context Packages: 15 pacotes contextuais carregados dinamicamente para enriquecer os prompts dos agentes de IA.
Ambientes remotos: Recursos gerenciados via AWS SAM (template.yaml). A homologação remota e secrets de produção não são validados por este build estático local.

2. Precedência de Fontes de Verdade¶

Conforme as diretrizes de documentação do projeto, a precedência adotada na resolução de inconsistências foi:

Código-fonte atual (src/)
    ↳ Testes automatizados (tests/)
        ↳ Infraestrutura como Código (template.yaml, samconfig.toml)
            ↳ Configurações e settings de exemplo (.env.example)
                ↳ Documentação técnica interna
                    ↳ Histórico de commits e discussões

Quando identificado comportamento divergente entre documentação preexistente e a implementação real, a documentação foi alinhada ao código em execução.

3. Cobertura da Documentação¶

Componente	Documentação Técnica	Código-Fonte Referência
Webhook & SQS FIFO	`architecture/sqs.md`, `architecture/message-flow.md`	`src/webhook/`, `template.yaml`
Orquestrador de Sessão	`architecture/orchestrator.md`, `architecture/state-machine.md`	`src/core/application/orchestrator.py`
Persistência DynamoDB	`architecture/dynamodb.md`	`src/core/integrations/dynamodb/`
Sincronização com CRM	`integrations/crm-sync.md`, `integrations/crm.md`	`src/crm_sync/`, `src/core/application/crm_sync.py`
Agentes de IA (Triagem, Qualificação, Coleta)	`agents/*.md`	`src/core/domain/agents/`
Integração WhatsApp	`integrations/whatsapp.md`	`src/core/integrations/whatsapp/`
Integração eGestor	`integrations/egestor.md`	`src/core/integrations/egestor/`
Atendimento Humano & Handoff	`human-support/*.md`, `integrations/handoff.md`	`src/core/application/handoff.py`
Dashboard e Operação	`operations/*.md`	`src/dashboard/`, scripts locais

4. Verificação de Renderização e Layout¶

Mermaid Diagrams: Renderizados via extensão pymdownx.superfences com suporte nativo do tema Material for MkDocs.
Temas Claro e Escuro: Configurados com paleta teal/cyan e chaveamento no topo.
Busca Offline: Indexada em português (lang: pt) via plugin search.
Modo Estrito (--strict): Validação sem links quebrados ou âncoras órfãs.