From 4e0e974473240e67803e2db847e4300915318430 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Sat, 20 Jun 2026 09:55:53 +0800 Subject: [PATCH] =?UTF-8?q?feat(ai-feature):=20AI=20=E2=91=A0=E9=9D=A2?= =?UTF-8?q?=E5=85=A5=E5=8F=A3=E9=A1=B5=20+=20api/ai.ts=EF=BC=88auto-develo?= =?UTF-8?q?p=EF=BC=8C=E6=81=92=20READY=5FFOR=5FHUMAN=5FREVIEW=20=E4=BA=BA?= =?UTF-8?q?=E5=AE=A1=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) --- src/api/ai.test.ts | 33 ++++++ src/api/ai.ts | 67 ++++++++++++ src/pages/AiFeatureForm.test.tsx | 65 +++++++++++ src/pages/AiFeatureForm.tsx | 181 +++++++++++++++++++++++++++++++ 4 files changed, 346 insertions(+) create mode 100644 src/api/ai.test.ts create mode 100644 src/api/ai.ts create mode 100644 src/pages/AiFeatureForm.test.tsx create mode 100644 src/pages/AiFeatureForm.tsx diff --git a/src/api/ai.test.ts b/src/api/ai.test.ts new file mode 100644 index 0000000..4686360 --- /dev/null +++ b/src/api/ai.test.ts @@ -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(); + }); +}); diff --git a/src/api/ai.ts b/src/api/ai.ts new file mode 100644 index 0000000..c325a0a --- /dev/null +++ b/src/api/ai.ts @@ -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 { + // §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('/api/ai/features/auto-develop', payload); + return data; +} diff --git a/src/pages/AiFeatureForm.test.tsx b/src/pages/AiFeatureForm.test.tsx new file mode 100644 index 0000000..43866ac --- /dev/null +++ b/src/pages/AiFeatureForm.test.tsx @@ -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(); + return { ...actual, autoDevelop: (...a: unknown[]) => autoDevelop(...a) }; +}); + +function renderForm() { + return render( + + + , + ); +} + +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(); + }); +}); diff --git a/src/pages/AiFeatureForm.tsx b/src/pages/AiFeatureForm.tsx new file mode 100644 index 0000000..8463d55 --- /dev/null +++ b/src/pages/AiFeatureForm.tsx @@ -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([{ column: '', label: '', type: 'string' }]); + + const [running, setRunning] = useState(false); + const [run, setRun] = useState(null); + + if (!isAdmin) { + return
AI 建功能仅管理员可用。
; + } + + const reviewTemplateId = run && run.status === READY_STATUS ? extractPageSchemaTemplateId(run) : undefined; + + function setField(i: number, patch: Partial) { + 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 ( +
+
+ +

⚡ AI 建功能

+
+
+ 外部 AI agent 起草,产物恒人审;点「审阅草稿」进设计器,平台不自动发布。 +
+ +
+
+