Painel de desenvolvimento

Como ler

Este índice é uma fotografia editorial da documentação publicada. Os documentos vinculados continuam sendo a fonte de verdade; os status servem para navegação e acompanhamento, não substituem o contrato técnico.

Como interpretar os status: implemented indica que o artefato já existe no código; a integração com o domínio, as migrations, as Policies e os testes específicos podem continuar pendentes. defined indica contrato aprovado ainda não implementado; planned indica trabalho ainda não iniciado.

Fases

Para a sequência e o andamento atuais, consulte Fases de desenvolvimento.

• Fase 00 — Preparação — completed — Checklist do ambiente, qualidade e fluxo de trabalho do projeto novo.
• Fase 01 — Fundação de dados — completed — Migrations, Models, factories e testes PostgreSQL da base de dados.
• Fase 02 — Conta e contexto — in-progress — Contexto, admin:create, administração de contas/vínculos administrativos, troca própria de senha/e-mail e avisos implementados; edição própria de perfil pessoal pendente.
• Fase 03 — Activity Log — completed — Eventos Eloquent, autoria por vínculo e auditoria dos campos pessoais e profissionais implementados.
• Fase 04 — Integração de e-mail — in-progress — Pipeline em fila e três fluxos de conta integrados; notificações operacionais de domínio e administração de entregas pendentes.
• Fase 05 — Administração hierárquica — in-progress — Gestão global de campi, administração de contas e vínculos e painel global do Administrador do Sistema concluídos; interface local, cursos, tipos e demais operações administrativas pendentes.
• Fase 06 — Documentos — planned — Checklist de templates DOCX, versões, geração e acompanhamento de assinatura.
• Fase 07 — Abertura do estágio — planned — Checklist de criação da solicitação, envio, análise e formalização inicial do estágio.
• Fase 08 — Estágio em andamento — planned — Checklist de pausas, substituições, aditivos, cancelamento e histórico do estágio.
• Fase 09 — Avaliação e conclusão — planned — Checklist de avaliações, notas, requisitos de encerramento e conclusão do estágio.
• Fases de desenvolvimento — in-progress — Índice das fases executáveis do desenvolvimento do SGE.

Enums

• Enum — AffiliationType — implemented — Tipos funcionais permitidos para um vínculo institucional do SGE.
• Enum — BrazilianState — implemented — Unidades federativas usadas em Models e validações de cidades, feriados e pedidos de cadastro.
• Enum — HolidayScope — implemented — Escopo nacional, estadual ou municipal de um feriado.
• Enum — EmailDeliveryAttemptStatus — implemented — Estados usados pelo Job de entrega e pela Action de reprocessamento.
• Enum — EmailMessagePurpose — implemented — Finalidades dos fluxos de notificação, conta criada, novo vínculo e alteração de e-mail já implementados.
• Enum — EmancipationEvidenceStatus — implemented — Cast e validação do Model EmancipationEvidence; upload HTTP e análise ainda pendentes.
• Enum — EvaluationStatus — implemented — Cast e validação do Model SupervisorEvaluation, com schema da Migration 18; fluxo funcional de análise pendente.
• Enum — GeneratedDocumentOrigin — implemented — Origem do documento registrado no processo de estágio.
• Enum — GeneratedDocumentStatus — implemented — Ciclo de vida de cada documento gerado ou registrado no estágio.
• Enum — GeneratedDocumentType — implemented — Tipos de documentos registrados no processo de estágio.
• Enum — InternshipCancellationRequestStatus — implemented — Ciclo do pedido de cancelamento de estágio formalizado; fluxo decisório pendente.
• Enum — InternshipRequestCorrectionStatus — implemented — Ciclo de cada pendência devolvida na solicitação de estágio; fluxo de análise pendente.
• Enum — InternshipRequestStatus — implemented — Ciclo de preenchimento, envio e análise da solicitação nativa de estágio; transições do fluxo pendentes.
• Enum — InternshipStatus — implemented — Cast e validação de status no Model Internship; operações funcionais do ciclo de estágio permanecem pendentes.
• Enum — LegalCapacityDeclaration — implemented — Opção declarada pelo discente para a capacidade civil; interface e análise manual pendentes.
• Enum — PartyDocumentType — implemented — Tipo de documento de identificação da parte concedente.
• Enum — RegistrationRequestStatus — implemented — Ciclo das solicitações de cadastro de supervisor e parte concedente.

