REF-80-A: Mapeamento de Enums do Domínio Activity
ADR: ADR-80 Status: Aceito Data: 2026-04-24
Contexto
O domínio activity usa enums técnicos para status de atividades, sessões, submissões e artefatos. Este REF mapeia cada enum ao term canônico correspondente em .vigim/ddd/terms/terms-atividades.yaml.
activity_status
| Enum | Term canônico | Uso |
|---|---|---|
pending |
Pendente | Atividade elegível mas não iniciada |
in_progress |
Em Andamento | Aluno interagindo |
submitted |
Submetida | Enviada, aguardando processamento/correção |
completed |
Concluída | Critério de conclusão satisfeito |
evaluated |
Avaliada | Concluída com nota atribuída (Escrito corrigido) |
exempted |
Dispensada | Dispensada por regra (Dispensa no CDA) |
skipped |
Pulada | Pulo Controlado (Atividade Opcional) |
written_exam_submission_status
| Enum | Term canônico | Uso |
|---|---|---|
received |
Recebida | Upload recebido, aguardando processamento |
processing |
Em Processamento | Sistema processando a submissão |
awaiting_correction |
Aguardando Correção | Processada, disponível para o Tutor |
corrected |
Corrigida | Tutor concluiu a correção |
rejected |
Rejeitada | Problema no upload, reenvio permitido |
flashcard_session_status
| Enum | Term canônico | Uso |
|---|---|---|
created |
Criada | Flashcards montados, sessão pronta |
started |
Iniciada | Aluno praticando |
paused |
Pausada | Sessão interrompida |
completed |
Finalizada | Prática concluída, resultado salvo |
questionnaire_status
| Enum | Term canônico | Uso |
|---|---|---|
created |
Criado | Sessão criada, aguardando início |
started |
Iniciado | Aluno respondendo perguntas |
paused |
Pausado | Sessão interrompida, pode retomar |
completed |
Finalizado | Todas as respostas submetidas |
evaluated |
Avaliado | Resultado processado e classificação feita |
artifact_sync_status
| Enum | Term canônico | Uso |
|---|---|---|
synchronized |
Sincronizado | Artefato coerente com conteúdo de origem |
desynchronized |
Desatualizado | Conteúdo de origem foi alterado após criação |
orphaned |
Órfão | Conteúdo de origem removido |
notebook_artifact_status
| Enum | Term canônico | Uso |
|---|---|---|
original |
Original | Artefato criado, sem edições do Aluno |
edited |
Editado | Aluno modificou o conteúdo |
archived |
Arquivado | Artefato descartado (substituição aceita) |
written_exam_type
| Enum | Term canônico | Uso |
|---|---|---|
essay |
Discursiva | Resposta dissertativa sobre tema |
dissertation |
Dissertação | Texto argumentativo longo |
practical |
Peça Prática | Redação de peça processual jurídica |
written_exam_correction_mode
| Enum | Term canônico | Uso |
|---|---|---|
manual |
Manual | Tutor corrige integralmente |
ai_assist |
Assistida por IA | IA pré-corrige, Tutor revisa e finaliza |
automatic |
Automática | Correção por Espelho de Resposta (sem Tutor) |
notebook_mode
| Enum | Term canônico | Uso |
|---|---|---|
auto_populated |
Auto-populado | Preenchido com conteúdo HÉLICO (Leitura, fallback) |
free |
Livre | Produzido pelo Aluno (Resumo) |
Regras de uso
- Os enums acima são os únicos valores válidos nos contracts JSON do activity
- O código PHP deve usar constantes derivadas destes enums (padrão MIDDAG)
- Novos valores devem ser adicionados primeiro nos terms, depois neste REF, depois nos contracts
- O mapeamento term → enum é 1:1 — não criar aliases