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,52 +1,52 @@
# å¹³å<EFBFBD>°åŸºç¡€å±?
# 平台基础层
> **层级定义ï¼?* 所有业务模å<C2A1>—的基础设æ½
> **核心原则ï¼?* 全局唯一ã€<C3A3>业务无关ã€<C3A3>稳定性高
> **层级定义:** 所有业务模块的基础设施
> **核心原则:** 全局唯一、业务无关、稳定性高
---
## 📋 模块清单
| 模å<EFBFBD>— | 说明 | 状æ€?|
| 模块 | 说明 | 状态 |
|------|------|------|
| **01-用户与æ<EFBFBD>ƒé™<EFBFBD>中å¿?UAM)** | 用户认è¯<C3A8>ã€<C3A3>è§è‰²æ<C2B2>ƒé™<C3A9>ã€<C3A3>Feature Flag | â<EFBFBD>?待设è®?|
| **02-å­˜å¨æœ<EFBFBD>务** | æ‡ä»¶ä¸Šä¼ ä¸è½½ã€<C3A3>对象存å?| â<>?待设è®?|
| **03-通知æœ<EFBFBD>务** | 站内消æ<CB86>¯ã€<C3A3>é®ä»¶ã€<C3A3>WebSocket | â<>?待设è®?|
| **04-监控与日å¿?* | æ“<C3A6>作日志ã€<C3A3>é”™è¯¯çæŽ§ã€<C3A3>审计日å¿?| â<>?待设è®?|
| **05-系统é…<EFBFBD>ç½®** | 系统级é…<C3A9>置管ç<C2A1>†ã€<C3A3>动æ€<C3A6>é…<C3A9>ç½?| â<>?待设è®?|
| **01-用户与权限中心(UAM)** | 用户认证、角色权限、Feature Flag | ⏳ 待设计 |
| **02-存储服务** | 文件上传下载、对象存储 | ⏳ 待设计 |
| **03-通知服务** | 站内消息、邮件、WebSocket | ⏳ 待设计 |
| **04-监控与日志** | 操作日志、错误监控、审计日志 | ⏳ 待设计 |
| **05-系统配置** | 系统级配置管理、动态配置 | ⏳ 待设计 |
---
## 🎯 设计原则
### 1. 全局唯一�
### 1. 全局唯一性
- 整个平台只有一套基础设施
- 所有业务模å<EFBFBD>—å…±äº?
- 所有业务模块共享
### 2. 业务无关�
### 2. 业务无关性
- 不涉及具体业务逻辑
- 提供通用能力
### 3. 高稳定�
### 3. 高稳定性
- 很少变动
- 向后兼容
### 4. 高å<EFBFBD>¯ç”¨æ€?
### 4. 高可用性
- 支持负载均衡
- 支持容灾备份
---
## 📚 快速导�
## 📚 快速导航
### 快速上下文
- **[AI对接] å¹³å<C2B3>°å±å¿«é€Ÿä¸Šä¸æ‡.md** - 2-3分éŸäº†è§£å¹³å<C2B3>°å±?
- **[AI对接] 平台层快速上下文.md** - 2-3分钟了解平台层
### 核心模块
1. [用户与æ<EFBFBD>ƒé™<EFBFBD>中å¿?UAM)](./01-用户与æ<C5BD>ƒé™<C3A9>中å¿?UAM)/README.md) - P0优先çº?
1. [用户与权限中心(UAM)](./01-用户与权限中心(UAM)/README.md) - P0优先级
2. [存储服务](./02-存储服务/README.md)
3. [通知服务](./03-通知服务/README.md)
4. [监控与日志](./04-监控与日�README.md)
4. [监控与日志](./04-监控与日志/README.md)
5. [系统配置](./05-系统配置/README.md)
---
@@ -54,7 +54,7 @@
## 🔗 相关文档
- [系统架构分层设计](../00-系统总体设计/01-系统架构分层设计.md)
- [通用能力层](../02-通用能力�README.md)
- [通用能力层](../02-通用能力层/README.md)
- [业务模块层](../03-业务模块/README.md)
---