Compare commits

...

10 Commits

Author SHA1 Message Date
a6bd4b0432 feat(routes): 接线 /new-feature 与 /ai-feature(admin-gated 页内守护)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:56:52 +08:00
4e0e974473 feat(ai-feature): AI ①面入口页 + api/ai.ts(auto-develop,恒 READY_FOR_HUMAN_REVIEW 人审)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:55:53 +08:00
8f94ba3c3d feat(new-feature): 人走五环编排壳页 NewFeatureShell(建模→recipe→compile→设计器→发布)
复用 ModelerFields(FieldTable)/ReferencePicker 在实体步内置 [+ 新建实体] Dialog(§B.9-4),
建含引用列的新实体在编排流里可达,建成用返回 {entityId,tablename} 回填进 recipe 步。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:54:26 +08:00
bfb076f803 feat(design-center): admin 入口按钮 +新建功能 / ⚡AI建功能
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:51:26 +08:00
4e7a95cc20 feat(modeler): reference-column picker (target entity + display column) per DECISION-1
引用列加载改用内部 selected 态(父级 onChange 不一定回写 value,列加载不能只依赖 value)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:39:39 +08:00
fef5e33a7a feat(modeler): field table + add-field dialog + ui-type to api-type mapping (buildAttribute)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:38:14 +08:00
915443f585 feat(modeler): ModelerPage shell + /modeler route + entity list + new-entity dialog
canSubmit 去掉 rows.length>0 约束以满足 Task 15 测试(有效表名即可提交);字段表 Task 16 补。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:37:15 +08:00
4b9c9338f3 feat(modeler): meta/recipe/publish api modules + vitest jest-dom setup
listRecipes 按 §B.9-2 改为静态常量({id,label},不调 /api/ai/page-recipes)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:35:43 +08:00
ae0155eb2c fix(web): editor.html CSS 改 import 进 bundle,修生产构建 404
editor.html 三条 /node_modules/*.css 绝对 link 在 vite build 后不入 dist,
preview/静态托管下 404 → 设计器裸样式。改由 src/editor/main.tsx import,
rollup 收集进 dist/assets/*.css。dev 不受影响(vite 转译同源)。
注:amis-ui/amis-editor-core 的 exports 字段不暴露 css 子路径,裸包名 import 被 rollup 拒绝,
故用相对 node_modules 路径直引真实 css 文件。
REQUIRED-before-any-hosted-demo, OPTIONAL-for-pure-dev。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:33:34 +08:00
690f4c755e fix(web): dev 反代默认目标 8084→8093,fresh checkout 开箱即通
.env.local(8093) 被 gitignore 排除,新克隆退回 .env/vite.config 的 8084(local profile)死口。
统一提交进库的默认值为 8093(dev profile),无需手建 .env.local 即可联调。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 09:31:18 +08:00
28 changed files with 1820 additions and 8 deletions

5
.env
View File

@@ -1,2 +1,3 @@
# 后端反代目标。后端默认 8084(local profile);若 8084 被占改为 8090,此处同步改。 # 后端反代目标。dev profile 默认 8093(本机联调跑这个口)。
VITE_BACKEND_TARGET=http://localhost:8084 # 若端口冲突,复制本文件为 .env.local 并改 VITE_BACKEND_TARGET(.env.local 已 gitignore,不入库)。
VITE_BACKEND_TARGET=http://localhost:8093

View File

@@ -5,10 +5,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>EIP4 页面设计器</title> <title>EIP4 页面设计器</title>
<!-- amis-editor 独立入口:用 npm 包版 amis,与主应用 sdk-local 完全隔离 --> <!-- amis-editor 独立入口:用 npm 包版 amis,与主应用 sdk-local 完全隔离 -->
<!-- CSS 在 HTML 里直接引用,绕开 vite esbuild 对 amis-ui 包路径的解析 --> <!-- CSS 由 src/editor/main.tsx import 引入(vite build 收集进 dist,避免绝对包路径在生产构建 404)-->
<link rel="stylesheet" href="/node_modules/amis-editor-core/lib/style.css" />
<link rel="stylesheet" href="/node_modules/amis-ui/lib/themes/default.css" />
<link rel="stylesheet" href="/node_modules/amis-ui/lib/helper.css" />
<style> <style>
html, body, #editor-root { height: 100%; margin: 0; overflow: hidden; } html, body, #editor-root { height: 100%; margin: 0; overflow: hidden; }
/* amis-editor 自带 CSS 未把 .ae-Editor 约束到容器高度 → 它按内容自然撑高(高页面如 /* amis-editor 自带 CSS 未把 .ae-Editor 约束到容器高度 → 它按内容自然撑高(高页面如

47
src/App.routes.test.tsx Normal file
View File

@@ -0,0 +1,47 @@
import '@testing-library/jest-dom';
import { render, screen, waitFor } from '@testing-library/react';
import { MemoryRouter, Routes, Route } from 'react-router-dom';
import { vi, describe, it, expect } from 'vitest';
import { NewFeatureShell } from './pages/NewFeatureShell';
import { AiFeatureForm } from './pages/AiFeatureForm';
vi.mock('./auth/token', () => ({
getProfile: () => ({ userId: 'ADMIN', account: 'admin', name: 'x', roles: [] }),
}));
vi.mock('./api/meta', () => ({ listEntities: vi.fn().mockResolvedValue([]), createEntity: vi.fn() }));
vi.mock('./api/recipe', () => ({
listRecipes: () => [{ id: 'maintenance-crud-v1', label: '维护型 CRUD' }],
compileRecipe: vi.fn(),
}));
vi.mock('./api/publish', () => ({ publishFeature: vi.fn() }));
vi.mock('./api/menu', () => ({ fetchMenu: vi.fn().mockResolvedValue({ roots: [] }), collectLeaves: vi.fn() }));
vi.mock('./api/ai', async (io) => {
const actual = await io<typeof import('./api/ai')>();
return { ...actual, autoDevelop: vi.fn() };
});
describe('新路由可达', () => {
it('/new-feature 渲染 NewFeatureShell', async () => {
render(
<MemoryRouter initialEntries={['/new-feature']}>
<Routes>
<Route path="/new-feature" element={<NewFeatureShell />} />
<Route path="/ai-feature" element={<AiFeatureForm />} />
</Routes>
</MemoryRouter>,
);
await waitFor(() => expect(screen.getByTestId('new-feature-shell')).toBeInTheDocument());
});
it('/ai-feature 渲染 AiFeatureForm', () => {
render(
<MemoryRouter initialEntries={['/ai-feature']}>
<Routes>
<Route path="/new-feature" element={<NewFeatureShell />} />
<Route path="/ai-feature" element={<AiFeatureForm />} />
</Routes>
</MemoryRouter>,
);
expect(screen.getByTestId('ai-feature-form')).toBeInTheDocument();
});
});

View File

@@ -8,6 +8,9 @@ import { PageRenderPage } from './pages/PageRenderPage';
import { TodoPage } from './pages/TodoPage'; import { TodoPage } from './pages/TodoPage';
import { WorkbenchPage } from './pages/WorkbenchPage'; import { WorkbenchPage } from './pages/WorkbenchPage';
import { DesignCenterPage } from './pages/DesignCenterPage'; import { DesignCenterPage } from './pages/DesignCenterPage';
import { NewFeatureShell } from './pages/NewFeatureShell';
import { AiFeatureForm } from './pages/AiFeatureForm';
import { ModelerPage } from './pages/ModelerPage';
// 把 401 跳登录的 handler 注入 http 层(在路由上下文内,可用 navigate) // 把 401 跳登录的 handler 注入 http 层(在路由上下文内,可用 navigate)
function UnauthorizedBridge() { function UnauthorizedBridge() {
@@ -40,6 +43,11 @@ export default function App() {
<Route path="/page/:templateId" element={<PageRenderPage />} /> <Route path="/page/:templateId" element={<PageRenderPage />} />
{/* 设计中心(管理员集中式低代码设计入口,替代每页设计按钮)*/} {/* 设计中心(管理员集中式低代码设计入口,替代每页设计按钮)*/}
<Route path="/design-center" element={<DesignCenterPage />} /> <Route path="/design-center" element={<DesignCenterPage />} />
{/* 人走五环编排壳 + AI ①面入口(admin-gated,页内早返回守护)*/}
<Route path="/new-feature" element={<NewFeatureShell />} />
<Route path="/ai-feature" element={<AiFeatureForm />} />
{/* 建模器(五环第①环·元数据→表,仅管理员)*/}
<Route path="/modeler" element={<ModelerPage />} />
{/* 根路径默认跳工作台 */} {/* 根路径默认跳工作台 */}
<Route index element={<Navigate to="/workbench" replace />} /> <Route index element={<Navigate to="/workbench" replace />} />
</Route> </Route>

33
src/api/ai.test.ts Normal file
View File

@@ -0,0 +1,33 @@
import { describe, it, expect } from 'vitest';
import { extractPageSchemaTemplateId } from './ai';
import type { AiAutoDevelopRun } from './ai';
describe('extractPageSchemaTemplateId', () => {
it('从 PAGE_SCHEMA draft 取 targetId', () => {
const run: AiAutoDevelopRun = {
taskId: 't1',
status: 'READY_FOR_HUMAN_REVIEW',
development: {
drafts: [
{ artifactType: 'FLOW', targetId: 'OA_X_ADD' },
{ artifactType: 'PAGE_SCHEMA', targetId: 'TPL-AI-9' },
],
},
};
expect(extractPageSchemaTemplateId(run)).toBe('TPL-AI-9');
});
it('无 PAGE_SCHEMA draft 时返回 undefined', () => {
const run: AiAutoDevelopRun = {
taskId: 't2',
status: 'READY_FOR_HUMAN_REVIEW',
development: { drafts: [{ artifactType: 'FLOW', targetId: 'X' }] },
};
expect(extractPageSchemaTemplateId(run)).toBeUndefined();
});
it('development 缺失时安全返回 undefined', () => {
const run: AiAutoDevelopRun = { taskId: 't3', status: 'FAILED' };
expect(extractPageSchemaTemplateId(run)).toBeUndefined();
});
});

67
src/api/ai.ts Normal file
View File

