Roteiros -> Correção e criação

[tomclima]

Pull Request - Teaching Assistant

📝 Descrição

O que foi feito:

• Implementação de criação e edição de roteiros compostos por atividades

• Implementação de correção de roteiros: Atribuição de nota às respostas às atividades dentro dos roteiros e comentários

Para isso foram feitas:
Novas classes - Script, Task, Scripts, TaskSet, ScriptAnswer, TaskAnswer, ScriptAnswerSet
Novas rotas - scriptgrading.ts, scripts.ts, tasks.ts dentro do diretório server/src/server_routes
Dados mockados - Lógica do mock na função loadMockScriptsAndAnswers no arquivo server/src/mock_scripts.ts

Testes unitários, de integração, de aceitação e e2e de todas as funcionalidades

📌 Observações

Impacto:

• 🟢 Baixo - Mudança isolada, sem efeitos colaterais
• 🟡 Médio - Afeta algumas funcionalidades
• 🔴 Alto - Mudanças críticas ou estruturais

Riscos identificados:

📦 Área afetada

Frontend (Client - React):

• 🖥️ Componentes React
• 🔌 Services/API
• 📝 Types/Interfaces TypeScript
• 🎨 Estilos e UI

Backend (Server - Express/Node.js):

• 🔌 API Routes/Endpoints
• 📊 Models e lógica de negócio
• 💾 Persistência de dados

Funcionalidades:

• 🎓 Gerenciamento de Estudantes
• 📋 Gerenciamento de Turmas
• 📝 Gerenciamento de Matrículas
• 📈 Gerenciamento de Avaliações
• 📄 Importação de dados
• Provas
• Flashcards
• Gerenciamento de roteiros
• Correção de roteiros

Infraestrutura:

• 🔧 Configurações (tsconfig, jest.config, cucumber.js)
• 📦 Dependências (package.json)
• 🚀 Scripts de build/deploy
• 📝 Documentação (README, guias)

🔧 Tipo de mudança

• 🐛 Correção de bug (fix)
• ✨ Nova funcionalidade (feature)
• ♻️ Refatoração de código
• 📚 Atualização de documentação
• ✅ Adição/atualização de testes
• 🎨 Melhorias de UI/UX
• 🔒 Correção de segurança
• ⚡ Melhoria de performance

🧪 Testes

Testes automatizados

Por nível de teste:

• 🔬 Testes Unitários (Jest) - Classes e funções isoladas
  • Dependências: versões antigas, stubs e drivers
• 🔗 Testes de Integração - Interação entre componentes/serviços
  • Dependências: novas versões evoluídas por outros desenvolvedores
• 🎯 Testes End-to-End (Cucumber) - Fluxos completos da aplicação
  • Dependências: todas as dependências envolvidas
• 🌐 Testes de Sistema - Ambiente completo de produção
  • Dependências: ambiente de produção com dependências externas reais

Por área testada:

• 🖥️ Testes de GUI (interface do usuário)
• 📊 Testes de Classes/Models (lógica de negócio)
• 🔌 Testes de Services/API (comunicação e endpoints)

Cobertura:

• Cobertura de testes mantida/aumentada
• Casos de erro e edge cases cobertos

Como revisar e testar

Testes Unitários (Server):

cd server
npm install
npm test                    # Executar testes
npm run test:watch          # Modo watch
npm run test:coverage       # Com cobertura

Testes E2E (Client):

cd client
npm install
npm start                   # Terminal 1: iniciar app
npm run test:cucumber       # Terminal 2: executar testes

Testar manualmente:

• Servidor: http://localhost:3000
• Cliente: http://localhost:3004

📸 Screenshots/GIFs

✅ Checklist

• Código segue os padrões do projeto
• Realizei self-review do código
• Comentei código em áreas complexas
• Atualizei a documentação (se necessário)
• Mudanças não geram warnings
• Adicionei testes que provam que a correção/feature funciona
• Testes novos e existentes passam localmente
• Mudanças dependentes foram merged e publicadas

🔗 Issues relacionadas

• Closes #
• Relacionado a #