Centralização do Domínio de Conteúdos e Classificações

[FernandoAlmeidaPinto]

📌 Status

Proposta | A ser implementada

👥 Equipe impactada

• Backend — API
• Backend — ms-simulado

🎯 Objetivo

Centralizar o domínio de conteúdos, temas, classificação acadêmica (áreas, matérias, frentes) e questões exclusivamente no ms-simulado, eliminando duplicidade de entidades na API.

---

🔍 Problema Atual

Hoje o sistema opera com classificações acadêmicas duplicadas e inconsistentes:

Serviço	Banco	Domínio duplicado
API (monolito)	MySQL	Área, Matéria, Frente, Tema, Conteúdo
ms-simulado	MongoDB	Área, Matéria, Frente (para questões)

🔴 Consequências

• Criamos matérias e frentes duas vezes.
• Dificulta o compartilhamento de lógica futura (ex.: recomendações pedagógicas).
• Compromete relatórios sobre desempenho de estudantes.
• Duplica manutenção e migração de dados.

---

🎯 Visão Após Refatoração

Serviço	Responsabilidade
ms-simulado	Classificações (área, matéria, frente), temas, conteúdos, questões e simulados
API	Usuários, colaboradores, inscrições, fluxo acadêmico e operações gerais da plataforma

📌 A API continuará referenciando dados de classificação pedagógica, porém não irá gerenciá-los.

---

🔁 Alterações de Domínio

🧩 Entidades movidas para o ms-simulado

Entidade	Destino	Observações
Área do ENEM	Ambos, como enum	Costante e fixa (4 áreas)
Matéria	ms-simulado	Passa a possuir area: EnumAreaEnem
Frente	ms-simulado	Referência por ID
Tema	ms-simulado	Exclusiva para conteúdos
Conteúdo	ms-simulado	Nova entidade mantida junto do Tema

📌 Impactos

• API não armazenará mais: Matéria, Frente, Tema, Conteúdo.
• Suas antigas tabelas e migrations serão removidas definitivamente.

---

🔎 Detalhamento do Novo Domínio no ms-simulado

Área (enum fixo)
↳ Matéria
↳ Frente
↳ Tema (exclusivo de conteúdo)
Conteúdo (referencia Tema, Frente, Matéria, Área)
Questões/Simulados (continuam referenciando Matéria e Frente)

---

👨‍🏫 Especialidades de Colaboradores

Para recomendar conteúdos/frentes em que colaboradores são mais especialistas:

📌 Decisão provisória

• A API armazenará um campo de texto JSON com:
  • IDs de matérias e frentes oriundos do ms-simulado.
• Informação consultada pelo ms-simulado não será necessária neste primeiro momento.

Essa solução evita dependência inversa prematura. Poderá ser revisada futuramente caso as recomendações se tornem mais inteligentes.

---

🧨 Estratégia de Migração

📌 Passos

1. Excluir todas as entidades afetadas na API
   • Remover modelos, controllers, services e migrations.
2. Criar Tema e Conteúdo no ms-simulado
   • Reaproveitar base das outras classificações.
3. Revisar endpoints de simulado/questões
   • Garantir que todos passam a usar IDs centralizados.
4. Atualizar API para consumir o ms-simulado
5. Documentar os novos contratos da API
6. Atualizar front-end (caso consuma essas entidades)

---

⚠️ Breaking Changes

• A API terá endpoints removidos definitivamente.
• Não haverá versão /v2; apenas remoção direta de funcionalidades obsoletas.
• Aplicações que consumirem essas entidades precisarão se ajustar.

---

📌 Riscos & Mitigações

Risco	Impacto	Mitigação
Dependência futura da API em dados externos	Alto	Centralizar 100% no ms-simulado (decisão atual)
Recomendação de colaboradores crescer e exigir lógica sofisticada	Médio	Posterior criação de endpoint específico no ms-simulado
Front consumir endpoints removidos	Alto	Comunicação antecipada + checklist de impacto

---

📍 Roadmap Proposto

Etapa	Status	Responsável
Documentação e validação	🟡	Tech
Excluir domínio duplicado na API	⬜	Backend API
Modelar Tema + Conteúdo no ms-simulado	⬜	Backend Simulado
Ajustar endpoints necessários	⬜	Backend Simulado
Criar endpoints de consulta na API	⬜	Backend API
Ajustar consumo nas features da plataforma	⬜	Full Stack
Revisar recomendação de colaboradores	⬜	Pedagógico x Tech

---

📌 Decisões Tomadas

• Todo domínio acadêmico ficará centralizado no ms-simulado.
• API apenas consome, não gerencia nem valida classificações.
• Especialidades de colaboradores serão armazenadas na API via JSON (provisório).
• Área do ENEM permanece como enum constante em ambos os serviços.

---

💬 Comentários e Discussão

Caso surja necessidade futura, a recomendação pedagógica pode ser elevada a serviço específico (ex.: ms-recomendador), consumindo o ms-simulado como fonte única de verdade.