Guia completo do SGE

1. O que é o SGE

O Sistema de Gestão de Estágios (SGE) centraliza a solicitação, a formalização, o acompanhamento e a conclusão de estágios. Ele reduz a dependência de formulários dispersos, e-mails e planilhas, deixando claro o que falta, quem precisa agir e qual informação está válida para cada processo.

O sistema trabalha com uma conta por pessoa e, quando aplicável, com um vínculo institucional. O vínculo informa a atuação da pessoa — por exemplo, discente, orientador ou integrante do Setor de Estágio — e limita o campus, o curso e as ações disponíveis naquele contexto.

2. Como interpretar este guia

No estado atual, login, recuperação de senha, dashboard, seleção e troca de vínculo, configurações próprias de senha/e-mail e o comando admin:create estão disponíveis. O Administrador do Sistema também tem páginas para gerir campi e contas/vínculos administrativos, consultar alterações de auditoria e ver o histórico de e-mails associados a contas e vínculos administrativos, inclusive o conteúdo salvo e as tentativas. Essas consultas exigem o vínculo ativo e selecionado e respeitam escopos próprios; a auditoria exclui estágios, documentos, concedentes e demais registros fora do escopo. O painel global apresenta totais de usuários, vínculos e campi e gráficos textuais por status de estágios, documentos e solicitações. A administração de contas permite editar nome, CPF e e-mail de login, administrar os vínculos administrativos e encerrá-los com os avisos e proteções previstos. A listagem de Usuários mostra contas com vínculo administrativo; o contador do painel considera todas as linhas da tabela users. As jornadas completas de solicitação, documentação, execução, avaliação e conclusão ainda não estão disponíveis. Consulte Fase 03 — Activity Log e Fase 04 — Integração de e-mail.

3. Quem participa

4. Jornada do estágio

O fluxo completo admite correções sem criar outro processo: quando uma solicitação ou avaliação é devolvida, a mesma pessoa corrige e reenvia o mesmo registro. A decisão continua com o Setor de Estágio e o histórico preserva as alterações relevantes.

4.1 Solicitação e análise

O discente inicia a solicitação, pode salvá-la como rascunho e a envia quando os dados obrigatórios estiverem completos. O Setor de Estágio pode aceitar, recusar ou devolver a solicitação com orientação sobre o que precisa ser corrigido.

Antes do aceite, o processo valida os dados do estágio, da parte concedente, do supervisor, do curso, da jornada e, quando aplicável, da capacidade civil e do responsável legal. Um discente pode desistir antes de existir um estágio formalizado.

4.2 Formalização

Depois do aceite, o estágio nasce em formalização. O Setor prepara o documento aplicável, informa onde ele estará disponível para assinatura e seleciona os participantes que precisam ser avisados. A assinatura ocorre fora do SGE e precisa ser conferida antes da liberação.

O SGE registra o processo e suas referências, mas não guarda o arquivo DOCX/PDF final ou o documento assinado. Templates, versões, dados resolvidos e histórico são tratados separadamente para preservar rastreabilidade sem duplicar acervo documental externo.

4.3 Execução, mudanças e encerramento

Após a liberação, o estágio inicia na data planejada. Pausas suspendem o cômputo da carga horária e atualizam a previsão de término; mudanças de jornada exigem aditivo formalizado. Cancelamentos exigem motivo, decisão do Setor e preservação do histórico.

O supervisor preenche a avaliação quando ela for liberada e o orientador registra as notas acadêmicas. A conclusão do estágio depende da confirmação de que a carga horária integral foi cumprida; a data prevista, as avaliações e as notas não concluem o estágio sozinhas.

5. Situações exibidas no processo

Solicitação de estágio

Estágio

Documentos e avaliação

6. Regras de dados, segurança e privacidade

• Cada ação é autorizada pelo vínculo ativo, pelo escopo institucional, pela relação com o registro e pela situação do fluxo.
• Dados sensíveis, como CPF, dados de responsável legal e comprovantes de emancipação, têm acesso restrito e não devem aparecer em avisos gerais, e-mails, documentos gerados ou logs detalhados.
• Alterações relevantes preservam histórico. Dados usados em um estágio podem ser congelados em snapshots para que uma mudança posterior de cadastro não altere o processo já formalizado.
• Recuperação de senha usa o fluxo do Fortify. Tokens, URLs assinadas, senhas e credenciais nunca devem ser preservados em conteúdo, logs ou auditoria.
• Não há confirmação adicional de endereço de e-mail no escopo atual.
• Notificação dentro do sistema e envio de e-mail são trilhas separadas: uma falha de entrega não pode ocultar o aviso no SGE.

7. Estado atual e próximos blocos de trabalho

A sequência é: 00 — preparação; 01 — fundação de dados; 02 — conta e contexto; 03 — Activity Log; 04 — integração de e-mail; 05 — administração; 06 — documentos; 07 — abertura do estágio; 08 — estágio em andamento; e 09 — avaliação e conclusão. As Fases 02–04 têm implementação parcial ou completa, com lacunas específicas descritas em seus checklists; as interfaces de domínio e fluxos operacionais ainda são as próximas entregas.

8. Referência técnica resumida

O projeto atual usa Laravel 13, PHP ^8.3 (ambiente atual: PHP 8.5), Livewire 4, Flux UI, Tailwind CSS, Vite, PostgreSQL, Laravel Fortify, Spatie Activitylog, Spatie Medialibrary, Laravel Scout e Meilisearch. A aplicação já possui autenticação, rotas protegidas, configurações de perfil e segurança, filas, cache, auditoria e infraestrutura de mídia.

A base de Models e migrations do domínio de estágio já existe, assim como Policies para campi e para a administração de contas/vínculos administrativos. Há transporte de e-mail em fila, telas globais de campi e usuários e painel global do Administrador do Sistema. Ainda faltam a interface local, outros cadastros administrativos, autorizações e Actions para várias jornadas, geração documental e comandos agendados do domínio. O projeto já tem comandos Artisan de bootstrap e importação; routes/console.php ainda não agenda tarefas de domínio.

9. Onde aprofundar

• Visão geral — objetivo e escopo do produto.
• Pessoas e responsabilidades — explicação completa dos papéis.
• Fluxos principais — jornada com todos os cenários.
• Ciclos de status — transições e significados detalhados.
• Glossário — termos usados pelo SGE.
• Planejamento — estado dos blocos de trabalho.
• Arquitetura atual — tecnologias, infraestrutura e limites do código existente.