Fix seed endpoint URL, auth requirement, and request format in 5.1 Playwright examples

Author: workcontrolgit

blogs/series-5-devops-data/5.1-database-seeding.md

@@ -424,7 +424,7 @@ This is useful for:
 * Seeding specific row counts in different environments
 * Integration test setup — seed exactly the records you need via an API call
 
-The command is dispatched via an API endpoint that sends a POST to `api/v1/positions/seed`. This can be called from Playwright tests, CI scripts, or Swagger UI.
+The command is dispatched via `POST /api/v1/positions/AddMock`. It requires a valid Bearer token (`[Authorize]`) and accepts `{ "RowCount": N }` as a JSON body. It can be called from Playwright tests, CI scripts, or Swagger UI.
 
 ---
 
@@ -469,7 +469,7 @@ Playwright provides a `request` fixture — an `APIRequestContext` that makes HT
 
 ### Calling the Seed Endpoint
 
-The `InsertMockPositionCommand` is exposed as `POST /api/v1/positions/seed`. Here is a complete implementation of `seed.spec.ts`:
+The `InsertMockPositionCommand` is exposed as `POST /api/v1/positions/AddMock`. It requires a Bearer token (`[Authorize]`) and accepts a JSON body. Here is a complete implementation of `seed.spec.ts`:
 
 ```typescript
 // Tests/AngularNetTutorial-Playwright/tests/seed.spec.ts
@@ -480,44 +480,58 @@ const API_BASE = process.env.API_URL ?? 'https://localhost:44378';
 test.describe('Database seeding via API', () => {
 
   test('seed positions', async ({ request }) => {
-    // POST /api/v1/positions/seed?rowCount=25
+    // Acquire a Bearer token first (use your test credentials)
+    const tokenResponse = await request.post(`${API_BASE}/api/v1/account/authenticate`, {
+      data: { userName: 'ashtyn1', password: 'Pa$$word123' },
+    });
+    const { jwToken } = await tokenResponse.json();
+
+    // POST /api/v1/positions/AddMock with JSON body
     // InsertMockPositionCommand generates positions with valid FK references
-    const response = await request.post(`${API_BASE}/api/v1/positions/seed`, {
-      params: { rowCount: 25 },
+    const response = await request.post(`${API_BASE}/api/v1/positions/AddMock`, {
+      headers: { Authorization: `Bearer ${jwToken}` },
+      data: { RowCount: 25 },
     });
 
     expect(response.status()).toBe(200);
 
-    const rowsInserted: number = await response.json();
-    console.log(`Seeded ${rowsInserted} positions`);
-    expect(rowsInserted).toBeGreaterThan(0);
+    const result = await response.json();
+    console.log(`Seeded ${result.data} positions`);
+    expect(result.succeeded).toBe(true);
   });
 
 });
 ```
 
-**`params: { rowCount: 25 }`** — Playwright serializes this as a query string: `?rowCount=25`. The command handler uses this value to control how many positions Bogus generates.
+**`POST /api/v1/positions/AddMock`** — the actual route registered by the `[Route("AddMock")]` attribute on `PositionsController`. The endpoint is protected with `[Authorize]`, so a valid Bearer token is required.
 
-**`request.post()`** — uses the `request` fixture from the `test` parameters. No browser is opened. The call completes before the test body continues.
+**`data: { RowCount: 25 }`** — Playwright serializes this as a JSON body. `InsertMockPositionCommand` binds from the request body (POST default). Property name matches the C# property: `RowCount` (Pascal case).
 
