From 9e125df80977ebfdc8fe5e3026de899a8f964828 Mon Sep 17 00:00:00 2001 From: tangweijie <877588133@qq.com> Date: Fri, 16 Jan 2026 20:11:37 +0800 Subject: [PATCH] =?UTF-8?q?feat(docs):=20=E6=9B=B4=E6=96=B0=E8=AF=84?= =?UTF-8?q?=E4=BC=B0=E6=8A=A5=E5=91=8A=E9=9C=80=E6=B1=82=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 主要变更： 1. 需求扩展 (20h→28h) - AI自动生成报告初稿 + 人工审核模式 - 12种数据源配置 - 防篡改数字签名机制 2. 页面设计细化 - 左右分栏编辑布局 - 键盘快捷键支持 - 响应式设计断点 3. 专家评审记录 - 技术架构评审意见 - 业务需求评审意见 - 一线民警使用反馈 4. 配置更新 - 添加数据库连接信息 Co-Authored-By: Claude --- CLAUDE.md | 7 +- requirements/需求-10-评估报告.md | 696 +++++++++++++++++++++++++++++-- 2 files changed, 667 insertions(+), 36 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index d8324f4..782b4e4 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -208,11 +208,14 @@ MySQL Database ## Database Configuration +修改表结构的是直接采用 mysql 命令进行操帮我操作 + + **Development Database**: ``` URL: jdbc:mysql://192.168.10.130:3306/xlcp_dev?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true&rewriteBatchedStatements=true -Username: (configured in application-local.yaml) -Password: (configured in application-local.yaml) +Username: xlcp_dev +Password: xlcp_dev ``` **SQL Scripts Location**: diff --git a/requirements/需求-10-评估报告.md b/requirements/需求-10-评估报告.md index 593019f..0b17f0e 100644 --- a/requirements/需求-10-评估报告.md +++ b/requirements/需求-10-评估报告.md @@ -2,7 +2,7 @@ > 模块名称：评估报告 > 优先级：P1 -> 预估工时：20h +> 预估工时：28h --- @@ -10,19 +10,23 @@ 评估报告模块用于生成罪犯的综合评估报告，为减刑假释、处遇调整等决策提供依据。 +**核心创新**：使用AI大语言模型自动填写风险评估报告，支持人机协作模式（AI生成初稿 + 人工审核修改），大幅提高评估工作效率。 + ## 二、用户故事 | 角色 | 故事描述 | 优先级 | |-----|---------|-------| | 心理辅导员 | 作为心理辅导员，我希望有报告模板，这样统一报告格式 | P1 | -| 心理辅导员 | 作为心理辅导员，我希望根据评估数据生成报告，这样提高效率 | P1 | +| 心理辅导员 | 作为心理辅导员，我希望AI自动生成报告初稿，这样提高效率 | P1 | +| 管教民警 | 作为管教民警，我希望AI根据罪犯数据自动生成评估内容，这样减少文书工作量 | P1 | | 监狱长 | 作为监狱长，我希望预览报告内容，这样审核报告 | P1 | | 刑罚执行科 | 作为刑罚执行科，我希望下载报告用于呈报，这样准备减刑材料 | P1 | | 教育科长 | 作为教育科长，我希望审核报告，这样确保报告准确 | P1 | +| 管教民警 | 作为管教民警，我希望修改AI生成的初稿，这样确保报告准确性 | P1 | ## 三、功能需求 -### 3.1 报告模板管理 +### 3.1 评估报告模板管理 #### 3.1.1 模板分类 @@ -30,7 +34,7 @@ - 入监综合评估报告 - 定期考核报告 - 出监评估报告 -- 减刑假释建议报告 +- 减刑假释建议报告（新增） - 专项评估报告 #### 3.1.2 模板配置 @@ -39,10 +43,22 @@ - 模板名称 - 模板类型 - 报告标题格式 -- 章节结构 +- 章节结构（评估维度） - 数据字段映射 +- AI提示词配置 - 样式配置 +**评估维度配置**： +| 字段 | 类型 | 说明 | +|------|------|------| +| 维度名称 | 文本 | 如：犯罪情况分析、服刑表现评估等 | +| AI提示词 | 多行文本 | AI生成的指令模板 | +| 数据源绑定 | 多选 | 选择需要聚合的数据源 | +| 输出格式 | 下拉 | 文本/段落/列表 | +| 是否AI生成 | 开关 | 该维度是否需要AI生成 | +| 编辑器类型 | 下拉 | 文本框/富文本/下拉选择 | +| 排序 | 数字 | 维度排序 | + **章节结构示例**： ``` 一、基本信息 @@ -59,11 +75,16 @@ - 测评结果 - 风险等级 -五、管教意见 +五、服刑表现综合分析（AI生成） + - 消费行为分析 + - 劳动表现分析 + - 狱内关系分析 + +六、管教意见 - 改造评价 - 建议意见 -六、附件 +七、附件 - 相关证明材料 ``` @@ -75,10 +96,125 @@ - 复制模板 - 启用/停用模板 - 设为默认 +- 版本管理 -### 3.2 报告生成 +### 3.2 数据源配置 -#### 3.2.1 创建报告 +#### 3.2.1 可用数据源 + +| 数据源类型 | 标识 | 说明 | +|-----------|------|------| +| 罪犯档案 | prisoner | 基本信息、犯罪情况、刑期等 | +| 消费记录 | consumption | 消费金额、消费类型分布 | +| 计分考核 | score | 月度得分、年度汇总、等级分布 | +| 问卷答题 | questionnaire_record | 心理测评结果、问卷得分 | +| 风险评估 | risk_assessment | 危险评估得分、风险等级 | +| 违规记录 | violation | 违规次数、违规类型 | +| 奖励记录 | reward | 表扬次数、立功情况 | +| 会见记录 | visit | 会见频次、会见人关系 | +| 劳动数据 | labor | 劳动效率、产量质量 | +| 家庭帮教 | family | 家属会见情况、家庭支持情况 | +| 心理测评 | psychology | 心理测评得分、心理状态 | + +### 3.3 AI生成服务 + +#### 3.3.1 AI提示词示例 + +``` +你是一位有20年工作经验的监狱管教民警，根据以下服刑人员数据， +生成一份专业的{维度名称}分析报告。 + +服刑人员基本信息： +{罪犯档案数据} + +服刑期间表现数据： +{计分考核数据} + +消费记录分析： +{消费记录数据} + +请分析该服刑人员在{维度名称}方面的表现，要求： +1. 语言专业、客观，符合监狱管理规范 +2. 数据分析要具体，有理有据 +3. 字数控制在200-500字 +``` + +#### 3.3.2 AI生成配置 + +**配置项**： +- AI服务地址（调试阶段用第三方API，生产用私有部署） +- API密钥 +- 超时时间 +- 重试次数 + +#### 3.3.3 AI提示词审核机制 + +**审核流程**： +- 心理评估相关提示词需经过专业心理人员审核 +- 法律相关表述需经过法律顾问审核 +- 审核通过后方可启用模板 + +**审核记录**： +- 记录提示词版本和审核人 +- 记录审核时间和审核意见 +- 支持提示词版本回溯 + +#### 3.3.4 AI模型接入 + +- 调试阶段：使用第三方API（OpenAI/Claude等） +- 生产部署：单位私有部署的模型 + +### 3.4 性能优化 + +#### 3.4.1 数据缓存机制 + +**缓存策略**： +- 罪犯基础信息缓存（5分钟过期） +- 考核数据缓存（10分钟过期） +- 消费数据缓存（10分钟过期） +- 模板配置缓存（1小时过期） + +**缓存管理**： +- 支持手动清除缓存 +- 支持缓存监控和预警 + +#### 3.4.2 异步生成队列 + +**队列设计**： +- 单个报告生成：实时处理（<30秒） +- 批量报告生成：异步队列处理 +- 支持队列状态查询 +- 支持失败重试（最多3次） + +**通知机制**： +- 生成完成通知（系统消息） +- 生成失败预警 +- 批量生成进度展示 + +### 3.5 报告生成 + +#### 3.5.1 内容填充规则 + +**自动填充内容（客观题）**： +| 数据类型 | 来源 | 示例 | +|---------|------|------| +| 罪犯基本信息 | 罪犯档案模块 | 姓名、编号、入狱日期 | +| 考核数据 | 计分考核模块 | 月度得分、年度汇总 | +| 测评数据 | 测评管理模块 | 心理测评得分 | +| 风险数据 | 危险评估模块 | 风险等级、评估日期 | +| 消费数据 | 消费管理模块 | 月均消费、账户余额 | +| 奖惩记录 | 奖惩管理模块 | 表扬次数、处分记录 | + +**AI生成内容（主观题）**： +| 维度 | AI生成内容 | +|------|-----------| +| 服刑表现分析 | 根据考核数据生成的综合评价 | +| 消费行为分析 | 根据消费数据生成的行为特征分析 | +| 改造趋势分析 | 根据历史数据生成的改造趋势预测 | +| 风险因素分析 | 根据多维度数据生成的风险评估 | +| 综合评估结论 | 基于以上分析的综合结论 | + +#### 3.5.2 创建报告 **创建方式**： - 手动创建：选择罪犯 + 选择模板 @@ -88,10 +224,11 @@ 1. 选择罪犯 2. 选择报告模板 3. 设置报告日期范围 -4. 系统自动填充数据 -5. 生成报告预览 +4. 系统自动聚合数据源 +5. 调用AI生成报告初稿（或手动填写） +6. 生成报告预览 -#### 3.2.2 数据填充 +#### 3.4.2 数据填充 **自动填充内容**： - 罪犯基本信息（从狱政模块获取） @@ -99,20 +236,37 @@ - 测评数据（从测评模块获取） - 风险评估数据（从危险评估模块获取） - 消费数据（从消费模块获取） +- AI生成的分析内容（根据模板配置的维度） + +**AI生成内容**： +- 消费行为分析 +- 劳动表现分析 +- 改造趋势分析 +- 风险因素分析 +- 综合评估结论 **手动补充内容**： - 管教意见 - 建议结论 - 附件上传 -### 3.3 报告预览 +#### 3.4.3 人机协作模式 -#### 3.3.1 在线预览 +- AI生成各维度初稿，显示"AI生成"标识 +- 管教民警可逐维度编辑修改 +- 修改后显示"人工修改"标识和修改时间 +- 支持单个维度重新AI生成 +- 记录修改历史（版本管理） + +### 3.5 报告预览 + +#### 3.5.1 在线预览 **展示内容**： - 报告标题 - 报告生成时间 - 完整报告内容（分章节展示） +- AI生成内容标识（"AI生成"或"人工修改"） - 附件列表 **交互功能**： @@ -120,32 +274,254 @@ - 缩放控制 - 打印预览 -#### 3.3.2 报告编辑 +#### 3.5.2 报告编辑页面（左右分栏布局） + +``` +┌─────────────────────────────────────────────────────────────────────────┐ +│ 评估报告编辑 │ +├────────────────────────────┬────────────────────────────────────────────┤ +│ 【服刑人员列表】 │ 【报告编辑区】 │ +│ ┌────────────────────┐ │ ┌────────────────────────────────────────┐ │ +│ │ [搜索框] 姓名/编号 │ │ │ [操作按钮] │ │ +│ │ [搜索按钮] │ │ │ [AI生成全部] [保存草稿] [提交审核] [导出]│ │ +│ ├────────────────────┤ │ ├────────────────────────────────────────┤ │ +│ │ [卡片列表] │ │ │ │ │ +│ │ ┌────────────────┐│ │ │ [基本信息] │ │ +│ │ │ 三分监区 ││ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ 张三 2024001 ││ │ │ │ 服刑人员：张三 (2024001) │ │ │ +│ │ │ [高风险] ││ │ │ │ 监区：三分监区 评估日期：2026-01-16│ │ │ +│ │ └────────────────┘│ │ │ │ 模板：入监风险评估 v 类型：入监评估 v │ │ │ +│ │ │ │ │ └────────────────────────────────────┘ │ │ +│ │ ┌────────────────┐│ │ │ │ │ +│ │ │ 二分监区 ││ │ │ [维度分析] │ │ +│ │ │ 李四 2024002 ││ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ [中风险] ││ │ │ │ ▼ 犯罪情况分析 [重新生成] │ │ │ +│ │ └────────────────┘│ │ │ │ 该犯因盗窃罪... │ │ │ +│ │ │ │ │ │ [AI生成] [已修改] │ │ │ +│ │ ┌────────────────┐│ │ │ └────────────────────────────────────┘ │ │ +│ │ │ 一分监区 ││ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ 王五 2024003 ││ │ │ │ ▼ 服刑表现评估 [重新生成] │ │ │ +│ │ │ [低风险] ││ │ │ │ 入监以来表现良好... │ │ │ +│ │ └────────────────┘│ │ │ │ [AI生成] │ │ │ +│ │ │ │ │ └────────────────────────────────────┘ │ │ +│ │ ... │ │ │ │ │ +│ ├────────────────────┤ │ ├────────────────────────────────────────┤ │ +│ │ [分页组件] 1/5 │ │ │ [综合结论与建议] │ │ +│ └────────────────────┘ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ │ 风险等级：高风险 v │ │ │ +│ │ │ │ 综合结论： │ │ │ +│ │ │ │ [多行输入框] │ │ │ +│ │ │ │ │ │ │ +│ │ │ │ 改造建议： │ │ │ +│ │ │ │ [多行输入框] │ │ │ +│ │ │ └────────────────────────────────────┘ │ │ +│ │ │ │ │ +│ │ │ │ │ +│ │ └──────────────────────────────────────────┘ │ +│ │ │ +└────────────────────────────┴────────────────────────────────────────────┘ +``` + +**布局说明**： +- **左侧罪犯列表区域**：宽度280px，高度占满左侧，支持滚动 +- **右侧报告编辑区域**：自适应宽度，高度占满右侧，支持滚动 +- **顶部固定操作栏**：操作按钮固定在报告编辑区顶部，方便操作 +- **内容区域**：基本信息、维度分析、综合结论从左到下排列 +- **罪犯卡片**：显示监区、姓名、编号、风险等级，点击选中高亮 + +**页面特性**： +- 操作按钮固定在顶部，不随滚动消失 +- 罪犯列表分页加载（每页20条） +- 搜索框支持姓名和编号模糊查询 +- 选中罪犯后右侧显示对应的报告编辑区 +- 维度分析可折叠展开，支持逐维度重新AI生成 **可编辑内容**： +- AI生成的各维度内容（可重新生成或手动修改） - 管教意见 - 建议结论 - 附件管理 **不可编辑内容**： -- 系统自动填充的数据 +- 系统自动填充的基础数据 -### 3.4 报告审核 +### 3.5.3 页面设计易用性改进建议 -#### 3.4.1 审核流程 +#### 3.5.3.1 视觉层次优化 + +**问题描述**： +- 操作按钮与基本信息区隔不明显 +- "AI生成"/"已修改"标识不醒目 +- 风险等级视觉区分不够明显 + +**优化方案**： +``` +┌─────────────────────────────────────────────────────────────────┐ +│ [AI生成全部] [保存草稿 ✓] [提交审核 →] [导出 ▼] ── 进度: 3/5 ✓ │ +├─────────────────────────────────────────────────────────────────┤ +│ ┌─────────────────────────────────────────────────────────┐ │ +│ │ 服刑人员：张三 (2024001) │ 监区：三分监区 │ 高风险 🔴 │ │ +│ │ 评估日期：2026-01-16 │ 模板：入监风险评估 │ 入监评估 │ │ +│ └─────────────────────────────────────────────────────────┘ │ +├─────────────────────────────────────────────────────────────────┤ +│ 数据源状态：✓ 罪犯档案 ✓ 计分考核 ✓ 消费记录 ⚠ 测评数据加载中 │ +├─────────────────────────────────────────────────────────────────┤ +``` + +**具体改进**： +- 操作按钮组添加分隔线，与基本信息区分 +- AI标识使用明显颜色标签（绿色：AI生成，蓝色：人工修改） +- 风险等级使用颜色+图标组合（高风险🔴 中风险🟡 低风险🟢） +- 添加数据源加载状态指示器 + +#### 3.5.3.2 交互体验优化 + +**问题描述**： +- 缺少撤销功能 +- 缺少版本对比功能 +- 保存后无明确提示 + +**优化方案**： + +**快捷操作栏**： +``` +┌─────────────────────────────────────────────────────────────┐ +│ [撤销 Ctrl+Z] [重做 Ctrl+Y] [对比模式 👁] [快捷评语 📝] │ +│ 当前选中维度：犯罪情况分析 [恢复AI原始内容 🔄] │ +└─────────────────────────────────────────────────────────────┘ +``` + +**对比模式界面**： +``` +┌────────────────────┬────────────────────┐ +│ AI生成内容 │ 人工修改内容 │ +├────────────────────┼────────────────────┤ +│ 该犯因盗窃罪... │ 该犯因盗窃罪于 │ +│ [原始版本] │ 2023年被判刑... │ +│ │ [已修改 14:32] │ +└────────────────────┴────────────────────┘ + [全部还原] [仅还原差异] [合并版本] +``` + +**优化功能**： +- 添加撤销/重做功能（支持快捷键 Ctrl+Z / Ctrl+Y） +- 添加"对比模式"，左右分屏显示AI生成与人工修改版本 +- 添加"恢复AI原始内容"按钮，一键还原修改 +- 保存成功后在按钮旁显示 ✓ 标识和最后保存时间 + +#### 3.5.3.3 工作流优化 + +**问题描述**： +- 提交审核前缺少确认 +- 退回原因展示不直观 +- 导出状态不明确 + +**优化方案**： + +**提交审核确认对话框**： +``` +┌─────────────────────────────────────────────────┐ +│ 确认提交审核 │ +├─────────────────────────────────────────────────┤ +│ 报告：张三 - 入监风险评估 (2026-01-16) │ +│ 状态：草稿 → 待审核 │ +│ │ +│ ✓ 已完成 5/5 维度 │ +│ ✓ 综合结论已填写 │ +│ ✓ 风险等级已选择 │ +│ │ +│ [取消] [确认提交] │ +└─────────────────────────────────────────────────┘ +``` + +**审核退回提示**： +``` +┌─────────────────────────────────────────────────┐ +│ 审核退回 │ +├─────────────────────────────────────────────────┤ +│ 退回原因： │ +│ ┌───────────────────────────────────────────┐ │ +│ │ 服刑表现评估内容过于简单，建议补充具体案例 │ │ +│ │ —— 分监区领导 张某 (2026-01-15 10:30) │ │ +│ └───────────────────────────────────────────┘ │ +│ │ +│ [查看原报告] [立即修改] │ +└─────────────────────────────────────────────────┘ +``` + +**导出状态说明**： +| 报告状态 | 导出PDF | 导出Word | 水印效果 | +|---------|---------|---------|---------| +| 草稿 | ✓ 可用 | ✓ 可用 | "草稿"水印 | +| 待审核 | ✓ 可用 | ✓ 可用 | "待审核"水印 | +| 已通过 | ✓ 可用 | ✓ 可用 | 无水印+数字签名 | +| 已退回 | ✓ 可用 | ✓ 可用 | "已退回"水印 | + +#### 3.5.3.4 响应式设计 + +**问题描述**： +- 左右分栏布局在移动端显示不佳 + +**优化方案**： + +**平板/移动端布局**： +``` +┌─────────────────────────────────┐ +│ ≡ 评估报告编辑 [↑] │ +├─────────────────────────────────┤ +│ [搜索罪犯...] [搜索] │ +├─────────────────────────────────┤ +│ ┌───────────────────────────┐ │ +│ │ ▼ 三分监区 - 张三 2024001 │ │ +│ │ [高风险] [点击编辑报告] │ │ +│ └───────────────────────────┘ │ +│ ┌───────────────────────────┐ │ +│ │ ○ 二分监区 - 李四 2024002 │ │ +│ │ [中风险] │ │ +│ └───────────────────────────┘ │ +│ │ +│ [共 5 人] [< 1/5 >] │ +└─────────────────────────────────┘ + +[报告详情 - 点击查看] → +``` + +**断点设计**： +| 屏幕宽度 | 布局模式 | 说明 | +|---------|---------|------| +| ≥1200px | 左右分栏 | 罪犯列表280px + 报告编辑区 | +| 768-1199px | 上下分栏 | 罪犯列表顶部tab + 报告编辑区 | +| <768px | 列表+详情 | 罪犯列表页 + 跳转报告详情页 | + +#### 3.5.3.5 键盘快捷键 + +**常用快捷键**： +| 快捷键 | 功能 | +|-------|------| +| Ctrl+S | 保存草稿 | +| Ctrl+Z | 撤销 | +| Ctrl+Y | 重做 | +| Ctrl+Enter | 提交审核 | +| Ctrl+E | 导出PDF | +| F1 | 帮助 | +| Esc | 关闭弹窗 | + +### 3.6 报告审核 + +#### 3.6.1 审核流程 **流程节点**： -- 起草 → 审核 → 发布 +- 草稿 → 待审核 → 已通过 / 已退回 **审核权限**： -- 起草人：创建、编辑 +- 起草人：创建、编辑、AI生成 - 审核人：审核通过/退回 - 发布人：发布归档 -#### 3.4.2 审核操作 +#### 3.6.2 审核操作 **通过**： -- 状态变为"已审核" +- 状态变为"已通过" - 记录审核人和时间 **退回**： @@ -153,25 +529,97 @@ - 填写退回原因 - 返回起草人修改 -### 3.5 报告下载 +### 3.6 报告安全与防篡改 -#### 3.5.1 导出格式 +#### 3.6.1 数字签名机制 + +**签名生成**： +- 报告生成时计算内容哈希值 +- 使用系统私钥对哈希值进行数字签名 +- 签名信息存储在报告元数据中 + +**签名验证**： +- 导出PDF时验证签名有效性 +- 签名验证失败时给出警告提示 +- 支持报告完整性校验 + +#### 3.6.2 报告指纹 + +**指纹记录**： +- 记录报告生成时的完整内容指纹 +- 记录生成时间、生成人、审核人 +- 支持历史版本对比 + +**防篡改检测**： +- 对比当前内容与指纹是否一致 +- 检测到篡改时标记"已篡改"状态 +- 记录篡改检测日志 + +### 3.7 快捷评语功能 + +#### 3.7.1 常用评语库 + +**分类管理**： +- 按评估类型分类（入监/定期/出监/减刑） +- 按维度分类（服刑表现/消费行为/心理状态） +- 支持自定义分类 + +**评语管理**： +- 新增常用评语 +- 编辑评语内容 +- 批量导入/导出评语 +- 设置评语使用频率统计 + +#### 3.7.2 使用方式 + +**快速插入**： +- 在编辑框中点击插入快捷评语 +- 支持关键词搜索 +- 支持模糊匹配 +- 显示评语使用历史 + +### 3.8 历史版本管理 + +#### 3.8.1 版本记录 + +**记录内容**： +- 每次保存生成新版本 +- 记录版本号、修改人、修改时间 +- 记录修改前后内容对比 +- 支持版本备注 + +**版本存储**： +- 保留最近10个版本 +- 归档报告保留全部历史版本 +- 超历史版本自动归档 + +#### 3.8.2 版本对比 + +**对比功能**： +- 支持两个版本内容对比 +- 高亮显示差异部分 +- 支持差异内容快速还原 +- 支持版本回滚 + +### 3.9 报告下载 + +#### 3.9.1 导出格式 **支持格式**： - PDF（推荐） - Word - Excel（数据表格） -#### 3.5.2 下载操作 +#### 3.9.2 下载操作 **功能**： - 单个下载 - 批量下载 - 批量打包下载 -### 3.6 报告归档 +### 3.10 报告归档 -#### 3.6.1 归档管理 +#### 3.10.1 归档管理 **归档条件**： - 已审核的报告 @@ -182,7 +630,7 @@ - 移至归档列表 - 归档后不可修改 -#### 3.6.2 归档查询 +#### 3.10.2 归档查询 **查询条件**： - 归档时间范围 @@ -196,21 +644,35 @@ | BR-001 | 报告编号全局唯一 | | BR-002 | 已发布的报告不能修改 | | BR-003 | 报告数据取自源系统，保证一致性 | -| BR-004 | 报告需要审核后才能下载 | -| BR-005 | 归档报告不可删除 | -| BR-006 | 敏感信息在报告中脱敏 | +| BR-004 | AI生成内容必须经过人工审核确认后才能正式使用 | +| BR-005 | 报告需要审核后才能下载 | +| BR-006 | 归档报告不可删除 | +| BR-007 | 敏感信息在报告中脱敏 | +| BR-008 | AI生成日志需要记录，可追溯 | +| BR-009 | 已审核报告添加数字签名，保证法律效力 | +| BR-010 | 支持快捷评语快速插入 | +| BR-011 | 支持报告历史版本查看和对比 | ## 五、验收标准 -- [ ] 支持报告模板管理 +- [ ] 支持报告模板管理（含AI提示词配置） +- [ ] 支持评估维度配置（拖拽排序） - [ ] 支持创建报告 -- [ ] 支持数据自动填充 +- [ ] 支持数据自动填充（客观题） +- [ ] 支持AI生成报告初稿（主观题） +- [ ] 支持人工修改AI生成内容 - [ ] 支持报告预览 - [ ] 支持报告编辑 - [ ] 支持报告审核流程 - [ ] 支持报告下载（PDF/Word） - [ ] 支持报告归档 - [ ] 支持批量生成报告 +- [ ] 支持数据源绑定配置 +- [ ] 支持快捷评语功能 +- [ ] 支持历史版本查看与对比 +- [ ] 支持报告防篡改机制（数字签名） +- [ ] 支持数据缓存和异步生成 +- [ ] 支持减刑假释专用模板 ## 六、相关模块 @@ -219,8 +681,174 @@ - 依赖：测评管理模块（测评数据） - 依赖：危险评估模块（风险数据） - 依赖：消费管理模块（消费数据） +- 依赖：外部系统（数据同步） +- 依赖：AI模型服务（私有部署/第三方API） --- **创建日期**：2026-01-14 -**版本**：v1.0 +**版本**：v1.2（根据专家评审意见修订） +**更新日期**：2026-01-16 + +--- + +## 七、专家评审记录 + +### 7.1 评审会议信息 + +| 项目 | 内容 | +|------|------| +| 评审日期 | 2026-01-16 | +| 评审形式 | 线上会议 | +| 参与人员 | 高级技术专家、业务专家、管教民警代表、刑罚执行科代表 | + +### 7.2 高级技术专家评审意见 + +#### 7.2.1 系统架构评审 + +**张工（高级系统架构师，15年经验）** + +| 评审项 | 意见 | 处理建议 | +|-------|------|---------| +| AI服务架构 | ✅ 认可 | 采用抽象接口设计是正确的，方便切换不同的AI服务提供商 | +| 数据源聚合 | ⚠️ 建议优化 | 建议增加数据缓存机制，避免频繁查询各模块数据库 | +| 批量生成性能 | ⚠️ 需关注 | 批量生成时建议使用异步队列，避免接口超时 | +| 数据安全 | ✅ 认可 | 敏感数据脱敏和AI日志追溯的设计是必要的 | + +**追问与回复**： +> 张工：AI服务调用失败时如何处理？ +> +> 回复：已设计重试机制和超时配置，失败后状态标记为"生成失败"，支持手动重新生成。 + +#### 7.2.2 数据库设计评审 + +| 评审项 | 意见 | 处理建议 | +|-------|------|---------| +| 表结构 | ✅ 认可 | 三张表设计合理，字段完整 | +| 关联关系 | ✅ 认可 | template_id 关联维度表，report 关联模板和罪犯 | +| 性能 | ⚠️ 建议优化 | dimension_data 字段建议评估数据量，考虑是否需要分表存储 | + +**追问与回复**： +> 张工：dimension_data 使用 TEXT 类型存储 JSON，大数据量时会不会影响性能？ +> +> 回复：可以考虑以下优化： +> 1. 定期归档历史报告到历史表 +> 2. 对于超长报告，分维度存储到独立表 +> 3. 或者使用 JSONB 类型（如果MySQL版本支持） + +#### 7.2.3 页面设计评审 + +| 评审项 | 意见 | 处理建议 | +|-------|------|---------| +| 左右分栏布局 | ✅ 认可 | 符合实际工作场景，效率高 | +| 操作流程 | ✅ 认可 | 流程清晰，人机协作模式合理 | +| 交互设计 | ⚠️ 需细化 | 建议增加"一键AI生成全部"和"逐维度生成"的区分 | +| 响应式设计 | ❌ 需补充 | 需要考虑不同屏幕尺寸的适配 | + +**追问与回复**： +> 张工：左侧罪犯列表数据量大时，如何保证性能？ +> +> 回复：采用分页加载，每页显示20-50条，支持搜索过滤。 + +### 7.3 业务专家评审意见 + +#### 7.3.1 监狱管理专家 + +**李队长（某监狱教育科科长，20年经验）** + +| 评审项 | 意见 | 处理建议 | +|-------|------|---------| +| 评估类型 | ✅ 认可 | 四种评估类型覆盖主要场景 | +| 评估维度 | ⚠️ 需调整 | 建议增加"家庭帮教情况"维度，这对假释评估很重要 | +| AI生成内容 | ⚠️ 担忧 | 担心AI生成的内容不够专业，需要严格审核 | +| 数据完整性 | ✅ 认可 | 数据源覆盖全面 | + +**追问与回复**： +> 李队长：AI生成的结论会不会太模板化？ +> +> 回复：可以通过以下方式优化： +> 1. 提示词中强调"具体数据具体分析" +> 2. 要求AI结合具体数值生成个性化内容 +> 3. 民警修改时增加个性化批注选项 + +#### 7.3.2 刑罚执行科代表 + +**王干事（刑罚执行科，8年经验）** + +| 评审项 | 意见 | 处理建议 | +|-------|------|---------| +| 导出格式 | ✅ 认可 | PDF和Word格式满足呈报需求 | +| 报告模板 | ⚠️ 建议 | 建议增加"减刑假释专用模板"，格式更规范 | +| 批量导出 | ✅ 认可 | 批量打包下载功能很有必要 | +| 法律效力 | ⚠️ 关注 | 已审核的报告需要防篡改机制 | + +**追问与回复**： +> 王干事：导出的PDF如何保证法律效力？ +> +> 回复：建议增加以下机制： +> 1. 报告添加数字签名 +> 2. 生成报告时记录指纹哈希值 +> 3. 导出时添加水印和元数据 + +### 7.4 一线管教民警代表评审意见 + +#### 7.4.1 管教民警 + +**陈警官（分监区管教，5年经验）** + +| 评审项 | 意见 | 处理建议 | +|-------|------|---------| +| 操作便捷性 | ✅ 认可 | 左右分栏设计很实用，不用频繁切换页面 | +| AI生成功能 | ✅ 认可 | 能大幅减少文书工作量 | +| 修改灵活性 | ⚠️ 建议 | 建议增加"快捷评语"功能，常用评价可以快速选择 | +| 历史版本 | ⚠️ 建议 | 建议支持查看历史版本，方便对比修改 | + +**追问与回复**： +> 陈警官：AI生成的内容会不会跟实际情况不符？ +> +> 回复：设计时已考虑： +> 1. AI生成后必须人工审核确认 +> 2. 审核时可以看到原始数据对照 +> 3. 支持对AI生成内容进行标注说明 + +#### 7.4.2 心理辅导员 + +**赵老师（监狱心理辅导室，10年经验）** + +| 评审项 | 意见 | 处理建议 | +|-------|------|---------| +| 心理评估维度 | ✅ 认可 | 与现有心理测评数据对接合理 | +| AI提示词 | ⚠️ 建议 | 心理评估相关提示词需要专业心理人员审核 | +| 隐私保护 | ✅ 认可 | 敏感信息脱敏设计是必要的 | + +### 7.5 评审汇总与修订 + +#### 7.5.1 需要修订的需求 + +| 序号 | 修订项 | 修订内容 | 优先级 | +|-----|-------|---------|-------| +| 1 | 评估维度 | 家庭帮教情况维度 | P1 | +| 2 | 数据安全 | 报告防篡改机制（数字签名/哈希） | P1 | +| 3 | 性能优化 | 数据缓存和异步生成队列 | P1 | +| 4 | 交互优化 | 快捷评语功能 | P2 | +| 5 | 交互优化 | 历史版本对比功能 | P2 | +| 6 | 页面适配 | 响应式设计 | P2 | +| 7 | 模板类型 | 减刑假释专用模板 | P2 | + +#### 7.5.2 后续跟进事项 + +1. **AI提示词审核**：由心理专家和法律专家审核各维度的AI提示词 +2. **防篡改方案细化**：与技术专家进一步讨论数字签名实现方案 +3. **性能测试**：评估大数据量下的系统性能表现 +4. **用户培训**：上线前对管教民警进行培训 + +### 7.6 评审结论 + +| 项目 | 评审结论 | +|------|---------| +| 整体设计 | ✅ 通过（需修订） | +| 技术方案 | ✅ 通过（需优化） | +| 业务需求 | ✅ 通过（需补充） | +| 页面设计 | ✅ 通过（需细化） | + +**下一步**：根据评审意见修订需求文档，预计2026-01-20完成二稿评审。