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

@@ -2,32 +2,32 @@
## 📋 目录
本ç®å½•包å<EFBFBD>«å¹³å<EFBFBD>°å‰<EFBFBD>ç«¯çš„æž¶æž„è®¾è®¡æ‡æ¡£ã€?
本目录包含平台前端的架构设计文档。
### 文档列表
- **[01-前端总体架构设计.md](./01-前端总体架构设计.md)** - 平台级前端架构总体设计
- **[02-导航结构设计.md](./02-导航结构设计.md)** - 顶部导航和左侧导航的详细设计
- **[03-架构原型å›?html](./03-架构原型å›?html)** - 交äºå¼<C3A5>å‰<C3A5>端架构原åžå¾
- **[03-架构原型图.html](./03-架构原型图.html)** - 交互式前端架构原型图
---
## 🎯 设计原则
### 1. 模å<EFBFBD>—åŒè®¾è®?
- æ¯<EFBFBD>个功能模å<EFBFBD>—ç¬ç«å¼€å<EFBFBD>ã€<EFBFBD>ç¬ç«éƒ¨ç½?
### 1. 模块化设计
- 每个功能模块独立开发、独立部署
- 模块间无依赖关系,可独立运行
- 支æŒ<EFBFBD>模å<EFBFBD>—ç¬ç«äº§å“<EFBFBD>åŒ?
- 支持模块独立产品化
### 2. 权限控制设计
- 基于用户版本的æ<EFBFBD>ƒé™<EFBFBD>控åˆ?
- ç<EFBFBD>µæ´»çš„功能模å<EFBFBD>—开关机åˆ?
- 版本é…<EFBFBD>ç½®å<EFBFBD>¯åЍæ€<EFBFBD>è°ƒæ•?
- 基于用户版本的权限控制
- 灵活的功能模块开关机制
- 版本配置可动态调整
### 3. å<EFBFBD>¯æ‰©å±•性设è®?
- é¢„ç•™æ°æ¨¡å<EFBFBD>—接入接å<EFBFBD>?
### 3. 可扩展性设计
- 预留新模块接入接口
- 插件化的模块加载机制
- é…<EFBFBD>置驱动的功能开å…?
- 配置驱动的功能开关
---
@@ -38,7 +38,7 @@
---
**维护者:** å‰<C3A5>端开å<E282AC>å¢é˜?
**维护者:** 前端开发团队
**最后更新:** 2025-11-07