Diagramas

Os diagramas estão em formato draw.io (.drawio) e são gerados por script (fonte versionada), garantindo consistência.

Como abrir

• Web: app.diagrams.net → File → Open → selecione o .drawio.
• VS Code / Cursor: instale a extensão Draw.io Integration e abra o arquivo direto no editor.

Como regenerar

node tools/gerar_drawio.mjs        # gera todos os diagramas de uma vez
# ou, via npm script:
npm run diagrams

No portal de docs (VitePress), os diagramas abaixo aparecem renderizados em SVG (exportados no build a partir do .drawio). No GitHub/editor, use o link do .drawio.

Arquitetura geral

Camadas do sistema, laterais de Observabilidade & SRE e Qualidade & Testes/CI, e a faixa de Entrega (GitOps).

• Arquivo (fonte): arquitetura.drawio

Fluxo de entrega (CI + GitOps + Kubernetes)

Padrão de dois repositórios (app + config), Argo CD sincronizando ambientes e o loop de observabilidade/IA.

• Arquivo (fonte): fluxo-gitops.drawio

Esquema do banco de dados

Modelo relacional (entidades e relacionamentos). Ver também Modelo de dados.

• Arquivo (fonte): banco-dados.drawio

Sequência do fluxo ponta a ponta

Da coleta do CSV à consulta no front, passando por ingestão, mensageria, enriquecimento (detalhe) e recálculo de custo/score. Ver Visão geral e Regras de negócio.

• Arquivo (fonte): sequencia-fluxo.drawio

Sequência do login (OIDC + refresh)

Login social (Google/GitHub) com Authorization Code + PKCE, rotação de refresh token e logout. Ver ADR-0013 e API Pública.

• Arquivo (fonte): sequencia-login.drawio

Fonte única: os .drawio ficam em docs/public/diagramas/ (gerados por node tools/gerar_drawio.mjs). No deploy, o CI renderiza cada .drawio em SVG nessa mesma pasta — não é preciso exportar imagens manualmente.