Files
AIclinicalresearch/docs/07-运维文档
HaHafeng 5523ef36ea 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
2026-01-11 21:25:16 +08:00
..

运维文档

文档定位: 系统运维、监控、故障排查
适用范围: 运维团队、SRE团队


📋 运维文档清单

文档 说明 状态
01-环境配置指南.md 环境变量、数据库连接、API密钥配置 已完成
02-环境变量配置模板.md .env配置模板含CloseAI配置 已完成
03-监控告警.md 监控指标、告警规则 待创建
04-故障排查.md 常见问题排查手册 待创建
05-备份恢复.md 数据备份和恢复策略 待创建

🎯 核心运维任务

1. 监控

  • 系统健康检查
  • 性能监控
  • 告警通知

2. 日志

  • 日志收集
  • 日志分析
  • 日志归档

3. 备份

  • 数据库备份
  • 文件备份
  • 恢复演练

4. 故障处理

  • 故障诊断
  • 应急预案
  • 事后总结

最后更新: 2025-11-06
维护人: 技术架构师