Enum — BrazilianState

Os valores persistidos são as siglas oficiais em maiúsculas. label() apresenta o nome da unidade federativa em português e options() serve diretamente aos campos de seleção.

O model City persiste state como sigla e o expõe como BrazilianState por meio do cast Eloquent. A validação do CitySeeder aceita somente as 27 siglas definidas neste enum.

Para o cálculo do estágio, a UF e a cidade do endereço histórico do local de trabalho definem os feriados estaduais e municipais aplicáveis. O catálogo de cidades é local e carregado pelo CitySeeder; a BrasilAPI/IBGE pode ser usada para gerar ou revisar o arquivo de carga. A consulta opcional de CEP no formulário fica para uma etapa futura e deverá resolver a cidade no catálogo local, preservando sua identidade IBGE. O calendário importado é persistido em holidays.

Checklist

• ✓Criar enum, rótulos, values() e options().
• ✓Cobrir cases, siglas, rótulos e opções com teste unitário.
• ✓Adicionar o cast de UF ao model City.
• ✓Expor a UF de Address pelo relacionamento com City, sem duplicar coluna ou cast.
• Integrar a UF ao cadastro de campus conforme seu contrato.
• ✓Criar o catálogo local de cidades e carregá-lo pelo CitySeeder.
• ✓Criar a tabela, o model e a importação BrasilAPI de feriados nacionais e estaduais; o cadastro municipal permanece pendente.
• Usar o calendário persistido no cálculo da previsão de término.