Feat/turmas

[Brenofrds]

Descrição

Este PR implementa no BFF o proxy simples das rotas de usuários para o Backend, mantendo a arquitetura definida para o projeto:

Frontend → BFF → Backend

Foram adicionadas as rotas:

• GET /api/v1/usuarios/alunos?busca=joao
• GET /api/v1/usuarios?ids=aluno-1,aluno-2

Essas rotas permitem que o frontend:

• busque alunos por texto;
• busque usuários por lista de ids.

O BFF continua atuando apenas como gateway/proxy simples, sem agregação, composição de dados ou regra de negócio.

Também foram realizadas as seguintes alterações:

• criação do router usuarios.routes.ts;
• registro de /api/v1/usuarios no roteador principal;
• atualização do README com a nova rota proxy;
• remoção da duplicação existente de apiRouter.use("/questoes", questoesRouter);
• adição de testes unitários e de integração para o novo proxy.

Rastreabilidade

Issue(s) Relacionada(s):

• Relates to: #94
• Relates to: #44
• Relates to: #70

Commits relacionados:

• f229b78300a1acfea0ebc41d964619405907dc06
• eae2179954f3ff5c76b5b6e2608b3db992107fe1
• b46bf11e06d7ae60806dc3650d206da0227933bd
• 01d57fe3c2160a3cbeb8b3057b848734fb2e35d1
• 0b1c5bfb125079f885a3b15e5d0267348d4f32ea

Tipo de Mudança

• Feature (nova funcionalidade)
• Bugfix (correção de erro)
• Refactor (melhoria interna)
• Documentação
• Testes

Evidências (se aplicável)

Comandos executados:

npx jest tests/unit/usuarios.routes.test.ts tests/integration/app.spec.ts --runInBand
npx tsc --project tsconfig.build.json --noEmit

Resultados:

Test Suites: 2 passed, 2 total
Tests: 21 passed, 21 total
TypeScript compilation: passou sem erros

Checklist

• Código segue o padrão de commits (Commitizen)
• PR está vinculado a uma issue (US ou Task)
• Testes foram adicionados/atualizados
• Código revisado localmente
• Não quebra funcionalidades existentes

Observações

O BFF foi mantido como gateway/proxy simples. Ele apenas repassa as chamadas para o Backend, sem buscar dados no Quiz-Service e sem agregar respostas.

A composição entre vínculos de turma e dados completos dos alunos será feita no frontend, conforme a arquitetura definida.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[pkbceira03]

tudo certo!