Pular para o conteúdo principal

Mindmap da arquitetura

Introdução ao documento

Este documento registra uma visão rápida do repositório em formato de mindmap textual. O objetivo é facilitar onboarding e navegação pelos módulos já identificados por evidência no código.

Mindmap

Evidências:

  • src/app/page.tsx:8-27
  • src/app/(protected-routes)/home/page.tsx:18-67
  • src/app/(protected-routes)/quiz/page.tsx:21-231
  • src/app/api/health/route.ts:3-31
  • src/app/api/submissions/route.ts:4-90
  • package.json:5-22
  • .github/workflows/ci-cd-pipeline.yml:13-124
  • .github/workflows/cypress.yml:11-104

Como interpretar

  • Interface: camadas visíveis ao usuário, incluindo rotas, providers e componentes.
  • BFF: rotas HTTP locais que abstraem serviços externos.
  • Domínio: conjuntos de features percebidos pelas rotas protegidas e componentes associados.
  • Integrações: dependências externas acionadas por handlers, serviços ou bootstrap da aplicação.
  • Operação: mecanismos observados para desenvolvimento, teste e entrega.

Pendências

  • Adicionar um mindmap por fluxo de negócio se o time quiser granularidade maior por feature.
  • Confirmar se existe outra topologia operacional além de Docker + Helm + Kubernetes descrita neste repositório.

Versionamento

  • Baseline criado em 2026-03-20.
  • Atualizar junto com mudanças estruturais em src/app, src/app/api, .github/workflows e helm/.

Referencial teórico

  • Mermaid mindmap para representação de estrutura.
  • Documentação arquitetural enxuta orientada a navegação do repositório.