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:
2026-06-20 09:55:53 +08:00
parent 8f94ba3c3d
commit 4e0e974473
4 changed files with 346 additions and 0 deletions

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>
);
}