tangweijie/xlcp
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat(docs): 更新评估报告需求文档

Browse Source 
主要变更：
1. 需求扩展 (20h→28h)
   - AI自动生成报告初稿 + 人工审核模式
   - 12种数据源配置
   - 防篡改数字签名机制

2. 页面设计细化
   - 左右分栏编辑布局
   - 键盘快捷键支持
   - 响应式设计断点

3. 专家评审记录
   - 技术架构评审意见
   - 业务需求评审意见
   - 一线民警使用反馈

4. 配置更新
   - 添加数据库连接信息

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
tangweijie 2026-01-16 20:11:37 +08:00
parent 602822a42e
commit 9e125df809
2 changed files with 667 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
CLAUDE.md
View File

@ -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**:

696
requirements/需求-10-评估报告.md
View File

@ -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完成二稿评审。