Dev

.gitignore

@@ -118,4 +118,9 @@ appsettings.json
 
 /applications/Orchestrator
 *.env
-/applications/Unity.GrantManager/src/Unity.GrantManager.Web/package-lock.json
+/applications/Unity.GrantManager/src/Unity.GrantManager.Web/package-lock.json
+/applications/Unity.AutoUI/cypress/config/dev.json
+/applications/Unity.AutoUI/cypress/config/dev2.json
+/applications/Unity.AutoUI/cypress/config/test.json
+/applications/Unity.AutoUI/cypress/config/uat.json
+/applications/Unity.AutoUI/cypress/config/prod.json

CLAUDE.md

@@ -0,0 +1,63 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+> This is **Unity Portal**, a grant management system for the Province of British Columbia. It is NOT the Unity game engine — do not suggest UnityEngine APIs.
+
+## Repository Layout
+
+`applications/Unity.GrantManager/` is where almost all work happens — a self-contained ABP Framework solution with its own extensive AI-agent instructions. `applications/Unity.AutoUI/` holds Cypress E2E tests; `applications/Unity.Tools/`, `database/`, and `documentation/` round out the rest (see root `README.md` for the full layout).
+
+**Read these before making non-trivial changes in `applications/Unity.GrantManager/`** — note this solution has its own `.github/`, separate from the root `.github/` above it:
+
+- `applications/Unity.GrantManager/.github/copilot-instructions.md` — authoritative project overview, layering, and conventions (trust this first)
+- `applications/Unity.GrantManager/.github/instructions/*.instructions.md` — path-scoped rules for C#, EF Core, JavaScript, security, testing
+- `applications/Unity.GrantManager/.github/skills/*/SKILL.md` — deep-dive patterns: DDD, application layer, EF Core, testing, ABP CLI, module structure
+- `applications/Unity.GrantManager/.github/agents/*.agent.md` — planning agents for features, DDD modeling, EF migrations, permissions/localization audits, test strategy, PR readiness
+
+Where those files and this one overlap, prefer the more specific ones under `applications/Unity.GrantManager/.github/`.
+
+## Build & Test
+
+All commands run from `applications/Unity.GrantManager/`:
+
+```bash
+dotnet restore Unity.GrantManager.sln
+dotnet build Unity.GrantManager.sln --no-restore      # ~3 min, 81 projects
+dotnet test Unity.GrantManager.sln --no-build          # ~470 tests, ~1-2 min
+
+# Single test project
+dotnet test test/Unity.GrantManager.Application.Tests/ --no-build
+```
+
+- No PostgreSQL setup needed for tests — SQLite in-memory (most projects) or `EFCore.InMemory` (`Unity.GrantManager.Web.Tests`).
+- `Unity.GrantManager.Web/Pages/Dashboard/Index.cshtml.cs` has one expected `CS8604` warning — don't fix it unless asked.
+- `Directory.Build.props` / `common.props` (repo-wide MSBuild props) already suppress `NU1701`, `MSB3277`, `CS1591` — don't re-suppress per-project.
+
+### Local dev environment
+
+`docker-compose.yml` + `.env.example` in `applications/Unity.GrantManager/` spin up the web app, PostgreSQL, a DB migrator, and Redis. Copy `.env.example` to `.env` and fill in secrets before running `docker compose up`.
+
+### EF Core migrations
+
+There are **two separate database contexts** — always specify which one:
+
+```bash
+cd applications/Unity.GrantManager/src/Unity.GrantManager.EntityFrameworkCore
+
+dotnet ef migrations add <Name> --context GrantManagerDbContext --output-dir Migrations/HostMigrations   # host/shared tables
+dotnet ef migrations add <Name> --context GrantTenantDbContext --output-dir Migrations/TenantMigrations   # per-tenant data
+```
+
+## Architecture
+
+ABP Framework modular monolith, DDD-layered — see `applications/Unity.GrantManager/.github/copilot-instructions.md` and `applications/Unity.GrantManager/.github/skills/unity-module-structure/SKILL.md` for the full module list and dependency-direction diagram.
+
+Business rules belong in Domain entities/managers, not controllers or app services. Don't call another app service within the same module — push shared logic into a domain service.
+
+### Key conventions
+
+C#, EF Core, JavaScript, security, and testing conventions are detailed in `.claude/rules/*.md` (loaded automatically for matching files) and `applications/Unity.GrantManager/.github/instructions/*.instructions.md`.
+
+- **Branching**: `dev` → `test` → `main` promotion. Feature branches `feature/*`, fixes `bugfix/*`, urgent `hotfix/*`. PRs to `dev` come from `feature/*`/`bugfix/*`/`hotfix/*`; PRs to `main` only from `test` or `hotfix/*`.
+- **Commit messages**: prefix with `[AB#<ID>]` extracted from the branch name (e.g. `feature/AB#32037-...` → `AB#32037`), then a short description.