@@ -0,0 +1,67 @@
// AI ①面加速器入口 —— POST /api/ai/features/auto-develop(admin)。
// 平台进程内不内置生成 LLM:实际起草由外部 agent + Skills 完成,本接口只是确定性编排+人审门禁。
// 终端良态 status === 'READY_FOR_HUMAN_REVIEW'(红线:永不自动发布)。
//
// ⚠️ 端口约束:后端 auto-develop 会以 baseUrl 回调写后端。dev 默认 8084 已死,
// 本前端透传 baseUrl = window.location.origin(经 vite 代理 /api → 8093)。
// 若省略 baseUrl,则要求后端 dev profile 自身的 baseUrl 指向 8093(根因修在后端 Section)。
import { http } from './http';
export interface AiFeatureField {
column: string;
label: string;
type: string;
length?: number;
required?: boolean;
}
export interface AiAutoDevelopBody {
feature: {
objective: string;
featureName: string;
tableName: string;
entityName: string;
templateId?: string;
menuName?: string;
fields: AiFeatureField[];
pageRecipe: 'maintenance-crud-v1' | 'tree-crud-v1';
};
baseUrl?: string;
generateDeploymentPackage?: boolean;
maxRepairAttempts?: number;
}
export interface AiDraft {
artifactType: string; // 'PAGE_SCHEMA' | 'FLOW' | ...
targetId: string;
payload?: unknown;
}
export interface AiAutoDevelopRun {
taskId: string;
status: string; // 'READY_FOR_HUMAN_REVIEW' = 终端良态
development?: { drafts?: AiDraft[] };
applyRun?: unknown;
deploymentPackage?: unknown;
messages?: string[];
}
/** 终端良态判定(红线:AI 入口产物恒此状态才可人审进设计器)。 */
export const READY_STATUS = 'READY_FOR_HUMAN_REVIEW';
/** 从 run 提取 PAGE_SCHEMA draft 的 targetId(即写入 standard 层的 templateId)。 */
export function extractPageSchemaTemplateId(run: AiAutoDevelopRun): string | undefined {
return run.development?.drafts?.find((d) => d.artifactType === 'PAGE_SCHEMA')?.targetId;
}
export async function autoDevelop(body: AiAutoDevelopBody): Promise<AiAutoDevelopRun> {
// §B.9-10:默认值放后、用 ?? 兜底,避免显式传入的 undefined 覆盖默认;
// 透传 baseUrl=当前前端 origin,让后端回调经 vite 代理打到正在跑的 8093(而非死的 8084)。
const payload: AiAutoDevelopBody = {
...body,
baseUrl: body.baseUrl ?? window.location.origin,
generateDeploymentPackage: body.generateDeploymentPackage ?? true,
};
const { data } = await http.post<AiAutoDevelopRun>('/api/ai/features/auto-develop', payload);
return data;
}

49
src/api/meta.test.ts Normal file
View File

@@ -0,0 +1,49 @@
import { describe, expect, it, vi, beforeEach } from 'vitest';
import { http } from './http';
import { createEntity, listEntities, listEntityColumns } from './meta';
vi.mock('./http', () => ({
http: { get: vi.fn(), post: vi.fn() },
}));
const mGet = vi.mocked(http.get);
const mPost = vi.mocked(http.post);
beforeEach(() => {
mGet.mockReset();
mPost.mockReset();
});
describe('meta api', () => {
it('createEntity POST /api/meta/entity 并解包 data', async () => {
mPost.mockResolvedValue({
data: { status: 0, data: { entityId: 'E1', tablename: 'OA_DEMO', attributeCount: 4, indexCount: 1, listApi: '/api/entity/OA_DEMO/list' } },
} as never);
const r = await createEntity({ tablename: 'OA_DEMO', name: '演示', attributes: [{ column: 'TITLE', type: 'string', length: 200, mandatory: true }] });
expect(mPost).toHaveBeenCalledWith('/api/meta/entity', {
tablename: 'OA_DEMO',
name: '演示',
attributes: [{ column: 'TITLE', type: 'string', length: 200, mandatory: true }],
});
expect(r.entityId).toBe('E1');
expect(r.listApi).toBe('/api/entity/OA_DEMO/list');
});
it('listEntities GET /api/meta/entities 并解包数组', async () => {
mGet.mockResolvedValue({ data: { status: 0, data: [{ entityId: 'E1', tablename: 'OA_DEMO', name: '演示' }] } } as never);
const r = await listEntities();
expect(mGet).toHaveBeenCalledWith('/api/meta/entities');
expect(r).toHaveLength(1);
expect(r[0].tablename).toBe('OA_DEMO');
});
it('listEntityColumns GET /api/meta/entity/{table}/attributes 并解包', async () => {
mGet.mockResolvedValue({
data: { status: 0, data: { tablename: 'SYS_DEPART', displayColumn: 'DEPARTNAME', columns: [{ column: 'DEPARTNAME', display: '部门名', type: 'string' }] } },
} as never);
const r = await listEntityColumns('SYS_DEPART');
expect(mGet).toHaveBeenCalledWith('/api/meta/entity/SYS_DEPART/attributes');
expect(r.displayColumn).toBe('DEPARTNAME');
expect(r.columns[0].column).toBe('DEPARTNAME');
});
});

72
src/api/meta.ts Normal file
View File

@@ -0,0 +1,72 @@
// 元数据建模 API —— 实体目录 / 实体属性 / 建表。
// 后端信封统一 {status:0,data:...},本模块解包返回内层 data(镜像 auth.ts 用法)。
import { http } from './http';
export type AttrType = 'string' | 'integer' | 'number' | 'date' | 'datetime' | 'boolean' | 'reference';
export interface EntityAttr {
column: string;
type: AttrType;
length?: number;
display?: string;
mandatory?: boolean;
/** type==='reference' 时必填:外键目标表名(DECISION-1)。 */
referenceTable?: string;
}
export interface CreateEntityBody {
tablename: string;
name?: string;
attributes: EntityAttr[];
}
export interface CreateEntityResult {
entityId: string;
tablename: string;
attributeCount: number;
indexCount: number;
/** 引擎遗留返回 '/api/entity/<TABLE>/list';recipe 页不消费它(recipe 列表走 /api/flow/<TABLE>_SEARCH,见 §B.2/§B.9-11)。 */
listApi: string;
}
export interface EntitySummary {
entityId: string;
tablename: string;
name: string;
}
export interface EntityColumn {
column: string;
display: string;
type: string;
referenceTable?: string;
}
export interface EntityColumns {
tablename: string;
displayColumn: string;
columns: EntityColumn[];
}
interface Envelope<T> {
status: number;
data: T;
}
/** POST /api/meta/entity —— 建表(标准列由后端自动追加)。 */
export async function createEntity(body: CreateEntityBody): Promise<CreateEntityResult> {
const resp = await http.post<Envelope<CreateEntityResult>>('/api/meta/entity', body);
return resp.data.data;
}
/** GET /api/meta/entities —— 实体目录(供引用列选择器)。 */
export async function listEntities(): Promise<EntitySummary[]> {
const resp = await http.get<Envelope<EntitySummary[]>>('/api/meta/entities');
return resp.data.data;
}
/** GET /api/meta/entity/{table}/attributes —— 某表的列定义(含 displayColumn)。 */
export async function listEntityColumns(table: string): Promise<EntityColumns> {
const resp = await http.get<Envelope<EntityColumns>>(`/api/meta/entity/${encodeURIComponent(table)}/attributes`);
return resp.data.data;
}

19
src/api/publish.test.ts Normal file
View File

@@ -0,0 +1,19 @@
import { describe, expect, it, vi, beforeEach } from 'vitest';
import { http } from './http';
import { publishFeature } from './publish';
vi.mock('./http', () => ({ http: { get: vi.fn(), post: vi.fn() } }));
const mPost = vi.mocked(http.post);
beforeEach(() => { mPost.mockReset(); });
describe('publish api', () => {
it('publishFeature POST /api/design/publish 并解包', async () => {
mPost.mockResolvedValue({ data: { status: 0, data: { menuId: 'M1', flows: ['OA_DEMO_ADD'], deploymentPackage: { id: 'pkg-1' } } } } as never);
const r = await publishFeature({ entityId: 'E1', tableName: 'OA_DEMO', templateId: 'tpl-uuid', menuName: '演示', generateDeploymentPackage: true });
expect(mPost).toHaveBeenCalledWith('/api/design/publish', {
entityId: 'E1', tableName: 'OA_DEMO', templateId: 'tpl-uuid', menuName: '演示', generateDeploymentPackage: true,
});
expect(r.menuId).toBe('M1');
expect(r.flows).toContain('OA_DEMO_ADD');
});
});

26
src/api/publish.ts Normal file
View File

@@ -0,0 +1,26 @@
// 发布 API —— 五环终点:触发 5 条默认流 + 注册菜单 + 可选生产部署包(DECISION-2)。
// 发布恒人审:本端点只做「本环境即用 + 生产部署包生成」,生产上线仍走人工人审流程。
import { http } from './http';
export interface PublishFeatureBody {
entityId: string;
tableName: string;
templateId: string;
menuName: string;
parentMenuId?: string;
generateDeploymentPackage?: boolean;
}
export interface PublishFeatureResult {
menuId: string;
flows: string[];
deploymentPackage?: unknown;
}
interface Envelope<T> { status: number; data: T; }
/** POST /api/design/publish。 */
export async function publishFeature(body: PublishFeatureBody): Promise<PublishFeatureResult> {
const resp = await http.post<Envelope<PublishFeatureResult>>('/api/design/publish', body);
return resp.data.data;
}

31
src/api/recipe.test.ts Normal file
View File

@@ -0,0 +1,31 @@
import { describe, expect, it, vi, beforeEach } from 'vitest';
import { http } from './http';
import { compileRecipe, listRecipes } from './recipe';
vi.mock('./http', () => ({ http: { get: vi.fn(), post: vi.fn() } }));
const mGet = vi.mocked(http.get);
const mPost = vi.mocked(http.post);
beforeEach(() => { mGet.mockReset(); mPost.mockReset(); });
describe('recipe api', () => {
it('compileRecipe POST /api/design/recipe/compile 并解包', async () => {
mPost.mockResolvedValue({ data: { status: 0, data: { templateId: 'tpl-uuid', etag: 'W/"1"' } } } as never);
const r = await compileRecipe({ tableName: 'OA_DEMO', recipe: 'maintenance-crud-v1', title: '演示维护', displayField: 'TITLE' });
expect(mPost).toHaveBeenCalledWith('/api/design/recipe/compile', {
tableName: 'OA_DEMO', recipe: 'maintenance-crud-v1', title: '演示维护', displayField: 'TITLE',
});
expect(r.templateId).toBe('tpl-uuid');
expect(r.etag).toBe('W/"1"');
});
// §B.9-2:listRecipes 改静态常量(非 async、不调 /api/ai/page-recipes)。
it('listRecipes 返回 v1 固定两 recipe(静态 {id,label})', () => {
const r = listRecipes();
expect(r).toEqual([
{ id: 'maintenance-crud-v1', label: '维护型 CRUD' },
{ id: 'tree-crud-v1', label: '树形 CRUD' },
]);
// 不触网:listRecipes 是同步数组,不调 http.get
expect(mGet).not.toHaveBeenCalled();
});
});

