cabloy 5.1.147 → 5.1.149

package/repo-docs/fullstack/parallel-worktree-environment.md

@@ -75,10 +75,10 @@ For privacy, the skill writes only to absent or empty permitted broad local file
 
 Use commands from the active repository root.
 
-| Edition      | Marker             | Frontend command                                   | Managed clean E2E              |
-| ------------ | ------------------ | -------------------------------------------------- | ------------------------------ |
-| Cabloy Basic | `__CABLOY_BASIC__` | `npm run dev:zova:admin` or `npm run dev:zova:web` | `npm run test:e2e`             |
-| Cabloy Start | `__CABLOY_START__` | `npm run dev:zova:admin` or `npm run dev:zova:web` | `npm run test:e2e:start:clean` |
+| Edition      | Marker             | Frontend command                                   | Managed clean E2E  |
+| ------------ | ------------------ | -------------------------------------------------- | ------------------ |
+| Cabloy Basic | `__CABLOY_BASIC__` | `npm run dev:zova:admin` or `npm run dev:zova:web` | `npm run test:e2e` |
+| Cabloy Start | `__CABLOY_START__` | `npm run dev:zova:admin` or `npm run dev:zova:web` | `npm run test:e2e` |
 
 Run one frontend command, not both, in each worktree. Both managed clean E2E workflows read Vona's effective local `SERVER_LISTEN_PORT`, then reset, start, and target that local runtime.
 

package/repo-docs/fullstack/quickstart.md

@@ -128,20 +128,20 @@ Cabloy Start is checked out from the licensed private repository rather than cre
 ```text
 repo-e2e/config/
 repo-e2e/scripts/
-repo-e2e/specs/cabloy-start/
+repo-e2e/specs/
 ```
 
-The public Cabloy upgrade flow does not synchronize or repair those Start E2E files, the `test:e2e:start*` scripts, or `@playwright/test`. Keep project-owned browser scenarios outside the baseline paths, for example under `repo-e2e/specs/my-project/`.
+The public Cabloy upgrade flow does not synchronize or repair those private Start E2E files, its root E2E scripts, or `@playwright/test`. Keep project-owned browser scenarios in the flat `repo-e2e/specs/` directory under distinct filenames, for example `repo-e2e/specs/my-project.spec.ts`.
 
 Prepare and run the managed Start baseline locally with:
 
 ```bash
 npm run build:zova
 npm run deps:vona
-npm run test:e2e:start:clean
+npm run test:e2e
 ```
 
-The managed command requires port `7102` to be available and owns the local reset and Vona worker lifecycle. For a separately managed target, set `START_E2E_BASE_URL` and use `test:e2e:start`, `test:e2e:start:web`, or `test:e2e:start:admin`; those commands do not reset, build, start, or stop the target. Install Chromium once when needed with `npx playwright install chromium`. See [Repo Scripts](/reference/repo-scripts#ssr-browser-checks) for the complete command variants.
+The managed command checks the effective local server port and owns the local reset and Vona worker lifecycle. For a separately managed target, set `E2E_BASE_URL` and use `npm run test:e2e:fast`; this mode does not reset, build, start, or stop the target. Select surfaces with `--tag @web` or `--tag @admin`, and exact scenarios with native `--grep` arguments. Install Chromium once when needed with `npx playwright install chromium`. See [Repo Scripts](/reference/repo-scripts#ssr-browser-checks) for the complete command variants.
 
 ## 7. Next steps for framework-aware development
 

package/repo-docs/reference/repo-scripts.md

@@ -63,10 +63,8 @@ Cabloy Start exposes the equivalent Start repository surface:
 - `npm run start:one`
 - `npm run test`
 - `npm run db:reset`
-- `npm run test:e2e:start`
-- `npm run test:e2e:start:web`
-- `npm run test:e2e:start:admin`
-- `npm run test:e2e:start:clean`
+- `npm run test:e2e`
+- `npm run test:e2e:fast`
 - `npm run tsc`
 
 Cabloy Start does not expose Basic Commerce or root documentation wrappers.
@@ -96,10 +94,10 @@ The Start E2E baseline is maintained in the private repository:
 ```text
 repo-e2e/config/
 repo-e2e/scripts/
-repo-e2e/specs/cabloy-start/
+repo-e2e/specs/
 ```
 
-The public-package upgrade flow does not source or reconcile the Start baseline, its `test:e2e:start*` scripts, or `@playwright/test`. Keep project browser tests outside the baseline paths, for example under `repo-e2e/specs/my-project/`.
+The public-package upgrade flow does not source or reconcile the private Start baseline, its root E2E scripts, or `@playwright/test`. Keep project browser tests in the flat `repo-e2e/specs/` directory under distinct filenames, for example `repo-e2e/specs/my-project.spec.ts`.
 
 ## SSR browser checks
 
@@ -158,24 +156,24 @@ The Start suite exercises Web at `/` and Admin at `/admin` through Vona's SSR di
 ```bash
 npm run build:zova
 npm run deps:vona
-npm run test:e2e:start:clean
+npm run test:e2e
 ```
 
 ```bash
 # Exact acceptance scenario
-npm run test:e2e:start -- --grep ATP-START-FLOW-01
+npm run test:e2e:fast cabloy-start -- --grep ATP-START-FLOW-01
 
 # Category or surface selection
-npm run test:e2e:start:clean -- --grep @smoke
-npm run test:e2e:start:clean -- --grep @admin
+npm run test:e2e:fast cabloy-start -- --tag @smoke
+npm run test:e2e:fast cabloy-admin -- --tag @admin --tag @cabloy-admin
 ```
 
-For an externally managed Start target, set `START_E2E_BASE_URL` and use matching aggregate, surface, or forwarded-tag commands. The target owner is responsible for data, cache, and artifact freshness:
+For an externally managed Start target, set `E2E_BASE_URL` and use `npm run test:e2e:fast`. The target owner is responsible for data, cache, artifact freshness, and process lifecycle:
 
 ```bash
-START_E2E_BASE_URL=http://127.0.0.1:7102 npm run test:e2e:start
-START_E2E_BASE_URL=http://127.0.0.1:7102 npm run test:e2e:start:admin
-START_E2E_BASE_URL=http://127.0.0.1:7102 npm run test:e2e:start -- --grep @web
+E2E_BASE_URL=http://127.0.0.1:7102 npm run test:e2e:fast
+E2E_BASE_URL=http://127.0.0.1:7102 npm run test:e2e:fast cabloy-admin -- --tag @admin
+E2E_BASE_URL=http://127.0.0.1:7102 npm run test:e2e:fast cabloy-start -- --tag @web
 ```
 
 Browser commands consume existing SSR and REST artifacts; they never rebuild them. Install Chromium once when needed with `npx playwright install chromium`.

package/repo-e2e/specs/cabloy-basic.spec.ts

@@ -1,4 +1,4 @@
-import type { Locator, Page } from '@playwright/test';
+import type { Locator, Page, Route } from '@playwright/test';
 
 import { expect, test } from '@playwright/test';
 
@@ -56,6 +56,39 @@ function waitForStudentSelect(page: Page) {
   });
 }
 
