SPD Business Transformation Project

Summary

Transforming SPD operations by modernizing business processes and the case management system to improve service accessibility and user-experience for staff and the 350,000 citizens who access SPD services each year.

This site is built with a .NET Core OData service serving as the backend. The frontend is developed using Angular, while the database is managed through Microsoft Dynamics.

Table of Contents

• Getting Started
  • Prerequisites
  • Backend Development
  • Frontend development - Angular
• Commit/branching
• Application walkthrough
• Usage
• Configuration
• Additional Documentation
• Deployment
• Contributing
• Credits

Getting Started

Prerequisites

1. Visual Studio 2022 with .net 8.0 installed
2. OData Connected Service 2022+ installed to visual studio as extension
3. Angular 20 installed
4. Create a fork of the repo from https://github.com/bcgov/PSSG-SPDBT
5. Clone your forked git repository into a local directory

Backend Development

.NET 8.0 + OData Connected Service

Open Spd.sln with Visual Studio and rebuild all

Frontend development - Angular

refer to \src\Spd.Presentation.Screening\ClientApp\package.json

reinstall npm

npm install

start local app

npm run startlocal

regenerate api

npm run gen-api-all-local

if there is compiling error, we can reinstall npm. Please delete package-lock.json and node_modules, then reinstall node modules with command

npm install

or

npm install --force

upgrade to Angular 20

start power shell with Administrator privilege run

choco upgrade nodejs

go to clientApp folder

del node_modules
del package-lock.json

then run

npm install

if you get "File C:\Program Files\nodejs\npm.ps1 cannot be loaded. The file C:\Program Files\nodejs\npm.ps1 is not digitally signed." run

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

then run npm install again.

Commit/branching

Each developer should create a feature branch for work on their forked repo that relates to the associated JIRA issue. (example: username/SPDBT-1121

Application walkthrough

• Screening Portals:

  This portal is designed for criminal record checks (CRC), this portal offers multiple access points:

  • Organization Portal: Allows organizations to issue CRC invitations and manage both CRC applications and portal users.

  • IDIR User Access: Enables IDIR users to log in, issue CRC invitations, and manage CRC cases as RSA users.

  • Public Applicant Portal: Lets applicants view and manage their own CRC cases.

  • for specific info, please refer to Security Screening - CRRP & PSSO Requirements

• Licensing Portals:

  This portal is designed to support both individuals and security businesses in applying for the appropriate security licences. It provides multiple access points:

  • Business Portal: Enables security businesses to new, renew, replace, and update their business licences.

  • Individual Portal: Allows individuals to apply new, renew, replace, and update their Security Worker licences, as well as Armoured Vehicle and Body Armour permits.

  • for specific info, please refer to Security Service - Licensing Requirements

• MDRA Portal:

  This portal is designed to support Metal dealers and recyclers to register as a Metal Recycling Dealer

  • for specific info, please refer to MDRA - Requirements

• GDSD Portal:

  This portal is designed to support guide and service dogs and their handlers, dog trainer, retired dog to get certified.

  • for specific info, please refer to Guide Dog Service Dog Requirements

• Dynamics Helper API:

  This is internal API mainly for dynamics to use.

  • provide File storage api to access s3
  • provide API to generate invitation
  • provide refund, invoice payment api
  • provide API to print with BCMP
  • provide API to support schedule job

Usage

The application can be accessed using the links below:

Prod	Test	Dev	Staging	Training
Screening Main Portal	Test - Screening Portal	Dev - Screening Portal	Staging - Screening Portal	Training - Screening Portal
Screening Applicant Portal	Test - Screening Applicant Portal	Dev - Screening Applicant Portal	Staging - Screening Applicant Portal	Training - Screening Applicant Portal
Screening Direct CRC Portal	Test - Screening Direct CRC Portal	Dev - Screening Direct CRC Portal	Staging - Screening Direct CRC Portal	Training - Screening Direct CRC Portal
Licensing Portal	Test - Licensing Portal	Dev - Licensing Portal	Staging - Licensing Portal	Training - Licensing Portal
Licensing Verification Portal	Test - Licensing Verification Portal	Dev - Licensing Verification Portal	Staging - Licensing Verification Portal	Training - Licensing Verification Portal
MDRA Portal	Test - MDRA Portal	Dev - MDRA Portal	Staging - MDRA Portal	Training - MDRA Portal
GDSD Portal	Test - GDSD Portal	Dev - GDSD Portal	Staging - GDSD Portal	Training - GDSD Portal
Dynamics Helper API - Not Accessible	Test - Dynamics Helper API - Not Accessible	Dev - API Docs	Staging - Dynamics Helper API - Not Accessible	Training - Dynamics Helper API - Not Accessible

Configuration

• For Screening, Licensing and GDSD portal, we support Maintenance Mode. Set MaintenanceMode to true, then user only see maintenance page.

 "MaintenanceMode": false,

• For licensing, we support one bceid has multiple business accounts. So for licensing prod, we need to set

"OneOrgGuidHasOneBizLicencePortal": true,

Additional Documentation

Please refer to SPD Business Transformation Project for requirements, project milestones and technical design.

Deployment

For deployment and content sync information, contact James Bradbury

Contributing

Contributions are welcome! Please fork the repo and submit a pull request.

Credits

Thanks to all contributors ( Carol Carpenter, Peggy Zhang, Yossi Tamari, Ruben Araya, Emad Salamat etc.) and third-party libraries.