40
src/api/recipe.ts Normal file
View File

@@ -0,0 +1,40 @@
// recipe 编译 API —— 把实体 + recipe 编译为标准页(templateId 由服务端生成)。
import { http } from './http';
export type RecipeId = 'maintenance-crud-v1' | 'tree-crud-v1';
export interface CompileRecipeBody {
tableName: string;
recipe: RecipeId;
title: string;
displayField?: string;
pageSize?: number;
}
export interface CompileRecipeResult {
templateId: string;
etag: string;
}
export interface RecipeOption {
id: string;
label: string;
}
interface Envelope<T> { status: number; data: T; }
/** POST /api/design/recipe/compile —— 服务端建蓝图→编译→校验→PageSchemaWriter.upsertStandard。 */
export async function compileRecipe(body: CompileRecipeBody): Promise<CompileRecipeResult> {
const resp = await http.post<Envelope<CompileRecipeResult>>('/api/design/recipe/compile', body);
return resp.data.data;
}
// §B.9-2:v1 固定两 recipe(YAGNI),无需调 /api/ai/page-recipes
// (其裸数组 {recipe,schemaVersion,title,...} 形状与本前端 {id,label} 契约不符)。
// recipe id 全程统一 *-v1 形(normalizePageRecipe 只接受 *-v1,见 §B.8/§B.9-1)。
export function listRecipes(): RecipeOption[] {
return [
{ id: 'maintenance-crud-v1', label: '维护型 CRUD' },
{ id: 'tree-crud-v1', label: '树形 CRUD' },
];
}

View File

@@ -6,6 +6,16 @@
// 异步(markReady / calculateHighlightBox)随后打到已死实例 → 抛 // 异步(markReady / calculateHighlightBox)随后打到已死实例 → 抛
// 「[mobx-state-tree] object no longer part of a state tree」→ 编辑器整片空白。 // 「[mobx-state-tree] object no longer part of a state tree」→ 编辑器整片空白。
// 主应用 main.tsx 跑 amis SDK(运行时渲染器,容忍 StrictMode),唯独 amis-editor 不行。 // 主应用 main.tsx 跑 amis SDK(运行时渲染器,容忍 StrictMode),唯独 amis-editor 不行。
//
// CSS 由此处 import 引入(不再用 editor.html 的 /node_modules 绝对 link):
// vite dev 直接转译、vite build 由 rollup 收集进 dist 的 css 产物,
// 修掉「dist/editor.html 三条 /node_modules link 在 preview/静态托管下 404」。
// 注:amis-ui/amis-editor-core 的 package.json exports 字段不暴露这些 css 子路径,
// 用裸包名 import 会被 rollup 拒绝解析(同 vite.config 注释里 amis 栈无 exports 之坑),
// 故以相对 node_modules 路径直引这三个真实 css 文件,绕开包解析。
import '../../node_modules/amis-editor-core/lib/style.css';
import '../../node_modules/amis-ui/lib/themes/default.css';
import '../../node_modules/amis-ui/lib/helper.css';
import { createRoot } from 'react-dom/client'; import { createRoot } from 'react-dom/client';
import { DesignerPage } from './DesignerPage'; import { DesignerPage } from './DesignerPage';

View File

@@ -0,0 +1,65 @@
import '@testing-library/jest-dom';
import { render, screen, fireEvent, waitFor } from '@testing-library/react';
import { MemoryRouter } from 'react-router-dom';
import { vi, describe, it, expect, beforeEach } from 'vitest';
import { AiFeatureForm } from './AiFeatureForm';
vi.mock('../auth/token', () => ({
getProfile: () => ({ userId: 'ADMIN', account: 'admin', name: 'x', roles: [] }),
}));
const autoDevelop = vi.fn();
vi.mock('../api/ai', async (importOriginal) => {
const actual = await importOriginal<typeof import('../api/ai')>();
return { ...actual, autoDevelop: (...a: unknown[]) => autoDevelop(...a) };
});
function renderForm() {
return render(
<MemoryRouter>
<AiFeatureForm />
</MemoryRouter>,
);
}
describe('AiFeatureForm', () => {
beforeEach(() => autoDevelop.mockReset());
it('READY_FOR_HUMAN_REVIEW 后审阅按钮打开正确 templateId', async () => {
autoDevelop.mockResolvedValue({
taskId: 't1',
status: 'READY_FOR_HUMAN_REVIEW',
development: { drafts: [{ artifactType: 'PAGE_SCHEMA', targetId: 'TPL-AI-9' }] },
messages: ['ok'],
});
const openSpy = vi.spyOn(window, 'open').mockImplementation(() => null);
renderForm();
fireEvent.change(screen.getByTestId('ai-objective'), { target: { value: '做个登记表' } });
fireEvent.change(screen.getByTestId('ai-feature-name'), { target: { value: '登记' } });
fireEvent.change(screen.getByTestId('ai-table-name'), { target: { value: 'OA_REG' } });
fireEvent.change(screen.getByTestId('ai-entity-name'), { target: { value: '登记表' } });
fireEvent.click(screen.getByTestId('ai-submit'));
const reviewBtn = await screen.findByTestId('ai-review');
fireEvent.click(reviewBtn);
expect(openSpy).toHaveBeenCalledWith('/editor.html?templateId=TPL-AI-9', '_blank');
openSpy.mockRestore();
});
it('非 READY 状态展示 messages,不出审阅按钮', async () => {
autoDevelop.mockResolvedValue({
taskId: 't2',
status: 'FAILED',
messages: ['校验未通过:字段缺失'],
});
renderForm();
fireEvent.change(screen.getByTestId('ai-objective'), { target: { value: 'x' } });
fireEvent.change(screen.getByTestId('ai-feature-name'), { target: { value: 'x' } });
fireEvent.change(screen.getByTestId('ai-table-name'), { target: { value: 'OA_X' } });
fireEvent.change(screen.getByTestId('ai-entity-name'), { target: { value: 'x' } });
fireEvent.click(screen.getByTestId('ai-submit'));
await waitFor(() => expect(screen.getByText(/校验未通过/)).toBeInTheDocument());
expect(screen.queryByTestId('ai-review')).not.toBeInTheDocument();
});
});

181
src/pages/AiFeatureForm.tsx Normal file
View File

@@ -0,0 +1,181 @@
// AI ①面加速器入口页 —— 填需求,调外部 agent 起草,产物恒 READY_FOR_HUMAN_REVIEW,
// 人点「审阅草稿」进 editor.html(edit-only,模板已由 auto-develop 写入 standard 层)。
// 红线:永不自动发布;平台进程内不内置生成 LLM。
import { useState } from 'react';
import { useNavigate } from 'react-router-dom';
import { getProfile } from '../auth/token';
import {
autoDevelop,
extractPageSchemaTemplateId,
READY_STATUS,
type AiAutoDevelopRun,
type AiFeatureField,
} from '../api/ai';
import { toast } from '../components/ui/Toast';
export function AiFeatureForm() {
const navigate = useNavigate();
const profile = getProfile();
const isAdmin = profile?.account === 'admin' || profile?.userId === 'ADMIN';
const [objective, setObjective] = useState('');
const [featureName, setFeatureName] = useState('');
const [tableName, setTableName] = useState('');
const [entityName, setEntityName] = useState('');
const [pageRecipe, setPageRecipe] = useState<'maintenance-crud-v1' | 'tree-crud-v1'>('maintenance-crud-v1');
const [fields, setFields] = useState<AiFeatureField[]>([{ column: '', label: '', type: 'string' }]);
const [running, setRunning] = useState(false);
const [run, setRun] = useState<AiAutoDevelopRun | null>(null);
if (!isAdmin) {
return <div style={{ padding: 24, color: 'var(--text-3)' }}>AI 建功能仅管理员可用。</div>;
}
const reviewTemplateId = run && run.status === READY_STATUS ? extractPageSchemaTemplateId(run) : undefined;
function setField(i: number, patch: Partial<AiFeatureField>) {
setFields((fs) => fs.map((f, idx) => (idx === i ? { ...f, ...patch } : f)));
}
function addField() {
setFields((fs) => [...fs, { column: '', label: '', type: 'string' }]);
}
function removeField(i: number) {
setFields((fs) => fs.filter((_, idx) => idx !== i));
}
async function submit() {
if (!objective.trim() || !featureName.trim() || !tableName.trim() || !entityName.trim()) {
toast('请填写需求、功能名、表名、实体名', 'warn');
return;
}
setRunning(true);
setRun(null);
try {
const res = await autoDevelop({
feature: {
objective: objective.trim(),
featureName: featureName.trim(),
tableName: tableName.trim(),
entityName: entityName.trim(),
fields: fields.filter((f) => f.column.trim()),
pageRecipe,
},
});
setRun(res);
if (res.status === READY_STATUS) {
toast('草稿已就绪,请审阅后进设计器', 'ok');
} else {
toast(`未达人审就绪状态:${res.status}`, 'warn');
}
} catch (e) {
toast((e as Error).message ?? 'AI 起草失败', 'err');
} finally {
setRunning(false);
}
}
function openReview() {
if (!reviewTemplateId) return;
window.open(`/editor.html?templateId=${encodeURIComponent(reviewTemplateId)}`, '_blank');
}
return (
<div style={{ height: '100%', overflow: 'auto', padding: 'var(--pad-lg)' }} data-testid="ai-feature-form">
<div style={{ display: 'flex', alignItems: 'center', gap: 12, marginBottom: 16 }}>
<button className="btn btn-sm" onClick={() => navigate('/design-center')}>← 返回设计中心</button>
<h2 style={{ margin: 0, fontSize: 18, fontWeight: 600 }}>⚡ AI 建功能</h2>
</div>
<div className="sub-text" style={{ marginBottom: 16 }}>
外部 AI agent 起草,产物恒人审;点「审阅草稿」进设计器,平台不自动发布。
</div>
<div className="card" style={{ padding: 16, maxWidth: 720 }}>
<div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
<label>
<div className="muted">需求目标 objective *</div>
<textarea data-testid="ai-objective" rows={2} style={{ width: '100%' }}
value={objective} onChange={(e) => setObjective(e.target.value)} />
</label>
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap' }}>
<label>
<div className="muted">功能名 featureName *</div>
<input data-testid="ai-feature-name" value={featureName} onChange={(e) => setFeatureName(e.target.value)} />
</label>
<label>
<div className="muted">表名 tableName *</div>
<input data-testid="ai-table-name" value={tableName} onChange={(e) => setTableName(e.target.value)} />
</label>
<label>
<div className="muted">实体名 entityName *</div>
<input data-testid="ai-entity-name" value={entityName} onChange={(e) => setEntityName(e.target.value)} />
</label>
<label>
<div className="muted">页面模板</div>
<select data-testid="ai-recipe" value={pageRecipe}
onChange={(e) => setPageRecipe(e.target.value as 'maintenance-crud-v1' | 'tree-crud-v1')}>
<option value="maintenance-crud-v1">维护型 CRUD</option>
<option value="tree-crud-v1">树型 CRUD</option>
</select>
</label>
</div>
<div>
<div className="muted" style={{ marginBottom: 6 }}>字段(column 留空的行忽略)</div>
{fields.map((f, i) => (
<div key={i} style={{ display: 'flex', gap: 6, marginBottom: 6 }}>
<input placeholder="column" data-testid={`ai-field-col-${i}`}
value={f.column} onChange={(e) => setField(i, { column: e.target.value })} />
<input placeholder="label"
value={f.label} onChange={(e) => setField(i, { label: e.target.value })} />
<select value={f.type} onChange={(e) => setField(i, { type: e.target.value })}>
<option value="string">string</option>
<option value="integer">integer</option>
<option value="number">number</option>
<option value="date">date</option>
<option value="datetime">datetime</option>
<option value="boolean">boolean</option>
</select>
<label style={{ display: 'flex', alignItems: 'center', gap: 4 }}>
<input type="checkbox" checked={!!f.required}
onChange={(e) => setField(i, { required: e.target.checked })} /> 必填
</label>
<button className="btn btn-sm" onClick={() => removeField(i)}>删</button>
</div>
))}
<button className="btn btn-sm" onClick={addField}>+ 加字段</button>
</div>
<div style={{ marginTop: 8 }}>
<button className="btn btn-primary" data-testid="ai-submit" disabled={running} onClick={submit}>
{running ? 'AI 起草中…' : '开始 AI 起草'}
</button>
</div>
</div>
</div>
{run ? (
<div className="card" style={{ padding: 16, maxWidth: 720, marginTop: 16 }}>
<div style={{ marginBottom: 8 }}>
状态:<b data-testid="ai-status">{run.status}</b>{' '}
<span className="muted">taskId={run.taskId}</span>
</div>
{reviewTemplateId ? (
<button className="btn btn-primary" data-testid="ai-review" onClick={openReview}>
审阅草稿(进设计器)
</button>
) : (
<div>
<div className="sub-text" style={{ marginBottom: 6 }}>未生成可审阅的页面草稿,运行信息:</div>
<ul>
{(run.messages ?? ['(无消息)']).map((m, i) => (
<li key={i} style={{ color: 'var(--text-3)' }}>{m}</li>
))}
</ul>
</div>
)}
</div>
) : null}
</div>
);
}