Migrations

Sequência física dos arquivos em database/migrations; os números permanecem como identificadores das notas.

• Migration base 01 — users — implemented — Estado atual das tabelas de autenticação, reset de senha e sessões.
• Migration base 02 — cache — implemented — Estado atual das tabelas de cache e locks do Laravel.
• Migration base 03 — jobs — implemented — Estado atual das filas, lotes e falhas de Jobs do Laravel.
• Migration base 04 — activity_log — implemented — Estado atual da auditoria baseada no Spatie Activity Log.
• Migration base 05 — media — implemented — Estado atual do armazenamento de mídia polimórfica do Spatie Media Library.
• Migration 01A — cities — implemented — Catálogo local de cidades identificado pelo código IBGE, carregado pelo CitySeeder antes dos endereços.
• Migration 22 — holidays — implemented — Base persistida de feriados nacional, estadual e municipal, com importação BrasilAPI para nacionais e estaduais.
• Migration 01 — addresses — implemented — Base backend com cidade local, validação dos campos obrigatórios, Activity Log e cópia histórica; consulta e validação de CEP continuam pendentes.
• Migration 02 — user_personal_data — implemented — Dados pessoais e profissionais opcionais por usuário; CPF permanece na conta.
• Migration 03 — campuses — implemented — Tabela de campi; representante legal e cargo permanecem textuais no próprio campus.
• Migration 04 — affiliations — implemented — Schema, Model, validação, factory, relações e Activity Log; contexto de sessão e seleção de vínculo estão implementados na Fase 02.
• Migration 05 — notifications — implemented — Tabela nativa do Laravel para notificações internas.
• Migration 06 — email_messages — implemented — Snapshot imutável da mensagem de e-mail preparada para envio.
• Migration 07 — email_delivery_attempts — implemented — Histórico append-only das tentativas de transporte de e-mails.
• Migration 09 — courses — implemented — Cursos por campus e dois vínculos coordenadores opcionais no cadastro inicial.
• Migration 10 — course_id em affiliations — implemented — Curso obrigatório para vínculo discente por validação do Model.
• Migration 11 — internship_types — implemented — Contrato dos tipos de estágio e suas regras configuráveis.
• Migration 12 — granting_parties — implemented — Contrato das partes concedentes reutilizáveis e seu endereço atual.
• Migration 12A — supervisor_registration_requests — implemented — Solicitações tipadas de cadastro de supervisor feitas durante a abertura.
• Migration 12B — granting_party_registration_requests — implemented — Solicitações tipadas de cadastro de parte concedente feitas durante a abertura.
• Migration 13 — document_templates — implemented — Contrato do catálogo de templates DOCX do SGE.
• Migration 14 — template_versions — in-progress — Versões DOCX privadas, com preservação após uso; validação do upload e integração com geração ainda pendentes.
• Migration 15 — internships — in-progress — Contrato do processo de estágio, referências atuais e snapshots históricos.
• Migration 18 — supervisor_evaluations — implemented — Schema, Model, factory e testes da avaliação do supervisor; fluxo funcional pendente.
• Migration 19 — internship_requests — implemented — Contrato da solicitação única de abertura de estágio preenchida pelo discente.
• Migration 16 — generated_documents — implemented — Contrato dos documentos gerados ou registrados no estágio.
• Migration 17 — internship_pauses — implemented — Contrato das pausas de estágio e sua validação temporal.
• Migration 19A — emancipation_evidences — implemented — Histórico privado das provas de emancipação e sua análise manual.
• Migration 20 — internship_request_corrections — implemented — Pendências operacionais que direcionam a edição da solicitação de estágio.
• Migration 21 — internship_cancellation_requests — implemented — Pedidos rastreáveis de cancelamento de estágio formalizado feitos pelo discente.
• Migration 22A — internship_calendar_overrides — implemented — Exceções de expediente específicas de um estágio.
• Migration 23 — internship_work_schedules — implemented — Jornada semanal pactuada, preservada por vigência somente quando um aditivo formalizado a alterar.

