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 @@
# 架构实施
> **鏂囨。瀹氫綅锛?* 鏋舵瀯婕旇繘銆佹妧鏈<E5A6A7>敼閫犮€佸伐绋嬪疄璺?
> **閫傜敤鑼冨洿锛?* 鎶€鏈<E282AC>灦鏋勫笀銆佹妧鏈<E5A6A7>礋璐
> **文档定位:** 架构演进、技术改造、工程实践
> **适用范围:** 技术架构师、技术负责人
---
@@ -9,10 +9,12 @@
```
09-架构实施/
鈹溾攢鈹€ 02-鏁版嵁搴撹繛鎺ラ厤缃?md # 鉁?Schema闅旂<EFBFBD>鐨勬暟鎹<EFBFBD>簱閰嶇疆
鈹溾攢鈹€ migration-scripts/ # 鈴?Schema杩佺ЩSQL鑴氭湰锛圵eek 1鍒涘缓锛? 鈹溾攢鈹€ 01-Monorepo鏋舵瀯璁捐<E79281>/ # 鈴?Monorepo杞<6F>崲鏂规<E98F82>
鈹溾攢鈹€ 02-浜у搧鎵撳寘鏂规<E98F82>/ # 鈴?鐙<>珛浜у搧鎵撳寘娴佺▼
鈹斺攢鈹€ 03-寰<>湇鍔℃媶鍒? # 鈴?寰<>湇鍔℃媶鍒嗙瓥鐣?```
├── 02-数据库连接配置.md # Schema隔离的数据库配置
├── migration-scripts/ # Schema迁移SQL脚本Week 1创建
├── 01-Monorepo架构设计/ # ⏳ Monorepo转换方案
├── 02-产品打包方案/ # ⏳ 独立产品打包流程
└── 03-微服务拆分/ # ⏳ 微服务拆分策略
```
---
@@ -20,14 +22,19 @@
### 1. Monorepo架构设计
- Monorepo总体设计
- 鍖呯<EFBFBD>鐞嗙瓥鐣ワ紙pnpm workspaces锛?- 浠爜鍏变韩涓庡<E6B693>鐢?- 鏋勫缓鍜岄儴缃?
- 包管理策略(pnpm workspaces
- 代码共享与复用
- 构建和部署
### 2. 产品打包方案
- 独立产品打包流程
- 依赖管理
- 构建脚本
- 版本管理
### 3. <EFBFBD>湇鍔℃媶鍒?- 鎷嗗垎绛栫暐鍜屾椂鏈?- 鏈嶅姟闂撮€氫俊
### 3. 微服务拆分
- 拆分策略和时机
- 服务间通信
- API网关配置
- 数据迁移
@@ -37,29 +44,40 @@
### 阶段一:模块化单体(当前)
- 严格代码隔离
- Schema闅旂<EFBFBD>锛堥€昏緫锛?- 妯″潡鍖栬<E98D96>璁?
### 闃舵<E99783>浜岋細棣栨<E6A3A3>鎷嗗垎锛?-18涓<38>湀锛?- Monorepo杞<6F>
- Schema鐗╃悊闅旂<E99785>
- 鎷嗗垎鐙<E59E8E>珛绯荤粺锛圧VW锛?- 寮曞叆API缃戝叧
- Schema隔离(逻辑)
- 模块化设计
### 闃舵<EFBFBD>涓夛細鍏ㄩ潰寰<EFBFBD>湇鍔★紙18涓<EFBFBD>湀+锛?- 鎵€鏈夋ā鍧楃嫭绔嬮儴缃?- K8s缂栨帓
### 阶段二首次拆分6-18个月
- Monorepo转换
- Schema物理隔离
- 拆分独立系统RVW
- 引入API网关
### 阶段三全面微服务18个月+
- 所有模块独立部署
- K8s编排
- 服务网格
---
## 馃摎 蹇<>€熷<E282AC>鑸?
### 褰撳墠瀹炴柦涓<E69FA6>紙Week 1锛?1. [鏁版嵁搴撹繛鎺ラ厤缃甝(./02-鏁版嵁搴撹繛鎺ラ厤缃?md) - 鉁?Schema闅旂<E99785>杩佺Щ閰嶇疆
2. [杩佺ЩSQL鑴氭湰](./migration-scripts/) - 鈴?Week 1鍒涘缓
## 📚 快速导航
### 当前实施中(Week 1
1. [数据库连接配置](./02-数据库连接配置.md) - ✅ Schema隔离迁移配置
2. [迁移SQL脚本](./migration-scripts/) - ⏳ Week 1创建
### 未来实施
3. [Monorepo鏋舵瀯璁捐<EFBFBD>](./01-Monorepo鏋舵瀯璁捐<EFBFBD>/README.md) - 鈴?寰呰<E5AFB0>鍒?4. [у搧鎵撳寘鏂规<EFBFBD>](./02-浜у搧鎵撳寘鏂规<E98F82>/README.md) - 鈴?寰呰<E5AFB0>鍒?5. [寰<>湇鍔℃媶鍒哴(./03-寰<>湇鍔℃媶鍒?README.md) - 鈴?寰呰<E5AFB0>鍒?
3. [Monorepo架构设计](./01-Monorepo架构设计/README.md) - ⏳ 待规划
4. [产品打包方案](./02-产品打包方案/README.md) - ⏳ 待规划
5. [微服务拆分](./03-微服务拆分/README.md) - ⏳ 待规划
---
## 🔗 相关文档
- [Monorepo架构评估](../00-系统总体设计/07-Monorepo架构评估.md)
- [模块独立部署方案](../00-系统总体设计/06-模块独立部署与单机版方案.md)
- [Schema闅旂<EFBFBD>鏂规<EFBFBD>](../00-绯荤粺鎬讳綋璁捐<EFBFBD>/05-Schema闅旂<EFBFBD>鏂规<EFBFBD>涓庢垚鏈<EFBFBD>垎鏋?md)
- [Schema隔离方案](../00-系统总体设计/05-Schema隔离方案与成本分析.md)
---