feat(admin): Complete Phase 3.5.1-3.5.4 Prompt Management System (83%)

Summary:
- Implement Prompt management infrastructure and core services
- Build admin portal frontend with light theme
- Integrate CodeMirror 6 editor for non-technical users

Phase 3.5.1: Infrastructure Setup
- Create capability_schema for Prompt storage
- Add prompt_templates and prompt_versions tables
- Add prompt:view/edit/debug/publish permissions
- Migrate RVW prompts to database (RVW_EDITORIAL, RVW_METHODOLOGY)

Phase 3.5.2: PromptService Core
- Implement gray preview logic (DRAFT for debuggers, ACTIVE for users)
- Module-level debug control (setDebugMode)
- Handlebars template rendering
- Variable extraction and validation (extractVariables, validateVariables)
- Three-level disaster recovery (database -> cache -> hardcoded fallback)

Phase 3.5.3: Management API
- 8 RESTful endpoints (/api/admin/prompts/*)
- Permission control (PROMPT_ENGINEER can edit, SUPER_ADMIN can publish)

Phase 3.5.4: Frontend Management UI
- Build admin portal architecture (AdminLayout, OrgLayout)
- Add route system (/admin/*, /org/*)
- Implement PromptListPage (filter, search, debug switch)
- Implement PromptEditor (CodeMirror 6 simplified for clinical users)
- Implement PromptEditorPage (edit, save, publish, test, version history)

Technical Details:
- Backend: 6 files, ~2044 lines (prompt.service.ts 596 lines)
- Frontend: 9 files, ~1735 lines (PromptEditorPage.tsx 399 lines)
- CodeMirror 6: Line numbers, auto-wrap, variable highlight, search, undo/redo
- Chinese-friendly: 15px font, 1.8 line-height, system fonts

Next Step: Phase 3.5.5 - Integrate RVW module with PromptService

Tested: Backend API tests passed (8/8), Frontend pending user testing
Status: Ready for Phase 3.5.5 RVW integration
This commit is contained in:
2026-01-11 21:25:16 +08:00
parent cdfbc9927a
commit 5523ef36ea
297 changed files with 15914 additions and 1266 deletions

View File

@@ -0,0 +1,79 @@
/**
* 测试 Prompt 管理 API
*
* 启动后端后运行: npx tsx scripts/test-prompt-api.ts
*/
const BASE_URL = 'http://localhost:3001/api/admin/prompts';
async function testAPI() {
console.log('🧪 测试 Prompt 管理 API...\n');
// 1. 获取列表
console.log('═══════════════════════════════════════════════════════');
console.log('📋 Test 1: GET /api/admin/prompts\n');
const listRes = await fetch(BASE_URL);
const listData = await listRes.json();
console.log(` 状态: ${listRes.status}`);
console.log(` 总数: ${listData.total}`);
console.log(` Prompts:`);
for (const p of listData.data || []) {
console.log(` - ${p.code} (${p.name}) v${p.latestVersion?.version || 0}`);
}
// 2. 获取详情
console.log('\n═══════════════════════════════════════════════════════');
console.log('📋 Test 2: GET /api/admin/prompts/RVW_EDITORIAL\n');
const detailRes = await fetch(`${BASE_URL}/RVW_EDITORIAL`);
const detailData = await detailRes.json();
console.log(` 状态: ${detailRes.status}`);
console.log(` Code: ${detailData.data?.code}`);
console.log(` Name: ${detailData.data?.name}`);
console.log(` 版本数: ${detailData.data?.versions?.length || 0}`);
// 3. 测试渲染
console.log('\n═══════════════════════════════════════════════════════');
console.log('📋 Test 3: POST /api/admin/prompts/test-render\n');
const renderRes = await fetch(`${BASE_URL}/test-render`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
content: '你好,{{name}}!请评估标题:{{title}}',
variables: { name: '张三', title: '测试标题' },
}),
});
const renderData = await renderRes.json();
console.log(` 状态: ${renderRes.status}`);
console.log(` 渲染结果: ${renderData.data?.rendered}`);
console.log(` 提取变量: [${renderData.data?.extractedVariables?.join(', ')}]`);
console.log(` 校验结果: ${renderData.data?.validation?.isValid ? '✅ 通过' : '❌ 缺少变量'}`);
// 4. 按模块筛选
console.log('\n═══════════════════════════════════════════════════════');
console.log('📋 Test 4: GET /api/admin/prompts?module=RVW\n');
const rvwRes = await fetch(`${BASE_URL}?module=RVW`);
const rvwData = await rvwRes.json();
console.log(` 状态: ${rvwRes.status}`);
console.log(` RVW模块Prompt数: ${rvwData.total}`);
for (const p of rvwData.data || []) {
console.log(` - ${p.code}`);
}
// 5. 获取调试状态无认证预期返回401
console.log('\n═══════════════════════════════════════════════════════');
console.log('📋 Test 5: GET /api/admin/prompts/debug (无认证)\n');
const debugRes = await fetch(`${BASE_URL}/debug`);
const debugData = await debugRes.json();
console.log(` 状态: ${debugRes.status}`);
console.log(` 响应: ${JSON.stringify(debugData)}`);
console.log('\n✅ API 测试完成!');
}
testAPI().catch(console.error);