data-model · in-progress
Modelo de dados — Núcleo
Relações centrais entre cadastros, solicitações, estágios, documentos e avaliações.
Identidade, cidades, endereços e cadastros
Diagram Design · Mermaid · arraste para mover · Ctrl/⌘ + scroll para zoom
Renderizando diagrama declarativo…
Leitura semântica
A conta possui dados pessoais e vínculos; cidades são catalogadas pelo código IBGE, endereços apontam para elas e cadastros mantêm endereços atuais.
diagrams/sources/modelo-nucleo-identidade.mmd| Entidade | Responsabilidade |
|---|---|
users | identidade autenticada e credenciais |
user_personal_data | Dados pessoais atuais e dados profissionais opcionais do supervisor, compartilhados por usuário; CPF permanece em users |
cities | catálogo local de municípios por código IBGE e UF |
addresses | endereços atuais e cópias históricas usadas por estágios |
affiliations | função institucional, campus e e-mail contextual; a Migration 10 adiciona course_id obrigatório para vínculos de discente |
campuses e courses | escopo acadêmico e administrativo |
internship_types | regras de carga, notas e exceções aplicáveis ao curso |
granting_parties | cadastro atual da concedente, vinculado a um campus; CPF/CNPJ podem se repetir e os dados locais não são compartilhados |
Uma pessoa possui uma conta e quantos vínculos forem necessários. O vínculo ativo, e não a conta isolada, define o contexto usado por Gates e Policies.
Da solicitação ao estágio
Diagram Design · Mermaid · arraste para mover · Ctrl/⌘ + scroll para zoom
Renderizando diagrama declarativo…
Leitura semântica
A solicitação é enviada por um vínculo discente, referencia curso, tipo e concedente, e mantém o estado que conduz à formalização.
diagrams/sources/modelo-nucleo-solicitacao.mmd- Existe uma solicitação por processo iniciado pelo discente; devoluções editam o mesmo registro.
- Evidências de emancipação são registros privados, analisados manualmente pelo Setor.
- O estágio nasce apenas após o aceite da solicitação e preserva FKs e snapshots dos dados aprovados.
- Correções posteriores atualizam somente os campos autorizados e não apagam documentos ou estados anteriores.
Execução, formalização e conclusão
Diagram Design · Mermaid · arraste para mover · Ctrl/⌘ + scroll para zoom
Renderizando diagrama declarativo…
Leitura semântica
O estágio usa os feriados nacionais, estaduais e municipais aplicáveis ao endereço do local de trabalho, possui jornadas, pausas e exceções e pode receber um pedido de cancelamento; a avaliação é detalhada no contrato próprio.
diagrams/sources/modelo-nucleo-execucao.mmd| Conjunto | Regra central |
|---|---|
| jornadas, pausas, calendário e exceções | determinam a previsão reproduzível de término |
| templates e versões | preservam o modelo usado em cada geração |
| documentos | mantêm origem, versão, estado e snapshot; o arquivo final é temporário |
| avaliação do supervisor | reutiliza o mesmo formulário em Draft ou Returned |
| notas | supervisor é calculada; relatório e apresentação são lançadas pelo orientador |
| cancelamento | exige pedido e decisão do Setor, preservando o histórico |
Regras de integridade
- Dados atuais relacionam-se por FK; valores usados em um processo histórico são congelados em snapshots.
- A jornada é pactuada na abertura; outra vigência só pode nascer de aditivo com assinaturas conferidas e não reescreve dias já cumpridos.
- Templates usados não são alterados; uma mudança cria nova versão.
SubmittedeApprovedbloqueiam a avaliação;Returnedreabre o mesmo registro.- O Activity Log registra alterações relevantes, mas não substitui tabelas de domínio.