Test

.github/copilot-instructions.md

@@ -0,0 +1,44 @@
+# Unity Portal – Copilot Instructions (Repository Root)
+
+> This file is used by **Copilot on GitHub.com** (PR reviews, web chat). For local IDE instructions, see `applications/Unity.GrantManager/.github/copilot-instructions.md`.
+
+## Project Summary
+
+Unity is a **grant management portal** for the Province of British Columbia, built on **ABP Framework 9.1.3** with **.NET 9.0**, targeting **PostgreSQL 17**. The primary application code lives in `applications/Unity.GrantManager/`.
+
+**Key stack:** .NET 9 · ABP 9.1.3 · EF Core 9.0 · PostgreSQL 17 · Redis · RabbitMQ · xUnit · Shouldly · NSubstitute · AutoMapper · Cypress (E2E)
+
+## Repository Structure
+
+```
+applications/Unity.GrantManager/   ← Main .NET solution (developers open this)
+applications/Unity.AutoUI/        ← Cypress E2E tests (TypeScript)
+database/scripts/                  ← SQL seed/migration scripts
+documentation/                     ← Technical docs
+.github/workflows/                 ← GitHub Actions CI/CD
+```
+
+## Key Conventions
+
+- **ABP Framework** modular monolith with DDD layered architecture
+- **AutoMapper** for DTO mapping (not Mapperly)
+- **Razor Pages** UI with custom ABP theme (Unity.Theme.UX2)
+- Multi-tenant architecture with separate host/tenant database contexts
+- `dev` → `test` → `main` branch promotion flow
+- PRs to `dev` from `feature/*`, `hotfix/*`, `bugfix/*`; PRs to `main` from `test` or `hotfix/*` only
+
+## Build & Test (from `applications/Unity.GrantManager/`)
+
+```bash
+dotnet restore Unity.GrantManager.sln
+dotnet build Unity.GrantManager.sln --no-restore
+dotnet test Unity.GrantManager.sln --no-build
+```
+
+All PRs must pass `dotnet build` and `dotnet test` before merge. The CI runs all `*Tests.csproj` in a parallel matrix.
+
+## Do NOT
+
+- Use Mapperly patterns — this project uses AutoMapper
+- Create repositories for child entities — only aggregate roots get repositories
+- Put business logic in application services — use domain entities/services

.github/workflows/docker-build-dev.yml

@@ -63,7 +63,7 @@ jobs:
     environment: dev
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Get short commitId
@@ -93,7 +93,7 @@ jobs:
       actions: write
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Set repository version variables
@@ -112,7 +112,7 @@ jobs:
     runs-on: ubuntu-latest
     environment: dev
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Build Docker images
       run: |
         rm -f ./docker-compose.override.yml

.github/workflows/docker-build-main.yml

@@ -63,7 +63,7 @@ jobs:
     environment: main
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Get short commitId
@@ -93,7 +93,7 @@ jobs:
       contents: write
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Generate Next Git Tag
@@ -146,7 +146,7 @@ jobs:
       actions: write
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Set repository version variables
@@ -169,7 +169,7 @@ jobs:
     runs-on: ubuntu-latest
     environment: main
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Build Docker images
       run: |
         rm -f ./docker-compose.override.yml

.github/workflows/docker-build-test.yml

@@ -63,7 +63,7 @@ jobs:
     environment: test
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Get short commitId
@@ -91,7 +91,7 @@ jobs:
     environment: test
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Generate Next Git Tag
@@ -118,7 +118,7 @@ jobs:
     environment: test
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Set repository version variables
@@ -145,7 +145,7 @@ jobs:
     runs-on: ubuntu-latest
     environment: test
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Build Docker images
       run: |
         rm -f ./docker-compose.override.yml

.github/workflows/manual-trigger.yml

@@ -59,7 +59,7 @@ jobs:
     environment: ${{ inputs.name }}
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Get short commitId
@@ -88,7 +88,7 @@ jobs:
       actions: write
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
           fetch-depth: '1'
     - name: Set repository version variables
@@ -107,7 +107,7 @@ jobs:
     runs-on: ubuntu-latest
     environment: ${{ inputs.name }}
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Build Docker images
       run: |
         rm -f ./docker-compose.override.yml

.github/workflows/pr-check-dev-branch.yml