applications/Unity.AutoUI/CypressTestLauncher.bat

@@ -1,5 +1,6 @@
 @echo off
+@echo off
 setlocal
 cd /d "%~dp0"
 
-powershell -NoProfile -ExecutionPolicy Bypass -NoExit -Command "$ErrorActionPreference='Stop';$ProgressPreference='SilentlyContinue';Add-Type -AssemblyName System.Windows.Forms;Add-Type -AssemblyName System.Drawing;$projectPath=(Get-Location).Path;$form=New-Object System.Windows.Forms.Form;$form.Text='Cypress Test Launcher';$form.Size=New-Object System.Drawing.Size(420,240);$form.StartPosition='CenterScreen';$form.AutoScaleMode=[System.Windows.Forms.AutoScaleMode]::None;$envLabel=New-Object System.Windows.Forms.Label;$envLabel.Text='Select Environment:';$envLabel.AutoSize=$true;$envLabel.Location=New-Object System.Drawing.Point(15,15);$envBox=New-Object System.Windows.Forms.ComboBox;$envBox.Location=New-Object System.Drawing.Point(15,35);$envBox.Size=New-Object System.Drawing.Size(380,25);$envBox.DropDownStyle='DropDownList';$envBox.Items.Add('Please select an environment');$envBox.Items.Add('DEV');$envBox.Items.Add('DEV2');$envBox.Items.Add('TEST');$envBox.Items.Add('UAT');$envBox.Items.Add('PROD');$envBox.SelectedIndex=0;$modeLabel=New-Object System.Windows.Forms.Label;$modeLabel.Text='Select Mode:';$modeLabel.AutoSize=$true;$modeLabel.Location=New-Object System.Drawing.Point(15,70);$modeBox=New-Object System.Windows.Forms.ComboBox;$modeBox.Location=New-Object System.Drawing.Point(15,90);$modeBox.Size=New-Object System.Drawing.Size(380,25);$modeBox.DropDownStyle='DropDownList';$modeBox.Items.Add('Please select a mode');$modeBox.Items.Add('GUI');$modeBox.Items.Add('Headless');$modeBox.SelectedIndex=0;$run=New-Object System.Windows.Forms.Button;$run.Text='Launch Cypress';$run.Location=New-Object System.Drawing.Point(15,135);$run.Size=New-Object System.Drawing.Size(380,32);$run.Add_Click({try{if($envBox.SelectedIndex -eq 0 -or $modeBox.SelectedIndex -eq 0){[System.Windows.Forms.MessageBox]::Show('Please select both an environment and a mode.','Missing Selection');return};Set-Location $projectPath;$envName=$envBox.SelectedItem;$envFile='.\\cypress.'+$envName+'.env.json';if(Test-Path $envFile){Copy-Item $envFile '.\\cypress.env.json' -Force}else{[System.Windows.Forms.MessageBox]::Show('Environment file not found: '+$envFile,'Missing Env File');return};if($modeBox.SelectedItem -eq 'Headless'){Start-Process powershell -ArgumentList '-NoExit','-Command',\"cd '$projectPath'; npx cypress run\"}else{Start-Process powershell -ArgumentList '-NoExit','-Command',\"cd '$projectPath'; npx cypress open\"}}catch{[System.Windows.Forms.MessageBox]::Show($_.Exception.Message,'Cypress Launcher Error')}});$form.Controls.Add($envLabel);$form.Controls.Add($envBox);$form.Controls.Add($modeLabel);$form.Controls.Add($modeBox);$form.Controls.Add($run);$form.ShowDialog()"
+powershell -NoProfile -ExecutionPolicy Bypass -NoExit -Command "$ErrorActionPreference='Stop';$ProgressPreference='SilentlyContinue';Add-Type -AssemblyName System.Windows.Forms;Add-Type -AssemblyName System.Drawing;$projectPath=(Get-Location).Path;$form=New-Object System.Windows.Forms.Form;$form.Text='Cypress Test Launcher';$form.Size=New-Object System.Drawing.Size(420,240);$form.StartPosition='CenterScreen';$form.AutoScaleMode=[System.Windows.Forms.AutoScaleMode]::None;$envLabel=New-Object System.Windows.Forms.Label;$envLabel.Text='Select Environment:';$envLabel.AutoSize=$true;$envLabel.Location=New-Object System.Drawing.Point(15,15);$envBox=New-Object System.Windows.Forms.ComboBox;$envBox.Location=New-Object System.Drawing.Point(15,35);$envBox.Size=New-Object System.Drawing.Size(380,25);$envBox.DropDownStyle='DropDownList';$envBox.Items.Add('Please select an environment');$envBox.Items.Add('DEV');$envBox.Items.Add('DEV2');$envBox.Items.Add('TEST');$envBox.Items.Add('UAT');$envBox.Items.Add('PROD');$envBox.SelectedIndex=0;$modeLabel=New-Object System.Windows.Forms.Label;$modeLabel.Text='Select Mode:';$modeLabel.AutoSize=$true;$modeLabel.Location=New-Object System.Drawing.Point(15,70);$modeBox=New-Object System.Windows.Forms.ComboBox;$modeBox.Location=New-Object System.Drawing.Point(15,90);$modeBox.Size=New-Object System.Drawing.Size(380,25);$modeBox.DropDownStyle='DropDownList';$modeBox.Items.Add('Please select a mode');$modeBox.Items.Add('GUI');$modeBox.Items.Add('Headless');$modeBox.SelectedIndex=0;$run=New-Object System.Windows.Forms.Button;$run.Text='Launch Cypress';$run.Location=New-Object System.Drawing.Point(15,135);$run.Size=New-Object System.Drawing.Size(380,32);$run.Add_Click({try{if($envBox.SelectedIndex -eq 0 -or $modeBox.SelectedIndex -eq 0){[System.Windows.Forms.MessageBox]::Show('Please select both an environment and a mode.','Missing Selection');return};Set-Location $projectPath;$envName=$envBox.SelectedItem.ToString().ToLowerInvariant();$envFile=Join-Path $projectPath ('cypress\config\'+$envName+'.json');if(-not (Test-Path $envFile)){[System.Windows.Forms.MessageBox]::Show('Environment file not found: '+$envFile,'Missing Env File');return};if($modeBox.SelectedItem -eq 'Headless'){Start-Process powershell -ArgumentList '-NoExit','-ExecutionPolicy','Bypass','-Command',\"`$env:UNITY_CYPRESS_ENV='$envName'; cd '$projectPath'; node .\\scripts\\run-cypress.js run --browser chrome\"}else{Start-Process powershell -ArgumentList '-NoExit','-ExecutionPolicy','Bypass','-Command',\"`$env:UNITY_CYPRESS_ENV='$envName'; cd '$projectPath'; node .\\scripts\\run-cypress.js open --browser chrome\"}}catch{[System.Windows.Forms.MessageBox]::Show($_.Exception.Message,'Cypress Launcher Error')}});$form.Controls.Add($envLabel);$form.Controls.Add($envBox);$form.Controls.Add($modeLabel);$form.Controls.Add($modeBox);$form.Controls.Add($run);$form.ShowDialog()"

