Fluxo Fase 1 — MVP

Visão geral

O MVP implementa dois caminhos principais:

1. Fluxo síncrono — consultas de KPI com sessão curta, Adaptive Card e auditoria.
2. Fluxo assíncrono — exportações enfileiradas no SQS com correlationId.

Diagrama end-to-end

flowchart TD
    U[Usuário no Teams] --> A[POST /api/messages]
    A --> B[Bot Handler]

    B --> C{Segurança OK?}
    C -- Não --> C1[401 Unauthorized]
    C -- Sim --> D[Parse Activity + correlationId]

    D --> E{Tipo da mensagem}

    E -- Exportação --> F[Queue: build job export.requested]
    F --> G[SQS JobsQueue]
    G --> H[Worker Jobs]
    H --> I[Processa job + logs estruturados]
    I --> J[DLQ em falha repetida]
    F --> K[202 processamento assíncrono]

    E -- KPI/Comparativo/Follow-up --> L[LLM Gateway: interpretar intent]
    L --> M[Resolver sessão por conversationId]
    M --> N[Data Service: queryKpi]
    N --> O[Monta Adaptive Card]
    O --> P[Audit Event who/what/when/result/latency]
    P --> Q[200 com texto + attachments]

    E -- Outro --> R[200 resposta padrão]

Critérios de aceitação (cumpridos)

• POST /api/messages responde em < 5s para KPI
• GET /health retorna status=ok com métricas e circuit breakers
• Exportação enfileirada retorna 202
• Worker consome a fila e processa sem erros
• Auditoria registra eventos who/what/when/result/latency