Componentes técnicos

• Action — ResetUserPassword — implemented — Implementação do contrato Fortify para validar e salvar a nova senha.
• Actions — in-progress — Índice das Actions de aplicação que encapsulam operações de negócio.
• Cast — CpfCast — implemented — Cast Eloquent que valida CPF e armazena o documento sem máscara.
• Cast — PhoneCast — implemented — Cast Eloquent que valida telefone fixo/celular com DDD e persiste somente os dígitos.
• Casts — in-progress — Índice dos casts Eloquent que transformam dados entre entrada, domínio e banco.
• Concern — PasswordValidationRules — implemented — Regras compartilhadas para criação/alteração e confirmação de senha.
• Concern — ProfileValidationRules — in-progress — Trait de validação existente; a tela de Segurança usa regras próprias e o trait ainda precisa ser integrado/testado.
• Concern — CityValidationRules — implemented — Regras compartilhadas para código IBGE, nome e UF do catálogo local.
• Concern — HolidayValidationRules — implemented — Regras compartilhadas para data, nome, escopo, UF e cidade dos feriados.
• Concerns — in-progress — Índice dos traits que centralizam regras reutilizáveis de validação.
• Configuração e bootstrap — in-progress — Mapa dos arquivos que inicializam a aplicação e configuram autenticação, locale, filas, cache e rotas.
• Helper — BrazilianAddressHelper — implemented — Formatação de CEP brasileiro para apresentação.
• Helper — BrazilianContactHelper — implemented — Formatação de telefones brasileiros locais, com DDD e com DDI 55.
• Helper — BrazilianDocumentHelper — implemented — Formatação de CPF e CNPJ brasileiros a partir de valores normalizados.
• Helper — CurrencyHelper — implemented — Formatação de valores monetários usando locale e moeda configurados.
• Helper — DateHelper — implemented — Formatação de datas e horários com timezone configurado na aplicação.
• Helper — DigitsHelper — implemented — Normalização de valores para uma sequência de dígitos.
• Helper — Funções globais — implemented — Funções globais carregadas pelo Composer que delegam a helpers de domínio.
• Helper — NumberToWordsHelper — implemented — Conversão determinística de números e valores em reais para texto por extenso.
• Helpers — in-progress — Índice dos helpers de formatação, normalização e apresentação do SGE.
• Model — User — in-progress — Conta autenticável, autoria no Activity Log, recuperação de senha enfileirada, relações e identificação editável pela administração; edição própria do perfil pessoal segue pendente.
• Provider — AppServiceProvider — implemented — Auditoria, integridade de activity_log, proteção Eloquent, locale, timezone e moeda.
• Provider — FortifyServiceProvider — implemented — Configuração atual de Actions, telas e rate limiting de autenticação do Fortify.
• Providers — in-progress — Índice dos Service Providers que configuram autenticação, locale, moeda e comportamento Eloquent.
• Desenvolvimento — Checklist de funcionalidade — maintained — Checklist reutilizável para implementar qualquer funcionalidade ou regra do SGE.
• Schedules — planned — Contrato dos comandos agendados que reconciliam a execução do estágio e vencimentos documentais.
• Service — InternshipEndDateCalculator — planned — Contrato técnico do cálculo reproduzível da previsão de término.
• Service — InternshipGradeCalculator — planned — Contrato técnico das notas de supervisor, relatório, apresentação e resultado consolidado.
• Services — planned — Índice dos serviços de domínio planejados para cálculos, documentos, snapshots e transições.
• Testes existentes — in-progress — Mapa da cobertura de testes já presente no projeto novo e lacunas conhecidas.

Integrações

• E-mails, notificações e entregas — in-progress — Pipeline de e-mail em fila e consulta de mensagens administrativas implementados; notificações de domínio, outros escopos de consulta e retenção pendentes.
• Geração de documentos DOCX e variáveis — defined — Arquitetura da geração DOCX, validação de templates e catálogo canônico de variáveis.

Decisões

• Backlog e decisões — in-progress — Decisões aprovadas e assuntos ainda pendentes no planejamento do SGE.
• Cadastros pendentes de supervisor e concedente — planned — Contrato de dados e análise dos cadastros solicitados durante a abertura de estágio.