Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
AIclinicalresearch/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-18-架构重构完成报告.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

7.8 KiB
Raw Permalink Blame History

ASL模块 - 架构重构完成报告

日期: 2025-11-18
任务: 根据用户反馈重构前端架构
状态: ✅ 完成

📝 重构原因

用户反馈

  1. ❌ 原方案缺少左侧导航栏
  2. ❌ 需要参考原型的7个模块结构
  3. ❌ MVP只需标题摘要初筛，不需要项目管理
  4. ❌ PICOS输入框太小，内容显示不全

🔄 重构内容

1. 创建左侧导航布局 ⭐

新文件: components/ASLLayout.tsx

功能:

  • ✅ 左侧导航栏（200px宽度）
  • ✅ 7个一级菜单
    1. 研究方案生成（禁用）
    2. 智能文献检索（禁用）
    3. 文献管理（禁用）
    4. 标题摘要初筛（✅ 可用，3个子菜单）
      • 设置与启动
      • 审核工作台
      • 初筛结果
    5. 全文复筛（禁用）
    6. 全文解析与数据提取（禁用）
    7. 数据综合分析与报告（禁用）
  • ✅ 右侧内容区（Outlet渲染子页面）

布局结构:

┌────────────────────────────────────────────────┐
│  AI智能文献 - 标题摘要初筛 MVP                  │
├─────────────┬──────────────────────────────────┤
│ 左侧导航    │  右侧内容区                       │
│ (250px)     │                                   │
│             │                                   │
│ 7个模块     │  (当前子页面)                     │
│ (标题初筛   │                                   │
│  展开3个    │                                   │
│  子菜单)    │                                   │
│             │                                   │
└─────────────┴──────────────────────────────────┘

2. 重构3个子页面

页面1: 设置与启动 ⭐

文件: pages/TitleScreeningSettings.tsx

改进:

  • ✅ PICOS字段全部改为TextArea（6-8行）
  • ✅ 纳入/排除标准TextArea（8-10行）
  • ✅ 合并了文献导入功能（Excel上传 + 模板下载）
  • ✅ 筛选风格选择（3种：宽松/标准/严格）
  • ✅ 启动AI筛选按钮

表单字段:

- P - 人群: TextArea (8行) ⭐
- I - 干预: TextArea (8行) ⭐
- C - 对照: TextArea (6行) ⭐
- O - 结局: TextArea (6行，可选) ⭐
- S - 研究设计: TextArea (4行) ⭐
- 纳入标准: TextArea (10行) ⭐
- 排除标准: TextArea (10行) ⭐
- 筛选风格: Radio (宽松/标准/严格)

功能流程:

1. 填写PICOS标准 → 
2. 填写纳入/排除标准 → 
3. 选择筛选风格 → 
4. 上传Excel文件 → 
5. 点击"开始AI筛选" → 
6. 跳转到审核工作台

页面2: 审核工作台（占位）

文件: pages/ScreeningWorkbench.tsx

计划功能（Week 2 Day 3-4）:

  • 显示当前PICOS标准（折叠面板）
  • 双行表格（严格按照原型）
  • 点击PICO维度 → 弹出双视图Modal
  • 修改最终决策

页面3: 初筛结果（占位）

文件: pages/ScreeningResults.tsx

计划功能（Week 2 Day 5）:

  • 统计卡片（总数/纳入/排除）
  • PRISMA排除原因统计
  • Tab切换（纳入/排除）
  • 结果表格
  • 批量操作
  • 导出Excel

3. 更新路由结构

新路由:

/literature (进入ASL模块)
  └── ASLLayout (左侧导航布局)
      └── /screening/title (标题摘要初筛)
          ├── /settings (默认) - 设置与启动
          ├── /workbench - 审核工作台
          └── /results - 初筛结果

路由跳转:

  • 点击"AI智能文献" → 自动跳转到 /literature/screening/title/settings
  • 点击"开始AI筛选" → 跳转到 /literature/screening/title/workbench

4. 删除旧文件

已删除:

  • ❌ pages/ProjectManagement.tsx - 项目管理页（MVP不需要）
  • ❌ components/ProjectForm.tsx - 项目表单组件
  • ❌ pages/LiteratureImport.tsx - 文献导入页（功能合并）
  • ❌ hooks/useProjects.ts - 项目管理Hooks

