{
  "id": "migration-02-user-personal-data",
  "title": "Migration 02 — user_personal_data",
  "description": "Dados pessoais e profissionais atuais da pessoa, separados da autenticação.",
  "type": "migration-reference",
  "status": "implemented",
  "visibility": "public",
  "tags": [
    "sge/migrations",
    "sge/banco-de-dados",
    "sge/dados-pessoais"
  ],
  "related": [
    "migration-01-addresses",
    "migration-12a-supervisor-registration-requests",
    "migration-19a-emancipation-evidences",
    "backlog-e-decisoes",
    "modelo-de-dados-acesso",
    "cast-phonecast"
  ],
  "sourceRefs": [
    "https://github.com/sge-suite/sge/blob/master/database/migrations/2026_09_20_085446_create_user_personal_data_table.php",
    "https://github.com/sge-suite/sge/blob/master/app/Models/UserPersonalData.php",
    "https://github.com/sge-suite/sge/blob/master/app/Casts/PhoneCast.php",
    "https://github.com/sge-suite/sge/blob/master/tests/Feature/UserPersonalDataTest.php",
    "https://github.com/sge-suite/sge/blob/master/tests/Unit/PhoneCastTest.php"
  ],
  "authors": [],
  "updated": null,
  "diagram": null,
  "body": "> [!success] Estado\n> Implementada. Depende de `users` (migration base do Laravel) e [`addresses`](doc:migration-01-addresses).\n\n## Contrato\n\n| Campo        | Regra                                                 |\n| ------------ | ----------------------------------------------------- |\n| `id`         | bigint, chave primária.                               |\n| `user_id`    | FK única para `users`; um perfil por conta.           |\n| `rg`         | `varchar(255)`, nullable; exigido para discente quando a regra pedir. |\n| `rg_issuer` | `varchar(255)`, nullable; obrigatório junto ao RG quando exigido. |\n| `rg_issue_date` | `date`, nullable; obrigatório junto ao RG quando exigido. |\n| `birth_date` | nullable; exigida quando a regra pedir.               |\n| `phone`      | `varchar(255)`, nullable, validado e normalizado pelo `PhoneCast` com `celular_com_ddd`; contato atual compartilhado pela conta, exigido para discente no envio da solicitação de estágio. |\n| `job_role`, `qualification` | `varchar(255)` nullable; cargo e qualificação atuais do supervisor. |\n| `training`, `professional_experience` | `text` nullable; formação e experiência profissional atuais do supervisor. |\n| `emancipation_verified_at` | `timestamp(0)` nullable; preenchido somente após validação do Setor de Estágio. |\n| `emancipation_verified_by_affiliation_id` | FK nullable para o vínculo que confirmou a prova; adicionada pela Migration 19A, depois de `affiliations`, para não criar dependência circular. |\n| `address_id` | nullable, FK para `addresses` com exclusão `RESTRICT`. |\n| timestamps   | obrigatórios.                                         |\n\nCPF permanece em `users` como identificador único da conta. O Administrador do Sistema pode corrigir esse dado pela gestão administrativa, com validação e unicidade; a pessoa não altera o CPF nas configurações próprias. Esta tabela guarda um perfil por usuário (`user_id` único), compartilhado entre seus vínculos; não há perfil separado por vínculo. A conta pode existir sem esta linha. A criação do usuário supervisor não exige os dados profissionais: ele os preenche ou confirma no futuro formulário do supervisor. Os campos profissionais ficam nullable para esse cadastro inicial e para usuários que não têm vínculo de supervisor. Dados atuais podem mudar, mas o estágio deve guardar snapshot histórico. A matrícula não pertence a esta tabela: ela é o `registration_number` do vínculo discente em `affiliations`.\n\nA autorização de edição será por tipo de vínculo: dados de RG, nascimento e endereço no contexto discente; cargo, qualificação, formação e experiência no contexto de supervisor. O telefone é contato compartilhado. Essa autorização e o formulário serão implementados no fluxo funcional, não na migration ou no Model de persistência.\n\n`emancipation_verified_at` conserva a decisão positiva já dada pelo Setor; não é um booleano editável pelo discente. A evidência e todo o histórico de envios ficam em [`emancipation_evidences`](doc:migration-19a-emancipation-evidences), não em uma string solta deste perfil. Na abertura, a opção `emancipated_minor` permite enviar o comprovante e dispensar temporariamente o responsável legal, mas cria pendência de análise manual. A cópia fica em área privada e não entra no `activity_log`, no e-mail ou em documentos gerados, conforme [D-018](doc:backlog-e-decisoes#d-018-emancipacao-exige-comprovacao-e-validacao-institucional).\n\n## Checklist\n\n- [x] Criar migration com FK única para `users` e exclusão em cascata.\n- [x] Definir `address_id` com `RESTRICT` para impedir exclusão do endereço ainda referenciado.\n- [x] Criar Model `UserPersonalData` e relação um-para-um em `User`.\n- [x] Criar factory com pessoa completa e pessoa sem dados opcionais.\n- [x] Normalizar e validar telefone pelo [`PhoneCast`](doc:cast-phonecast); validar RG, datas e endereço antes de persistir.\n- [x] Criar testes de unicidade, perfil ausente, FKs, schema, migrate e rollback em PostgreSQL.\n- [x] Acrescentar campos profissionais opcionais do supervisor, compartilhados por usuário, com validação e testes.\n- [x] Manter CPF exclusivamente em `users`, sem alterar cadastro ou autenticação.\n- [ ] Exigir e autorizar os campos pertinentes nos futuros fluxos de discente e supervisor.",
  "sections": [
    {
      "id": "contrato",
      "level": 2,
      "title": "Contrato",
      "text": "| Campo        | Regra                                                 | | ------------ | ----------------------------------------------------- | | `id`         | bigint, chave primária.                               | | `user_id`    | FK única para `users`; um perfil por conta.           | | `rg`         | `varchar(255)`, nullable; exigido para discente quando a regra pedir. | | `rg_issuer` | `varchar(255)`, nullable; obrigatório junto ao RG quando exigido. | | `rg_issue_date` | `date`, nullable; obrigatório junto ao RG quando exigido. | | `birth_date` | nullable; exigida quando a regra pedir.               | | `phone`      | `varchar(255)`, nullable, validado e normalizado pelo `PhoneCast` com `celular_com_ddd`; contato atual compartilhado pela conta, exigido para discente no envio da solicitação de estágio. | | `job_role`, `qualification` | `varchar(255)` nullable; cargo e qualificação atuais do supervisor. | | `training`, `professional_experience` | `text` nullable; formação e experiência profissional atuais do supervisor. | | `emancipation_verified_at` | `timestamp(0)` nullable; preenchido somente após validação do Setor de Estágio. | | `emancipation_verified_by_affiliation_id` | FK nullable para o vínculo que confirmou a prova; adicionada pela Migration 19A, depois de `affiliations`, para não criar dependência circular. | | `address_id` | nullable, FK para `addresses` com exclusão `RESTRICT`. | | timestamps   | obrigatórios.                                         |  CPF permanece em `users` como identificador único da conta. O Administrador do Sistema pode corrigir esse dado pela gestão administrativa, com validação e unicidade; a pessoa não altera o CPF nas configurações próprias. Esta tabela guarda um perfil por usuário (`user_id` único), compartilhado entre seus vínculos; não há perfil separado por vínculo. A conta pode existir sem esta linha. A criação do usuário supervisor não exige os dados profissionais: ele os preenche ou confirma no futuro formulário do supervisor. Os campos profissionais ficam nullable para esse cadastro inicial e para usuários que não têm vínculo de supervisor. Dados atuais podem mudar, mas o estágio deve guardar snapshot histórico. A matrícula não pertence a esta tabela: ela é o `registration_number` do vínculo discente em `affiliations`.  A autorização de edição será por tipo de vínculo: dados de RG, nascimento e endereço no contexto discente; cargo, qualificação, formação e experiência no contexto de supervisor. O telefone é contato compartilhado. Essa autorização e o formulário serão implementados no fluxo funcional, não na migration ou no Model de persistência.  `emancipation_verified_at` conserva a decisão positiva já dada pelo Setor; não é um booleano editável pelo discente. A evidência e todo o histórico de envios ficam em [`emancipation_evidences`](doc:migration-19a-emancipation-evidences), não em uma string solta deste perfil. Na abertura, a opção `emancipated_minor` permite enviar o comprovante e dispensar temporariamente o responsável legal, mas cria pendência de análise manual. A cópia fica em área privada e não entra no `activity_log`, no e-mail ou em documentos gerados, conforme [D-018](doc:backlog-e-decisoes#d-018-emancipacao-exige-comprovacao-e-validacao-institucional).",
      "line": 4
    },
    {
      "id": "checklist",
      "level": 2,
      "title": "Checklist",
      "text": "- [x] Criar migration com FK única para `users` e exclusão em cascata. - [x] Definir `address_id` com `RESTRICT` para impedir exclusão do endereço ainda referenciado. - [x] Criar Model `UserPersonalData` e relação um-para-um em `User`. - [x] Criar factory com pessoa completa e pessoa sem dados opcionais. - [x] Normalizar e validar telefone pelo [`PhoneCast`](doc:cast-phonecast); validar RG, datas e endereço antes de persistir. - [x] Criar testes de unicidade, perfil ausente, FKs, schema, migrate e rollback em PostgreSQL. - [x] Acrescentar campos profissionais opcionais do supervisor, compartilhados por usuário, com validação e testes. - [x] Manter CPF exclusivamente em `users`, sem alterar cadastro ou autenticação. - [ ] Exigir e autorizar os campos pertinentes nos futuros fluxos de discente e supervisor.",
      "line": 28
    }
  ],
  "sourcePath": "content/migration-02-user-personal-data.md",
  "visuals": [],
  "apiVersion": 1
}