#1815 - Ignore restrictions for specific disbursement(s) within an assessment (#3679)

- Created the `restrictionBypassesResolutionStep` to resolve active
bypasses when needed as the last step in the e-Cert generation process
for part-time and full-time.
- Changed the `getEligibleDisbursements` query adding the information
from the active bypasses and the restriction bypassed.
- Method `getRestrictionByActionType` was changed to use the effective
restrictions (active restrictions not bypassed) instead of the active
restrictions.
- The BCLM step is ignored at the beginning of its execution. If the
BCLM restriction is in place the method would not be executed (logic
already in place). The condition based on the bypass was added either
way to ensure that whatever happens to the BCLM logic the bypass will
guarantee that the store step will be ignored.
- A log was created to list all the active restrictions known during the
e-Cert calculation. The log records the restriction code and the student
restriction ID for easier troubleshooting.
- Created factories for the new table `ApplicationRestrictionBypass`.

### E2E Tests

#### Full-time
- Should generate BC awards amounts with no restriction deductions and
resolve the restriction bypass when a student has an active 'BCLM'
restriction and it is bypassed with behavior 'Next disbursement only'.
- Should have the e-Cert generated for a full-time application and the
bypass active when a student has an active 'Stop full time disbursement'
restriction and it is bypassed with behavior 'All disbursements'.
- Should prevent an e-Cert generation and keep the bypass active when
multiple 'Stop full time disbursement' restrictions exist and only one
is bypassed and it is bypassed with behavior 'Next disbursement only'.

#### Part-time
- Should have the e-Cert generated for a part-time application and the
bypass resolved when a student has an active 'Stop part time
disbursement' restriction and it is bypassed with behavior 'Next
disbursement only'.
- Should prevent an e-Cert generation and keep the bypass active when
multiple 'Stop part time disbursement' restrictions exist and only one
is bypassed and it is bypassed with behavior 'Next disbursement only'.

### Log sample without the bypass


![image](https://github.com/user-attachments/assets/cc75c575-df20-49b3-aefc-ebaac508b9f3)

### Log sample with a bypass in place.


![image](https://github.com/user-attachments/assets/be96088b-458e-41d2-abf1-f56d5d610d1b)

### Noted generated when a bypass is resolved by the system

AC was adjusted later to include the application number.

![image](https://github.com/user-attachments/assets/49f3180e-ae52-4f08-b169-9fe5ac93628d)

Author: andrewsignori-aot

Diff for: sims.code-workspace

@@ -91,6 +91,7 @@
     "cSpell.words": [
       "AEST",
       "bcag",
+      "BCLM",
       "BCSC",
       "BCSG",
       "bcsl",

Diff for: sources/packages/backend/apps/api/src/route-controllers/assessment/_tests_/e2e/assessment.students.controller.confirmAssessmentNOA.e2e-spec.ts

@@ -17,15 +17,21 @@ import {
   createFakeDisbursementValue,
   createFakeMSFAANumber,
   MSFAAStates,
+  saveFakeApplicationRestrictionBypass,
+  createFakeUser,
 } from "@sims/test-utils";
 import {
+  Application,
   ApplicationStatus,
   AssessmentStatus,
   AssessmentTriggerType,
   COEStatus,
   DisbursementScheduleStatus,
   DisbursementValueType,
   OfferingIntensity,
+  RestrictionActionType,
+  RestrictionBypassBehaviors,
+  User,
   WorkflowData,
 } from "@sims/sims-db";
 import { TestingModule } from "@nestjs/testing";
@@ -34,13 +40,16 @@ describe("AssessmentStudentsController(e2e)-confirmAssessmentNOA", () => {
   let app: INestApplication;
   let db: E2EDataSources;
   let appModule: TestingModule;
+  let sharedMinistryUser: User;
 
   beforeAll(async () => {
     const { nestApplication, dataSource, module } =
       await createTestingAppModule();
     app = nestApplication;
     appModule = module;
     db = createE2EDataSources(dataSource);
+    // Create a Ministry user to b used, for instance, for audit.
+    sharedMinistryUser = await db.user.save(createFakeUser());
   });
 
   it("Should allow NOA approval for the current application assessment when the application has multiple assessments.", async () => {
@@ -120,13 +129,44 @@ describe("AssessmentStudentsController(e2e)-confirmAssessmentNOA", () => {
       });
   });
 
+  it(`Should allow NOA approval when the current assessment is blocked by a '${RestrictionActionType.StopPartTimeDisbursement}' restriction but the application has a restriction bypass.`, async () => {
+    // Arrange
+    const { application } = await createApplicationAndAssessments();
+    // Create a student restriction and a bypass to allow the NOA to be accepted.
+    await saveFakeApplicationRestrictionBypass(
+      db,
+      {
+        application,
+        bypassCreatedBy: sharedMinistryUser,
+        creator: sharedMinistryUser,
+      },
+      {
+        restrictionActionType: RestrictionActionType.StopPartTimeDisbursement,
+        initialValues: {
+          bypassBehavior: RestrictionBypassBehaviors.NextDisbursementOnly,
+        },
+      },
+    );
+    const studentUserToken = await getStudentToken(
+      FakeStudentUsersTypes.FakeStudentUserType1,
+    );
+    const endpoint = `/students/assessment/${application.currentAssessment.id}/confirm-assessment`;
+
+    // Act/Assert
+    await request(app.getHttpServer())
+      .patch(endpoint)
+      .auth(studentUserToken, BEARER_AUTH_TYPE)
+      .expect(HttpStatus.OK);
+  });
+
   /**
    * Creates an application with two assessments.
    * @returns Old and new Assessment ID.
    */
   async function createApplicationAndAssessments(): Promise<{
     currentAssessmentId: number;
     oldAssessmentId: number;
+    application: Application;
   }> {
     // Create the new student to be mocked as the authenticated one.
     const student = await saveFakeStudent(db.dataSource);
@@ -192,6 +232,7 @@ describe("AssessmentStudentsController(e2e)-confirmAssessmentNOA", () => {
     return {
       currentAssessmentId: newCurrentAssessment.id,
       oldAssessmentId: oldAssessment.id,
+      application,
     };
   }