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,7 +1,7 @@
# 文档模板
> **<EFBFBD>綍璇存槑锛?* 鏈<>洰褰曞寘鍚<E5AF98>悇绫绘枃妗殑鏍囧噯妯℃澘
> **浣跨敤鏂规硶锛?* 鍒涘缓鏂版枃妗椂锛屽<E9949B>鍒跺<E98D92>搴旀ā鏉匡紝濉<E7B49D>厖鍐呭<E98D90>
> **目录说明:** 本目录包含各类文档的标准模板
> **使用方法:** 创建新文档时,复制对应模板,填充内容
---
@@ -9,28 +9,28 @@
| 模板 | 说明 | 适用场景 |
|------|------|---------|
| **[AI瀵规帴] 蹇<>€熶笂涓嬫枃-妯℃澘.md** | 蹇<>€熶笂涓嬫枃鏂囨。妯℃澘 | 鍒涘缓鏂版ā鍧?鑳藉姏鏃?|
| **[AI对接] 快速上下文-模板.md** | 快速上下文文档模板 | 创建新模块/能力时 |
| **模块README-模板.md** | 模块README模板 | 创建新业务模块时 |
---
## 🎯 使用说明
### 1. 鍒涘缓鏂颁笟鍔℃ā鍧?
### 1. 创建新业务模块
**姝ラ<EFBFBD>锛?*
**步骤:**
1. 复制 `模块README-模板.md` 到新模块目录
2. 重命名为 `README.md`
3. <EFBFBD>厖鎵€鏈?`[鍗犱綅绗<E7B685>` 鍐呭<E98D90>
3. 填充所有 `[占位符]` 内容
4. 删除不需要的章节
### 2. 创建快速上下文文档
**姝ラ<EFBFBD>锛?*
1. 澶嶅埗 `[AI瀵规帴] 蹇<>€熶笂涓嬫枃-妯℃澘.md` 鍒板<E98D92>搴旂洰褰?
**步骤:**
1. 复制 `[AI对接] 快速上下文-模板.md` 到对应目录
2. 重命名为 `[AI对接] [模块代号]快速上下文.md`
3. <EFBFBD>厖鎵€鏈夊唴瀹?
4. <EFBFBD>Token娑堣€楀湪鐩<EFBFBD>爣鑼冨洿鍐?
3. 填充所有内容
4. 确保Token消耗在目标范围内
---
@@ -40,18 +40,18 @@
**L0级别总体**
- Token消耗~800
- 闃呰<EFBFBD>鏃堕棿锛?鍒嗛挓
- 鍐呭<EFBFBD>锛氶」鐩<EFBFBD>叏璨屻€佸揩閫熻烦杞?
- 阅读时间2分钟
- 内容:项目全貌、快速跳转
**L1绾у埆锛堝眰绾э級锛?*
**L1级别(层级):**
- Token消耗~1500
- 闃呰<EFBFBD>鏃堕棿锛?鍒嗛挓
- 鍐呭<EFBFBD>锛氬眰绾ф<EFBFBD>瑙堛€佹ā鍧楁竻鍗?
- 阅读时间3分钟
- 内容:层级概览、模块清单
**L2绾у埆锛堟ā鍧楋級锛?*
**L2级别(模块):**
- Token消耗~2000
- 闃呰<EFBFBD>鏃堕棿锛?鍒嗛挓
- 鍐呭<EFBFBD>锛氭ā鍧楄<EFBFBD>鎯呫€佸紑鍙戞寚鍗?
- 阅读时间5分钟
- 内容:模块详情、开发指南
---