+function installStudentCreateResponseCapture(page: Page) {
+  let studentId: string | number | undefined;
+  const handler = async (route: Route) => {
+    const request = route.request();
+    const url = new URL(request.url());
+    if (
+      request.method() !== 'POST' ||
+      url.pathname !== '/api/training/student' ||
+      request.headers()['x-vona-openapi-schema']
+    ) {
+      await route.continue();
+      return;
+    }
+    const response = await route.fetch();
+    const payload = await response.json();
+    if (response.ok() && ['string', 'number'].includes(typeof payload.data)) {
+      studentId = payload.data;
+    }
+    await route.fulfill({ response });
+  };
+  return {
+    async install() {
+      await page.route('**/api/training/student', handler);
+    },
+    async uninstall() {
+      await page.unroute('**/api/training/student', handler);
+    },
+    get studentId() {
+      return studentId;
+    },
+  };
+}
+
 async function getFieldGeometry(locator: Locator): Promise<IFieldGeometry> {
   return locator.evaluate(element => {
     const field = element.closest('label')?.parentElement;
@@ -348,3 +381,145 @@ test(
     expect(pageErrors).toEqual([]);
   },
 );
+
+test(
+  'ATP-BASIC-FORM-01: Training Student content remains in the Basic Information tab',
+  { tag: ['@admin', '@flow'] },
+  async ({ page }) => {
+    const pageErrors = collectPageErrors(page);
+    await loginAsAdmin(page);
+
+    const response = await page.goto('/admin/rest/resource/training-student%3Astudent/create', {
+      waitUntil: 'load',
+    });
+    expect(response?.ok()).toBeTruthy();
+    await expect(page.locator('html')).toHaveAttribute('data-zova-hydrated', 'admin');
+
+    const basicInformationTab = page.getByRole('tab', { name: 'Basic Information', exact: true });
+    const studentContentGroup = page
+      .locator('fieldset')
+      .filter({ has: page.locator('legend').filter({ hasText: /^Student Content$/ }) });
+    await expect(studentContentGroup).toHaveCount(1);
+    await expect(
+      studentContentGroup.getByText('Description Markdown', { exact: true }),
+    ).toBeVisible();
+
+    const studentContentPanel = studentContentGroup.locator('xpath=ancestor::*[@role="tabpanel"]');
+    await expect(studentContentPanel).toHaveCount(1);
+    const basicInformationTabId = await basicInformationTab.getAttribute('id');
+    expect(basicInformationTabId).not.toBeNull();
+    await expect(studentContentPanel).toHaveAttribute('aria-labelledby', basicInformationTabId!);
+    expect(pageErrors).toEqual([]);
+  },
+);
+
+test(
+  'ATP-BASIC-SUMMARY-01: Training Student summary renders Markdown HTML in a dialog',
+  { tag: ['@admin', '@flow'] },
+  async ({ page }) => {
+    const pageErrors = collectPageErrors(page);
+    await loginAsAdmin(page);
+
+    const studentName = `Summary E2E ${Date.now()}`;
+    const createResponseCapture = installStudentCreateResponseCapture(page);
+    let studentId: string | number | undefined;
+    await createResponseCapture.install();
+    try {
+      const createPageResponse = await page.goto(
+        '/admin/rest/resource/training-student%3Astudent/create',
+        { waitUntil: 'load' },
+      );
+      expect(createPageResponse?.ok()).toBeTruthy();
+      await expect(page.locator('html')).toHaveAttribute('data-zova-hydrated', 'admin');
+      await page
+        .getByRole('group', { name: 'Student Name *', exact: true })
+        .getByRole('textbox')
+        .fill(studentName);
+      await page
+        .getByRole('group', { name: 'Mobile *', exact: true })
+        .getByRole('textbox')
+        .fill('13812345678');
+      await page
+        .locator('.ProseMirror')
+        .last()
+        .fill(`## Summary heading\n\nSummary paragraph ${studentName}`);
+      await page.getByRole('tab', { name: 'Student Training Records', exact: true }).click();
+      await page.getByText('Foundation Track', { exact: true }).click();
+
+      const submitButton = page.getByRole('button', { name: 'Submit', exact: true });
+      await expect(submitButton).toBeEnabled();
+      await submitButton.click();
+      await expect(page).toHaveURL(/\/admin\/(?:\?|$)/);
+      studentId = createResponseCapture.studentId;
+      expect(['string', 'number']).toContain(typeof studentId);
+
+      const response = await page.goto('/admin/rest/resource/training-student%3Astudent', {
+        waitUntil: 'load',
+      });
+      expect(response?.ok()).toBeTruthy();
+      await expect(page.locator('html')).toHaveAttribute('data-zova-hydrated', 'admin');
+
+      const filterName = page.getByLabel('Student Name');
+      await expect(filterName).toBeVisible();
+      await filterName.fill(studentName);
+      const searchResponse = waitForStudentSelect(page);
+      await page.getByRole('button', { name: 'Search', exact: true }).click();
+      await searchResponse;
+
+      const row = page.locator('tr').filter({ hasText: studentName });
+      await expect(row).toHaveCount(1);
+      const summaryResponse = page.waitForResponse(response => {
+        const url = new URL(response.url());
+        return (
+          response.request().method() === 'GET' &&
+          response.ok() &&
+          url.pathname === `/api/training/student/summary/${studentId}` &&
+          !response.request().headers()['x-vona-openapi-schema']
+        );
+      });
+      await row.getByRole('button', { name: 'Summary', exact: true }).click();
+      await summaryResponse;
+
+      const description = page.locator('.student-summary-description');
+      await expect(description).toBeVisible();
+      await expect(description.locator('h2')).toHaveText('Summary heading');
+      await expect(description).toContainText(`Summary paragraph ${studentName}`);
+      expect(pageErrors).toEqual([]);
+    } finally {
+      try {
+        if (studentId !== undefined) {
+          const description = page.locator('.student-summary-description');
+          if (await description.count()) {
+            await description.locator('xpath=../..').getByRole('button').click();
+          }
+          const row = page.locator('tr').filter({ hasText: studentName });
+          if (!(await row.count())) {
+            const response = await page.goto('/admin/rest/resource/training-student%3Astudent', {
+              waitUntil: 'load',
+            });
+            expect(response?.ok()).toBeTruthy();
+            await expect(page.locator('html')).toHaveAttribute('data-zova-hydrated', 'admin');
+            await page.getByLabel('Student Name').fill(studentName);
+            const searchResponse = waitForStudentSelect(page);
+            await page.getByRole('button', { name: 'Search', exact: true }).click();
+            await searchResponse;
+          }
+          const deleteResponse = page.waitForResponse(response => {
+            const url = new URL(response.url());
+            return (
+              response.request().method() === 'DELETE' &&
+              response.ok() &&
+              url.pathname === `/api/training/student/deleteForce/${studentId}` &&
+              !response.request().headers()['x-vona-openapi-schema']
+            );
+          });
+          await row.getByRole('button', { name: 'Force Delete', exact: true }).click();
+          await page.getByRole('button', { name: 'Yes', exact: true }).click();
+          await deleteResponse;
+        }
+      } finally {
+        await createResponseCapture.uninstall();
+      }
+    }
+  },
+);

package/vona/src/suite/a-training/modules/training-student/package.json

@@ -46,6 +46,7 @@
   "title": "training-student",
   "vonaModule": {
     "dependencies": {
+      "a-markdown": "5.0.0",
       "a-vona": "5.0.0"
     },
     "fileVersion": 1