-**`await response.json()`** — the endpoint returns the count of rows inserted as a plain integer. The assertion confirms at least one record was created.
+**`result.data`** — the endpoint returns a `Result<int>` wrapper with `{ succeeded: true, data: 25, ... }`, not a plain integer. Access the row count via `result.data`.
 
 ### Seeding in `beforeAll` for a Test Suite
 
 When multiple tests in the same file need the seeded data, call the seed endpoint in `beforeAll` so it runs once before the suite rather than repeating it in every test:
 
 ```typescript
 // Tests/AngularNetTutorial-Playwright/tests/positions.spec.ts
-import { test, expect, request as playwrightRequest } from '@playwright/test';
+import { test, expect } from '@playwright/test';
 
 const API_BASE = process.env.API_URL ?? 'https://localhost:44378';
 
 test.describe('Positions list', () => {
 
   test.beforeAll(async ({ request }) => {
+    // Acquire a Bearer token
+    const tokenResponse = await request.post(`${API_BASE}/api/v1/account/authenticate`, {
+      data: { userName: 'ashtyn1', password: 'Pa$$word123' },
+    });
+    const { jwToken } = await tokenResponse.json();
+
     // Ensure at least 50 positions exist before any test in this suite runs
-    await request.post(`${API_BASE}/api/v1/positions/seed`, {
-      params: { rowCount: 50 },
+    await request.post(`${API_BASE}/api/v1/positions/AddMock`, {
+      headers: { Authorization: `Bearer ${jwToken}` },
+      data: { RowCount: 50 },
     });
   });
 
@@ -555,8 +569,19 @@ const API_BASE = process.env.API_URL ?? 'https://localhost:44378';
 async function globalSetup() {
   const apiContext = await request.newContext({ baseURL: API_BASE });
 
-  const response = await apiContext.post('/api/v1/positions/seed', {
-    params: { rowCount: 100 },
+  // Acquire a Bearer token using test credentials
+  const tokenResponse = await apiContext.post('/api/v1/account/authenticate', {
+    data: { userName: 'ashtyn1', password: 'Pa$$word123' },
+  });
+  if (!tokenResponse.ok()) {
+    throw new Error(`Auth failed: ${tokenResponse.status()} ${await tokenResponse.text()}`);
+  }
+  const { jwToken } = await tokenResponse.json();
+
+  // POST /api/v1/positions/AddMock with Bearer token and JSON body
+  const response = await apiContext.post('/api/v1/positions/AddMock', {
+    headers: { Authorization: `Bearer ${jwToken}` },
+    data: { RowCount: 100 },
   });
 
   if (!response.ok()) {
@@ -570,7 +595,7 @@ async function globalSetup() {
 export default globalSetup;
 ```
 
-`request.newContext()` in `globalSetup` creates a standalone API context outside of any test. `await apiContext.dispose()` releases it when done. Throwing an error from `globalSetup` fails the entire run immediately with a clear message rather than silently running tests against an unseeded database.
+`request.newContext()` in `globalSetup` creates a standalone API context outside of any test. The auth call acquires a short-lived JWT using the same test credentials used in browser-based tests. `await apiContext.dispose()` releases it when done. Throwing on either failure (auth or seed) fails the entire run immediately with a clear message rather than silently running tests against an unseeded database.
 
 ### When to Use Each Approach
 
@@ -592,7 +617,7 @@ export default globalSetup;
 
 **Development-only seeding with an idempotency check.** The entire seed block is inside `if (app.Environment.IsDevelopment())` — production never auto-seeds. The `needsSeed` check (`!dbContext.Departments.Any() || !dbContext.Employees.Any()`) ensures the seeder only runs on an empty database, so restarting the API doesn't duplicate records.
 
-**`InsertMockPositionCommand` for runtime seeding.** The CQRS `POST /api/v1/positions/seed` endpoint lets you add more positions without restarting the API. It fetches existing departments and salary ranges from the database and passes them to `PositionInsertBogusConfig` — so every generated position has valid FK references to real rows. This pattern extends to any entity that has FK dependencies.
+**`InsertMockPositionCommand` for runtime seeding.** The CQRS `POST /api/v1/positions/AddMock` endpoint lets you add more positions without restarting the API. It fetches existing departments and salary ranges from the database and passes them to `PositionInsertBogusConfig` — so every generated position has valid FK references to real rows. This pattern extends to any entity that has FK dependencies.
 
 ---