保留文件:

  • ✅ types/index.ts - 类型定义（完整保留）
  • ✅ api/index.ts - API客户端（完整保留）
  • ✅ components/ASLLayout.tsx - 新布局组件 ⭐
  • ✅ pages/TitleScreeningSettings.tsx - 设置与启动 ⭐
  • ✅ pages/ScreeningWorkbench.tsx - 审核工作台（占位）
  • ✅ pages/ScreeningResults.tsx - 初筛结果（占位）

📊 重构对比

项目 重构前 重构后
布局 只有顶部导航 左侧导航 + 顶部导航 ⭐
第一个页面 项目管理列表 设置与启动（PICOS + 导入） ⭐
PICOS输入 Input (单行) TextArea (6-8行) ⭐
导航结构 扁平 树形（7个模块 + 子菜单） ⭐
项目概念 需要创建项目 MVP不需要项目 ⭐
文献导入 独立页面 合并到设置页

✅ 重构验收

布局验收

  • ✅ 左侧导航栏正常显示
  • ✅ 7个一级菜单正确展示
  • ✅ 标题摘要初筛展开3个子菜单
  • ✅ 其他模块显示"敬请期待"
  • ✅ 右侧内容区正常渲染

功能验收

  • ✅ 点击"AI智能文献"进入设置页
  • ✅ PICOS字段全部为TextArea（足够大）
  • ✅ 可以填写测试数据（非心源性卒中案例）
  • ✅ 可以上传Excel文件
  • ✅ 可以选择筛选风格
  • ✅ 点击"开始AI筛选"跳转到工作台

路由验收

  • ✅ /literature → 自动跳转到 /literature/screening/title/settings
  • ✅ /literature/screening/title/settings - 设置页正常
  • ✅ /literature/screening/title/workbench - 工作台占位
  • ✅ /literature/screening/title/results - 结果页占位

🎯 架构亮点

1. 完全符合原型设计 ⭐⭐⭐

  • 7个模块结构
  • 标题摘要初筛3个子页面
  • 左侧导航 + 右侧内容

2. MVP优先策略 ⭐⭐⭐

  • 只开发标题摘要初筛
  • 其他模块禁用但可见
  • 未来扩展性强

3. PICOS空间优化 ⭐⭐⭐

  • Input → TextArea
  • 足够显示复杂的测试数据
  • 用户体验友好

4. 功能合并简化 ⭐⭐

  • 文献导入合并到设置页
  • 减少页面跳转
  • 流程更顺畅

📝 代码统计

类别 文件数 代码行数 说明
新增
布局组件 1 155 ASLLayout.tsx
设置页面 1 350 TitleScreeningSettings.tsx
工作台页面 1 42 ScreeningWorkbench.tsx（占位）
结果页面 1 45 ScreeningResults.tsx（占位）
路由配置 1 58 routes.tsx（重写）
删除 4 -800 旧的项目管理相关文件
净增 5 -150 代码更精简了！

🚀 下一步开发

Week 2 继续计划

Day 2（今天剩余时间）:

  • ✅ Excel解析逻辑（内存解析，不落盘）
  • ✅ 文献预览表格
  • ✅ 去重逻辑
  • ✅ Excel模板生成

Day 3-4:

  • 审核工作台（双行表格）
  • 双视图Modal
  • 人工复核功能

Day 5:

  • 初筛结果展示
  • 批量操作
  • Excel导出

🎉 重构总结

耗时: 30分钟
文件变更: 新增5个，删除4个
代码量: 净减少150行（更精简）

重构效果:

  • ⭐⭐⭐⭐⭐ 完全符合用户需求
  • ⭐⭐⭐⭐⭐ 参考原型设计
  • ⭐⭐⭐⭐⭐ MVP优先策略
  • ⭐⭐⭐⭐⭐ PICOS空间足够
  • ⭐⭐⭐⭐ 代码结构清晰

用户反馈确认:

  1. ✅ 左侧导航 - 符合原型
  2. ✅ 第一个页面是"设置与启动"
  3. ✅ PICOS字段都用TextArea
  4. ✅ MVP不需要项目概念
  5. ✅ 双行表格按照原型设计

重构完成时间: 2025-11-18 22:00
下一阶段: Week 2 Day 2 继续开发

Reference in New Issue View Git Blame Copy Permalink