{
  "id": "fase-09-avaliacao-e-conclusao",
  "title": "Fase 09 — Avaliação e conclusão",
  "description": "Checklist de avaliações, notas, requisitos de encerramento e conclusão do estágio.",
  "type": "development-phase",
  "status": "planned",
  "visibility": "public",
  "tags": [
    "sge/desenvolvimento",
    "sge/avaliacao",
    "sge/checklist"
  ],
  "related": [
    "fluxos-principais",
    "migration-18-supervisor-evaluations",
    "backlog-e-decisoes"
  ],
  "sourceRefs": [],
  "authors": [],
  "updated": null,
  "diagram": null,
  "body": "Base: [avaliação e conclusão](doc:fluxos-principais#6-acompanhamento-academico-e-conclusao). O ciclo de resposta, a origem dos pesos e o contrato do formulário fixo estão definidos na [modelagem final da avaliação](doc:migration-18-supervisor-evaluations).\n\nImplemente o cálculo puro das notas e as transições/autorização no backend antes de montar os formulários de avaliação e conclusão.\n\n## Decisão antes do código\n\n- [ ] Definir quando a avaliação do supervisor será liberada.\n- [x] Mapear critérios, escala e regras condicionais do formulário fixo de avaliação.\n- [x] Definir os pesos e valores dos conceitos por tipo de estágio, com congelamento no snapshot do estágio.\n- [x] Reabrir o mesmo formulário quando devolvido e usar como vigente o aprovado mais recente.\n- [x] Definir que o Setor de Estágio aprova ou devolve sem editar a resposta do supervisor.\n- [x] Definir que o Orientador lança as notas de relatório e apresentação.\n- [x] Definir que as três notas já são contribuições na escala dos pesos e que a nota final é sua soma.\n- [x] Registrar a decisão em [D-009](doc:backlog-e-decisoes#d-009-ciclo-e-validade-da-avaliacao-do-supervisor).\n\n## Implementação\n\n- [ ] Registrar a liberação no estágio e notificar o supervisor pelo vínculo e canal permitido.\n- [ ] Permitir autosave Livewire em `Draft`, com campos nulos até o preenchimento completo.\n- [ ] Validar campos obrigatórios e condicionais antes do envio e em estados não `Draft`.\n- [ ] Exibir ao supervisor sua lista de avaliações por estágio, sem exclusão física ou acesso ao Activity Log.\n- [ ] Congelar a resposta após o envio e reabrir o mesmo registro quando houver devolução.\n- [ ] Permitir aprovar ou devolver pelo Setor de Estágio, sem alterar respostas.\n- [ ] Devolver a resposta com motivo quando a carga horária não estiver cumprida e permitir cancelamento auditável pelo supervisor.\n- [ ] Selecionar em transação a avaliação aprovada mais recente.\n- [ ] Calcular nota do supervisor usando snapshot do tipo.\n- [ ] Implementar o lançamento, pelo Orientador, das notas de relatório e apresentação.\n- [ ] Calcular nota consolidada conforme pesos congelados.\n- [ ] Verificar carga horária e requisitos de encerramento.\n- [ ] Manter estágio em andamento enquanto a carga horária integral não estiver confirmada, sem bloqueá-lo por avaliações ou notas pendentes.\n- [ ] Concluir preservando notas, documentos, snapshots e histórico.\n- [ ] Notificar envolvidos sobre a conclusão.\n\n> [!warning] Nota mínima\n> Não há nota mínima de aprovação configurada. Não criar corte acadêmico enquanto essa regra não for informada no tipo de estágio.\n\n## Encerramento do roteiro atual\n\n[Índice das fases de desenvolvimento](doc:fases-de-desenvolvimento)",
  "sections": [
    {
      "id": "decisao-antes-do-codigo",
      "level": 2,
      "title": "Decisão antes do código",
      "text": "- [ ] Definir quando a avaliação do supervisor será liberada. - [x] Mapear critérios, escala e regras condicionais do formulário fixo de avaliação. - [x] Definir os pesos e valores dos conceitos por tipo de estágio, com congelamento no snapshot do estágio. - [x] Reabrir o mesmo formulário quando devolvido e usar como vigente o aprovado mais recente. - [x] Definir que o Setor de Estágio aprova ou devolve sem editar a resposta do supervisor. - [x] Definir que o Orientador lança as notas de relatório e apresentação. - [x] Definir que as três notas já são contribuições na escala dos pesos e que a nota final é sua soma. - [x] Registrar a decisão em [D-009](doc:backlog-e-decisoes#d-009-ciclo-e-validade-da-avaliacao-do-supervisor).",
      "line": 5
    },
    {
      "id": "implementacao",
      "level": 2,
      "title": "Implementação",
      "text": "- [ ] Registrar a liberação no estágio e notificar o supervisor pelo vínculo e canal permitido. - [ ] Permitir autosave Livewire em `Draft`, com campos nulos até o preenchimento completo. - [ ] Validar campos obrigatórios e condicionais antes do envio e em estados não `Draft`. - [ ] Exibir ao supervisor sua lista de avaliações por estágio, sem exclusão física ou acesso ao Activity Log. - [ ] Congelar a resposta após o envio e reabrir o mesmo registro quando houver devolução. - [ ] Permitir aprovar ou devolver pelo Setor de Estágio, sem alterar respostas. - [ ] Devolver a resposta com motivo quando a carga horária não estiver cumprida e permitir cancelamento auditável pelo supervisor. - [ ] Selecionar em transação a avaliação aprovada mais recente. - [ ] Calcular nota do supervisor usando snapshot do tipo. - [ ] Implementar o lançamento, pelo Orientador, das notas de relatório e apresentação. - [ ] Calcular nota consolidada conforme pesos congelados. - [ ] Verificar carga horária e requisitos de encerramento. - [ ] Manter estágio em andamento enquanto a carga horária integral não estiver confirmada, sem bloqueá-lo por avaliações ou notas pendentes. - [ ] Concluir preservando notas, documentos, snapshots e histórico. - [ ] Notificar envolvidos sobre a conclusão.  > [!warning] Nota mínima > Não há nota mínima de aprovação configurada. Não criar corte acadêmico enquanto essa regra não for informada no tipo de estágio.",
      "line": 16
    },
    {
      "id": "encerramento-do-roteiro-atual",
      "level": 2,
      "title": "Encerramento do roteiro atual",
      "text": "[Índice das fases de desenvolvimento](doc:fases-de-desenvolvimento)",
      "line": 37
    }
  ],
  "sourcePath": "content/fase-09-avaliacao-e-conclusao.md",
  "visuals": [],
  "apiVersion": 1
}
