Migration 19 — internship_requests · Sistema de Gestão de Estágios

Contrato

Campo	Regra
`id`	bigint, chave primária.
`affiliation_id`	FK obrigatória para o vínculo discente dono da solicitação.
`course_id`	FK obrigatória fora de `Draft`; o curso deve estar disponível no contexto do vínculo.
`internship_type_id`	FK obrigatória fora de `Draft`; o tipo deve estar ativo e pertencer ao curso selecionado.
`advisor_affiliation_id`	FK nullable enquanto o Setor ainda não atribuiu orientador; obrigatória no aceite.
`granting_party_id`	FK nullable para concedente validada do campus do vínculo discente.
`granting_party_registration_request_id`	FK nullable para solicitação pendente do mesmo campus; é alternativa a `granting_party_id`, nunca texto livre solto.
`supervisor_affiliation_id`	FK nullable para o supervisor já cadastrado.
`supervisor_registration_request_id`	FK nullable para a solicitação pendente de cadastro; é alternativa a `supervisor_affiliation_id`.
`student_year_semester`	string nullable em `Draft`; período/semestre declarado pelo discente e congelado no snapshot no aceite.
`legal_capacity_declaration`	`LegalCapacityDeclaration` nullable em `Draft`; rádio obrigatório no envio: maior, menor ou menor emancipado.
`legal_guardian_name`	texto nullable; obrigatório quando a opção for `minor`.
`legal_guardian_cpf`	`varchar(255)` nullable; obrigatório quando a opção for `minor`, normalizado e validado pelo `CpfCast`.
`legal_guardian_kinship`	`varchar(80)` nullable; obrigatório quando a opção for `minor`.
`legal_guardian_email`	`varchar(255)` nullable; obrigatório quando a opção for `minor`.
`activities`	texto nullable em `Draft`; obrigatório no envio.
`internship_sector`	texto nullable; setor/área de realização, obrigatório se a concedente ou o tipo o exigir.
`weekly_hours`	JSONB nullable em `Draft`; mapa validado com domingo a sábado.
`planned_start_date`	data nullable em `Draft`; obrigatória no envio e usada para calcular o término.
`projected_end_date`	data nullable calculada no servidor; nunca editável pelo discente.
`is_remunerated`	boolean nullable em `Draft`; obrigatório no envio.
`grant_value`	decimal(10,2) nullable; bolsa obrigatória e positiva se remunerado.
`transportation_allowance`	decimal(10,2) nullable; auxílio pode ser zero ou nulo.
`observations`	texto nullable; observações complementares.
`status`	`InternshipRequestStatus`: rascunho, enviada, em análise, com pendência, aceita, recusada ou desistida.
`internship_id`	FK nullable e única para o estágio criado depois do aceite.
`terms_accepted_at`	data e hora do aceite explícito; nulo antes do primeiro envio e atualizado em cada reenvio. Não há coluna de versão, hash ou booleano.
timestamps	auditoria temporal.

Há somente uma solicitação para o processo aberto pelo discente. Ela é atualizada no mesmo registro quando o discente salva ou responde uma pendência; o Livewire pode persistir valores nulos enquanto estiver em Draft. Nos demais estados, todos os campos obrigatórios do caminho condicional escolhido devem estar válidos; campos de ramos não escolhidos continuam nulos. O Model registra criação e alterações no activity_log; com o vínculo ativo como autor em requisições autenticadas; Actions e Policies para o fluxo de análise ainda estão pendentes. Os Models validam que a concedente ou pedido pendente referenciado pertence ao campus do vínculo discente. Não há FK de revisor nesta tabela. Ao ser aceita pela primeira vez, os valores validados criam internships, que preserva student_affiliation_id = affiliation_id, as demais FKs, a jornada inicial e os snapshots históricos próprios. Se a solicitação já possuir internship_id, uma correção aprovada atualiza apenas os campos autorizados do estágio existente, recalcula os derivados e preserva os documentos anteriores no histórico.

Contrato de `weekly_hours`

JSON

{
  "sunday": 0,
  "monday": 4,
  "tuesday": 4,
  "wednesday": 4,
  "thursday": 4,
  "friday": 4,
  "saturday": 0
}

