# Work Permit Hub: potential-worker coverage and autofill compatibility ## Outcome Reference: https://jurislocator-work-permit-command-centre.barakatbrigitte.chatgpt.site/ (`app.js`, workerQuestionnaire). Audit date: 2026-10-27. Reviewed all **94 reference fields** against the existing Work Permit Hub, Master Entry Level and IMM1295/IMM5710 questionnaire definitions. Added **34 optional English/French assessment questions in four appended sections**. Original five sections and all 294 original question definitions are unchanged; Hub now has nine sections / 328 questions. The original section contract is pinned in `WorkPermitAssessmentSupplementTest`. The earlier proposed list was refined: actual physical location today is separate from country of residence; do not duplicate CSQ document details, support-letter document details, or generic PR plans. Pending federal PR follow-up collects only AOR/current-stage evidence and identifies the existing application record. Existing Master education, language tests, employment history/gaps, funds, family/custody, admissibility and confirmation records remain authoritative. This is combined Hub + Master coverage, not a claim that the Hub is standalone. Master records must be collected/reviewed through the existing workflow if absent. Cross-bank automatic answer copying/visibility was not introduced. Existing Master privacy consent is reused within its existing scope; the supplement does not create a new permission for third-party verification. ## Added questions All new source keys are in assessment-only namespaces, remain optional, and have no new profile, IMM form or Work Permit fact mappings. Current-permit LMIA history is separate from the proposed application's LMIA. A maintained-status claim is not automatically accepted as eligibility. Historical biometrics/medical details include earlier applications and do not require the current-application completion flags to be true. Quebec/PR assessment questions are not restricted to a current Quebec job location. ### Work permit assessment — Status and history evidence (9) - `work_permit_hub.assessment_status.current_permit_lmia` — Was your current Canadian work permit issued following a positive LMIA? Visible only when all parents answer Yes: `tr_currently_in_canada`. - `work_permit_hub.assessment_status.employment_ended` — Has the employment named on your Canadian work permit ended or been interrupted? Visible only when all parents answer Yes: `tr_currently_in_canada`. - `work_permit_hub.assessment_status.employment_end_details` — What was the exact employment end or interruption date, reason and available evidence? Visible only when all parents answer Yes: `tr_currently_in_canada, employment_ended`. - `work_permit_hub.assessment_status.extension_before_expiry` — Did you submit an extension or change-of-conditions application before your previous status expired? Visible only when all parents answer Yes: `tr_currently_in_canada`. - `work_permit_hub.assessment_status.maintained_status_claim` — Are you claiming maintained status in Canada? Visible only when all parents answer Yes: `tr_currently_in_canada`. - `work_permit_hub.assessment_status.maintained_status_evidence` — What submission evidence supports your maintained-status claim, and which permit conditions do you continue to follow? Visible only when all parents answer Yes: `tr_currently_in_canada, maintained_status_claim`. - `work_permit_hub.assessment_status.biometrics_history_details` — If you previously provided Canadian biometrics, when and where were they collected? - `work_permit_hub.assessment_status.medical_history_details` — If you previously had a Canadian immigration medical examination, give the date and panel physician. - `work_permit_hub.assessment_status.physical_country_today` — In which country are you physically located today? Actual location is separate from residence and application-country records. ### Work permit assessment — Qualifications and employment evidence (11) - `work_permit_hub.assessment_evidence.quebec_recognition_started` — Have you started qualification recognition, equivalency or professional registration in Quebec? - `work_permit_hub.assessment_evidence.quebec_recognition_details` — Give the Quebec authority, file number, completed steps and outstanding recognition requirements. Visible only when all parents answer Yes: `quebec_recognition_started`. - `work_permit_hub.assessment_evidence.specialized_skills` — Which technical skills, equipment, software, processes or methods relevant to the proposed job have you mastered? - `work_permit_hub.assessment_evidence.cv_ready` — Is your detailed chronological CV available? - `work_permit_hub.assessment_evidence.credential_docs_ready` — Are your diplomas, transcripts and certificates available with translations where needed? - `work_permit_hub.assessment_evidence.employment_letters_available` — Can you obtain detailed employment letters showing duties, dates, hours and salary? - `work_permit_hub.assessment_evidence.pay_evidence` — Which pay slips, bank transfers, tax or social-insurance records can support your employment? - `work_permit_hub.assessment_evidence.skills_assessed` — Has the Canadian employer assessed your skills for the proposed job? Visible only when all parents answer Yes: `worker_has_job_offer`. - `work_permit_hub.assessment_evidence.skills_assessment_details` — Give the employer skills-assessment method, date and result. Visible only when all parents answer Yes: `worker_has_job_offer, skills_assessed`. - `work_permit_hub.assessment_evidence.employer_relationship` — Do you have a family, financial or business relationship with the Canadian employer or its directors? Visible only when all parents answer Yes: `worker_has_job_offer`. - `work_permit_hub.assessment_evidence.employer_relationship_details` — Describe the relationship with the Canadian employer or its directors. Visible only when all parents answer Yes: `worker_has_job_offer, employer_relationship`. ### Work permit assessment — Quebec selection and permanent residence (11) - `work_permit_hub.assessment_pr.current_csq` — Do you currently hold a Quebec Selection Certificate (CSQ)? - `work_permit_hub.assessment_pr.federal_pr_pending` — Do you currently have a pending federal permanent-residence application? - `work_permit_hub.assessment_pr.federal_pr_aor_details` — What is the acknowledgement-of-receipt (AOR) and current processing stage of your pending federal PR application? Visible only when all parents answer Yes: `federal_pr_pending`. - `work_permit_hub.assessment_pr.arrima_declaration` — Have you submitted an expression of interest in Arrima? - `work_permit_hub.assessment_pr.pstq_invitation` — Have you received an invitation under the Skilled Worker Selection Program (PSTQ)? - `work_permit_hub.assessment_pr.pstq_invitation_accepted` — Have you accepted your PSTQ invitation? Visible only when all parents answer Yes: `pstq_invitation`. - `work_permit_hub.assessment_pr.pstq_dsp_submitted` — After accepting the invitation, have you submitted your permanent selection application (DSP)? Visible only when all parents answer Yes: `pstq_invitation, pstq_invitation_accepted`. - `work_permit_hub.assessment_pr.pstq_dsp_details` — Give the DSP submission date, reference number, proof and whether you are the principal applicant. Visible only when all parents answer Yes: `pstq_invitation, pstq_invitation_accepted, pstq_dsp_submitted`. - `work_permit_hub.assessment_pr.support_letter` — Have you received a provincial or federal letter that may support a work-permit application? - `work_permit_hub.assessment_pr.previous_selection_work_permit` — Have you previously applied for or obtained a work permit based on a CSQ, nomination or PR application? - `work_permit_hub.assessment_pr.previous_selection_work_permit_details` — Which previous work-permit application relied on a CSQ, nomination or PR application, and on what basis? Visible only when all parents answer Yes: `previous_selection_work_permit`. ### Work permit assessment — Documents and third-party history (3) - `work_permit_hub.assessment_readiness.representative_document_history` — Has a representative, recruiter or employer prepared an application for you or kept your documents? - `work_permit_hub.assessment_readiness.representative_document_details` — Give their name, role, contact details, fees and the documents or applications concerned. Visible only when all parents answer Yes: `representative_document_history`. - `work_permit_hub.assessment_readiness.documents_ready` — Are your passport, permits, decisions, CV, credentials and employment evidence ready to send? Identify missing items. ## Reference-field coverage (94/94) `Existing` means no duplicate question was added. `Supplement` means new assessment detail was needed; related underlying documents may remain in Master. A reference field can map to multiple existing/new questions and vice versa. | Reference field | Decision | Existing/new source keys | Reason | |---|---|---|---| | `family_name` | Existing | `master_entry_level.B01` | Existing Hub/Master content; no duplicate question added. | | `given_names` | Existing | `master_entry_level.B02` | Existing Hub/Master content; no duplicate question added. | | `other_names` | Existing | `master_entry_level.B03`, `master_entry_level.B04` | Existing Hub/Master content; no duplicate question added. | | `birth_date` | Existing | `master_entry_level.B05` | Existing Hub/Master content; no duplicate question added. | | `birth_place` | Existing | `master_entry_level.B06` | Existing Hub/Master content; no duplicate question added. | | `citizenships` | Existing | `master_entry_level.B08` | Existing Hub/Master content; no duplicate question added. | | `marital_status` | Existing | `master_entry_level.C01` | Existing Hub/Master content; no duplicate question added. | | `email` | Existing | `master_entry_level.B13` | Existing Hub/Master content; no duplicate question added. | | `phone` | Existing | `master_entry_level.B14` | Existing Hub/Master content; no duplicate question added. | | `residential_address` | Existing | `master_entry_level.B10` | Existing Hub/Master content; no duplicate question added. | | `passport_number` | Existing | `master_entry_level.B20` | Existing Hub/Master content; no duplicate question added. | | `passport_country` | Existing | `master_entry_level.B20` | Existing Hub/Master content; no duplicate question added. | | `passport_issue` | Existing | `master_entry_level.B20` | Existing Hub/Master content; no duplicate question added. | | `passport_expiry` | Existing | `master_entry_level.B20` | Existing Hub/Master content; no duplicate question added. | | `other_passports` | Existing | `master_entry_level.B20`, `master_entry_level.B39` | Existing Hub/Master content; no duplicate question added. | | `current_country` | Supplement | `work_permit_hub.assessment_status.physical_country_today` | Physical location today can differ from residence or application country; do not overwrite either existing record. | | `in_canada` | Existing | `work_permit_hub.tr_core.tr_currently_in_canada` | Existing Hub/Master content; no duplicate question added. | | `canada_entry_date` | Existing | `master_entry_level.D01`, `work_permit_hub.imm5710.latest_entry` | Existing Hub/Master content; no duplicate question added. | | `current_status` | Existing | `work_permit_hub.tr_core.tr_current_status` | Existing Hub/Master content; no duplicate question added. | | `permit_type` | Existing | `master_entry_level.D02` | The current-document record captures document type, conditions, employer and uploaded permit; do not confuse current permit conditions with proposed job conditions. | | `permit_expiry` | Existing | `work_permit_hub.tr_core.tr_status_expiry_date` | Existing Hub/Master content; no duplicate question added. | | `permit_employer` | Existing | `work_permit_hub.worker.worker_current_employer_name`, `master_entry_level.D02` | Existing Hub/Master content; no duplicate question added. | | `permit_occupation` | Existing | `master_entry_level.D02` | The current-document record captures document type, conditions, employer and uploaded permit; do not confuse current permit conditions with proposed job conditions. | | `permit_lmia` | Supplement | `work_permit_hub.assessment_status.current_permit_lmia` | Asks about the CURRENT permit; existing worker_lmia_* questions concern the proposed application. | | `employment_ended` | Supplement | `work_permit_hub.assessment_status.employment_ended` | Missing assessment detail; separate from IMM autofill answers. | | `end_date_reason` | Supplement | `work_permit_hub.assessment_status.employment_end_details` | Missing assessment detail; separate from IMM autofill answers. | | `extension_filed` | Supplement | `work_permit_hub.assessment_status.extension_before_expiry` | Adds the before-expiry relationship; pending application dates/receipts remain in Master D03/D04. | | `maintained_status` | Supplement | `work_permit_hub.assessment_status.maintained_status_claim`, `work_permit_hub.assessment_status.maintained_status_evidence` | A claim is not an eligibility conclusion; do not automatically infer it from an extension filing. | | `restoration` | Existing | `work_permit_hub.tr_core.tr_status_expired`, `work_permit_hub.tr_core.tr_applied_for_restoration` | Existing Hub/Master content; no duplicate question added. | | `uci` | Existing | `master_entry_level.B19`, `work_permit_hub.imm5710.uci` | Existing Hub/Master content; no duplicate question added. | | `canada_applications` | Existing | `master_entry_level.D07`, `master_entry_level.D08` | Existing Hub/Master content; no duplicate question added. | | `canada_refusal` | Existing | `master_entry_level.D08`, `master_entry_level.D09`, `master_entry_level.D10` | Master application history includes returned/withdrawn outcomes, reasons and documents; IMM refusal questions remain unchanged. | | `refusal_details` | Existing | `master_entry_level.D08`, `master_entry_level.D09`, `master_entry_level.D10` | Master application history includes returned/withdrawn outcomes, reasons and documents; IMM refusal questions remain unchanged. | | `overstay` | Existing | `master_entry_level.I03`, `master_entry_level.I12` | Existing Hub/Master content; no duplicate question added. | | `overstay_details` | Existing | `master_entry_level.I03`, `master_entry_level.I12` | Existing Hub/Master content; no duplicate question added. | | `entry_refusal` | Existing | `master_entry_level.I04`, `master_entry_level.I12`, `master_entry_level.D23`, `master_entry_level.D24` | Existing Hub/Master content; no duplicate question added. | | `entry_refusal_details` | Existing | `master_entry_level.I04`, `master_entry_level.I12`, `master_entry_level.D23`, `master_entry_level.D24` | Existing Hub/Master content; no duplicate question added. | | `misrepresentation` | Existing | `master_entry_level.I05`, `master_entry_level.I12`, `master_entry_level.D31`, `master_entry_level.D32` | Existing Hub/Master content; no duplicate question added. | | `biometrics` | Supplement | `work_permit_hub.assessment_status.biometrics_history_details` | Optional historical date/place narrative; current-application biometrics questions and Master B32 identifiers remain unchanged. | | `biometrics_date` | Supplement | `work_permit_hub.assessment_status.biometrics_history_details` | Optional historical date/place narrative; current-application biometrics questions and Master B32 identifiers remain unchanged. | | `medical` | Supplement | `work_permit_hub.assessment_status.medical_history_details` | Optional historical date/physician narrative referencing existing IME documents; not gated by completion of an exam for this application. | | `medical_date` | Supplement | `work_permit_hub.assessment_status.medical_history_details` | Optional historical date/physician narrative referencing existing IME documents; not gated by completion of an exam for this application. | | `highest_education` | Existing | `master_entry_level.E01`, `master_entry_level.E02` | Existing Hub/Master content; no duplicate question added. | | `education_list` | Existing | `master_entry_level.E01`, `master_entry_level.E02` | Existing Hub/Master content; no duplicate question added. | | `licences` | Existing | `work_permit_hub.worker.worker_professional_licenses`, `work_permit_hub.worker.worker_license_details`, `master_entry_level.G09` | Existing Hub/Master content; no duplicate question added. | | `quebec_recognition` | Supplement | `work_permit_hub.assessment_evidence.quebec_recognition_started` | Missing assessment detail; separate from IMM autofill answers. | | `quebec_recognition_details` | Supplement | `work_permit_hub.assessment_evidence.quebec_recognition_details` | Adds actual Quebec recognition progress/file/stages; existing licence and generic licensing-plan records are not rewritten. | | `languages` | Existing | `master_entry_level.F01`, `master_entry_level.F02` | Existing Hub/Master content; no duplicate question added. | | `language_tests` | Existing | `master_entry_level.F03`, `master_entry_level.F04` | Existing Hub/Master content; no duplicate question added. | | `specialized_skills` | Supplement | `work_permit_hub.assessment_evidence.specialized_skills` | Missing assessment detail; separate from IMM autofill answers. | | `cv_ready` | Supplement | `work_permit_hub.assessment_evidence.cv_ready` | Missing assessment detail; separate from IMM autofill answers. | | `credential_docs` | Supplement | `work_permit_hub.assessment_evidence.credential_docs_ready` | Missing assessment detail; separate from IMM autofill answers. | | `current_job` | Existing | `master_entry_level.G01`, `master_entry_level.G02` | Master employment record already includes employer, country, title, dates, hours, salary and duties. | | `work_history` | Existing | `work_permit_hub.imm1295.employment_history`, `work_permit_hub.imm5710.employment_history`, `master_entry_level.D12`, `master_entry_level.G02` | Existing Hub/Master content; no duplicate question added. | | `related_years` | Existing | `work_permit_hub.worker.worker_years_experience_in_occupation` | Existing Hub/Master content; no duplicate question added. | | `related_duties` | Existing | `work_permit_hub.worker.worker_relevant_work_experience`, `master_entry_level.G02` | Existing Hub/Master content; no duplicate question added. | | `employment_letters` | Supplement | `work_permit_hub.assessment_evidence.employment_letters_available` | Missing assessment detail; separate from IMM autofill answers. | | `pay_proof` | Supplement | `work_permit_hub.assessment_evidence.pay_evidence` | Missing assessment detail; separate from IMM autofill answers. | | `employment_gaps` | Existing | `master_entry_level.G15`, `master_entry_level.G16` | Existing Hub/Master content; no duplicate question added. | | `skills_assessment` | Supplement | `work_permit_hub.assessment_evidence.skills_assessed`, `work_permit_hub.assessment_evidence.skills_assessment_details` | Missing assessment detail; separate from IMM autofill answers. | | `relationship_employer` | Supplement | `work_permit_hub.assessment_evidence.employer_relationship` | Missing assessment detail; separate from IMM autofill answers. | | `relationship_details` | Supplement | `work_permit_hub.assessment_evidence.employer_relationship_details` | Missing assessment detail; separate from IMM autofill answers. | | `criminal` | Existing | `work_permit_hub.imm1295.background_criminal`, `work_permit_hub.imm1295.background_criminal_details`, `master_entry_level.I12` | Existing Hub/Master content; no duplicate question added. | | `criminal_details` | Existing | `work_permit_hub.imm1295.background_criminal`, `work_permit_hub.imm1295.background_criminal_details`, `master_entry_level.I12` | Existing Hub/Master content; no duplicate question added. | | `military` | Existing | `work_permit_hub.imm1295.background_military`, `master_entry_level.I12`, `master_entry_level.I38` | Existing Hub/Master content; no duplicate question added. | | `military_details` | Existing | `work_permit_hub.imm1295.background_military`, `master_entry_level.I12`, `master_entry_level.I38` | Existing Hub/Master content; no duplicate question added. | | `organizations` | Existing | `work_permit_hub.imm1295.background_organization`, `master_entry_level.I09`, `master_entry_level.I12` | Existing Hub/Master content; no duplicate question added. | | `organizations_details` | Existing | `work_permit_hub.imm1295.background_organization`, `master_entry_level.I09`, `master_entry_level.I12` | Existing Hub/Master content; no duplicate question added. | | `violence` | Existing | `work_permit_hub.imm1295.background_ill_treatment`, `work_permit_hub.imm5710.background.ill_treatment` | Existing Hub/Master content; no duplicate question added. | | `medical_condition` | Existing | `work_permit_hub.imm1295.background_health`, `work_permit_hub.imm5710.background.medical_condition` | Existing Hub/Master content; no duplicate question added. | | `admissibility_notes` | Existing | `master_entry_level.I11`, `master_entry_level.I12` | Existing Hub/Master content; no duplicate question added. | | `csq` | Supplement | `work_permit_hub.assessment_pr.current_csq` | Distinguishes a CURRENT CSQ from generic prior selection history. CSQ is not CAQ. | | `csq_details` | Existing | `master_entry_level.H10` | Existing selection-document record contains category/program, reference, date and upload; no duplicate CSQ details block. | | `federal_pr` | Supplement | `work_permit_hub.assessment_pr.federal_pr_pending` | Adds whether there is a CURRENT pending federal PR application; Master D08/D27/D28 retain application history. | | `federal_pr_details` | Supplement | `work_permit_hub.assessment_pr.federal_pr_aor_details`, `master_entry_level.D08` | Adds AOR evidence/current stage only; category, date, application number and documents remain in the Master application record. | | `arrima` | Supplement | `work_permit_hub.assessment_pr.arrima_declaration` | Missing assessment detail; separate from IMM autofill answers. | | `pstq_invitation` | Supplement | `work_permit_hub.assessment_pr.pstq_invitation` | Missing assessment detail; separate from IMM autofill answers. | | `pstq_dsp` | Supplement | `work_permit_hub.assessment_pr.pstq_invitation_accepted`, `work_permit_hub.assessment_pr.pstq_dsp_submitted` | Splits invitation acceptance from DSP submission; full positive chain gates submission evidence. | | `pstq_proof` | Supplement | `work_permit_hub.assessment_pr.pstq_dsp_details` | Missing assessment detail; separate from IMM autofill answers. | | `support_letter` | Supplement | `work_permit_hub.assessment_pr.support_letter`, `master_entry_level.H10` | Adds specific work-permit-support purpose; the existing selection/support document record retains issuer/date/reference/upload. | | `previous_csQ_wp` | Supplement | `work_permit_hub.assessment_pr.previous_selection_work_permit`, `work_permit_hub.assessment_pr.previous_selection_work_permit_details` | Missing assessment detail; separate from IMM autofill answers. | | `permanent_other` | Existing | `master_entry_level.A04`, `master_entry_level.A05`, `master_entry_level.D08` | Existing Hub/Master content; no duplicate question added. | | `accompanying` | Existing | `work_permit_hub.tr_core.tr_family_accompanying`, `work_permit_hub.tr_core.tr_accompanying_family_details`, `master_entry_level.C02`, `master_entry_level.C05` | Existing Hub/Master content; no duplicate question added. | | `family_details` | Existing | `work_permit_hub.tr_core.tr_family_accompanying`, `work_permit_hub.tr_core.tr_accompanying_family_details`, `master_entry_level.C02`, `master_entry_level.C05` | Existing Hub/Master content; no duplicate question added. | | `spouse_status` | Existing | `master_entry_level.C08`, `master_entry_level.C09` | Existing Hub/Master content; no duplicate question added. | | `custody` | Existing | `master_entry_level.C14`, `master_entry_level.C15`, `master_entry_level.C25` | Existing Hub/Master content; no duplicate question added. | | `funds` | Existing | `master_entry_level.H11`, `master_entry_level.H12`, `master_entry_level.H13`, `master_entry_level.L15` | Existing Hub/Master content; no duplicate question added. | | `documents_ready` | Supplement | `work_permit_hub.assessment_readiness.documents_ready` | Missing assessment detail; separate from IMM autofill answers. | | `representative_history` | Supplement | `work_permit_hub.assessment_readiness.representative_document_history` | Covers recruiters/employers retaining documents, not only formal appointment of a representative on IMM5476. | | `representative_details` | Supplement | `work_permit_hub.assessment_readiness.representative_document_details` | Missing assessment detail; separate from IMM autofill answers. | | `truth_worker` | Existing | `master_entry_level.K01`, `master_entry_level.K09` | Existing Hub/Master content; no duplicate question added. | | `document_consent` | Existing | `master_entry_level.K05` | Existing privacy/authorized collection, use and secure sharing consent; supplement does not grant a new or broader verification authority. | | `worker_signature` | Existing | `master_entry_level.K06` | Existing electronic confirmation record; no new signature/date written into any IMM form. | | `worker_declaration_date` | Existing | `master_entry_level.K06` | Existing electronic confirmation record; no new signature/date written into any IMM form. | ## Safe activation and rollback From `backend`: ```powershell php artisan questionnaire-bank:work-permit-assessment-supplement php artisan questionnaire-bank:work-permit-assessment-supplement --apply ``` Preview makes no changes. Apply checks dependencies/ownership, creates a backup, inserts missing sections/questions transactionally, and validates conditions using the existing public bank validator. Repeats preserve consultant edits and create no duplicates. Archived dependencies/sections or conflicting source-key ownership block activation. No client questionnaire is resent or rebuilt. Previously sent draft/submitted assignment snapshots and answers remain unchanged; only future sends use additions. The command prints the backup path. For an immediate rollback during a bank-edit maintenance window: ```powershell php artisan questionnaire-bank:update --rollback=questionnaire-bank-backups/.json ``` Existing backup restore archives new bank rows without deleting IDs, snapshots or answers. Do not run a full bank sync to activate this supplement: that path may synchronize other bank metadata. Do not use a stale whole-bank backup after unrelated administrator edits. A rolled-back supplement is not silently reactivated by retrying the additive command. ## Verification - Original 294-question metadata hash remains unchanged. - Create-only activation, idempotency, administrator edits, cross-bank collisions, missing/archived dependencies and transaction rollback are covered by feature tests. - Persisted draft/submitted assignments and answers remain unchanged during activation and rollback; future snapshots remap source-key conditions to bank question IDs. - Shared client visibility and backend evaluator tests cover Yes/No/Unknown/blank parents and all steps of the PSTQ chain. - Blank, positive, negative and conflicting assessment answers leave the entire existing IMM1295, IMM5710, IMM5476, IMM5257, IMM5257SCH1, IMM5406 and IMM5669 payloads unchanged in English/French. Existing IMM prefill suites are also run.