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