@nocobase/app-template-default 1.0.0-beta.83 → 1.0.0-beta.85

package/tests/client/session-preparation.test.tsx

@@ -19,7 +19,7 @@ import {
   createTestI18nRuntime,
 } from '@nocobase/i18n/testing';
 import { act, fireEvent, render, screen } from '@testing-library/react';
-import { useEffect } from 'react';
+import { useEffect, useState } from 'react';
 import { MemoryRouter, Outlet } from 'react-router';
 import { afterEach, expect, it, vi } from 'vitest';
 import { AppRouter } from '../../client/routing/app-router.js';
@@ -80,6 +80,7 @@ async function setup() {
   const accepted = vi.fn();
   const old = Promise.withResolvers<void>();
   function Page() {
+    const [privateFilter, setPrivateFilter] = useState('');
     useEffect(() => {
       let active = true;
       mounted();
@@ -96,6 +97,11 @@ async function setup() {
         <DialogContent>
           <DialogTitle>Protected dialog</DialogTitle>
           <DialogDescription>Protected content</DialogDescription>
+          <input
+            aria-label='Private filter'
+            value={privateFilter}
+            onChange={(event) => setPrivateFilter(event.target.value)}
+          />
         </DialogContent>
       </Dialog>
     );
@@ -170,6 +176,10 @@ async function setup() {
       session = null;
       await act(async () => refresh());
     },
+    switchUser: async () => {
+      session = { user: { id: 'other' }, session: { id: 'other-session' } };
+      await act(async () => refresh());
+    },
   };
 }
 
@@ -195,6 +205,19 @@ it('mounts only after the initial handshake and preserves runtime fail-closed po
   expect(await screen.findByText('Access denied')).toBeVisible();
 });
 
+it('clears mounted private list memory when the signed-in identity changes', async () => {
+  const probe = await setup();
+  await probe.open();
+  const filter = await screen.findByRole('textbox', { name: 'Private filter' });
+  fireEvent.change(filter, { target: { value: 'private condition' } });
+  expect(filter).toHaveValue('private condition');
+  await probe.switchUser();
+  await probe.open();
+  expect(
+    await screen.findByRole('textbox', { name: 'Private filter' }),
+  ).toHaveValue('');
+});
+
 it('keeps a timed-out session closed, supports retry, and reports sign-out failure', async () => {
   vi.useFakeTimers();
   const probe = await setup();

package/tests/client/settings-continuity.test.tsx

@@ -1,10 +1,17 @@
-import { answerApi, renderWithApp } from '@nocobase/app-testing/client';
+import { renderSettingsClient as renderWithApp } from '../helpers/settings-client.js';
+import { answerApi } from '@nocobase/app-testing/client';
 import { apiClientToken, type ClientApplication } from '@nocobase/app-client';
 import {
   AuthorizationClient,
   authorizationClientToken,
 } from '@nocobase/app-plugin-authorization/client';
-import { screen, waitFor, within } from '@testing-library/react';
+import {
+  act,
+  fireEvent,
+  screen,
+  waitFor,
+  within,
+} from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 import { Routes, Route, useLocation } from 'react-router';
 import { expect, it, vi } from 'vitest';
@@ -58,6 +65,79 @@ function Location() {
   );
 }
 
+it.each(['fast', 'slow'] as const)(
+  'keeps the user table on drawer close and only indicates a slow refresh (%s)',
+  async (speed) => {
+    const user = userEvent.setup();
+    let refresh = false;
+    let complete!: () => void;
+    const response = new Promise<void>((resolve) => {
+      complete = resolve;
+    });
+    await renderWithApp(
+      <Routes>
+        <Route path='/settings/users' element={<UsersPage />}>
+          <Route path=':userId' element={<UserDetail />}>
+            <Route path='edit' element={<UserForm />} />
+          </Route>
+        </Route>
+      </Routes>,
+      {
+        route: '/settings/users',
+        namespace,
+        namespaces,
+        services,
+        fetch: answerApi(async ({ path }) => {
+          if (path === 'authorization/permissions')
+            return { data: { unrestricted: true, permissions: [] } };
+          if (path === 'users/options') return options;
+          if (path === 'users/alice') return { data: row };
+          if (refresh) await response;
+          return {
+            data: [{ ...row, name: refresh ? 'Alice refreshed' : row.name }],
+            meta: { total: 1 },
+          };
+        }),
+      },
+    );
+    await user.click(await screen.findByRole('link', { name: 'Alice' }));
+    await waitFor(() =>
+      expect(screen.getByRole('textbox', { name: 'Name *' })).toHaveValue(
+        'Alice',
+      ),
+    );
+    refresh = true;
+    vi.useFakeTimers();
+    try {
+      await act(() => vi.advanceTimersByTimeAsync(1000));
+      expect(screen.queryByText(enUS.settings.loading)).not.toBeInTheDocument();
+      await act(async () => {
+        fireEvent.click(
+          screen.getByRole('button', { name: 'Cancel', exact: true }),
+        );
+      });
+      expect(screen.getByRole('link', { name: 'Alice' })).toBeVisible();
+      expect(screen.queryByText(enUS.settings.loading)).not.toBeInTheDocument();
+      if (speed === 'slow') {
+        await act(() => vi.advanceTimersByTimeAsync(1000));
+        expect(screen.getByText(enUS.settings.loading)).toBeVisible();
+        expect(screen.getByRole('link', { name: 'Alice' })).toBeVisible();
+      }
+      await act(async () => {
+        complete();
+        await response;
+      });
+      await act(() => vi.advanceTimersByTimeAsync(1000));
+      expect(
+        screen.getByRole('link', { name: 'Alice refreshed' }),
+      ).toBeVisible();
+      expect(screen.queryByText(enUS.settings.loading)).not.toBeInTheDocument();
+    } finally {
+      vi.useRealTimers();
+    }
+  },
+);
+
 it('uses role labels and paired server filters, retaining the source and ordering when clearing filters', async () => {
   const calls = vi.fn(({ path }: { path: string }) =>
     path === 'authorization/permissions'
@@ -282,9 +362,9 @@ it.each(['/settings/users', '/users'])(
         `${base}${search}`,
       ),
     );
-    expect(
-      await screen.findByText('Alice updated', { exact: true }),
-    ).toBeVisible();
+    await waitFor(() =>
+      expect(screen.getByText('Alice updated', { exact: true })).toBeVisible(),
+    );
   },
 );
 

package/tests/client/settings-feedback.test.tsx

@@ -10,6 +10,7 @@ import { describe, expect, it, vi } from 'vitest';
 import { Routes, Route } from 'react-router';
 import UsersPage from '../../client/pages/settings/users.js';
 import RolesPage from '../../client/pages/settings/roles.js';
+import { ListRecoveryError } from '../../client/hooks/use-table-url-state.js';
 import { SettingsError } from '../../client/pages/settings/shared.js';
 import enUS from '../../client/locales/en-US.js';
 import zhCN from '../../client/locales/zh-CN.js';
@@ -40,7 +41,7 @@ describe.each([
   ['zh-CN', zhCN],
 ] as const)('%s', (language, copy) => {
   it.each(['users', 'roles'] as const)(
-    'explains the next step for a read-only empty %s list',
+    'keeps the compact empty status and hides creation for a read-only %s list',
     async (kind) => {
       await renderWithApp(
         <Routes>
@@ -63,13 +64,9 @@ describe.each([
           }),
         },
       );
-      expect(
-        await screen.findByText(
-          kind === 'users'
-            ? copy.settings.usersReadOnlyEmpty
-            : copy.settings.rolesReadOnlyEmpty,
-        ),
-      ).toBeVisible();
+      expect((await screen.findByRole('status')).textContent).toBe(
+        copy.listFeedback.empty,
+      );
       expect(
         screen.queryByRole('button', {
           name:
@@ -118,13 +115,9 @@ describe.each([
             kind === 'users' ? copy.settings.newUser : copy.settings.newRole,
         }),
       ).toHaveLength(1);
-      expect(
-        screen.queryByText(
-          kind === 'users'
-            ? copy.settings.usersReadOnlyEmpty
-            : copy.settings.rolesReadOnlyEmpty,
-        ),
-      ).not.toBeInTheDocument();
+      expect(screen.getByRole('status').textContent).toBe(
+        copy.listFeedback.empty,
+      );
     },
   );
 
@@ -151,6 +144,30 @@ describe.each([
     expect(retry).not.toHaveBeenCalled();
   });
 
+  it.each([false, true])(
+    'preserves bounded recovery feedback with inline=%s',
+    async (inline) => {
+      const retry = vi.fn();
+      const message = 'The list changed repeatedly. Refresh to try again.';
+      await renderWithApp(
+        <SettingsError
+          error={new ListRecoveryError(message)}
+          retry={retry}
+          inline={inline}
+        />,
+        { locale: language, namespace, namespaces },
+      );
+      expect(screen.getByText(message)).toBeVisible();
+      expect(screen.queryByText(copy.settings.failed)).not.toBeInTheDocument();
+      expect(screen.queryAllByRole('alert')).toHaveLength(inline ? 0 : 1);
+      expect(retry).not.toHaveBeenCalled();
+      await userEvent.click(
+        screen.getByRole('button', { name: copy.settings.retry }),
+      );
+      expect(retry).toHaveBeenCalledTimes(1);
+    },
+  );
+
   it('keeps a retry for temporary failures and performs it only on demand', async () => {
     const retry = vi.fn();
     await renderWithApp(

package/tests/client/settings-permissions.test.ts

@@ -332,3 +332,38 @@ it('shows a shared plugin action explanation once without duplicating row hints'
   );
   expect(result[0]?.groups[0]?.rows.every((row) => !row.hint)).toBe(true);
 });
+
+it('keeps scope metadata while ungranted without creating a grant or selecting its default', () => {
+  const catalog = {
+    sections: [
+      {
+        name: 'business',
+        title: 'Business',
+        subsections: [{ name: 'orders', resources: [resource] }],
+      },
+    ],
+    recordAccess: [
+      { key: 'mine', title: 'Own' },
+      { key: 'all', title: 'All' },
+    ],
+  } as unknown as Parameters<typeof permissionSections>[0];
+  const grants: Parameters<typeof permissionSections>[1] = [];
+  const row = permissionSections(catalog, grants, (value) =>
+    typeof value === 'string' ? value : value.key,
+  )[0]!.groups[0]!.rows[0]!;
+  expect(row.enabled).toBe(false);
+  expect(row.scopes?.[0]).toMatchObject({
+    id: JSON.stringify(['composite', 'orders', 'edit', 'records']),
+    level: '',
+  });
+  expect(grants).toEqual([]);
+  const enabled = permissionSections(
+    catalog,
+    setPermission(grants, resource, 'edit', true),
+    (value) => (typeof value === 'string' ? value : value.key),
+  )[0]!.groups[0]!.rows[0]!;
+  expect(enabled.scopes?.map((scope) => scope.id)).toEqual(
+    row.scopes?.map((scope) => scope.id),
+  );
+  expect(enabled.scopes?.[0]?.level).toBe('mine');
+});

package/tests/client/settings.test.tsx

@@ -1,4 +1,5 @@
-import { answerApi, renderWithApp } from '@nocobase/app-testing/client';
+import { renderSettingsClient as renderWithApp } from '../helpers/settings-client.js';
+import { answerApi } from '@nocobase/app-testing/client';
 import { apiClientToken, type ClientApplication } from '@nocobase/app-client';
 import {
   AuthorizationClient,

package/tests/client/table-url-state.test.tsx

@@ -4,11 +4,24 @@ import userEvent from '@testing-library/user-event';
 import { useState } from 'react';
 import { useLocation, useNavigate } from 'react-router';
 import { expect, it } from 'vitest';
-import { useTableUrlState } from '../../client/hooks/use-table-url-state.js';
+import {
+  readTableUrlState,
+  useTableUrlState,
+} from '../../client/hooks/use-table-url-state.js';
 
-function Probe() {
+function Probe({
+  sortFormat = 'sort-order',
+}: {
+  sortFormat?: 'sort-order' | 'orderBy';
+}) {
   const [count, setCount] = useState<number>();
-  const state = useTableUrlState({ sortColumns: ['name'], rowCount: count });
+  const [active, setActive] = useState(true);
+  const state = useTableUrlState({
+    sortColumns: ['name', 'updatedAt'],
+    rowCount: count,
+    active,
+    sortFormat,
+  });
   const location = useLocation();
   const navigate = useNavigate();
   return (
@@ -20,7 +33,27 @@ function Probe() {
       </output>
       <output data-testid='url'>{location.search}</output>
       <button onClick={() => setCount(25)}>Loaded</button>
+      <button onClick={() => setActive((value) => !value)}>
+        Toggle active
+      </button>
       <button onClick={() => setCount(10)}>Removed</button>
+      <button
+        onClick={() =>
+          state.onSortingChange([
+            { id: 'name', desc: true },
+            { id: 'updatedAt', desc: false },
+          ])
+        }
+      >
+        Multi sort
+      </button>
+      <button
+        onClick={() =>
+          state.onPaginationChange((old) => ({ ...old, pageSize: 20 }))
+        }
+      >
+        Resize
+      </button>
       <button
         onClick={() => state.onSortingChange([{ id: 'name', desc: true }])}
       >
@@ -93,3 +126,84 @@ it('allows browser Back to restore the preceding page', async () => {
   expect(screen.getByTestId('state')).toHaveTextContent('"pageIndex":2');
   expect(screen.getByTestId('url')).toHaveTextContent('q=kept');
 });
+
+it('starts at page one after resizing even when the table supplies an old page index', async () => {
+  await renderWithApp(<Probe />, {
+    route: '/?page=4&pageSize=10&sort=name&order=desc&q=kept',
+  });
+  await userEvent.click(screen.getByRole('button', { name: 'Resize' }));
+  expect(screen.getByTestId('state')).toHaveTextContent(
+    '"pageIndex":0,"pageSize":20',
+  );
+  expect(screen.getByTestId('url')).toHaveTextContent('order=desc');
+  expect(screen.getByTestId('url')).toHaveTextContent('q=kept');
+});
+
+it('preserves ordered multi-column orderBy and falls back on invalid columns and directions', () => {
+  const options = {
+    sortColumns: ['name', 'updatedAt'],
+    sortFormat: 'orderBy' as const,
+    defaultSorting: [{ id: 'updatedAt', desc: true }],
+  };
+  expect(
+    readTableUrlState(
+      new URLSearchParams('orderBy=name,updatedAt desc&page=2'),
+      options,
+    ),
+  ).toEqual({
+    paginationState: { pageIndex: 1, pageSize: 10 },
+    sortingState: [
+      { id: 'name', desc: false },
+      { id: 'updatedAt', desc: true },
+    ],
+  });
+  for (const value of [
+    'name sideways',
+    'deleted desc',
+    'name,deleted',
+    'name desc extra',
+  ]) {
+    expect(
+      readTableUrlState(new URLSearchParams({ orderBy: value }), options)
+        .sortingState,
+    ).toEqual(options.defaultSorting);
+  }
+});
+
+it('writes and restores the complete existing orderBy sequence', async () => {
+  await renderWithApp(<Probe sortFormat='orderBy' />, {
+    route: '/?page=3&pageSize=20&q=kept',
+  });
+  await userEvent.click(screen.getByRole('button', { name: 'Multi sort' }));
+  expect(screen.getByTestId('state')).toHaveTextContent(
+    '[{"id":"name","desc":true},{"id":"updatedAt","desc":false}]',
+  );
+  expect(screen.getByTestId('state')).toHaveTextContent('"pageIndex":0');
+  await userEvent.click(screen.getByRole('button', { name: 'Next' }));
+  expect(screen.getByTestId('url')).toHaveTextContent(
+    'orderBy=name+desc%2CupdatedAt',
+  );
+  expect(screen.getByTestId('url')).toHaveTextContent('q=kept');
+});
+
+it('keeps ordered multi-sort while deferred deletion recovery corrects the reactivated list', async () => {
+  await renderWithApp(<Probe sortFormat='orderBy' />, {
+    route: '/?page=5&pageSize=10&orderBy=name%20desc,updatedAt&q=kept&tab=open',
+  });
+  await userEvent.click(screen.getByRole('button', { name: 'Toggle active' }));
+  await userEvent.click(screen.getByRole('button', { name: 'Loaded' }));
+  expect(screen.getByTestId('state')).toHaveTextContent('"pageIndex":4');
+  await userEvent.click(screen.getByRole('button', { name: 'Toggle active' }));
+  await waitFor(() =>
+    expect(screen.getByTestId('state')).toHaveTextContent('"pageIndex":2'),
+  );
+  expect(screen.getByTestId('state')).toHaveTextContent(
+    '[{"id":"name","desc":true},{"id":"updatedAt","desc":false}]',
+  );
+  const params = new URLSearchParams(
+    screen.getByTestId('url').textContent ?? '',
+  );
+  expect(params.get('orderBy')).toBe('name desc,updatedAt');
+  expect(params.get('q')).toBe('kept');
+  expect(params.get('tab')).toBe('open');
+});

package/tests/client/user-drawer.test.tsx

@@ -1,4 +1,5 @@
-import { answerApi, renderWithApp } from '@nocobase/app-testing/client';
+import { renderSettingsClient as renderWithApp } from '../helpers/settings-client.js';
+import { answerApi } from '@nocobase/app-testing/client';
 import { apiClientToken, type ClientApplication } from '@nocobase/app-client';
 import {
   AuthorizationClient,

package/tests/client/user-permissions.test.tsx

@@ -1,4 +1,5 @@
-import { answerApi, renderWithApp } from '@nocobase/app-testing/client';
+import { renderSettingsClient as renderWithApp } from '../helpers/settings-client.js';
+import { answerApi } from '@nocobase/app-testing/client';
 import { apiClientToken, type ClientApplication } from '@nocobase/app-client';
 import {
   AuthorizationClient,
@@ -9,7 +10,7 @@ import {
   defineAppRoutes,
   defineClientPlugin,
 } from '@nocobase/app-client/plugins';
-import { screen, waitFor } from '@testing-library/react';
+import { screen, waitFor, within } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 import { Routes, Route } from 'react-router';
 import { describe, expect, it, vi } from 'vitest';
@@ -138,12 +139,36 @@ describe('user permission configuration', () => {
       expect(
         screen.getByRole('heading', { name: words.roleAssignment }),
       ).toBeVisible();
-      expect(screen.getAllByRole('checkbox')).toHaveLength(8);
+      const permissionNames = [
+        words.readUsers,
+        words.createUsers,
+        words.updateUsers,
+        words.disable,
+        words.enable,
+        words.revokeSessions,
+        words.assignRole,
+      ];
+      const permissionCheckboxes = permissionNames.map((name) =>
+        screen.getByRole('checkbox', { name, exact: true }),
+      );
+      expect(screen.getAllByRole('checkbox')).toHaveLength(
+        permissionNames.length,
+      );
       expect(
         screen.queryByRole('checkbox', { name: words.inviteUsers }),
       ).not.toBeInTheDocument();
-      const rowIds = screen.getAllByRole('checkbox').map((node) => node.id);
-      expect(new Set(rowIds).size).toBe(8);
+      const rowIds = permissionCheckboxes.map((node) => node.id);
+      expect(rowIds).not.toContain('');
+      expect(new Set(rowIds).size).toBe(permissionNames.length);
+      const status = within(
+        screen.getByRole('tablist', { name: words.permissionStatus }),
+      );
+      expect(status.getAllByRole('tab')).toHaveLength(3);
+      expect(
+        status.getByRole('tab', { name: words.permissionAll, exact: true }),
+      ).toHaveAttribute('aria-selected', 'true');
+      for (const name of [words.permissionGranted, words.permissionUngranted])
+        expect(status.getByRole('tab', { name, exact: true })).toBeVisible();
       await user.click(
         screen.getByRole('button', { name: words.save, exact: true }),
       );

package/tests/database/mutation-receipts.test.ts

@@ -0,0 +1,45 @@
+import path from 'node:path';
+import { describeMigration } from '@nocobase/app-testing/server';
+import { expect } from 'vitest';
+
+describeMigration('202611020002_create_mutation_receipts', {
+  sources: [
+    {
+      packageName: 'operation-receipts-test',
+      directory: path.resolve(
+        import.meta.dirname,
+        '../../database/main/migrations',
+      ),
+    },
+  ],
+  up: async ({ connection, expectCollection }) => {
+    const receipts = await expectCollection('mutationReceipts').toExist();
+    expect(receipts.primaryKey).toEqual(['id']);
+    await expectCollection('mutationReceipts').toHaveField('expiresAt', {
+      nullable: false,
+    });
+    await connection.query
+      .insertInto('mutationReceipts')
+      .values({
+        id: 'sample',
+        digest: 'digest',
+        result: '{}',
+        expiresAt: new Date(),
+      })
+      .execute();
+    await expect(
+      connection.query
+        .insertInto('mutationReceipts')
+        .values({
+          id: 'sample',
+          digest: 'other',
+          result: '{}',
+          expiresAt: new Date(),
+        })
+        .execute(),
+    ).rejects.toThrow();
+  },
+  down: async ({ expectCollection }) => {
+    await expectCollection('mutationReceipts').not.toExist();
+  },
+});

package/tests/fixtures/form-feedback/README.md

@@ -0,0 +1,33 @@
+# Isolated form feedback verification
+
+This test-only workload checks newly generated Default and Examples applications. It is not registered in either template runtime. Use independent databases and storage, native sign-in and the existing administrator action; never install it in a management or production application.
+
+## Prepare two new applications
+
+Create one application from each selected target template with `pnpm create @nocobase/app@beta <name> --template <package>@<exact-version> --no-install --json`. Use actual released packages or immutable, explicitly versioned candidates in an isolated registry. Read each generated application's instructions, install dependencies and record exact template/runtime versions, lockfiles, source commits and package integrity. Keep the target's feedback component and auth/settings sources unchanged.
+
+Copy `equipment-layout.tsx`, `equipment-detail.tsx`, `equipment.tsx` and `equipment-validation.tsx` into the application's `client/pages/`; copy `equipment-server.ts` as `server/routes/equipment-fixture.ts` and `equipment-migration.ts` as `database/main/migrations/209901010001_equipment_fixture.ts`. Keep an executed migration unchanged. Register `equipmentRoutes` in the server route contributions.
+
+Declare `/equipment` with required native authentication, `authz: { resource: { type: 'user', id: '*' }, action: 'create' }` and the equipment layout. Its `dialog` and `drawer` children load the equipment editor; its `:equipmentId` detail child has an `edit` child loading that editor. The layout renders the page editor at its own path and the outlet on child paths. Keep the actual RouteDialog, RouteDrawer and RouteChildPage. Declare `/equipment-validation` loading `equipment-validation.tsx` with the same authentication and administrator action. The server independently checks that native permission.
+
+Add the `equipment` application translation group: title, name, help, department, departmentError, attachment, retainedAttachment, longForm, response, save, saved, itemError, customCopy. English values are “Equipment borrowing”, “Equipment name”, “Keep this equipment identifier.”, “Department”, “Department must be Operations.”, “Attachment”, “Retained attachment”, “Additional equipment information.”, “Response”, “Save request”, “Saved; workflow submitted.”, “Check this borrowed item.” and “Customized equipment workflow and asset fields are preserved.” respectively. Add corresponding Chinese application overrides and preserve existing system groups.
+
+Initialize and check configuration through the native CLI, using a separate SQLite database and storage for each app. Start one fixture at a time with `NOCOBASE_STRICT_STARTUP=true APP_SERVER_PORT=<port> pnpm dev`, record its printed server Local URL, and verify the served `client/runtime.ts` identifies the intended application. Strict startup isolates the backend port while several development tasks share a host. Never copy configuration secrets or native sessions between applications or into evidence.
+
+Run `pnpm typecheck` after wiring the workload. Install the application's matching Playwright Chromium shell in a task-local directory and set `PLAYWRIGHT_BROWSERS_PATH`.
+
+## Inline feedback regression
+
+From each generated application run:
+
+```bash
+node tests/fixtures/form-feedback/verify-inline.mjs <printed-server-entry-url> <evidence-directory> <sample-name>
+```
+
+The verifier accepts only an explicitly supplied loopback `/main/` entry. It uses the isolated initializer's default native administrator or `TEST_ADMIN_USERNAME`/`TEST_ADMIN_PASSWORD` from the environment; it saves no session.
+
+Mapped field and array-level reasons appear only beside their controls, without a top summary or navigation list. Submission still opens required regions, scrolls and focuses the first editable error. Repeated submission does not accumulate errors; corrections and successful retry clear obsolete marks while preserving input, selected files, existing attachment references and help/error associations. Unknown paths, permission/network failures and unavailable editable focus targets retain a safe accessible form message. The script checks these cases in a real routed drawer and saves English screenshots and machine-readable results.
+
+The broader `verify.mjs` fixture remains available for layout order, row identities, long forms, dialog/drawer/detail routes, native permission checks and the fictional submitted/approved process. Its failure modes are explicit test inputs, not external providers. This fixture does not verify resumable uploads or a commercial approval provider.
+
+Existing source reconciliation support is documented in the installed upgrade Skill's `references/form-feedback-upgrade.md`. Preserve application-owned business code and executed migrations when using that support; creating old applications or replaying upgrades is not part of this inline regression.

package/tests/fixtures/form-feedback/equipment-detail.tsx

@@ -0,0 +1,11 @@
+import { Outlet } from 'react-router';
+import type { ReactElement } from 'react';
+
+export default function EquipmentDetail(): ReactElement {
+  return (
+    <section aria-label='Equipment record detail'>
+      <h2>Equipment record detail</h2>
+      <Outlet />
+    </section>
+  );
+}

package/tests/fixtures/form-feedback/equipment-layout.tsx

@@ -0,0 +1,15 @@
+import { Outlet, useLocation } from 'react-router';
+import type { ReactElement } from 'react';
+import EquipmentFixture from './equipment.js';
+
+export default function EquipmentLayout(): ReactElement {
+  const { pathname } = useLocation();
+  return (
+    <div className='relative h-full'>
+      <section aria-label='Equipment requests'>
+        Equipment borrowing requests
+      </section>
+      {pathname === '/equipment' ? <EquipmentFixture /> : <Outlet />}
+    </div>
+  );
+}

package/tests/fixtures/form-feedback/equipment-migration.ts

@@ -0,0 +1,27 @@
+// Test-only schema, installed before the customized application's source upgrade.
+import { defineMigration } from '@nocobase/db';
+export default defineMigration({
+  name: '209901010001_equipment_fixture',
+  async up({ builder }) {
+    await builder.createCollection('equipmentFixture', (collection) => {
+      collection.string('id').primary().notNull();
+      for (const key of [
+        'name',
+        'department',
+        'attachment',
+        'workflow',
+        'customField',
+      ])
+        collection.string(key, { nullable: false });
+    });
+    await builder.createCollection('equipmentFixtureHistory', (collection) => {
+      collection.string('id').primary().notNull();
+      for (const key of ['recordId', 'event', 'actor'])
+        collection.string(key, { nullable: false });
+    });
+  },
+  async down({ builder }) {
+    await builder.dropCollection('equipmentFixtureHistory');
+    await builder.dropCollection('equipmentFixture');
+  },
+});