HaHafeng
40c2f8e148
Major Features: - Created ekb_schema (13th schema) with 3 tables: KB/Document/Chunk - Implemented EmbeddingService (text-embedding-v4, 1024-dim vectors) - Implemented ChunkService (smart Markdown chunking) - Implemented VectorSearchService (multi-query + hybrid search) - Implemented RerankService (qwen3-rerank) - Integrated DeepSeek V3 QueryRewriter for cross-language search - Python service: Added pymupdf4llm for PDF-to-Markdown conversion - PKB: Dual-mode adapter (pgvector/dify/hybrid) Architecture: - Brain-Hand Model: Business layer (DeepSeek) + Engine layer (pgvector) - Cross-language support: Chinese query matches English documents - Small Embedding (1024) + Strong Reranker strategy Performance: - End-to-end latency: 2.5s - Cost per query: 0.0025 RMB - Accuracy improvement: +20.5% (cross-language) Tests: - test-embedding-service.ts: Vector embedding verified - test-rag-e2e.ts: Full pipeline tested - test-rerank.ts: Rerank quality validated - test-query-rewrite.ts: Cross-language search verified - test-pdf-ingest.ts: Real PDF document tested (Dongen 2003.pdf) Documentation: - Added 05-RAG-Engine-User-Guide.md - Added 02-Document-Processing-User-Guide.md - Updated system status documentation Status: Production ready
227 lines
5.9 KiB
Markdown
227 lines
5.9 KiB
Markdown
# ADMIN - 运营管理端
|
||
|
||
> **模块代码：** ADMIN
|
||
> **模块名称：** 运营管理端（Operations Management Portal）
|
||
> **优先级：** P0（核心基础设施）
|
||
> **开发状态：** 🟡 架构设计中
|
||
> **负责人：** [待定]
|
||
|
||
---
|
||
|
||
## 📋 模块概述
|
||
|
||
运营管理端是AI临床研究平台的**核心管理后台**，为公司内部运营人员提供全方位的系统管理和运维能力。
|
||
|
||
### 核心价值
|
||
|
||
1. **SaaS多租户管理**：统一管理所有医院/药企客户
|
||
2. **AI成本控制**：精细化配额管理，控制Token消耗
|
||
3. **Prompt工程化**：生产环境灰度预览，专业人员调试AI效果
|
||
4. **系统运维**：用户管理、权限配置、审计日志
|
||
|
||
---
|
||
|
||
## 🎯 核心功能模块
|
||
|
||
### 1. 租户管理
|
||
- 租户创建/编辑/停用
|
||
- 品牌定制（Logo、背景图、主题色）
|
||
- 模块订阅管理（ASL/DC/IIT等）
|
||
- 配额分配与监控
|
||
|
||
### 2. Prompt管理系统 ⭐
|
||
- **生产环境灰度预览**
|
||
- 调试者角色（PROMPT_ENGINEER）
|
||
- DRAFT/ACTIVE版本隔离
|
||
- 多业务模块Prompt配置（ASL/DC/IIT/PKB/AIA/RVW）
|
||
|
||
### 3. 用户与权限管理
|
||
- 用户CRUD
|
||
- 角色分配（SUPER_ADMIN/PROMPT_ENGINEER/等）
|
||
- 权限配置
|
||
|
||
### 4. 系统监控与审计
|
||
- 操作日志审计
|
||
- Token消耗统计
|
||
- 系统健康监控
|
||
|
||
---
|
||
|
||
## 📂 文档结构
|
||
|
||
```
|
||
ADMIN-运营管理端/
|
||
├── README.md # 本文件
|
||
├── 00-模块当前状态与开发指南.md # 快速上手指南
|
||
│
|
||
├── 00-系统设计/ # 系统架构设计
|
||
│ ├── 00-权限与角色体系梳理报告_v1.0.md
|
||
│ └── 02-通用能力层_10-权限体系梳理反馈与修正建议.md
|
||
│
|
||
├── 01-需求分析/ # PRD文档
|
||
│ └── 02-通用能力层_07-运营与机构管理端PRD_v2.1.md
|
||
│
|
||
├── 02-技术设计/ # 技术设计文档
|
||
│ ├── 02-通用能力层_03-Prompt管理系统与灰度预览设计方案.md
|
||
│ ├── 03-Prompt管理系统快速参考.md
|
||
│ └── Prompt管理后台设计.md
|
||
│
|
||
├── 03-UI设计/ # 原型与UI设计
|
||
│
|
||
├── 04-开发计划/ # 开发计划与任务分解
|
||
│
|
||
├── 05-测试文档/ # 测试用例与测试数据
|
||
│
|
||
├── 06-开发记录/ # 每日开发总结
|
||
│
|
||
└── 07-技术债务/ # 技术债务清单
|
||
```
|
||
|
||
---
|
||
|
||
## 🔐 角色与权限设计
|
||
|
||
### 核心角色
|
||
|
||
| 角色 | 角色Code | 权限范围 | 说明 |
|
||
|------|---------|---------|------|
|
||
| **超级管理员** | SUPER_ADMIN | 所有权限 | 公司内部运营人员 |
|
||
| **Prompt工程师** | PROMPT_ENGINEER | prompt:* | 调试AI Prompt的专业人员 |
|
||
| 医院管理员 | HOSPITAL_ADMIN | 租户级管理 | 仅管理自己的医院租户 |
|
||
| 药企管理员 | PHARMA_ADMIN | 租户级管理 | 仅管理自己的药企租户 |
|
||
| 普通用户 | USER | 基础功能 | 业务模块使用者 |
|
||
|
||
### Prompt管理专属权限
|
||
|
||
| 权限 | 说明 |
|
||
|------|------|
|
||
| `prompt:view` | 查看Prompt列表和历史版本 |
|
||
| `prompt:edit` | 创建/修改DRAFT版本 |
|
||
| `prompt:debug` | ⭐ 开启调试模式（生产环境灰度预览） |
|
||
| `prompt:publish` | 发布DRAFT→ACTIVE |
|
||
|
||
---
|
||
|
||
## 🗄️ 数据库Schema
|
||
|
||
### 核心表（platform_schema）
|
||
|
||
- `tenants` - 租户表
|
||
- `tenant_members` - 租户成员关系
|
||
- `tenant_modules` - 租户订阅的模块
|
||
- `tenant_quotas` - 租户配额
|
||
- `tenant_quota_allocations` - 配额分配（科室/个人）
|
||
- `departments` - 科室表
|
||
- `permissions` - 权限表
|
||
- `role_permissions` - 角色权限关联
|
||
|
||
### Prompt管理表（capability_schema）
|
||
|
||
- `prompt_templates` - Prompt模板
|
||
- `prompt_versions` - Prompt版本（DRAFT/ACTIVE/ARCHIVED）
|
||
|
||
### 审计日志表（admin_schema）
|
||
|
||
- `admin_operation_logs` - 运营操作日志
|
||
|
||
---
|
||
|
||
## 🚀 技术栈
|
||
|
||
### 后端
|
||
- **框架：** Fastify + Prisma
|
||
- **数据库：** PostgreSQL 14+（支持LISTEN/NOTIFY）
|
||
- **认证：** JWT (jsonwebtoken)
|
||
- **密码：** bcryptjs
|
||
|
||
### 前端
|
||
- **框架：** React 19 + TypeScript
|
||
- **UI库：** Ant Design 6.0
|
||
- **状态管理：** React Context + Hooks
|
||
- **路由：** React Router v6
|
||
|
||
---
|
||
|
||
## 📅 开发路线图
|
||
|
||
### Phase 0: 数据迁移 + 基础设施（3天）
|
||
- [ ] 统一User表（public.users → platform_schema.users）
|
||
- [ ] 创建所有新表
|
||
- [ ] 超级管理员种子数据
|
||
- [ ] Prompt表和权限配置
|
||
|
||
### Phase 1-2: 认证系统（2天）
|
||
- [ ] JWT认证
|
||
- [ ] 登录/登出API
|
||
- [ ] 认证中间件
|
||
|
||
### Phase 3-4: 运营管理端MVP（5天）
|
||
- [ ] 租户管理（CRUD + 品牌配置）
|
||
- [ ] **Prompt管理系统**
|
||
- [ ] 列表/编辑器/版本历史
|
||
- [ ] 全局调试开关
|
||
- [ ] 草稿保存/发布
|
||
|
||
### Phase 5-6: 完善功能（3天）
|
||
- [ ] 用户管理
|
||
- [ ] 权限配置
|
||
- [ ] 审计日志查询
|
||
- [ ] 配额管理
|
||
|
||
---
|
||
|
||
## 🔗 相关模块
|
||
|
||
- **机构管理端（INST）**：医院端/药企端自服务管理界面
|
||
- **平台基础层（Platform）**：认证、权限、存储等基础服务
|
||
- **通用能力层（Capability）**：Prompt管理、LLM Gateway等
|
||
|
||
---
|
||
|
||
## 📚 快速开始
|
||
|
||
1. **阅读架构设计**
|
||
→ `00-系统设计/00-权限与角色体系梳理报告_v1.0.md`
|
||
|
||
2. **了解需求**
|
||
→ `01-需求分析/02-通用能力层_07-运营与机构管理端PRD_v2.1.md`
|
||
|
||
3. **Prompt管理（核心功能）**
|
||
→ `02-技术设计/03-Prompt管理系统快速参考.md`
|
||
|
||
4. **查看开发状态**
|
||
→ `00-模块当前状态与开发指南.md`
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **安全第一**：运营管理端拥有最高权限，必须严格控制访问
|
||
2. **审计日志**：所有操作必须记录，支持追溯
|
||
3. **多租户隔离**：确保租户数据完全隔离
|
||
4. **Prompt管理**：生产环境调试模式必须有权限控制
|
||
|
||
---
|
||
|
||
## 📞 联系方式
|
||
|
||
- **技术负责人：** [待定]
|
||
- **产品负责人：** [待定]
|
||
|
||
---
|
||
|
||
*最后更新：2026-01-11*
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|