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,26 +1,27 @@
# 运维文档
> **鏂囨。瀹氫綅锛?* 绯荤粺杩愮淮銆佺洃鎺с€佹晠闅滄帓鏌?
> **閫傜敤鑼冨洿锛?* 杩愮淮鍥㈤槦銆丼RE鍥㈤槦
> **文档定位:** 系统运维、监控、故障排查
> **适用范围:** 运维团队、SRE团队
---
## 📋 运维文档清单
| 鏂囨。 | 璇存槑 | 鐘舵€?|
| 文档 | 说明 | 状态 |
|------|------|------|
| **01-<EFBFBD><EFBFBD>閰嶇疆鎸囧崡.md** | <EFBFBD><EFBFBD>鍙橀噺銆佹暟鎹<EFBFBD>簱杩炴帴銆丄PI瀵嗛挜閰嶇疆 | 鉁?宸插畬鎴?|
| **02-<EFBFBD><EFBFBD>鍙橀噺閰嶇疆妯℃澘.md** | .env閰嶇疆妯℃澘锛屽惈CloseAI閰嶇疆 猸?| 鉁?宸插畬鎴?|
| **03-鐩戞帶鍛婅<EFBFBD>.md** | 鐩戞帶鎸囨爣銆佸憡璀﹁<EFBFBD>鍒?| 鈴?寰呭垱寤?|
| **04-鏁呴殰鎺掓煡.md** | 甯歌<EFBFBD><EFBFBD><EFBFBD>鎺掓煡鎵嬪唽 | 鈴?寰呭垱寤?|
| **05-澶囦唤鎭㈠<EFBFBD>.md** | 鏁版嵁澶囦唤鍜屾仮澶嶇瓥鐣?| 鈴?寰呭垱寤?|
| **01-环境配置指南.md** | 环境变量、数据库连接、API密钥配置 | ✅ 已完成 |
| **02-环境变量配置模板.md** | .env配置模板含CloseAI配置 ⭐ | ✅ 已完成 |
| **03-监控告警.md** | 监控指标、告警规则 | ⏳ 待创建 |
| **04-故障排查.md** | 常见问题排查手册 | ⏳ 待创建 |
| **05-备份恢复.md** | 数据备份和恢复策略 | ⏳ 待创建 |
---
## 🎯 核心运维任务
### 1. 监控
- 绯荤粺鍋ュ悍妫€鏌?- 鎬ц兘鐩戞帶
- 系统健康检查
- 性能监控
- 告警通知
### 2. 日志
@@ -29,12 +30,14 @@
- 日志归档
### 3. 备份
- 鏁版嵁搴撳<EFBFBD>浠?- 鏂囦欢澶囦唤
- 数据库备份
- 文件备份
- 恢复演练
### 4. 故障处理
- 故障诊断
- 搴旀€ラ<EFBFBD>妗?- 浜嬪悗鎬荤粨
- 应急预案
- 事后总结
---