Files
AIclinicalresearch/docs/03-业务模块/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

3.2 KiB
Raw Blame History

业务模块层

层级定位: 面向用户的产品功能
核心原则: 独立部署、独立销售、低耦合、高内聚


📋 模块清单

模块 名称 商业价值 独立性 状态 优先级
AIA AI智能问答 已完成 -
ASL AI智能文献 下一步 P0
PKB 个人知识库 已完成 -
DC 数据清洗整理 规划中 P1
SSA 智能统计分析 规划中 P2
ST 统计分析工具 规划中 P2
RVW 稿件审查系统 独立系统 P1
ADMIN 运营管理端 规划中 P1

🎯 设计原则

1. 独立部署

  • 每个模块可以单独部署
  • 支持Docker打包
  • 支持Electron单机版

2. 独立销售

  • 每个模块可以单独售卖
  • 完整的文档和部署指南
  • 独立的定价策略

3. 低耦合

  • 模块间不直接依赖
  • 通过通用能力层交互

4. 高内聚

  • 模块内功能完整
  • 业务逻辑闭环

📊 模块分类

核心差异化模块(可独立销售)

  1. ASL - AI智能文献

    • 目标客户:系统评价研究者、循证医学中心
    • 商业模式:独立售卖
  2. DC - 数据清洗整理

    • 目标客户:临床科室、数据管理员
    • 商业模式:独立售卖
  3. RVW - 稿件审查系统

    • 目标客户:期刊编辑部、出版社
    • 商业模式:按期刊订阅

协同模块(组合销售)

  1. SSA + ST - 统计分析套件
    • 协同效应强
    • 组合售卖

基础模块(平台功能)

  1. AIA + PKB - AI助手套件
    • 平台标配功能

管理模块

  1. ADMIN - 运营管理端
    • SaaS运营必备

📚 快速导航

快速上下文

  • [AI对接] 业务模块快速上下文.md - 2-3分钟了解业务模块层

核心模块(按优先级)

  1. ASL-AI智能文献 - P0下一步开发
  2. DC-数据清洗整理 - P1核心竞争力
  3. RVW-稿件审查系统 - P1独立系统
  4. ADMIN-运营管理端 - P1商业基础

已完成模块

  1. AIA-AI智能问答 - 已完成
  2. PKB-个人知识库 - 已完成

规划中模块

  1. SSA-智能统计分析 - P2
  2. ST-统计分析工具 - P2

🔗 相关文档


最后更新: 2025-11-06
维护人: 技术架构师