♻️ Update applicant location preferences - part 1: "I am willing to work in..."

[JoshBeveridge]

✨ Summary

The way we currently ask if you are interested in remote work is by having a "work location" that is called "telework". This isn't good enough, especially because we can't differentiate between "hybrid" and "remote".

✅ Requirements

Your current location (Profile)

• [ ] Add "current country" radio button group to "Your current location" section
• [ ] Only show the required fields for Province, territory or region AND City or town if they are currently living in Canada
• [ ] Update the read-only states on profile, admin view of profile, admin view of candidate

Work location preferences (Profile)

• [ ] Add the "Flexible work location options" checkbox group
• [ ] Migration for populating "Flexible work location options"
• [ ] "Telework" should no longer appear in the "I am willing to work in the..." radio button group
• [ ] "I am willing to work in the..." is renamed to "?"
• [ ] "Please indicate if there is a city that you would like to exclude from a region." text area is renamed to "Location exclusions"
• [ ] Add new descriptive text above "Location options" input and above "Location exclusions" input
• [ ] Update the read-only states on profile, admin view of profile, admin view of candidate

Work location (Find talent)

• [ ] Update copy
• [ ] Migrate "Region" checkbox group to "On-site regions" multiselect
• [ ] Add optional checkbox group "Flexible work location options"
• [ ] Migration for populating "Flexible work location options"
• [ ] Implement New location matching logic
• [ ] Update the read-only state of the request in the "Request information" (summary of filters) section of the Request page

Filters (Candidates table)

• [ ] New "flexible work location options" filter for Candidates table
• [ ] New "On-site location" filter for Candidates table
• [ ] Null state for "On-site location" filter if Hybrid or On-site not selected

Downloads

• [ ] Profile download
• [ ] Application (candidate) download
• [ ] CSV downloads

One time notification

• [ ] One-time in-app notification

Candidate snapshots

• [ ] Bump candidate snapshots to a new version to reflect how candidate location is now stored
• [ ] Ensure when viewing candidate snapshots, component can continue to view old version, while correctly viewing new version

Tests

• [ ] PHPUnit feature tests for changes to candidate search
• [ ] Browser tests for updating location preferences on profile

🔍 Screenshots

📸 Relocation logic


📸 Full form (light and dark modes)


🔍 Talent Search page

📸 Work location section (new)


📸 Work location section (dark mode)


Summary of filters (Static)


🔍 Admin pages

We encounter the location as a read view on User profile and the User application snapshot. We also encounter the location as a filter on several places "Candidates", "Candidate results" when inside a specific request and "Candidates table" in the talent placement tab of a process.

📸 New location filter


Additional details

New location matching logic

City and the exemptions are not validated, so we can only match on Province/territory/region location field and the onsite, hybrid or remote options.

Matching logic pseudocode: job object is the info collected from the Find Talent form candidate object is the info collected on the profile

If (candidate.yesRemote && job.yesRemote) -> match

If (candidate.yesOnsite || (candidate.yesHybrid && job.yesHybrid))
(
     for all job.region (
        for all candidate.regions (
            If (job.region  == candidate.region) -> match
        )
    )
) 

Existing users - Migration for populating Flexible work location options

This is based on the users previous answers to "I am willing to work in the..."

If telework is selected as a region -> Remote should be selected
If telework is selected AND at least 1 other region is selected -> Hybrid should be selected
If at least 1 other region besides telework is selected -> On-site should be selected

Existing talent requests - migration for populating Flexible work location options

If telework is selected as a region -> Remote should be selected If telework is selected AND at least 1 other region is selected -> Hybrid should be selected

Downloadable documents (Profile, Application, CSV)

Sample profile Sample application (candidate) Sample CSV download

Notification

One-time in-app notification. No email notification necessary.

Copy: "We've updated the work location options on your profile. Please review your preferences and ensure they're up to date."

Link: This should link directly to /applicant/personal-information#work-preferences-section

[gobyrne]

Notes from Lauren: Hybrid - Just ask "you are willing to work 2 or more days in the office..." and remove the question asking how many days. 1 day is not an option in any department, so let's not create an expectations gap.

[JoshBeveridge]

@gobyrne

1 day might not be an option in departments, but it is an option for a fully remote employee to request. In my opinion, it's helpful for a manager to know that their fully remote employee is open to hybrid days in the office, even if it's only once a week.

[gobyrne]

We have DISCUSSED

[vd1992]

People might already be living in a location, like the NCR, in which case they would not relocate to NCR as they already live there This would need to be kept in mind for matching by location.

[vd1992]

Need to figure out matching and search page design

[gobyrne]

• Replace the slashes (City or town)(Province, territory or region)

• Do we run a migration to "translate" Province or territory to Province, territory or region?

• Do we run a migration if only "telework" -> Remote Work, else if NOT "telework" -> On-site, else Hybrid?

• Just for simplicity, lets revert the "Relocation details" back to "location exemptions" for the time being. Josh's proposal here is better, but it's not better enough to throw out the old data or run a migration for it imo. Not when we want to do better again the future (#10274)

• Need to update the design on the Talent search page for managers too: I think we can ask about Hybrid and Remote work separately. Then we still kinda need to provide the list of regions again to allow for satellite office locations. Or new UI.

• Then describe search logic for the devs

[gobyrne]

Assuming managers are asked:

• [ ] I cannot offer "full remote"
• [ ] I cannot offer hybrid
• [ ] Office location (Province/territory/region & city)

City and the exemptions are not validated, so we can only match on Province/territory/region location field

Matching logic sudocode:

1. If (candidate.remote && job.remote) -> match
2. If ((candidate.region == job.region) || (candidate.relocation && candidate.relocationregions.contains(job.region) )) -> regionalcompatibility
3. If(regionalcompatibility && ((candidate.onsite && job.onsite) || (candidate.hybrid && job.hybrid)) -> match

[gobyrne]

@Jerryescandon let's discuss

[gobyrne]

@Jerryescandon to look into exclusion region data and leaving it as exclusion vs migrating it to "relocation details". @NienkeBr to update for 3 days hybrid

[gobyrne]

• Gray to describe migration for "telework" and relocation regions

[NienkeBr]

@GCTC-NTGC/designers Re the location preference screenshots currently in the GitHub tickets, I'd rather have the copy say:

1. For the talent search page: Select the flexible work location options available for this position. Flexible work location options
2. For the candidate side: [ ] Remote I am willing to work 100% remote, with no requirements to be in-person at an office. [ ] Hybrid I am willing to work on-site for a minimum of 3 days per week, with the rest being remote. [ ] On-site I am willing to work on-site full-time.

[tristan-orourke]

This is too big right now, will try to refine this into smaller pieces.

[gobyrne]

I can split it when I have some time.

[tristan-orourke]

The main change I was thinking of was making the migration of locations list its own ticket.