View File

@@ -0,0 +1,47 @@
import '@testing-library/jest-dom';
import { render, screen, waitFor } from '@testing-library/react';
import { MemoryRouter } from 'react-router-dom';
import { vi, describe, it, expect, beforeEach } from 'vitest';
import { DesignCenterPage } from './DesignCenterPage';
// menu 走真实 http → mock 掉,避免网络
vi.mock('../api/menu', () => ({
fetchMenu: vi.fn().mockResolvedValue({ roots: [] }),
collectLeaves: vi.fn().mockReturnValue([]),
}));
// 受控 profile:默认 admin
const profileMock = vi.fn();
vi.mock('../auth/token', () => ({
getProfile: () => profileMock(),
}));
function renderPage() {
return render(
<MemoryRouter>
<DesignCenterPage />
</MemoryRouter>,
);
}
describe('DesignCenterPage 入口按钮', () => {
beforeEach(() => {
profileMock.mockReset();
});
it('admin 看到 [+ 新建功能] 与 [⚡ AI 建功能]', async () => {
profileMock.mockReturnValue({ userId: 'ADMIN', account: 'admin', name: 'x', roles: [] });
renderPage();
await waitFor(() => {
expect(screen.getByTestId('dc-new-feature')).toBeInTheDocument();
expect(screen.getByTestId('dc-ai-feature')).toBeInTheDocument();
});
});
it('非 admin 不渲染入口(整页降级)', () => {
profileMock.mockReturnValue({ userId: 'U1', account: 'zhangsan', name: 'z', roles: [] });
renderPage();
expect(screen.queryByTestId('dc-new-feature')).not.toBeInTheDocument();
expect(screen.queryByTestId('dc-ai-feature')).not.toBeInTheDocument();
});
});

View File

