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,61 +1,61 @@
# RAG引擎
> **鑳藉姏瀹氫綅锛?* 閫氱敤鑳藉姏灞?
> **澶嶇敤鐜囷細** 43% (3<EFBFBD>ā鍧椾緷璧?
> **能力定位:** 通用能力层
> **复用率:** 43% (3个模块依赖)
> **优先级:** P1
> **鐘舵€侊細** 鉁?宸插疄鐜帮紙鍩轰簬Dify锛?
> **状态:** ✅ 已实现(基于Dify
---
## 📋 能力概述
RAG寮曟搸璐熻矗锛?
- 鍚戦噺鍖栧瓨鍌<EFBFBD>Embedding锛?
- <EFBFBD>箟妫€绱<EFBFBD>Semantic Search锛?
- 妫€绱㈠<EFBFBD>寮虹敓鎴愶紙RAG锛?
- Rerank閲嶆帓搴?
RAG引擎负责:
- 向量化存储(Embedding
- 语义检索(Semantic Search
- 检索增强生成(RAG
- Rerank重排序
---
## 📊 依赖模块
**3<EFBFBD>ā鍧椾緷璧栵紙43%澶嶇敤鐜囷級锛?*
**3个模块依赖43%复用率):**
1. **AIA** - AI智能问答@知识库问答
2. **ASL** - AI智能文献文献内容检索
3. **PKB** - <EFBFBD>汉鐭ヨ瘑搴擄紙RAG闂<EFBFBD>瓟锛?
3. **PKB** - 个人知识库RAG问答
---
## 💡 核心功能
### 1. 鍚戦噺鍖栧瓨鍌?
### 1. 向量化存储
- 基于Dify平台
- Qdrant鍚戦噺鏁版嵁搴擄紙Dify鍐呯疆锛?
- Qdrant向量数据库Dify内置
### 2. <EFBFBD>箟妫€绱?
- Top-K妫€绱?
- 鐩稿叧搴﹁瘎鍒?
- 澶氱煡璇嗗簱鑱斿悎妫€绱?
### 2. 语义检索
- Top-K检索
- 相关度评分
- 多知识库联合检索
### 3. RAG问答
- 妫€绱?+ 鐢熸垚
- 鏅鸿兘寮曠敤绯荤粺锛?00%鍑嗙<E28098>簮锛?
- 检索 + 生成
- 智能引用系统100%准确溯源)
---
## 馃彈锔?鎶€鏈<E282AC>灦鏋?
## 🏗️ 技术架构
**鍩轰簬Dify骞冲彴锛?*
**基于Dify平台:**
```typescript
// DifyClient封装
interface RAGEngine {
// 鍒涘缓鐭ヨ瘑搴?
// 创建知识库
createDataset(name: string): Promise<string>;
// 上传文档
uploadDocument(datasetId: string, file: File): Promise<string>;
// <EFBFBD>箟妫€绱?
// 语义检索
search(datasetId: string, query: string, topK?: number): Promise<SearchResult[]>;
// RAG问答
@@ -68,19 +68,19 @@ interface RAGEngine {
## 📈 优化成果
**检索参数优化:**
| 鎸囨爣 | 浼樺寲鍓?| 浼樺寲鍚?| 鎻愬崌 |
| 指标 | 优化前 | 优化后 | 提升 |
|------|--------|--------|------|
| 妫€绱㈡暟閲?| 3 chunks | 15 chunks | 5鍊?|
| Chunk澶у皬 | 500 tokens | 1500 tokens | 3鍊?|
| 鎬昏<EFBFBD>鐩?| 1,500 tokens | 22,500 tokens | 15鍊?|
| 瑕嗙洊鐜?| ~5% | ~40-50% | 8-10鍊?|
| 检索数量 | 3 chunks | 15 chunks | 5|
| Chunk大小 | 500 tokens | 1500 tokens | 3|
| 总覆盖 | 1,500 tokens | 22,500 tokens | 15|
| 覆盖率 | ~5% | ~40-50% | 8-10|
---
## 🔗 相关文档
- [通用能力层总览](../README.md)
- [Dify闆嗘垚鏂囨。](../../00-绯荤粺鎬讳綋璁捐<EFBFBD>/03-鏁版嵁搴撴灦鏋勮<E98F8B>鏄?md)
- [Dify集成文档](../../00-系统总体设计/03-数据库架构说明.md)
---