[Feature] Development programs backend

[petertgiles]

🤖 Resolves #12099

👋 Introduction

Adds backend modelling for development programs.

🕵️ Details

🧪 Testing

1. Rebuild app (with migrations, etc)
2. Test using Graphiql - there is no UI yet

Some queries:

Query dev programs

query Communities {
  communities {
    id
    developmentPrograms {
      id
      name {en fr}
      descriptionForProfile {en fr}  
      descriptionForNominations {en fr}  		
      eligibleClassifications {group level}
    }
  }
}

Query my interest in dev programs

query Me {
  me {
    employeeProfile {
      communityInterests {
        id
        community {
          name {
            en
          }
        }
        interestInDevelopmentPrograms {
          id
          developmentProgram {
            name {
              en
            }
          }
          participationStatus
          completionDate
        }
      }
    }
  }
}

CreateCommunityInterest

mutation CreateCommunityInterest($createCommunityInterestInput: CreateCommunityInterestInput!) {
  createCommunityInterest(communityInterest: $createCommunityInterestInput) {
    id
  }
}
#-------------------------------------
{
  "createCommunityInterestInput": {
    "userId": "0b941616-2731-437c-89ac-5e2c63966288",
    "community": {
      "connect": "954d3de1-6fb0-40b6-9fa7-f23e0e79f8ac"
    },
    "interestInDevelopmentPrograms": {
      "create": [
        {
          "developmentProgramId": "0e3faf7e-8e96-46c2-8cc4-0f33b3f4d278"
        }
      ]
    }
  }
}

UpdateCommunityInterest

mutation UpdateCommunityInterest($id: UUID!, $updateCommunityInterestInput: UpdateCommunityInterestInput!) {
  updateCommunityInterest(
    id: $id
    communityInterest: $updateCommunityInterestInput
  ) {
    id
  }
}
#-----------------
{
  "id": "0a2f1017-6307-41f4-82f5-adf44d6d7e50",
  "updateCommunityInterestInput": {
    "interestInDevelopmentPrograms": {
      "create": [
        {
          "developmentProgramId": "8c1bd920-03d5-4aa8-a038-a3bcfcf271ad",
          "participationStatus": "COMPLETED",
          "completionDate": "2025-01-01"
        }
      ]
    }
  }
}

DeleteDevProgramInterest

mutation DeleteDevProgramInterest($id: UUID!, $updateCommunityInterestInput: UpdateCommunityInterestInput!) {
  updateCommunityInterest(
    id: $id
    communityInterest: $updateCommunityInterestInput
  ) {
    id
  }
}
#-------------------------------
{
  "id": "0a2f1017-6307-41f4-82f5-adf44d6d7e50",
  "updateCommunityInterestInput": {
    "interestInDevelopmentPrograms": {
      "delete": [
        "e882d6e5-2d09-44aa-9c1f-a58a9f58b8d6"
      ]
    }
  }
}

📸 Screenshot

🚚 Deployment

[petertgiles]

Unfortunately, it's a bit awkward that we can't validate this member of the input in its own validator. We don't have the community_id at this level and having two validators for the same field doesn't seem to work in Laravel.

[petertgiles]

I've elected to not back-end localize this enum. On the applicant side, the UI uses the first person "I'm..." form of description and I don't see the descriptions on the admin side at all.

[esizer]

LGTM! 👍 Learned some new laravel stuff while reviewing this 🎉

Looks like you just need to update the one test to match the new method args.

gc-digital-talent/api/tests/Feature/CommunityInterestTest.php

Line 53 in 3a7aabd

->withCommunityInterests()

[esizer]

Oh this is cool! I did not know about firstOr.

[esizer]

So simple but so helpful 😛