Files

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

5.4 KiB

Raw Blame History

壹证循科技 - AI智能问答 (AIA) V2.1 产品需求文档

文档状态： Draft (V2.1)

关联原型： AI问答原型图V11.html

架构标准： Postgres-Only | Ant Design X | Schema Isolation

最后更新： 2026-01-11

本次更新： 新增移动端适配、深度思考模式、UI/UX 细节规范

1. 概述与目标

1.1 背景

原 AIA 模块功能较为单一。V2.0+ 版本旨在构建一个全流程驱动的科研智能体大厅 (Agent Hub)，对标 ChatGPT/Gemini 的流畅体验，并深度结合医学科研场景。

1.2 核心价值

流程化引导：打破“只有一个对话框”的迷茫感，通过 5 个阶段引导用户逐步推进研究。
专业分工：不同的智能体加载不同的 System Prompt 和知识库。
全端体验：提供桌面端到移动端的无缝衔接，随时随地记录科研灵感。

2. 核心业务流程 (User Flow)

进入大厅 (Dashboard)：
- 顶部提供“全局意图搜索框”，用户输入模糊需求。
- 系统识别意图，自动跳转到对应的智能体。
选择智能体：
- 用户也可以直接点击具体的卡片（如“06 样本量计算”）。
沉浸式工作台 (Workspace)：
- 进入具体的对话界面。
- 桌面端：三栏布局（历史记录 + 对话区 + 如果有右侧引用栏）。
- 移动端：单栏布局，历史记录折叠为抽屉。
结果产出：
- AI 展示思考过程 (Thinking Process) 后输出最终答案。
- 用户可一键导出 Word 报告。

3. 功能需求详情

F1. 智能体大厅 (Dashboard) - 基于 V11 原型

F1.1 全局意图路由 (Intent Router)

UI：顶部大搜索框，文案“输入研究想法...”。
逻辑：后端调用 Router Agent 识别意图 -> 跳转目标 Agent -> 自动填入 Prompt。

F1.2 智能体流水线展示 (Agent Pipeline)

严格还原 V11 原型的 5 阶段布局 和 3 色视觉体系（详见原型图）。

跳转逻辑：
- 常规卡片：进入 Chat Workspace。
- 工具卡片 (09, 10)：跳转 /dc/portal 或 /st/dashboard。

F2. 沉浸式对话工作台 (Chat Workspace)

F2.1 界面布局与风格 (UI/UX)

设计理念：参考 Gemini 的“大留白”风格，减少分割线，使用卡片投影区分层级。
左侧侧边栏 (Sidebar)：
- 桌面端：固定显示，可折叠（图标化）。
- 移动端：默认隐藏，通过左上角“汉堡菜单”滑出（Drawer 组件）。
- 内容：按时间分组的历史会话（今天、昨天、7天前）。
主对话区 (Main Area)：
- Header：显示当前智能体名称 + 状态（"思考中..." / "输入中..."）。
- Input：底部悬浮，支持多行自动增高。

F2.2 核心对话能力增强

深度思考模式 (Thinking Process)：
- 需求：针对“科学问题梳理”等复杂任务，AI 需先输出推理过程。
- 交互：输出 <think>...</think> 内容时，前端显示为可折叠的灰色引用块，默认展开，生成结束后自动收起，只显示“已深度思考 (耗时 12s)”。
Markdown 渲染增强：
- 公式：使用 Katex 渲染 LaTeX 医学公式。
- 表格：支持横向滚动，防止手机端撑破布局。
- 代码：支持一键复制，语法高亮。
快捷指令 (Slash Commands)：
- 输入 / 弹出快捷菜单：/润色, /扩写, /翻译, /导出Word。

F2.3 附件上传 (Attachment)

格式：PDF, Word, TXT, Excel (限制 20MB)。
处理 (Postgres-Only)：
1. 上传 OSS -> common_schema.files。
2. 后端提取文本 -> 截取注入 LLM Context。
3. UI 显示：在气泡下方显示附件小卡片（图标+文件名）。

F2.4 结果操作栏 (Action Bar)

每条 AI 回答下方提供微型工具栏（Hover 显示）：

复制：复制 Markdown 源码。
重新生成：不满意当前回答，触发重试。
导出 Word：调用 RVW 模块的 docx 导出服务，将当前单轮对话导出为文档。

F3. 移动端适配 (Mobile Adaptation)

F3.1 响应式布局

断点：md (768px)。
Dashboard：
- 隐藏顶部复杂导航，只保留 Logo 和用户头像。
- 智能体卡片由 3 列变为 1 列流式布局。
- 左侧时间轴（Timeline）在移动端需调整样式，避免占用过多水平空间（可改为顶部横向步骤条或简化左侧线条）。

F3.2 交互优化

输入体验：
- 输入框聚焦时，确保不被 iOS/Android 软键盘遮挡（scrollIntoView）。
- 发送按钮在移动端需始终可见。
触控反馈：按钮和卡片增加 active 态背景色变化。

4. 数据架构 (Postgres-Only)

(保持不变，复用 V2.0 定义)

// schema.prisma (新增字段)

model AiaMessage {
// ... 现有字段
thinkingContent String? @db.Text // 存储思维链内容 (<think>...</think>)
// ...
}

5. 配置化开发策略

(保持不变)

6. 非功能性需求

流式体验：TTFB (首字响应时间) < 1.5s。
移动端性能：首屏加载 < 1s (LCP)。
防抖：意图搜索框需增加 500ms 防抖，避免频繁请求 Router Agent。

5.4 KiB Raw Blame History Unescape Escape