Vestibuline — Documentação

Índice central de documentação técnica do projeto Vestibuline (plataforma de preparação para vestibulares: simulados, IA pedagógica, gamificação e mini-games, planner de estudos e consultor de notas de corte).

Repositórios

Repositório	Descrição
frontend	Next.js — interface web (BFF)
backend	Spring Boot (Java 21) — API principal
IA	Serviço de IA e aprendizado personalizado
APPS	Aplicações mobile/desktop multiplataforma

Índice

• Arquitetura — visão geral do sistema e fluxogramas
  • Arquitetura do Frontend
• Decisões técnicas (ADRs) — histórico de decisões de arquitetura

Como contribuir com a documentação

1. Toda mudança de arquitetura relevante (nova stack, novo padrão, mudança de fluxo de dados) deve ser registrada como um ADR em adr/, usando o template.
2. Diagramas usam Mermaid embutido em Markdown, para renderizar direto no GitHub sem imagens externas.
3. Documentação específica de um repositório (ex.: setup local, scripts, variáveis de ambiente) continua no README.md daquele repositório — aqui ficam apenas arquitetura, decisões e visão de sistema.