DC-207 Add: Run Playwright tests in CI; fix: example spec

Author: noxmwalsh

.github/workflows/playwright-e2e.yaml

@@ -0,0 +1,101 @@
+# Playwright E2E Tests
+# Runs end-to-end tests against the full application stack (API + Web)
+# Uses DC state configuration; requires MSSQL for API startup
+
+name: Playwright E2E
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  e2e:
+    name: E2E Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    services:
+      mssql:
+        image: mcr.microsoft.com/mssql/server:2022-latest
+        env:
+          ACCEPT_EULA: Y
+          MSSQL_SA_PASSWORD: YourStrong@Passw0rd
+        ports:
+          - 1433:1433
+        options: >-
+          --health-cmd="/opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P YourStrong@Passw0rd -Q 'SELECT 1' -C -b -o /dev/null || exit 1"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=10
+          --health-start-period=10s
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Determine state connector ref
+        id: connector-ref
+        run: |
+          BRANCH="${{ github.event_name == 'pull_request' && github.head_ref || github.ref_name }}"
+          FALLBACK="${{ github.event_name == 'pull_request' && github.base_ref || 'main' }}"
+          REPO_URL="https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository_owner }}/sebt-self-service-portal-state-connector.git"
+          if git ls-remote --exit-code --heads "$REPO_URL" "refs/heads/${BRANCH}" 1>/dev/null 2>&1; then
+            echo "ref=${BRANCH}" >> "$GITHUB_OUTPUT"
+          else
+            echo "ref=${FALLBACK}" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Checkout state connector
+        uses: actions/checkout@v4
+        with:
+          repository: codeforamerica/sebt-self-service-portal-state-connector
+          ref: ${{ steps.connector-ref.outputs.ref }}
+          path: state-connector
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "10.0.200"
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: "10"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline
+
+      - name: Build backend
+        run: ./.github/workflows/scripts/build-backend.sh --configuration Release
+
+      - name: Install Playwright browsers
+        run: cd src/SEBT.Portal.Web && pnpm exec playwright install --with-deps chromium
+
+      - name: Run Playwright tests
+        env:
+          CI: true
+          STATE: dc
+          NEXT_PUBLIC_STATE: dc
+          ASPNETCORE_ENVIRONMENT: Development
+          ConnectionStrings__DefaultConnection: "Server=localhost,1433;Database=SebtPortal;User Id=sa;Password=YourStrong@Passw0rd;TrustServerCertificate=True;"
+          JwtSettings__SecretKey: "ci-e2e-jwt-secret-at-least-32-characters-long"
+          IdentifierHasher__SecretKey: "ci-e2e-identifier-hasher-key-32chars"
+          Oidc__CompleteLoginSigningKey: "ci-e2e-oidc-signing-key-at-least-32-chars"
+          UseMockHouseholdData: "true"
+        run: cd src/SEBT.Portal.Web && pnpm exec playwright test --project=chromium
+
+      - name: Upload Playwright report
+        uses: actions/upload-artifact@v4
+        if: ${{ !cancelled() }}
+        with:
+          name: playwright-report
+          path: src/SEBT.Portal.Web/playwright-report/
+          retention-days: 7

package.json

@@ -14,6 +14,7 @@
     "ci:build:frontend": "./scripts/ci/build-frontend.sh",
     "ci:build:backend": "./scripts/ci/build-backend.sh",
     "ci:test": "./scripts/ci/test-backend.sh && ./scripts/ci/test-frontend.sh",
+    "ci:test:e2e": "cd src/SEBT.Portal.Web && pnpm test:e2e",
     "ci:test:frontend": "./scripts/ci/test-frontend.sh",
     "ci:test:backend": "./scripts/ci/test-backend.sh",
     "ci:list": "./act-test.sh list",

src/SEBT.Portal.Web/e2e/example.spec.ts

@@ -9,8 +9,8 @@ test.describe('Homepage', () => {
   test('should load and display the homepage', async ({ page }) => {
     await page.goto('/')
 
-    // Check that the page loaded
-    await expect(page).toHaveTitle(/SEBT Portal/i)
+    // Check that the page loaded (homepage redirects to login; title includes state + SUN Bucks)
+    await expect(page).toHaveTitle(/SUN Bucks/i)
 
     // Check for USWDS JavaScript initialization
     const html = page.locator('html')

src/SEBT.Portal.Web/playwright.config.ts

@@ -1,8 +1,13 @@
 import { defineConfig, devices } from '@playwright/test'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
 /**
  * Playwright E2E Testing Configuration
  * Cross-browser testing with mobile viewport support
+ * webServer runs from project root to start both API and Web (pnpm dev)
  */
 export default defineConfig({
   testDir: './e2e',
@@ -44,6 +49,7 @@ export default defineConfig({
   webServer: {
     command: 'pnpm dev',
     url: process.env.BASE_URL || 'http://localhost:3000',
+    cwd: path.resolve(__dirname, '../..'),
     reuseExistingServer: !process.env.CI
   }
 })