📄 Documento de Execução — Card 14: [M3] Tarefas & Avaliações

🎯 1. O que foi implementado

Substituído o protótipo mock da página /professor/tarefas (com tarefas hardcoded e modal que não persistia) por uma implementação real e completa do painel de Tarefas do professor, conectada ao banco via tRPC.

O professor agora pode criar tarefas (título, descrição, instruções detalhadas, prazo, nota máxima, anexos via upload real), revisar como rascunho (DRAFT), publicar (notifica todos os alunos matriculados), fechar (PUBLISHED → CLOSED, não aceita mais entregas), e avaliar entregas (nota + feedback + flag "permitir refazer") com o GradingModal.

A página de detalhe lista todas as entregas com status (Pendente/Entregue/Atrasada/Corrigida), número da tentativa (para tarefas refeitas do M1.5), nota atribuída, e botão "Corrigir"/"Rever". Ao avaliar, o aluno recebe notificação automática com a nota e feedback.

Também foram criados procedures professor.exam (criar/listar/publicar provas com 4 tipos de questão: MC/ESSAY/TRUE_FALSE/MIXED). O ExamBuilder completo (editor visual de questões + auto-correção MC/TF) fica como refinamento futuro — o schema Exam.questions é Json flexível e já suporta a estrutura.

✅ Critérios de aceite validados

📁 2. Arquivos criados/modificados

Criados

Modificados

🗄️ 3. Schema do banco (mudanças)

Nenhuma mudança de schema — reutilizado:

• Task (status DRAFT/PUBLISHED/CLOSED, dueDate, maxScore, attachmentUrls Json, instructions)
• TaskSubmission (status PENDING/SUBMITTED/LATE/GRADED, score, feedback, attemptNumber, allowResubmit)
• Exam (type MULTIPLE_CHOICE/ESSAY/TRUE_FALSE/MIXED, questions Json, duration, shuffleQuestions, showResults, availableFrom/Until)
• ClassTeacher (validação de acesso)

🔌 4. Handoff para o próximo card

Procedures tRPC disponíveis (professor.task.*)

• list({status?, classId?}) → { tasks: [{ id, title, status, dueDate, _count.submissions, subject }] }
• detail({taskId}) → { task, submissions[], totalStudents }
• create({title, description?, instructions?, subjectId, dueDate?, maxScore, attachmentUrls[]}) → {id}
• update({taskId, ...}) → {id} (somente se DRAFT)
• publish({taskId}) → {notified} (DRAFT→PUBLISHED + notifica alunos)
• close({taskId}) → {ok} (PUBLISHED→CLOSED)
• grade({submissionId, score, feedback?, allowResubmit?}) → {ok} (status GRADED + notifica aluno)

Procedures (professor.exam.*)

• list({published?}) → { exams[] }
• create({title, type, subjectId, duration?, questions[], ...}) → {id}
• publish({examId}) → {notified}

Defaults adotados (confirmar com cliente — em decisoes.md)

📋 5. Checklist do Trello — status por item

Entregas (5/5)

• Criar tarefa para turma
• Definir prazo e peso
• Receber entregas
• Lançar feedback/nota
• Notificar alunos

Especificação Técnica (20/30 implementados)

Não implementados nesta iteração (refinamento futuro):

• ExamBuilder completo (editor visual de questões MC/TF/ESSAY + alternativas + gabarito) — o procedure exam.create aceita questions[] como Json, falta a UI de montagem
• Auto-correção MC/TF (calcula score automático comparando com gabarito)
• Páginas dedicadas /professor/provas/* (provas são criadas via API; UI fica para quando o ExamBuilder estiver pronto)
• Job Bull de notificação (atualmente notificação síncrona no DB)
• Socket.io live (nova tarefa em tempo real)
• S3 signed URL para anexos (atualmente /api/upload local para DEV)

🚀 6. Deploy DEV

• URL lista: https://sistemaescolar.wellka.com.br/professor/tarefas
• URL criar: https://sistemaescolar.wellka.com.br/professor/tarefas/nova
• Login demo: carla.prof@genioon.com.br / Prof@2026
• Profª Carla: 3 tarefas publicadas (do seed), com 2 entregas para corrigir
• Commit: c9b6ccd
• PM2: genioon-dev reload ✓ (HTTP 307 auth / 200 smoke)

🧠 7. Contexto gerado para próximas etapas

1. professor.task.grade é o procedure canônico de avaliação. Quando integrar correção visual (M1.5 saveVisualCorrection), ambos atualizam TaskSubmission — coordenar campos.
2. allowResubmit na avaliação abre nova tentativa para o aluno (tentativa N+1). Já integrado com o Card 7 (aluno reenvia) e M1.5 (galeria).
3. Notificação de nota (task.grade) usa type: 'SYSTEM_ALERT'. Quando Web Push estiver pronto, disparar push também.
4. ExamBuilder é a próxima Feature grande dentro de M3: editor de questões com 4 tipos + auto-correção. O schema e procedures já suportam; falta a UI.
5. Anexos via /api/upload (FormData → /public/uploads/). Para PROD, migrar para S3 presigned URL.

🎯 8. Próximo card

Card 15 [M3] Plano de Aula & Materiais

• Spec: docs/execucao/15-m3-plano-aula.md
• Foco: professor cria planos de aula (LessonPlan) e sobe materiais didáticos
• Reuso: ProfessorShell, resolveTeacher(), ClassTeacher, upload de anexos