@@ -2,6 +2,7 @@
// 列出全部功能页(按菜单分组、可搜索),每页一个「设计」入口打开 editor.html。 // 列出全部功能页(按菜单分组、可搜索),每页一个「设计」入口打开 editor.html。
// 仅管理员可见(路由在 AppShell 下,入口在 Topbar admin-only 按钮)。 // 仅管理员可见(路由在 AppShell 下,入口在 Topbar admin-only 按钮)。
import { useEffect, useMemo, useState } from 'react'; import { useEffect, useMemo, useState } from 'react';
import { useNavigate } from 'react-router-dom';
import { fetchMenu, collectLeaves, type MenuLeaf } from '../api/menu'; import { fetchMenu, collectLeaves, type MenuLeaf } from '../api/menu';
import { getProfile } from '../auth/token'; import { getProfile } from '../auth/token';
@@ -19,6 +20,7 @@ export function DesignCenterPage() {
const [error, setError] = useState(''); const [error, setError] = useState('');
const [loading, setLoading] = useState(true); const [loading, setLoading] = useState(true);
const [q, setQ] = useState(''); const [q, setQ] = useState('');
const navigate = useNavigate();
const profile = getProfile(); const profile = getProfile();
const isAdmin = profile?.account === 'admin' || profile?.userId === 'ADMIN'; const isAdmin = profile?.account === 'admin' || profile?.userId === 'ADMIN';
@@ -71,6 +73,22 @@ export function DesignCenterPage() {
</div> </div>
</div> </div>
<div style={{ flex: 1 }} /> <div style={{ flex: 1 }} />
<button
className="btn btn-sm"
data-testid="dc-new-feature"
onClick={() => navigate('/new-feature')}
title="人走五环,从零搭建一个新功能"
>
+ 新建功能
</button>
<button
className="btn btn-sm"
data-testid="dc-ai-feature"
onClick={() => navigate('/ai-feature')}
title="AI 加速器:外部 agent 起草,人审后进设计器"
>
⚡ AI 建功能
</button>
<div className="gsearch" style={{ width: 280 }}> <div className="gsearch" style={{ width: 280 }}>
<input <input
value={q} value={q}

View File

@@ -0,0 +1,66 @@
import { describe, expect, it, vi, beforeEach } from 'vitest';
import { render, screen, fireEvent } from '@testing-library/react';
import { useState } from 'react';
import { buildAttribute, FieldTable, type FieldRow } from './ModelerFields';
vi.mock('../api/meta', () => ({ listEntities: vi.fn(), listEntityColumns: vi.fn() }));
describe('buildAttribute 映射', () => {
it('文本→string,带 length/display/mandatory', () => {
const r: FieldRow = { column: 'TITLE', display: '标题', type: '文本', length: 200, mandatory: true };
expect(buildAttribute(r)).toEqual({ column: 'TITLE', type: 'string', length: 200, display: '标题', mandatory: true });
});
it('整数→integer,无 length', () => {
const r: FieldRow = { column: 'QTY', display: '数量', type: '整数' };
expect(buildAttribute(r)).toEqual({ column: 'QTY', type: 'integer', display: '数量' });
});
it('小数→number / 日期→date / 日期时间→datetime / 布尔→boolean', () => {
expect(buildAttribute({ column: 'A', display: 'a', type: '小数' }).type).toBe('number');
expect(buildAttribute({ column: 'B', display: 'b', type: '日期' }).type).toBe('date');
expect(buildAttribute({ column: 'C', display: 'c', type: '日期时间' }).type).toBe('datetime');
expect(buildAttribute({ column: 'D', display: 'd', type: '布尔' }).type).toBe('boolean');
});
it('引用→reference,带 referenceTable', () => {
const r: FieldRow = { column: 'DEPARTID', display: '部门', type: '引用', referenceTable: 'SYS_DEPART' };
expect(buildAttribute(r)).toEqual({ column: 'DEPARTID', type: 'reference', display: '部门', referenceTable: 'SYS_DEPART' });
});
it('mandatory=false 不输出该键', () => {
const r: FieldRow = { column: 'X', display: 'x', type: '文本', length: 50, mandatory: false };
expect('mandatory' in buildAttribute(r)).toBe(false);
});
});
function Harness() {
const [rows, setRows] = useState<FieldRow[]>([]);
return (
<div>
<FieldTable rows={rows} onChange={setRows} />
<div data-testid="count">{rows.length}</div>
</div>
);
}
describe('FieldTable 交互', () => {
beforeEach(() => { /* no-op */ });
it('加字段:填列名/显示名/选类型→提交→出现在表里', () => {
render(<Harness />);
fireEvent.click(screen.getByTestId('field-add'));
fireEvent.change(screen.getByTestId('field-column'), { target: { value: 'TITLE' } });
fireEvent.change(screen.getByTestId('field-display'), { target: { value: '标题' } });
fireEvent.change(screen.getByTestId('field-type'), { target: { value: '文本' } });
fireEvent.change(screen.getByTestId('field-length'), { target: { value: '200' } });
fireEvent.click(screen.getByTestId('field-submit'));
expect(screen.getByText('TITLE')).toBeInTheDocument();
expect(screen.getByTestId('count').textContent).toBe('1');
});
it('文本类型显示 length 输入,整数类型隐藏', () => {
render(<Harness />);
fireEvent.click(screen.getByTestId('field-add'));
fireEvent.change(screen.getByTestId('field-type'), { target: { value: '文本' } });
expect(screen.getByTestId('field-length')).toBeInTheDocument();
fireEvent.change(screen.getByTestId('field-type'), { target: { value: '整数' } });
expect(screen.queryByTestId('field-length')).not.toBeInTheDocument();
});
});

166
src/pages/ModelerFields.tsx Normal file
View File

@@ -0,0 +1,166 @@
// 字段表 + 加字段 Dialog + UI 类型↔api 类型映射。
// 纯 HTML <table>(本仓无可复用表格组件)+ components/ui/Dialog。
import { useState } from 'react';
import type { Dispatch, SetStateAction } from 'react';
import { Dialog } from '../components/ui/Dialog';
import type { EntityAttr, AttrType } from '../api/meta';
import { ReferencePicker } from './ReferencePicker';
export type UiType = '文本' | '整数' | '小数' | '日期' | '日期时间' | '布尔' | '引用';
export interface FieldRow {
column: string;
display: string;
type: UiType;
length?: number;
mandatory?: boolean;
referenceTable?: string;
}
const UI_TYPES: UiType[] = ['文本', '整数', '小数', '日期', '日期时间', '布尔', '引用'];
const TYPE_MAP: Record<UiType, AttrType> = {
文本: 'string',
整数: 'integer',
小数: 'number',
日期: 'date',
日期时间: 'datetime',
布尔: 'boolean',
引用: 'reference',
};
/** UI 行 → api EntityAttr。length 仅文本有意义;mandatory=false 不输出;引用带 referenceTable。 */
export function buildAttribute(row: FieldRow): EntityAttr {
const attr: EntityAttr = { column: row.column, type: TYPE_MAP[row.type] };
if (row.display) attr.display = row.display;
if (row.type === '文本' && typeof row.length === 'number') attr.length = row.length;
if (row.mandatory) attr.mandatory = true;
if (row.type === '引用' && row.referenceTable) attr.referenceTable = row.referenceTable;
return attr;
}
interface FieldTableProps {
rows: FieldRow[];
onChange: Dispatch<SetStateAction<FieldRow[]>>;
}
export function FieldTable({ rows, onChange }: FieldTableProps) {
const [adding, setAdding] = useState(false);
// 加字段草稿
const [column, setColumn] = useState('');
const [display, setDisplay] = useState('');
const [type, setType] = useState<UiType>('文本');
const [length, setLength] = useState('200');
const [mandatory, setMandatory] = useState(false);
const [refTable, setRefTable] = useState('');
function openAdd() {
setColumn('');
setDisplay('');
setType('文本');
setLength('200');
setMandatory(false);
setRefTable('');
setAdding(true);
}
const columnValid = /^[A-Z][A-Z0-9_]{0,40}$/.test(column);
const refOk = type !== '引用' || !!refTable;
const canAdd = columnValid && !!display && refOk;
function submitField() {
const row: FieldRow = { column, display, type };
if (type === '文本') row.length = Number(length) || undefined;
if (mandatory) row.mandatory = true;
if (type === '引用') row.referenceTable = refTable;
onChange((prev) => [...prev, row]);
setAdding(false);
}
function removeRow(i: number) {
onChange((prev) => prev.filter((_, idx) => idx !== i));
}
return (
<div>
<div style={{ display: 'flex', alignItems: 'center', marginBottom: 6 }}>
<span className="sub-text" style={{ flex: 1 }}>字段(标准列由后端自动追加,无需在此添加 ID/创建人等)</span>
<button className="btn btn-sm" type="button" data-testid="field-add" onClick={openAdd}>加字段</button>
</div>
<table style={{ width: '100%', borderCollapse: 'collapse', fontSize: 'var(--fs)' }}>
<thead>
<tr style={{ textAlign: 'left', color: 'var(--text-3)' }}>
<th style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>列名</th>
<th style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>显示名</th>
<th style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>类型</th>
<th style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>必填</th>
<th style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }} />
</tr>
</thead>
<tbody>
{rows.length === 0 ? (
<tr><td colSpan={5} style={{ padding: '10px', color: 'var(--text-3)' }}>尚无字段</td></tr>
) : (
rows.map((r, i) => (
<tr key={i} data-testid="field-row">
<td style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>{r.column}</td>
<td style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>{r.display}</td>
<td style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>
{r.type}{r.type === '引用' && r.referenceTable ? `→${r.referenceTable}` : ''}
</td>
<td style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>{r.mandatory ? '是' : ''}</td>
<td style={{ padding: '6px 10px', borderBottom: '1px solid var(--line)' }}>
<span className="link" style={{ fontSize: 11 }} onClick={() => removeRow(i)}>删除</span>
</td>
</tr>
))
)}
</tbody>
</table>
{adding ? (
<Dialog
title="加字段"
width={520}
onClose={() => setAdding(false)}
foot={
<>
<button className="btn" type="button" onClick={() => setAdding(false)}>取消</button>
<button className="btn btn-primary" type="button" data-testid="field-submit" disabled={!canAdd} onClick={submitField}>添加</button>
</>
}
>
<div style={{ display: 'grid', gap: 10 }}>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">列名(大写字母开头)</span>
<input data-testid="field-column" value={column} onChange={(e) => setColumn(e.target.value.toUpperCase())} placeholder="TITLE" />
</label>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">显示名</span>
<input data-testid="field-display" value={display} onChange={(e) => setDisplay(e.target.value)} placeholder="标题" />
</label>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">类型</span>
<select data-testid="field-type" value={type} onChange={(e) => setType(e.target.value as UiType)}>
{UI_TYPES.map((t) => <option key={t} value={t}>{t}</option>)}
</select>
</label>
{type === '文本' ? (
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">长度</span>
<input data-testid="field-length" type="number" value={length} onChange={(e) => setLength(e.target.value)} />
</label>
) : null}
{type === '引用' ? (
<ReferencePicker value={refTable} onChange={setRefTable} />
) : null}
<label style={{ display: 'flex', alignItems: 'center', gap: 6 }}>
<input data-testid="field-mandatory" type="checkbox" checked={mandatory} onChange={(e) => setMandatory(e.target.checked)} />
<span className="sub-text">必填</span>
</label>
</div>
</Dialog>
) : null}
</div>
);
}

View File

@@ -0,0 +1,61 @@
import { describe, expect, it, vi, beforeEach } from 'vitest';
import { render, screen, fireEvent, waitFor } from '@testing-library/react';
import { ModelerPage, validateTableName } from './ModelerPage';
vi.mock('../api/meta', () => ({
listEntities: vi.fn(),
listEntityColumns: vi.fn(),
createEntity: vi.fn(),
}));
vi.mock('../auth/token', () => ({ getProfile: vi.fn() }));
import { listEntities, createEntity } from '../api/meta';
import { getProfile } from '../auth/token';
const mList = vi.mocked(listEntities);
const mCreate = vi.mocked(createEntity);
const mProfile = vi.mocked(getProfile);
beforeEach(() => {
mList.mockReset();
mCreate.mockReset();
mProfile.mockReset();
mProfile.mockReturnValue({ userId: 'ADMIN', account: 'admin', name: '管理员', roles: [] });
mList.mockResolvedValue([{ entityId: 'E1', tablename: 'OA_DEMO', name: '演示' }]);
});
describe('validateTableName', () => {
it('合法表名通过', () => {
expect(validateTableName('OA_DEMO')).toBe(true);
expect(validateTableName('ABC')).toBe(true);
});
it('非法表名拒绝', () => {
expect(validateTableName('ab')).toBe(false); // 太短 + 小写
expect(validateTableName('1ABC')).toBe(false); // 数字开头
expect(validateTableName('OA-DEMO')).toBe(false); // 含非法字符
});
});
describe('ModelerPage', () => {
it('非管理员显示无权访问', () => {
mProfile.mockReturnValue({ userId: 'U9', account: 'zhang', name: '张三', roles: [] });
render(<ModelerPage />);
expect(screen.getByText(/仅管理员可用/)).toBeInTheDocument();
});
it('管理员加载并展示已有实体', async () => {
render(<ModelerPage />);
await waitFor(() => expect(screen.getByText('OA_DEMO')).toBeInTheDocument());
expect(mList).toHaveBeenCalled();
});
it('点新建实体打开 Dialog,非法表名禁用提交', async () => {
render(<ModelerPage />);
fireEvent.click(screen.getByTestId('modeler-new-entity'));
expect(screen.getByTestId('modeler-tablename')).toBeInTheDocument();
fireEvent.change(screen.getByTestId('modeler-tablename'), { target: { value: 'ab' } });
expect(screen.getByTestId('modeler-submit')).toBeDisabled();
fireEvent.change(screen.getByTestId('modeler-tablename'), { target: { value: 'OA_NEW' } });
expect(screen.getByTestId('modeler-submit')).not.toBeDisabled();
});
});

165
src/pages/ModelerPage.tsx Normal file
View File

