{
  "id": "migration-base-04-activity-log",
  "title": "Migration base 04 — activity_log",
  "description": "Estado atual da auditoria baseada no Spatie Activity Log.",
  "type": "migration-reference",
  "status": "implemented",
  "visibility": "public",
  "tags": [
    "sge/migrations",
    "sge/auditoria",
    "sge/banco-de-dados"
  ],
  "related": [
    "fase-03-activity-log",
    "perfis-e-responsabilidades-por-vinculo"
  ],
  "sourceRefs": [
    "https://github.com/sge-suite/sge/blob/master/database/migrations/2026_08_06_201115_create_activity_log_table.php",
    "https://github.com/sge-suite/sge/blob/master/app/Http/Middleware/SetAuditActor.php",
    "https://github.com/sge-suite/sge/blob/master/app/Support/ActivityAccess.php",
    "https://github.com/sge-suite/sge/blob/master/app/Support/AdministrativeActivityScope.php",
    "https://github.com/sge-suite/sge/blob/master/app/Policies/ActivityPolicy.php",
    "https://github.com/sge-suite/sge/blob/master/tests/Feature/AuditInterfaceTest.php",
    "https://github.com/sge-suite/sge/blob/master/tests/Feature/DatabaseAuditTest.php"
  ],
  "authors": [],
  "updated": null,
  "diagram": null,
  "body": "> [!success] Estado\n> Implementada no arquivo `2026_08_06_201115_create_activity_log_table.php` e usada pelo pacote Spatie Activity Log.\n\n## Contrato atual\n\n| Campo                         | Regra                                          |\n| ----------------------------- | ---------------------------------------------- |\n| `id`                          | bigint, chave primária.                        |\n| `log_name`                    | nullable e indexado.                           |\n| `description`                 | texto obrigatório.                             |\n| `subject_type` / `subject_id` | morph nullable/indexado para entidade afetada. |\n| `event`                       | nullable.                                      |\n| `causer_type` / `causer_id`   | morph nullable/indexado para autor.            |\n| `attribute_changes`           | JSON nullable; alterações de atributos.        |\n| `properties`                  | JSON nullable; contexto adicional.             |\n| timestamps                    | auditoria temporal.                            |\n\n## Cuidados\n\nNão guardar senhas, tokens, URLs assinadas, códigos de verificação, credenciais SMTP ou conteúdo sensível de e-mail em `properties`/`attribute_changes`.\n\n## Consulta e autorização\n\nA tela de auditoria usa Policy e revalida o vínculo ativo selecionado a cada requisição. No estado atual, somente o Administrador do Sistema pode consultá-la. O escopo inclui alterações em campi, contas com vínculos administrativos e vínculos de Administrador do Sistema ou Administrador do Campus. Estágios, documentos, concedentes e outros vínculos ficam fora. O histórico de e-mails usa tabelas próprias e autorização separada.\n\n## Rollback atual\n\nO arquivo não define `down()`. Isso deve ser tratado como limitação/documentação explícita: rollback automático não está disponível para esta migration.\n\n## Checklist\n\n- [x] Criar tabela e morphs de sujeito/causador.\n- [x] Criar JSON de alterações/propriedades.\n- [ ] Decidir se a migration deve ganhar `down()` antes de ser usada em produção.\n- [x] Definir e implementar eventos Eloquent para entidades de negócio, incluindo campos cadastrais de e-mail; tabelas de entrega mantêm histórico técnico próprio.\n- [x] Implementar consulta do histórico administrativo com Policy e vínculo ativo selecionado.\n- [ ] Definir limites de consulta para os demais perfis e retenção institucional.\n- [x] Testar a exclusão de senhas, hashes, tokens e outros dados protegidos dos valores registrados.\n- [x] Relacionar ações humanas ao vínculo ativo; identificar `admin:create` como `terminal` e Jobs/seeders/comandos sem pessoa autenticada como `system`.\n- [ ] Completar registro de todos os campos de negócio de `UserPersonalData`; hoje somente `emancipation_verified_at` é incluído.",
  "sections": [
    {
      "id": "contrato-atual",
      "level": 2,
      "title": "Contrato atual",
      "text": "| Campo                         | Regra                                          | | ----------------------------- | ---------------------------------------------- | | `id`                          | bigint, chave primária.                        | | `log_name`                    | nullable e indexado.                           | | `description`                 | texto obrigatório.                             | | `subject_type` / `subject_id` | morph nullable/indexado para entidade afetada. | | `event`                       | nullable.                                      | | `causer_type` / `causer_id`   | morph nullable/indexado para autor.            | | `attribute_changes`           | JSON nullable; alterações de atributos.        | | `properties`                  | JSON nullable; contexto adicional.             | | timestamps                    | auditoria temporal.                            |",
      "line": 4
    },
    {
      "id": "cuidados",
      "level": 2,
      "title": "Cuidados",
      "text": "Não guardar senhas, tokens, URLs assinadas, códigos de verificação, credenciais SMTP ou conteúdo sensível de e-mail em `properties`/`attribute_changes`.",
      "line": 18
    },
    {
      "id": "consulta-e-autorizacao",
      "level": 2,
      "title": "Consulta e autorização",
      "text": "A tela de auditoria usa Policy e revalida o vínculo ativo selecionado a cada requisição. No estado atual, somente o Administrador do Sistema pode consultá-la. O escopo inclui alterações em campi, contas com vínculos administrativos e vínculos de Administrador do Sistema ou Administrador do Campus. Estágios, documentos, concedentes e outros vínculos ficam fora. O histórico de e-mails usa tabelas próprias e autorização separada.",
      "line": 22
    },
    {
      "id": "rollback-atual",
      "level": 2,
      "title": "Rollback atual",
      "text": "O arquivo não define `down()`. Isso deve ser tratado como limitação/documentação explícita: rollback automático não está disponível para esta migration.",
      "line": 26
    },
    {
      "id": "checklist",
      "level": 2,
      "title": "Checklist",
      "text": "- [x] Criar tabela e morphs de sujeito/causador. - [x] Criar JSON de alterações/propriedades. - [ ] Decidir se a migration deve ganhar `down()` antes de ser usada em produção. - [x] Definir e implementar eventos Eloquent para entidades de negócio, incluindo campos cadastrais de e-mail; tabelas de entrega mantêm histórico técnico próprio. - [x] Implementar consulta do histórico administrativo com Policy e vínculo ativo selecionado. - [ ] Definir limites de consulta para os demais perfis e retenção institucional. - [x] Testar a exclusão de senhas, hashes, tokens e outros dados protegidos dos valores registrados. - [x] Relacionar ações humanas ao vínculo ativo; identificar `admin:create` como `terminal` e Jobs/seeders/comandos sem pessoa autenticada como `system`. - [ ] Completar registro de todos os campos de negócio de `UserPersonalData`; hoje somente `emancipation_verified_at` é incluído.",
      "line": 30
    }
  ],
  "sourcePath": "content/migration-base-04-activity-log.md",
  "visuals": [],
  "apiVersion": 1
}