Migration 11 — internship_types

Contrato

Os campos escalares substituem a coluna JSONB rules. Eles têm casts declarados no Model, incluindo cast integer para os pesos e cast decimal:1 para os valores configuráveis dos conceitos. EvaluationConcept define os nomes persistidos e seus rótulos em português: a chave histórica excellent aparece como “Ótimo” na interface. O valor de excellent é o próprio supervisor_evaluation_weight e não tem coluna. unsatisfactory tem valor inicial 0, mas permanece configurável por tipo de estágio na coluna unsatisfactory_value. Os limites de jornada e a margem são inteiros.

Regras de negócio em PHP

As regras são aplicadas pela validação Laravel no Model ao salvar. A migration não adiciona constraints CHECK para validar regras de negócio; a validação acontece na aplicação.

• required_hours deve ser inteiro positivo.
• Os três pesos devem ser inteiros positivos e sua soma deve ser exatamente 10. O peso da avaliação do supervisor também define o valor de excellent e o limite superior dos demais conceitos.
• Os quatro conceitos configuráveis devem ser números não negativos com até uma casa decimal. A sequência completa — excellent, very_good, good, satisfactory e unsatisfactory — deve ser estritamente decrescente; valores iguais não são permitidos. Os conceitos configuráveis não podem ultrapassar supervisor_evaluation_weight. unsatisfactory costuma começar em zero, mas cada tipo pode definir outro valor, como 1.0.
• excellent usa diretamente supervisor_evaluation_weight, sem duplicar esse valor em uma coluna.
• max_daily_hours e max_weekly_hours são inteiros. O formulário começa preenchido com 6 e 30; esses valores são limites mínimos, não podem ser reduzidos e podem ser aumentados. A jornada informada deve respeitar os limites configurados para cada dia e para a soma semanal.
• safety_margin_days é inteiro não negativo, inicialmente 7, e será congelado no estágio. O cálculo automático usa essa margem e grava somente a previsão em internships.projected_end_date; não persiste fórmula, versão de algoritmo ou entradas. A regra completa está definida por este contrato e pelo serviço de cálculo de término.

A validação também exige curso ativo na criação, troca de curso ou reativação. Uma desativação posterior do curso não bloqueia a edição de um tipo já existente enquanto sua associação não mudar. active() filtra tipos não desativados; esta migration não cria índices secundários explícitos.

Os pesos e os valores dos conceitos são configurados no tipo de estágio, nunca na resposta da avaliação nem livremente em cada estágio. Na criação do estágio, o snapshot pode agrupar esses valores no contrato histórico internship_type_snapshot.rules, montado a partir das colunas escalares, usando o peso do supervisor para excellent; alterar o tipo depois não pode recalcular históricos já formalizados.

Checklist

• ✓Definir que pesos e valores dos conceitos pertencem ao tipo de estágio.
• ✓Definir campos escalares, precisão dos pesos e conceitos, limites de jornada e margem do cálculo de término.
• ✓Criar migration sem constraints CHECK de regras de negócio e sem índice secundário explícito.
• ✓Criar Model com casts e validação Laravel em PHP.
• ✓Criar factory com regras completas.
• ✓Implementar validação da carga horária obrigatória, dos pesos, conceitos e limites diário e semanal da jornada.
• ✓Testar consulta de tipos por curso/campus e ciclo de desativação.
• Testar snapshot e alteração do tipo após uso no estágio, quando a Migration 15 existir.
• ✓Testar conceitos fora do peso, excellent derivado do peso do supervisor, valores repetidos, ordem inválida, limites menores que 6/30 e margem negativa.
• ✓Testar migrate/rollback das Migrations 15, 11, 10 e 09 na ordem das FKs.