Files
AIclinicalresearch/docs/_templates/模块README-模板.md
HaHafeng 66255368b7 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
2026-01-16 13:42:10 +08:00

100 lines
1.7 KiB
Markdown

# [模块代号] - [模块名称]
> **模块代号:** [代号] ([英文全称])
> **开发状态:** [✅已完成 / ⏳开发中 / ⏳规划中]
> **商业价值:** ⭐⭐⭐⭐⭐ [评级]
> **独立性:** ⭐⭐⭐⭐⭐ [评级]
> **优先级:** [P0/P1/P2]
---
## 📋 模块概述
[2-3句话描述模块核心功能和价值]
**核心价值:** [核心差异化点]
---
## 🎯 核心功能
### [已完成功能 / 计划功能]
1. [✅/⏳] **功能1** - 简要描述
2. [✅/⏳] **功能2** - 简要描述
3. [✅/⏳] **功能3** - 简要描述
**[本周/下一步]重点:** [当前重点]
---
## 📂 文档结构
```
[模块代号]-[模块名称]/
├── [AI对接] [代号]快速上下文.md # [状态]
├── 00-项目概述/
│ ├── 01-产品需求文档(PRD).md # [状态]
│ └── README.md
├── 01-设计文档/
│ ├── 01-技术架构设计.md # [状态]
│ ├── 02-数据库设计.md # [状态]
│ ├── 03-API设计.md # [状态]
│ └── README.md
├── 02-业务规则/
├── 03-开发计划/
├── 04-测试文档/
└── README.md # ✅ 当前文档
```
---
## 🔗 依赖的通用能力
- **[能力1]** - [用途]
- **[能力2]** - [用途]
---
## 🎯 商业模式
**目标客户:** [目标客户群]
**售卖方式:** [独立产品 / 组合售卖 / 平台功能]
**定价策略:** [定价方式]
---
## ⚠️ [技术难点 / 核心特色]
[如果有特别的技术难点或核心特色,在这里说明]
---
**最后更新:** [日期]
**维护人:** 技术架构师