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>
This commit is contained in:
33
src/api/ai.test.ts
Normal file
33
src/api/ai.test.ts
Normal 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
67
src/api/ai.ts
Normal 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;
|
||||||
|
}
|
||||||
65
src/pages/AiFeatureForm.test.tsx
Normal file
65
src/pages/AiFeatureForm.test.tsx
Normal 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
181
src/pages/AiFeatureForm.tsx
Normal 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>
|
||||||
|
);
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user