{
  "id": "migration-09-courses",
  "title": "Migration 09 — courses",
  "description": "Contrato dos cursos por campus e de seus coordenadores.",
  "type": "migration-reference",
  "status": "implemented",
  "visibility": "public",
  "tags": [
    "sge/migrations",
    "sge/cursos",
    "sge/banco-de-dados"
  ],
  "related": [
    "migration-03-campuses",
    "migration-04-affiliations",
    "migration-10-course-id-em-affiliations",
    "migration-11-internship-types"
  ],
  "sourceRefs": [
    "https://github.com/sge-suite/sge/blob/master/database/migrations/2026_09_22_163548_create_courses_table.php",
    "https://github.com/sge-suite/sge/blob/master/app/Models/Course.php",
    "https://github.com/sge-suite/sge/blob/master/database/factories/CourseFactory.php",
    "https://github.com/sge-suite/sge/blob/master/tests/Feature/CourseTest.php"
  ],
  "authors": [],
  "updated": null,
  "diagram": null,
  "body": "> [!success] Estado\n> Migration, Model, factory, relações, validação e testes PostgreSQL implementados. O cadastro e a edição pela interface permanecem na Fase 05.\n\n## Contrato\n\n| Campo | Regra |\n| --- | --- |\n| `id` | `bigint` autoincremental, chave primária. |\n| `campus_id` | `bigint` obrigatório, FK para `campuses.id` com `ON DELETE RESTRICT`. |\n| `name` | Nome obrigatório, `varchar(255)`. |\n| `primary_coordinator_affiliation_id` | `bigint` nullable, FK para `affiliations.id` com `ON DELETE RESTRICT`. |\n| `secondary_coordinator_affiliation_id` | `bigint` nullable, FK para `affiliations.id` com `ON DELETE RESTRICT`. |\n| `deactivated_at` | Timestamp nullable; nulo significa curso ativo. |\n| `created_at`, `updated_at` | Timestamps convencionais do Laravel. |\n\nO curso pode ser criado sem coordenadores, conforme a decisão para cadastro inicial. Quando atribuídos, os dois vínculos devem ser distintos, ativos, do tipo `Coordinator` e do mesmo campus do curso. `Course` valida isso no momento da atribuição, preservando referências históricas se um coordenador for desativado depois. O campus deve estar ativo ao criar, trocar de campus ou reativar o curso. Não há `CHECK` de domínio nem tabela intermediária de coordenação.\n\nO ciclo do catálogo usa `deactivated_at`, sem `SoftDeletes`; FKs impedem exclusão física de campus ou coordenador referenciado. Esta migration não cria índices secundários explícitos; a escolha ficará para uma etapa posterior, com base nas consultas reais. Nomes iguais no mesmo campus não recebem restrição de unicidade nesta migration porque o contrato não distingue modalidades ou ofertas homônimas; eventual regra de catálogo precisará de decisão própria.\n\n## Checklist\n\n- [x] Fixar os nomes `primary_coordinator_affiliation_id` e `secondary_coordinator_affiliation_id`.\n- [x] Criar migration com FKs para `campuses` e `affiliations`.\n- [x] Permitir coordenadores nulos durante o cadastro inicial.\n- [x] Criar Model `Course`, relações e factory.\n- [x] Validar campus, tipo e escopo dos vínculos coordenadores no Model.\n- [x] Testar curso de campus ativo, coordenador de outro campus e vínculo desativado.\n- [x] Testar migrate/rollback na ordem completa.\n\n## Dependências\n\n- [adicionar course_id a affiliations](doc:migration-10-course-id-em-affiliations)\n- [internship_types](doc:migration-11-internship-types)",
  "sections": [
    {
      "id": "contrato",
      "level": 2,
      "title": "Contrato",
      "text": "| Campo | Regra | | --- | --- | | `id` | `bigint` autoincremental, chave primária. | | `campus_id` | `bigint` obrigatório, FK para `campuses.id` com `ON DELETE RESTRICT`. | | `name` | Nome obrigatório, `varchar(255)`. | | `primary_coordinator_affiliation_id` | `bigint` nullable, FK para `affiliations.id` com `ON DELETE RESTRICT`. | | `secondary_coordinator_affiliation_id` | `bigint` nullable, FK para `affiliations.id` com `ON DELETE RESTRICT`. | | `deactivated_at` | Timestamp nullable; nulo significa curso ativo. | | `created_at`, `updated_at` | Timestamps convencionais do Laravel. |  O curso pode ser criado sem coordenadores, conforme a decisão para cadastro inicial. Quando atribuídos, os dois vínculos devem ser distintos, ativos, do tipo `Coordinator` e do mesmo campus do curso. `Course` valida isso no momento da atribuição, preservando referências históricas se um coordenador for desativado depois. O campus deve estar ativo ao criar, trocar de campus ou reativar o curso. Não há `CHECK` de domínio nem tabela intermediária de coordenação.  O ciclo do catálogo usa `deactivated_at`, sem `SoftDeletes`; FKs impedem exclusão física de campus ou coordenador referenciado. Esta migration não cria índices secundários explícitos; a escolha ficará para uma etapa posterior, com base nas consultas reais. Nomes iguais no mesmo campus não recebem restrição de unicidade nesta migration porque o contrato não distingue modalidades ou ofertas homônimas; eventual regra de catálogo precisará de decisão própria.",
      "line": 4
    },
    {
      "id": "checklist",
      "level": 2,
      "title": "Checklist",
      "text": "- [x] Fixar os nomes `primary_coordinator_affiliation_id` e `secondary_coordinator_affiliation_id`. - [x] Criar migration com FKs para `campuses` e `affiliations`. - [x] Permitir coordenadores nulos durante o cadastro inicial. - [x] Criar Model `Course`, relações e factory. - [x] Validar campus, tipo e escopo dos vínculos coordenadores no Model. - [x] Testar curso de campus ativo, coordenador de outro campus e vínculo desativado. - [x] Testar migrate/rollback na ordem completa.",
      "line": 20
    },
    {
      "id": "dependencias",
      "level": 2,
      "title": "Dependências",
      "text": "- [adicionar course_id a affiliations](doc:migration-10-course-id-em-affiliations) - [internship_types](doc:migration-11-internship-types)",
      "line": 30
    }
  ],
  "sourcePath": "content/migration-09-courses.md",
  "visuals": [],
  "apiVersion": 1
}