@@ -44,7 +44,7 @@ jobs:
     outputs:
       matrix: ${{ steps.discover.outputs.matrix }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - id: discover
         run: |
@@ -67,7 +67,7 @@ jobs:
         project: ${{ fromJson(needs.discover-test-projects.outputs.matrix) }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - uses: actions/setup-dotnet@v4
         with:

.github/workflows/pr-check-main-branch.yml

@@ -40,7 +40,7 @@ jobs:
     outputs:
       matrix: ${{ steps.discover.outputs.matrix }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - id: discover
         run: |
@@ -63,7 +63,7 @@ jobs:
         project: ${{ fromJson(needs.discover-test-projects.outputs.matrix) }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - uses: actions/setup-dotnet@v4
         with:

.github/workflows/pr-check-test-branch.yml

@@ -42,7 +42,7 @@ jobs:
     outputs:
       matrix: ${{ steps.discover.outputs.matrix }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - id: discover
         run: |
@@ -65,7 +65,7 @@ jobs:
         project: ${{ fromJson(needs.discover-test-projects.outputs.matrix) }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - uses: actions/setup-dotnet@v4
         with:

applications/Unity.AutoUI/cypress.config.ts

@@ -1,22 +1,82 @@
-import { defineConfig } from 'cypress';
+import { defineConfig } from "cypress";
+import FormData from "form-data";
+import fs from "fs";
+import path from "path";
+
 // https://docs.cypress.io/guides/references/configuration
 export default defineConfig({
   e2e: {
-    setupNodeEvents(on, config) {
-      // implement node event listeners here
+    setupNodeEvents(on) {
+      on("task", {
+        readJsonIfExists(filePath: string): Record<string, unknown> | null {
+          try {
+            // path.resolve handles both forward and back slashes on Windows
+            const content = fs.readFileSync(path.resolve(filePath), "utf-8");
+            return JSON.parse(content);
+          } catch {
+            return null;
+          }
+        },
+
+        async uploadChefsFile({
+          baseURL,
+          authToken,
+          filePath,
+        }: {
+          baseURL: string;
+          authToken: string;
+          filePath: string;
+        }) {
+          const fileBuffer = fs.readFileSync(filePath);
+          const fileName = path.basename(filePath);
+
+          const form = new FormData();
+          form.append("files", fileBuffer, {
+            filename: fileName,
+            contentType: "text/plain",
+          });
+
+          // Use getBuffer() so fetch receives a complete binary buffer
+          // rather than a piped stream (which causes "Unexpected end of form")
+          const formBuffer = form.getBuffer();
+          const formHeaders = form.getHeaders();
+
+          const response = await fetch(`${baseURL}/app/api/v1/files`, {
+            method: "POST",
+            headers: {
+              Authorization: `Bearer ${authToken}`,
+              ...formHeaders,
+            },
+            body: formBuffer as unknown as BodyInit,
+          });
+
+          if (!response.ok) {
+            throw new Error(
+              `File upload failed: ${response.status} ${await response.text()}`,
+            );
+          }
+
+          return response.json();
+        },
+      });
     },
-    baseUrl: 'https://developer.gov.bc.ca/',
+    specPattern: [
+      "cypress/e2e/**/*.cy.{js,jsx,ts,tsx}",
+      "cypress/scripts/**/*.cy.{js,jsx,ts,tsx}",
+      "cypress/regression/**/*.cy.{js,jsx,ts,tsx}",
+    ],
+    baseUrl: "https://dev-unity.apps.silver.devops.gov.bc.ca/",
     defaultCommandTimeout: 20000, // Time, in milliseconds, to wait until most DOM based commands are considered timed out.
-    viewportWidth: 1440,  // Default width in pixels.
-    viewportHeight: 900,  // Default height in pixels.
+    viewportWidth: 1440, // Default width in pixels.
+    viewportHeight: 900, // Default height in pixels.
     chromeWebSecurity: false, // Chromium-based browser's Web Security for same-origin policy and insecure mixed content.
-    testIsolation: false,  // Set true to ensure a clean browser context between test cases.
-    retries:  // The number of times to retry a failing test. 
-      {
-        "runMode": 3, 
-        "openMode": 0
-       },
+    testIsolation: false, // Set true to ensure a clean browser context between test cases.
+    // The number of times to retry a failing test.
+    retries: {
+      runMode: 3,
+      openMode: 0,
+    },
     experimentalMemoryManagement: true,
-    numTestsKeptInMemory: 3
-  }
-});
+    numTestsKeptInMemory: 3,
+  },
+});

applications/Unity.AutoUI/cypress/e2e/basicEmail.cy.ts

@@ -306,20 +306,23 @@ describe("Send an email", () => {
   });
 
   it("Select Email Template", () => {
-    cy.intercept("GET", "/api/app/template/*/template-by-id").as(
-      "loadTemplate",
-    );
-
     cy.get("#template", { timeout: STANDARD_TIMEOUT })
       .should("exist")
       .should("be.visible")
       .select(TEMPLATE_NAME);
 
-    cy.wait("@loadTemplate", { timeout: STANDARD_TIMEOUT });
-
     cy.get("#template")
       .find("option:selected")
       .should("have.text", TEMPLATE_NAME);
+
+    // #EmailBody is a hidden textarea backing the rich-text editor.
+    // Template selection populates the visible RTE but does not auto-sync
+    // the backing field — trigger the change manually if still empty.
+    cy.get("#EmailBody", { timeout: STANDARD_TIMEOUT }).then(($el) => {
+      if (($el.val() as string).trim() === "") {
+        cy.wrap($el).invoke("val", "Test email body").trigger("change");
+      }
+    });
   });
 
   it("Set Email To address", () => {

applications/Unity.AutoUI/cypress/fixtures/test-attachment.txt

@@ -0,0 +1,3 @@
+Maple Ridge Community Resource Development Initiative
+Test Attachment - Automated Regression Submission
+Generated by Cypress automation script.