HaHafeng
66255368b7
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
AI临床研究平台 - Frontend V2
版本： V2.0
创建日期： 2025-11-12
技术栈： React 18 + TypeScript + Vite + Ant Design + Tailwind CSS
📋 项目说明
这是AI临床研究平台的全新前端架构，采用模块化设计，支持：
- ✅ 顶部导航布局
- ✅ 模块化架构（5个业务模块）
- ✅ 动态模块加载
- ✅ 懒加载和代码分割
- ✅ 统一的开发规范
🚀 快速开始
安装依赖
npm install
启动开发服务器
npm run dev
构建生产版本
npm run build
预览生产构建
npm run preview
📁 项目结构
src/
├── framework/ # 框架层（平台级基础设施）
│ ├── layout/ # 布局系统
│ ├── modules/ # 模块注册系统
│ ├── router/ # 路由系统
│ ├── permission/ # 权限控制
│ └── config/ # 全局配置
│
├── modules/ # 业务模块（完全独立）
│ ├── asl/ # AI智能文献
│ ├── aia/ # AI智能问答
│ ├── pkb/ # 个人知识库
│ ├── rvw/ # 审稿系统
│ └── dc/ # 数据清洗
│
├── shared/ # 共享资源
│ ├── components/ # 通用组件
│ ├── hooks/ # 通用Hooks
│ ├── utils/ # 工具函数
│ └── api/ # API客户端
│
├── pages/ # 页面组件
│ └── HomePage.tsx # 首页
│
├── App.tsx # 应用根组件
└── main.tsx # 应用入口
🎯 模块说明
已实现
- ✅ 框架层：顶部导航、主布局、模块注册
- ✅ 占位页面：5个模块的占位展示
- ✅ 首页：模块入口和统计信息
开发中
- 🚧 ASL模块：Week 3 开发（AI智能文献）
待开发
- 📋 AIA模块：AI智能问答（后续重写）
- 📋 PKB模块：个人知识库（后续重写）
- 📋 RVW模块：审稿系统（后续重写）
- 📋 DC模块：数据清洗（占位）
🔧 开发规范
命名规范
- 组件文件：PascalCase（
TopNavigation.tsx） - Hooks文件：camelCase + use前缀（
useAuth.ts） - 工具函数：camelCase（
formatDate.ts） - 类型定义：PascalCase（
types.ts）
路径别名
使用 @/ 作为 src/ 的别名：
import TopNavigation from '@/framework/layout/TopNavigation'
import Placeholder from '@/shared/components/Placeholder'
模块开发
每个新模块需要：
- 在
src/modules/[模块名]/创建目录 - 创建
index.tsx作为模块入口 - 在
moduleRegistry.ts中注册模块 - 实现模块的
ModuleDefinition接口
📚 相关文档
🔗 API代理
开发环境下，所有 /api/* 请求会被代理到后端服务器：
Frontend: http://localhost:3000
Backend: http://localhost:3001
📝 TODO
- 实现权限控制系统
- 添加用户认证流程
- 实现面包屑导航
- 添加全局状态管理
- 完善错误处理
- 添加单元测试
维护者： 开发团队
最后更新： 2025-11-12