Files
AIclinicalresearch/docs/03-业务模块/ASL-AI智能文献/00-系统设计/01-系统架构设计.md
HaHafeng 66255368b7 feat(admin): Add user management and upgrade to module permission system
Features - User Management (Phase 4.1):
- Database: Add user_modules table for fine-grained module permissions
- Database: Add 4 user permissions (view/create/edit/delete) to role_permissions
- Backend: UserService (780 lines) - CRUD with tenant isolation
- Backend: UserController + UserRoutes (648 lines) - 13 API endpoints
- Backend: Batch import users from Excel
- Frontend: UserListPage (412 lines) - list/filter/search/pagination
- Frontend: UserFormPage (341 lines) - create/edit with module config
- Frontend: UserDetailPage (393 lines) - details/tenant/module management
- Frontend: 3 modal components (592 lines) - import/assign/configure
- API: GET/POST/PUT/DELETE /api/admin/users/* endpoints

Architecture Upgrade - Module Permission System:
- Backend: Add getUserModules() method in auth.service
- Backend: Login API returns modules array in user object
- Frontend: AuthContext adds hasModule() method
- Frontend: Navigation filters modules based on user.modules
- Frontend: RouteGuard checks requiredModule instead of requiredVersion
- Frontend: Remove deprecated version-based permission system
- UX: Only show accessible modules in navigation (clean UI)
- UX: Smart redirect after login (avoid 403 for regular users)

Fixes:
- Fix UTF-8 encoding corruption in ~100 docs files
- Fix pageSize type conversion in userService (String to Number)
- Fix authUser undefined error in TopNavigation
- Fix login redirect logic with role-based access check
- Update Git commit guidelines v1.2 with UTF-8 safety rules

Database Changes:
- CREATE TABLE user_modules (user_id, tenant_id, module_code, is_enabled)
- ADD UNIQUE CONSTRAINT (user_id, tenant_id, module_code)
- INSERT 4 permissions + role assignments
- UPDATE PUBLIC tenant with 8 module subscriptions

Technical:
- Backend: 5 new files (~2400 lines)
- Frontend: 10 new files (~2500 lines)
- Docs: 1 development record + 2 status updates + 1 guideline update
- Total: ~4900 lines of code

Status: User management 100% complete, module permission system operational
2026-01-16 13:42:10 +08:00

100 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AI智能文献模块 - 系统架构设计
> **文档版本:** v1.0
> **创建日期:** 2025-10-29
> **维护者:** AI智能文献开发团队
> **最后更新:** 2025-10-29
---
## 📋 文档说明
本文档描述AI智能文献模块的系统架构设计包括模块架构、技术架构、数据架构等。
---
## 🏗️ 模块架构
### 核心功能模块
```
AI智能文献模块
├── 1. 研究方案生成
├── 2. 智能文献检索
├── 3. 标题摘要初筛 ⭐ 当前优先开发
├── 4. 全文复筛
├── 5. 全文解析与数据提取
└── 6. 数据综合分析与报告生成
```
### 模块间关系
```
研究方案生成 → 指导后续所有模块
智能文献检索 → 生成文献列表
标题摘要初筛 → 初步筛选结果
全文复筛 → 最终纳入列表
全文解析与数据提取 → 结构化数据
数据综合分析与报告生成 → 最终报告
```
---
## 🔧 技术架构
### 前端架构
- **框架**: React + TypeScript
- **UI库**: Ant Design + Tailwind CSS
- **状态管理**: Zustand / React Query
- **路由**: React Router
### 后端架构
- **框架**: Node.js + TypeScript + Fastify
- **数据库**: PostgreSQL + Prisma ORM
- **文件存储**: 本地存储 / 对象存储
- **AI集成**: DeepSeek-V3、Qwen3-72B
### AI服务架构
- **双模型系统**: DS模型 + Q3模型
- **流式输出**: Server-Sent Events (SSE)
- **批处理**: 支持批量任务处理
---
## 📊 数据架构
### 核心数据实体
- **研究方案** (Research Protocol)
- **文献项目** (Literature Project)
- **文献条目** (Literature Item)
- **筛选结果** (Screening Result)
- **提取数据** (Extracted Data)
---
## ⏳ 待完善内容
本文档内容正在完善中,后续将补充:
- 详细的架构图
- 模块间通信机制
- 数据流设计
- 安全性设计
---
**文档版本:** v1.0
**最后更新:** 2025-10-29