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
4.5 KiB
4.5 KiB
PRD：智能数据清洗工作台 (The Data Cleaning Portal)
| 文档版本 | V1.0 (基于原型 V2) |
|---|---|
| 产品形态 | Web 端综合仪表盘 (Dashboard) |
| 核心价值 | 作为数据清洗模块的统一入口，提供工具启动、异步任务监控、数据资产管理及跨工具流转能力。 |
| 目标用户 | 临床医生、科研助理 |
一、 产品架构图 (Product Architecture)
工作台处于系统的二级导航位置，向下连接三个具体工具，横向连接任务与数据。
全局导航 -> 工作台 (本PRD) -> (工具 A, 工具 B, 工具 C)
二、 核心功能需求 (Functional Requirements)
1. 全局导航集成 (Global Navigation)
- P0: 必须无缝嵌入现有系统顶部导航栏。
- 位置： 位于 知识库 与 智能数据分析 之间。
- 状态： 点击后高亮显示“智能数据清洗”。
2. 工具启动区 (The Launcher)
- P0: 三卡片入口： 醒目展示三个核心工具的入口卡片。
- 工具 A (超级合并器): 强调“多源数据合并、ID对齐”。
- 工具 B (病历结构化机器人): 强调“AI 提取、非结构化转结构化”。
- 工具 C (科研数据编辑器): 强调“在线清洗、缺失值处理”。
- 交互： 点击卡片，以全屏模态框或新页面形式打开对应工具。
3. 任务流转中心 (Task Flow Hub) —— 核心交互
- P0: 最近任务列表： 展示用户最近发起的 10 条任务。
- 字段定义： 任务名称 | 所属工具(A/B/C) | 状态(处理中/完成/失败) | 进度条 | 操作。
- P0: 状态实时更新：
- 处理中： 显示动态进度条（如 45%）。
- 失败： 显示红色警告，支持查看错误日志。
- P0: 智能流转操作 (Smart Action)：
- 基于任务类型，动态推荐下一步操作：
- 工具 A 完成后： 显示按钮 [下载] 和 [去 AI 提取] (跳转工具 B)。
- 工具 B 完成后： 显示按钮 [下载] 和 [去清洗] (跳转工具 C)。
- 工具 C 完成后： 显示按钮 [下载]。
4. 数据资产库 (Data Asset Library) —— V2 核心升级
- P0: Tab 分栏视图：
- [全部]
- [处理结果] (Outputs): 存放工具 A/B/C 生成的最终文件。图标使用绿色/蓝色区分。
- [原始上传] (Inputs): 存放用户直接上传的底表。图标使用灰色区分。
- P0: 资产卡片信息：
- 文件名、标签（如“已清洗”、“已脱敏”）、行数、修改时间。
- P0: 快捷操作 (Hover Actions):
- 鼠标悬停在卡片上时，显示操作按钮：
- [下载]: 下载到本地。
- [去处理]: 如果是原始文件，点击跳转到工具选择页（或默认工具 A）。
- [分析]: 如果是处理结果，点击跳转到“智能数据分析”模块（未来规划）。
- P0: 原始文件上传入口：
- 底部固定按钮 [+ 上传原始文件到库]，允许用户将本地 Excel 存入云端备用。
三、 界面原型参考 (UI Reference)
请严格参考 智能数据清洗工作台_原型演示_V2.html。
- 布局： 顶部为 Launcher，下方分为左右两栏（左 2/3 为任务，右 1/3 为资产）。
- 视觉风格：
- 工具 A：蓝色系 (Blue)
- 工具 B：紫色系 (Purple)
- 工具 C：翠绿色系 (Emerald)
- 状态色：处理中(蓝)、成功(绿)、失败(红)、警告(橙)。
四、 数据交互逻辑 (Data Logic)
- 任务轮询 (Polling):
- 工作台加载时，调用 GET /api/tasks/recent。
- 若列表中有状态为 processing 的任务，每隔 5 秒轮询一次状态更新，直到完成。
- 跨工具流转 (Handoff):
- 当用户点击 [去 AI 提取] 时：
- 前端获取该任务的 resultFileId。
- 跳转路由至 /tools/b?sourceFileId={resultFileId}。
- 工具 B 初始化时，自动加载该文件，无需用户重新上传。
- 资产管理:
- 工具 A/B/C 产生的最终结果，需自动注册到 DataAsset 表中，并标记 type='output'。
- 用户手动上传的文件，注册为 type='input'。
五、 埋点与统计需求
- UV/PV: 工作台访问量。
- CTR: 三个工具卡片的点击率（判断哪个工具最常用）。
- 流转率: 用户点击“去 AI 提取”等流转按钮的比例（判断工作流是否顺畅）。