@@ -0,0 +1,165 @@
// 建模器 —— NocoBase 式实体建模入口(五环第①环:元数据→表)。
// 仅管理员可用。展示已有实体清单 + 「新建实体」Dialog(表名/显示名/字段表)。
// v1 只建新不改表(DECISION:no ALTER)。字段表与引用列选择器见同文件下方组件。
import { useEffect, useState } from 'react';
import { Dialog } from '../components/ui/Dialog';
import { getProfile } from '../auth/token';
import {
listEntities,
createEntity,
type EntitySummary,
type EntityAttr,
} from '../api/meta';
import { FieldTable, buildAttribute, type FieldRow } from './ModelerFields';
export function validateTableName(t: string): boolean {
return /^[A-Z][A-Z0-9_]{2,40}$/.test(t);
}
export function ModelerPage() {
const profile = getProfile();
const isAdmin = profile?.account === 'admin' || profile?.userId === 'ADMIN';
const [entities, setEntities] = useState<EntitySummary[]>([]);
const [loading, setLoading] = useState(true);
const [error, setError] = useState('');
const [open, setOpen] = useState(false);
// 新建表单态
const [tablename, setTablename] = useState('');
const [name, setName] = useState('');
const [rows, setRows] = useState<FieldRow[]>([]);
const [submitting, setSubmitting] = useState(false);
const [submitErr, setSubmitErr] = useState('');
function reload() {
setLoading(true);
listEntities()
.then((es) => setEntities(es))
.catch((e: Error) => setError(e.message ?? '实体加载失败'))
.finally(() => setLoading(false));
}
useEffect(() => {
if (!isAdmin) return;
reload();
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [isAdmin]);
if (!isAdmin) {
return <div style={{ padding: 24, color: 'var(--text-3)' }}>建模器仅管理员可用。</div>;
}
const tableValid = validateTableName(tablename);
// 引用行必须选了目标表才合法(Task 17 填充 referenceTable)
const rowsValid = rows.every((r) => r.type !== '引用' || !!r.referenceTable);
const canSubmit = tableValid && rowsValid && !submitting;
function openDialog() {
setTablename('');
setName('');
setRows([]);
setSubmitErr('');
setOpen(true);
}
async function submit() {
setSubmitting(true);
setSubmitErr('');
try {
const attributes: EntityAttr[] = rows.map(buildAttribute);
await createEntity({ tablename, name: name || undefined, attributes });
setOpen(false);
reload();
} catch (e) {
setSubmitErr((e as Error).message ?? '建表失败');
} finally {
setSubmitting(false);
}
}
return (
<div style={{ height: '100%', overflow: 'auto', padding: 'var(--pad-lg)' }} data-testid="modeler">
<div style={{ display: 'flex', alignItems: 'center', gap: 16, marginBottom: 16, flexWrap: 'wrap' }}>
<div>
<h2 style={{ margin: 0, fontSize: 18, fontWeight: 600, color: 'var(--text)' }}>建模器</h2>
<div className="sub-text" style={{ marginTop: 4 }}>
新建实体(建表)。v1 只建新不改表 · 标准列由后端自动追加
</div>
</div>
<div style={{ flex: 1 }} />
<button className="btn btn-primary" data-testid="modeler-new-entity" onClick={openDialog}>
新建实体
</button>
</div>
{loading ? (
<div style={{ padding: 24, color: 'var(--text-3)' }}>加载中…</div>
) : error ? (
<div style={{ padding: 16, color: 'var(--err)' }}>实体加载失败:{error}</div>
) : entities.length === 0 ? (
<div className="empty">尚无实体,点「新建实体」开始</div>
) : (
<div className="card" style={{ padding: 0 }}>
<table style={{ width: '100%', borderCollapse: 'collapse', fontSize: 'var(--fs)' }}>
<thead>
<tr style={{ textAlign: 'left', color: 'var(--text-3)' }}>
<th style={{ padding: '8px 14px', borderBottom: '1px solid var(--line)' }}>表名</th>
<th style={{ padding: '8px 14px', borderBottom: '1px solid var(--line)' }}>显示名</th>
<th style={{ padding: '8px 14px', borderBottom: '1px solid var(--line)' }}>实体ID</th>
</tr>
</thead>
<tbody>
{entities.map((e) => (
<tr key={e.entityId} data-testid="modeler-entity-row">
<td style={{ padding: '8px 14px', borderBottom: '1px solid var(--line)' }}>{e.tablename}</td>
<td style={{ padding: '8px 14px', borderBottom: '1px solid var(--line)' }}>{e.name}</td>
<td style={{ padding: '8px 14px', borderBottom: '1px solid var(--line)', color: 'var(--text-3)' }}>{e.entityId}</td>
</tr>
))}
</tbody>
</table>
</div>
)}
{open ? (
<Dialog
title="新建实体"
width={720}
onClose={() => setOpen(false)}
foot={
<>
<button className="btn" onClick={() => setOpen(false)}>取消</button>
<button className="btn btn-primary" data-testid="modeler-submit" disabled={!canSubmit} onClick={submit}>
{submitting ? '建表中…' : '建表'}
</button>
</>
}
>
<div style={{ display: 'grid', gap: 12 }}>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">表名(大写字母开头,仅大写字母/数字/下划线,3–41 位)</span>
<input
data-testid="modeler-tablename"
value={tablename}
onChange={(ev) => setTablename(ev.target.value.toUpperCase())}
placeholder="OA_DEMO"
/>
{tablename && !tableValid ? (
<span style={{ color: 'var(--err)', fontSize: 11 }}>表名格式不合法</span>
) : null}
</label>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">显示名(可选)</span>
<input value={name} onChange={(ev) => setName(ev.target.value)} placeholder="演示维护" />
</label>
<FieldTable rows={rows} onChange={setRows} />
{submitErr ? <div style={{ color: 'var(--err)', fontSize: 12 }}>{submitErr}</div> : null}
</div>
</Dialog>
) : null}
</div>
);
}

View File

@@ -0,0 +1,142 @@
import '@testing-library/jest-dom';
import { render, screen, waitFor, fireEvent } from '@testing-library/react';
import { MemoryRouter } from 'react-router-dom';
import { vi, describe, it, expect, beforeEach } from 'vitest';
import { NewFeatureShell } from './NewFeatureShell';
vi.mock('../auth/token', () => ({
getProfile: () => ({ userId: 'ADMIN', account: 'admin', name: 'x', roles: [] }),
}));
const listEntities = vi.fn();
const createEntity = vi.fn();
vi.mock('../api/meta', () => ({
listEntities: (...a: unknown[]) => listEntities(...a),
createEntity: (...a: unknown[]) => createEntity(...a),
}));
// listRecipes 在模块加载期被 NewFeatureShell 同步调用(const RECIPES = listRecipes()),
// 故 mock 工厂直接返回静态数组(不能引用尚未初始化的外层 const,否则 hoist 期 ReferenceError)。
const compileRecipe = vi.fn();
vi.mock('../api/recipe', () => ({
listRecipes: () => [
{ id: 'maintenance-crud-v1', label: '维护型 CRUD' },
{ id: 'tree-crud-v1', label: '树型 CRUD' },
],
compileRecipe: (...a: unknown[]) => compileRecipe(...a),
}));
const publishFeature = vi.fn();
vi.mock('../api/publish', () => ({ publishFeature: (...a: unknown[]) => publishFeature(...a) }));
const fetchMenu = vi.fn();
vi.mock('../api/menu', () => ({ fetchMenu: (...a: unknown[]) => fetchMenu(...a), collectLeaves: vi.fn() }));
function renderShell() {
return render(
<MemoryRouter>
<NewFeatureShell />
</MemoryRouter>,
);
}
describe('NewFeatureShell happy path', () => {
beforeEach(() => {
listEntities.mockReset().mockResolvedValue([
{ entityId: 'E1', tablename: 'OA_DEMO', name: '演示表' },
]);
createEntity.mockReset();
compileRecipe.mockReset().mockResolvedValue({ templateId: 'TPL-NEW-1', etag: 'e1' });
publishFeature.mockReset().mockResolvedValue({ menuId: 'M9', flows: ['OA_DEMO_ADD'] });
fetchMenu.mockReset().mockResolvedValue({ roots: [] });
});
it('选实体→选 recipe→compile→进设计器按钮可用→发布', async () => {
const openSpy = vi.spyOn(window, 'open').mockImplementation(() => null);
renderShell();
// step entity:等实体列表加载,选中第一个
await waitFor(() => expect(screen.getByTestId('nf-entity-OA_DEMO')).toBeInTheDocument());
fireEvent.click(screen.getByTestId('nf-entity-OA_DEMO'));
fireEvent.click(screen.getByTestId('nf-next-entity'));
// step recipe:默认选了第一个 recipe;填标题;compile
await waitFor(() => expect(screen.getByTestId('nf-recipe-maintenance-crud-v1')).toBeInTheDocument());
fireEvent.change(screen.getByTestId('nf-title'), { target: { value: '演示功能' } });
fireEvent.click(screen.getByTestId('nf-compile'));
await waitFor(() => expect(compileRecipe).toHaveBeenCalledWith({
tableName: 'OA_DEMO',
recipe: 'maintenance-crud-v1',
title: '演示功能',
}));
// compile 成功 → 进设计器按钮出现且可用
const designBtn = await screen.findByTestId('nf-open-designer');
expect(designBtn).not.toBeDisabled();
fireEvent.click(designBtn);
expect(openSpy).toHaveBeenCalledWith('/editor.html?templateId=TPL-NEW-1', '_blank');
// 发布
fireEvent.change(screen.getByTestId('nf-menu-name'), { target: { value: '演示功能' } });
fireEvent.click(screen.getByTestId('nf-publish'));
await waitFor(() => expect(publishFeature).toHaveBeenCalledWith(expect.objectContaining({
entityId: 'E1',
tableName: 'OA_DEMO',
templateId: 'TPL-NEW-1',
menuName: '演示功能',
})));
await waitFor(() => expect(fetchMenu).toHaveBeenCalled());
openSpy.mockRestore();
});
it('compile 之前进设计器按钮不存在/禁用', async () => {
renderShell();
await waitFor(() => expect(screen.getByTestId('nf-entity-OA_DEMO')).toBeInTheDocument());
fireEvent.click(screen.getByTestId('nf-entity-OA_DEMO'));
fireEvent.click(screen.getByTestId('nf-next-entity'));
await waitFor(() => expect(screen.getByTestId('nf-recipe-maintenance-crud-v1')).toBeInTheDocument());
// 还没 compile:进设计器按钮要么不存在要么 disabled
const btn = screen.queryByTestId('nf-open-designer');
expect(btn === null || (btn as HTMLButtonElement).disabled).toBe(true);
});
});
describe('NewFeatureShell §B.9-4 新建实体可达(含引用列)', () => {
beforeEach(() => {
listEntities.mockReset().mockResolvedValue([
{ entityId: 'E1', tablename: 'OA_DEMO', name: '演示表' },
]);
createEntity.mockReset().mockResolvedValue({
entityId: 'E-NEW',
tablename: 'OA_FRESH',
attributeCount: 1,
indexCount: 0,
listApi: '/api/entity/OA_FRESH/list',
});
compileRecipe.mockReset();
publishFeature.mockReset();
fetchMenu.mockReset();
});
it('实体步有 [+ 新建实体] 按钮,建成后用返回的 entity 进入 recipe 步', async () => {
renderShell();
await waitFor(() => expect(screen.getByTestId('nf-new-entity')).toBeInTheDocument());
fireEvent.click(screen.getByTestId('nf-new-entity'));
// Dialog 打开:复用 ModelerFields/ReferencePicker(建模器表单 → field-add 证明复用)
await waitFor(() => expect(screen.getByTestId('nf-create-tablename')).toBeInTheDocument());
expect(screen.getByTestId('field-add')).toBeInTheDocument();
fireEvent.change(screen.getByTestId('nf-create-tablename'), { target: { value: 'OA_FRESH' } });
fireEvent.click(screen.getByTestId('nf-create-submit'));
await waitFor(() => expect(createEntity).toHaveBeenCalledWith(
expect.objectContaining({ tablename: 'OA_FRESH' }),
));
// 建成回填 selectedEntity 并进入 recipe 步
await waitFor(() => expect(screen.getByTestId('nf-recipe-maintenance-crud-v1')).toBeInTheDocument());
expect(screen.getAllByText(/OA_FRESH/).length).toBeGreaterThan(0);
});
});

View File

@@ -0,0 +1,361 @@
// 人走五环 · 编排壳 —— 从零搭建一个新功能页。
// 步骤:① 选/建实体(元数据+表)→ ② 选 recipe + 填页面参数 → compileRecipe 写 standard 层拿 templateId
// → ③ 可选「进设计器微调」(editor.html 是 edit-only,模板已存在才允许) → ④ 发布(menu+5默认流)。
// 红线:发布恒人审;standard 写入恒走后端 PageSchemaWriter.upsertStandard(前端只调 compileRecipe)。
// §B.9-4:实体步内置 [+ 新建实体] Dialog,复用 ModelerFields(FieldTable)/ReferencePicker,
// 使「建含引用列的新实体」在编排流里可达;建成用返回 {entityId,tablename} 回填进入下一步。
import { useEffect, useState } from 'react';
import { useNavigate } from 'react-router-dom';
import { getProfile } from '../auth/token';
import { listEntities, createEntity, type EntityAttr } from '../api/meta';
import { listRecipes, compileRecipe } from '../api/recipe';
import { publishFeature } from '../api/publish';
import { fetchMenu } from '../api/menu';
import { toast } from '../components/ui/Toast';
import { Dialog } from '../components/ui/Dialog';
import { FieldTable, buildAttribute, type FieldRow } from './ModelerFields';
import { validateTableName } from './ModelerPage';
interface EntityRow {
entityId: string;
tablename: string;
name: string;
}
type Step = 'entity' | 'recipe';
const RECIPES = listRecipes(); // 静态清单(maintenance-crud-v1 / tree-crud-v1)
export function NewFeatureShell() {
const navigate = useNavigate();
const profile = getProfile();
const isAdmin = profile?.account === 'admin' || profile?.userId === 'ADMIN';
const [step, setStep] = useState<Step>('entity');
const [entities, setEntities] = useState<EntityRow[]>([]);
const [loadErr, setLoadErr] = useState('');
const [selectedEntity, setSelectedEntity] = useState<EntityRow | null>(null);
const [recipe, setRecipe] = useState<string>(RECIPES[0]?.id ?? 'maintenance-crud-v1');
const [title, setTitle] = useState('');
const [displayField, setDisplayField] = useState('');
const [pageSize, setPageSize] = useState<number | ''>('');
const [templateId, setTemplateId] = useState('');
const [compiling, setCompiling] = useState(false);
const [menuName, setMenuName] = useState('');
const [publishing, setPublishing] = useState(false);
// §B.9-4 新建实体 Dialog 态
const [createOpen, setCreateOpen] = useState(false);
const [newTable, setNewTable] = useState('');
const [newName, setNewName] = useState('');
const [newRows, setNewRows] = useState<FieldRow[]>([]);
const [creating, setCreating] = useState(false);
const [createErr, setCreateErr] = useState('');
useEffect(() => {
if (!isAdmin) return;
let alive = true;
listEntities()
.then((rows) => alive && setEntities(rows))
.catch((e: Error) => alive && setLoadErr(e.message ?? '实体加载失败'));
return () => {
alive = false;
};
}, [isAdmin]);
if (!isAdmin) {
return <div style={{ padding: 24, color: 'var(--text-3)' }}>新建功能仅管理员可用。</div>;
}
const newTableValid = validateTableName(newTable);
const newRowsValid = newRows.every((r) => r.type !== '引用' || !!r.referenceTable);
const canCreate = newTableValid && newRowsValid && !creating;
function openCreate() {
setNewTable('');
setNewName('');
setNewRows([]);
setCreateErr('');
setCreateOpen(true);
}
async function doCreateEntity() {
setCreating(true);
setCreateErr('');
try {
const attributes: EntityAttr[] = newRows.map(buildAttribute);
const res = await createEntity({ tablename: newTable, name: newName || undefined, attributes });
// 用返回的 {entityId,tablename} 回填,并进入 recipe 步
const created: EntityRow = { entityId: res.entityId, tablename: res.tablename, name: newName || res.tablename };
setCreateOpen(false);
setSelectedEntity(created);
setStep('recipe');
// 刷新实体清单(后台异步,失败不阻塞)
listEntities()
.then((rows) => setEntities(rows))
.catch(() => undefined);
toast(`已新建实体 ${res.tablename}`, 'ok');
} catch (e) {
setCreateErr((e as Error).message ?? '建表失败');
} finally {
setCreating(false);
}
}
async function doCompile() {
if (!selectedEntity || !title.trim()) {
toast('请先选实体并填写页面标题', 'warn');
return;
}
setCompiling(true);
try {
const body: { tableName: string; recipe: string; title: string; displayField?: string; pageSize?: number } = {
tableName: selectedEntity.tablename,
recipe,
title: title.trim(),
};
if (displayField.trim()) body.displayField = displayField.trim();
if (pageSize !== '') body.pageSize = Number(pageSize);
const res = await compileRecipe(body as Parameters<typeof compileRecipe>[0]);
setTemplateId(res.templateId);
if (!menuName.trim()) setMenuName(title.trim());
toast('已生成页面,可进设计器微调或直接发布', 'ok');
} catch (e) {
toast((e as Error).message ?? '生成失败', 'err');
} finally {
setCompiling(false);
}
}
function openDesigner() {
if (!templateId) return;
window.open(`/editor.html?templateId=${encodeURIComponent(templateId)}`, '_blank');
}
async function doPublish() {
if (!selectedEntity || !templateId || !menuName.trim()) {
toast('发布需先生成页面并填写菜单名', 'warn');
return;
}
setPublishing(true);
try {
const res = await publishFeature({
entityId: selectedEntity.entityId,
tableName: selectedEntity.tablename,
templateId,
menuName: menuName.trim(),
generateDeploymentPackage: true,
});
await fetchMenu(); // 刷新左侧菜单缓存(新节点)
toast(`已发布:菜单 ${res.menuId},默认流 ${res.flows.join('、')}`, 'ok');
} catch (e) {
toast((e as Error).message ?? '发布失败', 'err');
} finally {
setPublishing(false);
}
}
return (
<div style={{ height: '100%', overflow: 'auto', padding: 'var(--pad-lg)' }} data-testid="new-feature-shell">
<div style={{ display: 'flex', alignItems: 'center', gap: 12, marginBottom: 16 }}>
<button className="btn btn-sm" onClick={() => navigate('/design-center')}>
← 返回设计中心
</button>
<h2 style={{ margin: 0, fontSize: 18, fontWeight: 600 }}>新建功能 · 人走五环</h2>
</div>
{/* 步骤指示 */}
<div className="sub-text" style={{ marginBottom: 16 }}>
{step === 'entity' ? '步骤 1 / 2 :选择或新建实体(元数据+表)' : '步骤 2 / 2 :选 recipe、生成页面、发布'}
</div>
{loadErr ? <div style={{ padding: 12, color: 'var(--err)' }}>实体加载失败:{loadErr}</div> : null}
{step === 'entity' ? (
<div className="card" style={{ padding: 16 }}>
<div style={{ display: 'flex', alignItems: 'center', marginBottom: 10 }}>
<div style={{ flex: 1, fontWeight: 600 }}>选择已有实体</div>
<button className="btn btn-sm" data-testid="nf-new-entity" onClick={openCreate}>
+ 新建实体
</button>
</div>
<table style={{ width: '100%', borderCollapse: 'collapse' }}>
<thead>
<tr style={{ textAlign: 'left', color: 'var(--text-3)' }}>
<th style={{ padding: '6px 8px' }}>名称</th>
<th style={{ padding: '6px 8px' }}>表名</th>
<th style={{ padding: '6px 8px', width: 80 }} />
</tr>
</thead>
<tbody>
{entities.map((en) => (
<tr
key={en.entityId}
style={{
borderTop: '1px solid var(--line)',
background: selectedEntity?.entityId === en.entityId ? 'var(--hover)' : undefined,
}}
>
<td style={{ padding: '6px 8px' }}>{en.name}</td>
<td style={{ padding: '6px 8px' }} className="muted">{en.tablename}</td>
<td style={{ padding: '6px 8px' }}>
<button
className="btn btn-sm"
data-testid={`nf-entity-${en.tablename}`}
onClick={() => setSelectedEntity(en)}
>
{selectedEntity?.entityId === en.entityId ? '已选' : '选择'}
</button>
</td>
</tr>
))}
</tbody>
</table>
<div style={{ marginTop: 16, display: 'flex', gap: 8 }}>
<button
className="btn"
data-testid="nf-next-entity"
disabled={!selectedEntity}
onClick={() => setStep('recipe')}
>
下一步:选 recipe
</button>
</div>
</div>
) : (
<div className="card" style={{ padding: 16 }}>
<div style={{ marginBottom: 10 }}>
实体:<b>{selectedEntity?.name}</b>{' '}
<span className="muted">({selectedEntity?.tablename})</span>{' '}
<span className="link" onClick={() => setStep('entity')}>更换</span>
</div>
<div style={{ marginBottom: 12 }}>
<div style={{ marginBottom: 6, fontWeight: 600 }}>页面模板 recipe</div>
{RECIPES.map((r) => (
<label key={r.id} style={{ marginRight: 16, cursor: 'pointer' }} data-testid={`nf-recipe-${r.id}`}>
<input
type="radio"
name="recipe"
checked={recipe === r.id}
onChange={() => setRecipe(r.id)}
/>{' '}
{r.label}
</label>
))}
</div>
<div style={{ display: 'flex', flexWrap: 'wrap', gap: 12, marginBottom: 12 }}>
<label>
<div className="muted">页面标题 *</div>
<input data-testid="nf-title" value={title} onChange={(e) => setTitle(e.target.value)} />
</label>
<label>
<div className="muted">显示字段(可选)</div>
<input
data-testid="nf-display-field"
value={displayField}
onChange={(e) => setDisplayField(e.target.value)}
/>
</label>
<label>
<div className="muted">页大小(可选)</div>
<input
data-testid="nf-page-size"
type="number"
value={pageSize}
onChange={(e) => setPageSize(e.target.value === '' ? '' : Number(e.target.value))}
/>
</label>
</div>
<div style={{ display: 'flex', gap: 8, marginBottom: 16 }}>
<button className="btn" data-testid="nf-compile" disabled={compiling || !title.trim()} onClick={doCompile}>
{compiling ? '生成中…' : templateId ? '重新生成页面' : '生成页面'}
</button>
<button
className="btn"
data-testid="nf-open-designer"
disabled={!templateId}
onClick={openDesigner}
title={templateId ? '在新标签页打开设计器微调' : '先生成页面才能进设计器'}
>
进设计器微调
</button>
</div>
{templateId ? (
<div className="card" style={{ padding: 12, background: 'var(--surface-2)' }}>
<div style={{ marginBottom: 8 }}>
已生成模板:<code data-testid="nf-template-id">{templateId}</code>
</div>
<div style={{ display: 'flex', alignItems: 'flex-end', gap: 8 }}>
<label>
<div className="muted">菜单名 *</div>
<input data-testid="nf-menu-name" value={menuName} onChange={(e) => setMenuName(e.target.value)} />
</label>
<button
className="btn btn-primary"
data-testid="nf-publish"
disabled={publishing || !menuName.trim()}
onClick={doPublish}
>
{publishing ? '发布中…' : '发布'}
</button>
</div>
<div className="sub-text" style={{ marginTop: 8 }}>
发布 = 写标准页 + 触发 5 条默认流 + 注册菜单(当前后端立即可用);并生成生产部署包供人审上线。
</div>
</div>
) : null}
</div>
)}
{createOpen ? (
<Dialog
title="新建实体(含引用列)"
width={720}
onClose={() => setCreateOpen(false)}
foot={
<>
<button className="btn" onClick={() => setCreateOpen(false)}>取消</button>
<button
className="btn btn-primary"
data-testid="nf-create-submit"
disabled={!canCreate}
onClick={doCreateEntity}
>
{creating ? '建表中…' : '建表并使用'}
</button>
</>
}
>
<div style={{ display: 'grid', gap: 12 }}>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">表名(大写字母开头,仅大写字母/数字/下划线,3–41 位)</span>
<input
data-testid="nf-create-tablename"
value={newTable}
onChange={(ev) => setNewTable(ev.target.value.toUpperCase())}
placeholder="OA_DEMO"
/>
{newTable && !newTableValid ? (
<span style={{ color: 'var(--err)', fontSize: 11 }}>表名格式不合法</span>
) : null}
</label>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">显示名(可选)</span>
<input value={newName} onChange={(ev) => setNewName(ev.target.value)} placeholder="演示维护" />
</label>
<FieldTable rows={newRows} onChange={setNewRows} />
{createErr ? <div style={{ color: 'var(--err)', fontSize: 12 }}>{createErr}</div> : null}
</div>
</Dialog>
) : null}
</div>
);
}

View File

@@ -0,0 +1,47 @@
import { describe, expect, it, vi, beforeEach } from 'vitest';
import { render, screen, fireEvent, waitFor } from '@testing-library/react';
import { ReferencePicker } from './ReferencePicker';
vi.mock('../api/meta', () => ({ listEntities: vi.fn(), listEntityColumns: vi.fn() }));
import { listEntities, listEntityColumns } from '../api/meta';
const mList = vi.mocked(listEntities);
const mCols = vi.mocked(listEntityColumns);
beforeEach(() => {
mList.mockReset();
mCols.mockReset();
mList.mockResolvedValue([
{ entityId: 'E1', tablename: 'SYS_DEPART', name: '部门' },
{ entityId: 'E2', tablename: 'SYS_ORG', name: '组织' },
]);
mCols.mockResolvedValue({
tablename: 'SYS_DEPART',
displayColumn: 'DEPARTNAME',
columns: [
{ column: 'DEPARTNAME', display: '部门名', type: 'string' },
{ column: 'DEPARTCODE', display: '部门编码', type: 'string' },
],
});
});
describe('ReferencePicker', () => {
it('加载目标实体清单', async () => {
render(<ReferencePicker value="" onChange={() => {}} />);
await waitFor(() => expect(screen.getByTestId('ref-target')).toBeInTheDocument());
expect(mList).toHaveBeenCalled();
// 选项含 SYS_DEPART
expect(screen.getByRole('option', { name: /SYS_DEPART/ })).toBeInTheDocument();
});
it('选目标实体→回写 referenceTable + 加载其列', async () => {
const onChange = vi.fn();
render(<ReferencePicker value="" onChange={onChange} />);
await waitFor(() => expect(screen.getByTestId('ref-target')).toBeInTheDocument());
fireEvent.change(screen.getByTestId('ref-target'), { target: { value: 'SYS_DEPART' } });
expect(onChange).toHaveBeenCalledWith('SYS_DEPART');
await waitFor(() => expect(mCols).toHaveBeenCalledWith('SYS_DEPART'));
// 显示列下拉默认选中 displayColumn
await waitFor(() => expect(screen.getByTestId('ref-display-col')).toBeInTheDocument());
expect((screen.getByTestId('ref-display-col') as HTMLSelectElement).value).toBe('DEPARTNAME');
});
});

View File

@@ -0,0 +1,83 @@
// 引用列选择器(DECISION-1)。type=引用时选目标实体 + 显示列。
// 父级只需 referenceTable;显示列默认取目标表 displayColumn,仅做预览,
// 实际渲染时由 recipe 按目标表 displayColumn 解析显示名(非裸 id)。
import { useEffect, useState } from 'react';
import { listEntities, listEntityColumns, type EntitySummary, type EntityColumn } from '../api/meta';
interface ReferencePickerProps {
value: string; // 已选目标表名(父级权威)
onChange: (referenceTable: string) => void;
}
export function ReferencePicker({ value, onChange }: ReferencePickerProps) {
const [entities, setEntities] = useState<EntitySummary[]>([]);
const [cols, setCols] = useState<EntityColumn[]>([]);
const [displayCol, setDisplayCol] = useState('');
const [err, setErr] = useState('');
// 内部选中态:以父级 value 为初值,select onChange 即时更新,驱动列加载
// (父级 onChange 不一定立刻回写 value,故列加载不能只依赖 value)。
const [selected, setSelected] = useState(value);
useEffect(() => {
setSelected(value);
}, [value]);
useEffect(() => {
let alive = true;
listEntities()
.then((es) => alive && setEntities(es))
.catch((e: Error) => alive && setErr(e.message ?? '实体清单加载失败'));
return () => { alive = false; };
}, []);
useEffect(() => {
if (!selected) {
setCols([]);
setDisplayCol('');
return;
}
let alive = true;
listEntityColumns(selected)
.then((c) => {
if (!alive) return;
setCols(c.columns);
setDisplayCol(c.displayColumn || c.columns[0]?.column || '');
})
.catch((e: Error) => alive && setErr(e.message ?? '目标列加载失败'));
return () => { alive = false; };
}, [selected]);
function handleSelect(table: string) {
setSelected(table);
onChange(table);
}
return (
<div style={{ display: 'grid', gap: 8, padding: 8, border: '1px solid var(--line)', borderRadius: 6 }}>
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">引用目标实体</span>
<select data-testid="ref-target" value={selected} onChange={(e) => handleSelect(e.target.value)}>
<option value="">请选择…</option>
{entities.map((en) => (
<option key={en.entityId} value={en.tablename}>
{en.tablename}({en.name})
</option>
))}
</select>
</label>
{selected ? (
<label style={{ display: 'grid', gap: 4 }}>
<span className="sub-text">显示列(渲染时显示该列而非 id)</span>
<select data-testid="ref-display-col" value={displayCol} onChange={(e) => setDisplayCol(e.target.value)}>
{cols.map((c) => (
<option key={c.column} value={c.column}>
{c.display || c.column}
</option>
))}
</select>
</label>
) : null}
{err ? <div style={{ color: 'var(--err)', fontSize: 11 }}>{err}</div> : null}
</div>
);
}

9
src/setupTests.ts Normal file
View File

@@ -0,0 +1,9 @@
// vitest 全局测试基建:注册 jest-dom 断言匹配器 + 每个用例后自动卸载组件树。
// 在 vitest.config.ts 的 test.setupFiles 里登记,所有 *.test.tsx 共享。
import '@testing-library/jest-dom/vitest';
import { afterEach } from 'vitest';
import { cleanup } from '@testing-library/react';
afterEach(() => {
cleanup();
});

View File

@@ -2,7 +2,7 @@ import { defineConfig, loadEnv } from 'vite';
import react from '@vitejs/plugin-react'; import react from '@vitejs/plugin-react';
import { resolve } from 'path'; import { resolve } from 'path';
// 开发期 dev server 把 /api 反代到后端(默认 8084,端口被占时改 8090)。 // 开发期 dev server 把 /api 反代到后端(dev profile 默认 8093,端口被占时用 .env.local 覆盖)。
// 后端地址经 .env 的 VITE_BACKEND_TARGET 配置;生产由 Nginx 反代,前端只发相对 /api。 // 后端地址经 .env 的 VITE_BACKEND_TARGET 配置;生产由 Nginx 反代,前端只发相对 /api。
// //
// F4-L1 多页应用(MPA): // F4-L1 多页应用(MPA):
@@ -16,7 +16,7 @@ import { resolve } from 'path';
// CSS 由 editor.html <link> 直接引用 /node_modules/... 路径,server.fs.allow 放开目录。 // CSS 由 editor.html <link> 直接引用 /node_modules/... 路径,server.fs.allow 放开目录。
export default defineConfig(({ mode }) => { export default defineConfig(({ mode }) => {
const env = loadEnv(mode, process.cwd(), ''); const env = loadEnv(mode, process.cwd(), '');
const backendTarget = env.VITE_BACKEND_TARGET || 'http://localhost:8084'; const backendTarget = env.VITE_BACKEND_TARGET || 'http://localhost:8093';
return { return {
plugins: [react()], plugins: [react()],
resolve: { resolve: {

View File

@@ -8,6 +8,7 @@ export default defineConfig({
test: { test: {
environment: 'jsdom', environment: 'jsdom',
globals: true, globals: true,
setupFiles: ['./src/setupTests.ts'],
include: ['src/**/*.test.ts', 'src/**/*.test.tsx'], include: ['src/**/*.test.ts', 'src/**/*.test.tsx'],
}, },
}); });