Program Year Setup - bcgov/SIMS GitHub Wiki

What is it?

Every year there is a need to enable Student Applications to be submitted to a new Ministry Program Year (August 1st, 2021 till July 31st, 2022). Below is the sequence of steps required to create the baseline for a new program year based on the previous program year. The example below will assume that the current program year is 2023-2024 and the new 2024-2025 will be enabled.

Duplicate BPMN files from the previous year and adjust them

  1. Copy fulltime-assessment-2023-2024.bpmn and rename it as fulltime-assessment-2024-2025.bpmn.
  2. Copy parttime-assessment-2023-2024.bpmn and rename it as parttime-assessment-2024-2025.bpmn.
  3. Ensure to update the internal variable names previously referencing the source year (name, processRef, and id) on the above BPMNs. Please see the example below. image

Add new 2024-2025 Values in the DMN tables (copy existing 2023-2024 values)

  1. Open the file fulltime-assessment-decisions.dmn and for every program year-related condition entry a new one for the new program year.
  2. Repeat the same for the parttime-assessment-decisions.dmn.

For instance, in the below DMN, the last two rows were duplicated from the previous year. The tool allows copy and paste the entire rows, no need to copy the values of the individual columns.

image

Copy and rename the below form.io definitions

  1. sfaa2023-24.json to sfaa2024-25.json.
  2. supportingusersparent2022-2023.json to supportingusersparent2024-2025.json.
  3. supportinguserspartner2022-2023.json to supportinguserspartner2024-2025.json.
  4. Update the name and path to reflect the new program year in the above forms, as shown below.

image

Create the new program year entry in DB

Create a migration to insert the new Program Year record in sims.program_years.

  • program_year: 2024-2025
  • program_year_desc: Study starting between August 01, 2024 and July 31, 2025
  • form_name: SFAA2024-25
  • is_active: true
  • start_date: 2024-08-01
  • end_date: 2025-07-31
  • parent_form_name: supportingusersparent2024-2025
  • partner_form_name: supportinguserspartner2024-2025
  • program_year_prefix: 2024
  • max_lifetime_bc_loan_amount: 50000

Create a new suite of E2E tests for the new program year

  1. Duplicate the folder from sources\packages\backend\workflow\test\2023-2024 and rename it to 2024-2025.
  2. Update the const under sources\packages\backend\workflow\test\2024-2025\constants\program-year.constants.ts to 2024-2025
  3. Ensure that all tests are passing for the new program year.
  4. Ensure new student applications can be submitted selecting the new program year and has its NOA generated.
  5. Ensure supporting users can submit information for a new Student Application created for the new program year.

Reference tickets