As sete chaves sempre existem quando o formulário é enviado; cada valor é inteiro não negativo em horas. A soma semanal deve ser positiva. Para o tipo selecionado, cada dia deve respeitar internship_types.max_daily_hours e a soma da semana deve respeitar internship_types.max_weekly_hours. Na configuração do tipo, esses limites começam em 6 horas diárias e 30 semanais e podem ser aumentados, nunca reduzidos. projected_end_date deverá ser calculada pelo fluxo a partir desta jornada, da carga exigida do tipo, do calendário nacional, estadual e municipal aplicável ao endereço do local de trabalho e das pausas posteriormente registradas. Por enquanto, o Model exige a data preenchida fora de Draft e valida que ela não antecede o início; o cálculo automático ainda não existe.

Caminhos condicionais de cadastro

Concedente: exatamente uma de granting_party_id ou granting_party_registration_request_id deve ser informada no envio. A concedente ou solicitação deve pertencer ao campus do vínculo discente, conferido no servidor. A segunda aponta para um registro próprio, com documento, endereço, representante, contatos, área, conselho e processo, aguardando análise do Setor. CPF/CNPJ iguais em outro cadastro não autorizam reutilizá-lo entre campi.
Supervisor: exatamente uma de supervisor_affiliation_id ou supervisor_registration_request_id deve ser informada no envio. A segunda preserva nome, CPF, telefone, e-mail, cargo, qualificação, formação e experiência propostos pelo discente até que o Setor crie/associe o vínculo de supervisor. O supervisor completa ou confirma seus dados profissionais atuais em user_personal_data no futuro fluxo do formulário.
Capacidade civil: o rádio oferece adult, minor e emancipated_minor. adult só é válido para quem tiver 18 anos completos na data do envio. minor exige os quatro campos de responsável legal. emancipated_minor dispensará responsável legal e exigirá ao menos uma evidência enviada; o aceite final exigirá evidência aprovada pelo Setor. A Migration 19A já implementa no Model a exigência de anexo no envio e de evidência aprovada no aceite; a análise manual e a autorização ficam para o fluxo. Se a devolução apontar comprovante inválido, o discente cria novo envio ou troca para minor e informa o responsável.
Remuneração: is_remunerated = true exige grant_value; se for false, ambos os valores monetários ficam nulos, salvo decisão posterior que admita auxílio sem bolsa.

As duas solicitações pendentes de cadastro são estruturas de domínio próprias, conforme Cadastros pendentes de supervisor e concedente e D-011; não são JSON genérico nem notificações. As migrations que as criam devem preceder a FK desta tabela. As duas migrations de cadastro pendente já existem no código; esta tabela usa somente FKs para esses caminhos.

Validações do formulário

affiliation_id deve ser o vínculo discente ativo e autorizado;
o curso deve ser elegível para o vínculo;
ao escolher um curso, a interface apresenta apenas seus tipos de estágio ativos: um tipo é selecionado automaticamente quando for único; mais de um exige seleção explícita;
a validação no servidor confirma a relação entre curso e tipo, exige que os limites configurados no tipo sejam de pelo menos 6 horas diárias e 30 semanais e valida a jornada diária e semanal contra esses limites;
a parte concedente deve estar cadastrada antes de ser aceita; o número de processo de credenciamento é opcional e preenche o documento quando aplicável;
a data prevista de término é calculada, e não digitada, a partir do tipo e da jornada.
envio e reenvio exigirão checkbox explícito de ciência na interface; somente a data e hora do aceite serão persistidas em terms_accepted_at.

Checklist

Definir uma solicitação única pertencente ao vínculo discente.
Definir a associação única com o estágio criado após o aceite.
Definir curso, tipo e parte concedente como referências validadas.
Separar o enum de status da solicitação do status de internships.
Mapear todas as colunas do formulário de abertura e seus casts.
Fechar os critérios de validação da parte concedente e do supervisor pendentes.
Especificar as migrations tipadas das solicitações de cadastro pendente antes desta migration.
Definir o histórico privado de evidências e o aceite das normas por data e hora.
Criar migration, Model, factory, relações, índice por vínculo/status e FK única para o estágio.
Criar Policies e fluxos de envio, análise, aceite e reenvio.
Testar no Model a compatibilidade de curso/tipo, os limites de carga horária e os ramos condicionais.
Implementar seleção na interface, cálculo da data projetada e fluxo de análise da evidência de emancipação e autorização por vínculo.