applications/Unity.AutoUI/cypress.config.ts

@@ -3,10 +3,30 @@ import FormData from "form-data";
 import fs from "fs";
 import path from "path";
 
+function loadLocalEnvironmentConfig(): Record<string, unknown> {
+  const environmentName = (
+    process.env.UNITY_CYPRESS_ENV || "dev"
+  ).toLowerCase();
+  const environmentFilePath = path.resolve(
+    "cypress",
+    "config",
+    `${environmentName}.json`,
+  );
+
+  try {
+    const content = fs.readFileSync(environmentFilePath, "utf-8");
+    return JSON.parse(content) as Record<string, unknown>;
+  } catch {
+    return {};
+  }
+}
+
 // https://docs.cypress.io/guides/references/configuration
 export default defineConfig({
   e2e: {
-    setupNodeEvents(on) {
+    setupNodeEvents(on, config) {
+      const environmentConfig = loadLocalEnvironmentConfig();
+
       on("task", {
         readJsonIfExists(filePath: string): Record<string, unknown> | null {
           try {
@@ -59,6 +79,17 @@ export default defineConfig({
           return response.json();
         },
       });
+
+      return {
+        ...config,
+        baseUrl:
+          (environmentConfig["webapp.url"] as string | undefined) ||
+          config.baseUrl,
+        env: {
+          ...config.env,
+          ...environmentConfig,
+        },
+      };
     },
     specPattern: [
       "cypress/e2e/**/*.cy.{js,jsx,ts,tsx}",

applications/Unity.AutoUI/cypress/config/dev.json.example

@@ -7,5 +7,6 @@
     "test2password": "",
     "TEST_EMAIL_TO": "",
     "TEST_EMAIL_CC": "",
-    "TEST_EMAIL_BCC": ""
+    "TEST_EMAIL_BCC": "",
+    "chefsApiKey": ""
 }

applications/Unity.AutoUI/cypress/config/test.json.example

@@ -7,5 +7,6 @@
     "test2password": "",
     "TEST_EMAIL_TO": "",
     "TEST_EMAIL_CC": "",
-    "TEST_EMAIL_BCC": ""
+    "TEST_EMAIL_BCC": "",
+    "chefsApiKey": ""
 }

applications/Unity.AutoUI/cypress/config/uat.json.example

@@ -7,5 +7,6 @@
     "test2password": "",
     "TEST_EMAIL_TO": "",
     "TEST_EMAIL_CC": "",
-    "TEST_EMAIL_BCC": ""
+    "TEST_EMAIL_BCC": "",
+    "chefsApiKey": ""
 }

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

@@ -10,31 +10,34 @@ describe('Grant Manager Login and List Navigation', () => {
     const appsPage = ApplicationsPageInstance()
 
     function setDashboardIntakeToTestIfAvailable() {
-        const btnSel = 'button[data-id="dashboardIntakeId"]'
-        const listboxSel = '#bs-select-1[role="listbox"]'
-        const searchSel = 'input[type="search"][aria-controls="bs-select-1"]'
-
-        cy.get(btnSel, { timeout: 30000 })
+        // The INTAKES filter is a Select2 (bootstrap-5 theme) multi-select, not
+        // bootstrap-select — the toggle is the [role="combobox"] wrapping the
+        // rendered-choices <ul id="select2-dashboardIntakeId-container">.
+        const renderedSel = '#select2-dashboardIntakeId-container'
+        const dropdownSel = '.select2-dropdown'
+        const optionSel = `${dropdownSel} li.select2-results__option`
+
+        cy.get(renderedSel, { timeout: 30000 })
             .should('be.visible')
-            .first()
+            .closest('[role="combobox"]')
+            .as('intakeCombobox')
             .click({ force: true })
 
-        cy.get(listboxSel, { timeout: 30000 }).should('be.visible')
+        cy.get(dropdownSel, { timeout: 30000 }).should('be.visible')
 
-        cy.get(searchSel, { timeout: 30000 })
+        cy.get(renderedSel)
+            .parent()
+            .find('textarea.select2-search__field', { timeout: 30000 })
             .should('be.visible')
             .clear()
             .type('Test')
 
-        cy.contains(`${listboxSel} a.dropdown-item[role="option"] span.text`, /^Test$/, { timeout: 30000 })
-            .closest('a.dropdown-item')
+        cy.contains(optionSel, /^Test$/, { timeout: 30000 })
             .then(($opt) => {
-                const selected =
-                    $opt.attr('aria-selected') === 'true' ||
-                    $opt.hasClass('selected')
+                const selected = $opt.attr('aria-selected') === 'true'
 
                 if (!selected) {
-                    cy.wrap($opt).scrollIntoView().click({ force: true })
+                    cy.wrap($opt).click({ force: true })
                 }
             })
 
@@ -43,8 +46,8 @@ describe('Grant Manager Login and List Navigation', () => {
             expect(texts).to.include('Test')
         })
 
-        cy.get(btnSel).first().click({ force: true })
-        cy.get(btnSel).first().should('have.attr', 'aria-expanded', 'false')
+        cy.get('@intakeCombobox').click({ force: true })
+        cy.get('@intakeCombobox').should('have.attr', 'aria-expanded', 'false')
     }
 
     it('Verify Login', () => {

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

@@ -1,3 +1,4 @@
+/// <reference types="cypress" />
 import { LoginPageInstance, NavigationPageInstance } from "../utilities";
 
 describe('Grant Manager Login and Logout', () => {
@@ -8,10 +9,9 @@ describe('Grant Manager Login and Logout', () => {
         loginPage.login()
         loginPage.verifyOnGrantApplications()
 
-        // Verify Default Grant Program tenant is selected
+        navPage.switchToDefaultGrantsProgramIfAvailable()
         navPage.verifyCurrentTenant('Default Grants Program')
 
-        // Logout (terminal action)
         loginPage.quickLogout()
     })
 })

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

@@ -11,10 +11,9 @@ describe('Grant Manager Login and Top Navigation', () => {
 
     it('Verify navigation options in the top banner', () => {
 
-        // 3.) Verify Default Grant Program tenant is selected.
+        navPage.switchToDefaultGrantsProgramIfAvailable()
         navPage.verifyCurrentTenant('Default Grants Program')
 
-        // 4.) Ensure all expected headings are present.
         navPage.verifyAllNavItemsExist()
 
         // 5.) Applications

applications/Unity.AutoUI/cypress/fixtures/metabase.json

@@ -18,7 +18,7 @@
     },
     {
       "unityEnv": "PROD",
-      "baseURL": "https://unity-reporting.apps.gold.devops.gov.bc.ca/"
+      "baseURL": "https://unity-reporting.apps.silver.devops.gov.bc.ca/"
     }
   ]
 }

applications/Unity.AutoUI/cypress/regression/ApprovalFlow.cy.ts

@@ -506,10 +506,25 @@ const APPLICATIONS_PATH = "GrantApplications";
           return;
         }
 
-        // Priority 3: fetch the latest matching submission from the Unity API
+        // Priority 3: fetch the latest matching submission from the Unity API,
+        // falling back to seeding a fresh one via CHEFS if none currently
+        // match (e.g. every existing seeded submission has already been
+        // approved by a prior run) — so this spec is self-sufficient and
+        // doesn't depend on a separate seed step running first.
         cy.fetchDynamicSubmission(TEST_CONFIG.fetchOptions).then((id) => {
-          submissionId = id;
-          cy.log(`✅ Fetched dynamic submission ID: ${submissionId}`);
+          if (id) {
+            submissionId = id;
+            cy.log(`✅ Fetched dynamic submission ID: ${submissionId}`);
+            return;
+          }
+
+          cy.log(
+            "⚠️ No matching submission found — seeding a fresh one via CHEFS",
+          );
+          cy.seedApprovalFlowSubmission().then((seededId) => {
+            submissionId = seededId;
+            cy.log(`✅ Seeded and using submission ID: ${submissionId}`);
+          });
         });
       },
     );
@@ -619,6 +634,25 @@ const APPLICATIONS_PATH = "GrantApplications";
       .enterSupplierNumber(TEST_CONFIG.supplierNumber)
       .clickElsewhere()
       .clickPaymentInfoSave();
+
+    // Saving the supplier number calls out to CAS to resolve it, which can
+    // transiently fail with "GetAuthTokenAsync: Error retrieving Token".
+    // When that happens the save silently doesn't attach a supplier, leaving
+    // SupplierId empty for the rest of the flow — dismiss and retry once.
+    cy.get("body").then(($body) => {
+      const hasTokenError =
+        $body.text().includes("GetAuthTokenAsync") ||
+        $body.text().includes("Error retrieving Token");
+
+      if (hasTokenError) {
+        cy.log("⚠️ Transient CAS token error on payment save — retrying once");
+        detailsPage.dismissErrorModalIfPresent();
+        detailsPage
+          .enterSupplierNumber(TEST_CONFIG.supplierNumber)
+          .clickElsewhere()
+          .clickPaymentInfoSave();
+      }
+    });
   });
 
   // Must use function() (not arrow) so this.skip() is accessible

applications/Unity.AutoUI/cypress/scripts/chefs-api-config.json

@@ -1,21 +1,31 @@
 {
-    "environments": {
-        "test": {
-            "baseURL": "https://chefs-test.apps.silver.devops.gov.bc.ca",
-            "formId": "46e25863-0ead-4aa8-897f-51e45f79e137",
-            "versionId": "4ef52ead-2cc3-4bdb-a7b7-73be983a7838"
-        },
-        "dev": {
-            "baseURL": "https://chefs-dev.apps.silver.devops.gov.bc.ca",
-            "formId": "233f47f9-b566-46c3-926a-73d565bf710f",
-            "versionId": "1e209d6b-46f5-4ddb-bc79-6e04033231cb"
-        },
-        "uat": {
-            "baseURL": "https://chefs-test.apps.silver.devops.gov.bc.ca",
-            "formId": "f2f45aa7-62c5-49ca-8846-b214e02adb46",
-            "versionId": "1d4d73ec-00e7-4b57-98c9-49d1e0c7d15b"
-        }
+  "environments": {
+    "dev": {
+      "baseURL": "https://chefs-dev.apps.silver.devops.gov.bc.ca",
+      "formId": "233f47f9-b566-46c3-926a-73d565bf710f",
+      "versionId": "1e209d6b-46f5-4ddb-bc79-6e04033231cb"
     },
+    "dev2": {
+      "baseURL": "https://chefs-dev.apps.silver.devops.gov.bc.ca",
+      "formId": "92c0df4c-34f9-4a9a-a1b4-61c12495749c",
+      "versionId": "8218c285-7fa3-42df-b445-7e8ae835fad0"
+    },
+    "test": {
+      "baseURL": "https://chefs-test.apps.silver.devops.gov.bc.ca",
+      "formId": "46e25863-0ead-4aa8-897f-51e45f79e137",
+      "versionId": "4ef52ead-2cc3-4bdb-a7b7-73be983a7838"
+    },
+    "uat": {
+      "baseURL": "https://chefs-test.apps.silver.devops.gov.bc.ca",
+      "formId": "f2f45aa7-62c5-49ca-8846-b214e02adb46",
+      "versionId": "1d4d73ec-00e7-4b57-98c9-49d1e0c7d15b"
+    },
+    "prod": {
+      "baseURL": "https://submit.digital.gov.bc.ca",
+      "formId": "4defd3bf-f57c-4969-94a1-ced745a99ccf",
+      "versionId": "d8736cde-a11a-41be-8800-084f2dfcb825"
+    }
+  },
     "headers": {
         "Accept": "application/json",
         "Content-Type": "application/json"