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
This commit is contained in:
2026-01-16 13:42:10 +08:00
parent 98d862dbd4
commit 66255368b7
560 changed files with 70424 additions and 52353 deletions

View File

@@ -1,15 +1,15 @@
# AI智能文献模块 - 前端组件设计
> **<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𧋦嚗?* v1.0
> **<EFBFBD>𥕦遣<EFBFBD><EFBFBD>嚗?* 2025-10-29
> **蝏湔擪<EFBFBD><EFBFBD><EFBFBD>** AI<41><EFBFBD><E7AE84><EFBFBD>讃撘<E8AE83><E69298>穃𣪧<E7A983>?
> **文档版本:** v1.0
> **创建日期:** 2025-10-29
> **维护者:** AI智能文献开发团队
> **最后更新:** 2025-10-29
---
## 📋 文档说明
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>餈蚊I<EFBFBD><EFBFBD><EFBFBD><EFBFBD>讃璅<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝡舐<EFBFBD>隞嗉挽霈∴<EFBFBD><EFBFBD><EFBFBD>𡠺蝏<EFBFBD>辣蝏𤘪<EFBFBD><EFBFBD><EFBFBD><EFBFBD>隞嗆𦻖<EFBFBD><EFBFBD><EFBFBD><EFBFBD>漱鈭坿挽霈∠<EFBFBD><EFBFBD>?
本文档描述AI智能文献模块的前端组件设计包括组件结构、组件接口、交互设计等。
---
@@ -20,37 +20,37 @@
```
LiteratureScreeningModule/
├── TitleAbstractScreening/
<EFBFBD>? <20><EFBFBD><E98EBF><EFBFBD> SetupView/ # 霈曄蔭銝𤾸鍳<EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> CriteriaReference.tsx # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>𢒰<EFBFBD>?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> CriteriaAdjustment.tsx # 銝湔𧒄靚<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> LiteratureImport.tsx # <EFBFBD><EFBFBD>讃撖澆<EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20><EFBFBD><E5A999><EFBFBD> StartScreeningButton.tsx # <EFBFBD>臬𢆡蝑偦<EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <20>?
<EFBFBD>? <20><EFBFBD><E98EBF><EFBFBD> ReviewTableView/ # 銵冽聢<EFBFBD>硋恣<EFBFBD>詨極雿𨅯蝱 潃鞉瓲敹?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> ScreeningTable.tsx # 銝餉”<EFBFBD><EFBFBD>隞?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> TableHeader.tsx # 銵典仍嚗<EFBFBD><EFBFBD>銵𣬚<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> TableRow.tsx # 銵冽聢銵?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> ExpandableRow.tsx # <EFBFBD><EFBFBD><EFBFBD>銵䕘<EFBFBD><EFBFBD>旿撅閧內嚗?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> JudgmentCell.tsx # <EFBFBD>斗鱏<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?<3F>??嚗?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> ConflictIndicator.tsx # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝷箏膥
<EFBFBD>? <20>? <20><EFBFBD><E5A999><EFBFBD> DecisionSelector.tsx # <EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝑㚚<EFBFBD>㗇𥋘<EFBFBD>?
<EFBFBD>? <20>?
<EFBFBD>? <20><EFBFBD><E98EBF><EFBFBD> EvidenceModal/ # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>交芋<EFBFBD><EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> ModalContainer.tsx # 璅⊥<EFBFBD><EFBFBD><EFBFBD>摰孵膥
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> AbstractView.tsx # 撌虫儒嚗𡁏<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> EvidenceView.tsx # <EFBFBD>喃儒嚗朞<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <20>? <20><EFBFBD><E5A999><EFBFBD> HighlightedText.tsx # 擃䀝漁<EFBFBD><EFBFBD>𧋦蝏<EFBFBD>
<EFBFBD>? <20>?
<EFBFBD>? <20><EFBFBD><E98EBF><EFBFBD> ResultView/ # 蝏𤘪<EFBFBD>撅閧內閫<EFBFBD>
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> StatisticsCards.tsx # 蝏蠘恣<EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> PrismaSummary.tsx # PRISMA撘𤩺<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20><EFBFBD><E98EBF><EFBFBD> ResultTabs.tsx # 蝏𤘪<EFBFBD>Tab憿?
<EFBFBD>? <20>? <20><EFBFBD><E5A999><EFBFBD> ResultTable.tsx # 蝏𤘪<EFBFBD>銵冽聢
<EFBFBD>? <20>?
<EFBFBD>? <20><EFBFBD><E5A999><EFBFBD> shared/ # <EFBFBD>曹澈蝏<EFBFBD>
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> ProtocolOverview.tsx # <EFBFBD>𠉛弦<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> BatchOperation.tsx # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
<EFBFBD>? <EFBFBD><EFBFBD><EFBFBD><EFBFBD> ExportButton.tsx # 撖澆枂<EFBFBD>厰僼
│ ├── SetupView/ # 设置与启动视图
│ │ ├── CriteriaReference.tsx # 标准参考面板
│ │ ├── CriteriaAdjustment.tsx # 临时调整标准
│ │ ├── LiteratureImport.tsx # 文献导入组件
│ │ └── StartScreeningButton.tsx # 启动筛选按钮
│ │
│ ├── ReviewTableView/ # 表格化审核工作台 ⭐核心
│ │ ├── ScreeningTable.tsx # 主表格组件
│ │ ├── TableHeader.tsx # 表头(双行结构)
│ │ ├── TableRow.tsx # 表格行
│ │ ├── ExpandableRow.tsx # 可展开行(证据展示)
│ │ ├── JudgmentCell.tsx # 判断单元格(✓/✗/?
│ │ ├── ConflictIndicator.tsx # 冲突状态指示器
│ │ └── DecisionSelector.tsx # 最终决策选择器
│ │
│ ├── EvidenceModal/ # 双视图原文审查模态框
│ │ ├── ModalContainer.tsx # 模态框容器
│ │ ├── AbstractView.tsx # 左侧:摘要视图
│ │ ├── EvidenceView.tsx # 右侧:证据视图
│ │ └── HighlightedText.tsx # 高亮文本组件
│ │
│ ├── ResultView/ # 结果展示视图
│ │ ├── StatisticsCards.tsx # 统计卡片
│ │ ├── PrismaSummary.tsx # PRISMA式排除总结
│ │ ├── ResultTabs.tsx # 结果Tab
│ │ └── ResultTable.tsx # 结果表格
│ │
│ └── shared/ # 共享组件
├── ProtocolOverview.tsx # 研究方案概览面板
├── BatchOperation.tsx # 批量操作组件
└── ExportButton.tsx # 导出按钮
```
---
@@ -60,7 +60,7 @@ LiteratureScreeningModule/
### 1. ScreeningTable (表格化审核工作台)
**组件职责**:
- 撅閧內<EFBFBD><EFBFBD><EFBFBD>𡑒”<EFBFBD>𣬚<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
- 展示文献列表和筛选结果
- 支持展开/收起查看证据
- 支持点击判断查看详情
- 支持批量操作
@@ -80,7 +80,7 @@ interface ScreeningTableProps {
**组件职责**:
- 左侧显示摘要/全文
- <EFBFBD>喃儒<EFBFBD>曄內AI<EFBFBD>斗鱏<EFBFBD><EFBFBD><EFBFBD>?
- 右侧显示AI判断和证据
- 支持文本高亮
- 支持查看引用来源
@@ -98,14 +98,14 @@ interface EvidenceModalProps {
**组件职责**:
- 整合表格和模态框
- 蝞∠<EFBFBD>蝑偦<EFBFBD>厩𠶖<EFBFBD>?
- 管理筛选状态
- 处理用户交互
---
## <EFBFBD><EFBFBD> <20><EFBFBD><E59786><EFBFBD>?
## 🔄 状态管理
### 雿輻鍂Zustand蝞∠<EFBFBD>蝑偦<EFBFBD>厩𠶖<EFBFBD>?
### 使用Zustand管理筛选状态
```typescript
interface ScreeningStore {
@@ -124,26 +124,26 @@ interface ScreeningStore {
---
## <EFBFBD>𢲡 <20><EFBFBD>撘讛挽霈?
## 📱 响应式设计
### 表格布局适配
- **獢屸𢒰蝡?*: 摰峕㟲銵冽聢<E586BD>曄內
- **撟單踎蝡?*: <20>舀赤<E88880><EFBFBD><E78390><EFBFBD><E58981>喲睸<E596B2>堒𤐄摰?
- **蝘餃𢆡蝡?*: <20><EFBFBD>撘誩<E69298><EFBFBD><E69285>蹂誨銵冽聢
- **桌面端**: 完整表格显示
- **平板端**: 可横向滚动,关键列固定
- **移动端**: 卡片式布局替代表格
---
## <EFBFBD>?敺<><E695BA><EFBFBD><EFBFBD><EFBFBD>摰?
## ⏳ 待完善内容
后续将补充:
- 详细组件接口定义
- <EFBFBD>辣鈭支<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
- 组件交互流程图
- 样式设计规范
- 组件使用示例
---
**<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𧋦嚗?* v1.0
**文档版本:** v1.0
**最后更新:** 2025-10-29