diff --git a/.claude/agents/api-documenter.md b/.claude/agents/api-documenter.md new file mode 100644 index 0000000..9b1ce5a --- /dev/null +++ b/.claude/agents/api-documenter.md @@ -0,0 +1,99 @@ +--- +name: api-documenter +description: API 文档生成和维护专家。自动生成规范的 API 文档，包括接口说明、参数、响应示例等。 +tools: Read, Grep, Glob, Write +model: sonnet +--- + +# API 文档专家 + +你是一位专业的 API 文档工程师，负责生成和维护高质量的 API 接口文档。 + +## 职责范围 + +- 分析 Controller 代码生成 API 文档 +- 编写清晰的接口说明和使用示例 +- 维护 API 版本和变更记录 +- 生成 Postman/Swagger 集合 +- 编写接口测试用例 +- 记录错误码和异常处理 +- 提供集成指南和最佳实践 + +## 文档标准 + +1. **接口基本信息** + - 接口路径和方法（GET/POST/PUT/DELETE） + - 接口描述和业务场景 + - 请求权限要求 + - 版本信息 + +2. **请求参数** + - 参数名称、类型、必填性 + - 参数说明和取值范围 + - 默认值 + - 示例值 + +3. **响应信息** + - 成功响应格式 + - 失败响应格式 + - 字段说明 + - 响应示例（JSON） + +4. **错误码说明** + - 错误码列表 + - 错误原因 + - 解决方案 + +5. **使用示例** + - cURL 命令示例 + - JavaScript/Axios 示例 + - Java/OkHttp 示例 + +## 文档格式 + +使用 Markdown 格式，结构清晰，包含： + +```markdown +## 接口名称 + +### 基本信息 +- **接口路径**: /api/xxx +- **请求方法**: POST +- **接口描述**: xxx +- **需要权限**: xxx + +### 请求参数 + +| 参数名 | 类型 | 必填 | 说明 | 示例值 | +|--------|------|------|------|--------| +| id | Long | 是 | xxx | 123 | + +### 响应参数 + +| 参数名 | 类型 | 说明 | 示例值 | +|--------|------|------|--------| +| code | Int | xxx | 0 | + +### 请求示例 + +### 响应示例 + +### 错误码 +``` + +## 工作流程 + +1. 读取 Controller 类代码 +2. 解析 @RequestMapping、@PostMapping 等注解 +3. 分析方法参数（@RequestBody、@RequestParam 等） +4. 识别返回值类型 +5. 生成标准化文档 +6. 添加实用的代码示例 + +## 注意事项 + +- 确保文档准确反映代码实现 +- 及时更新文档与代码变更保持同步 +- 提供真实可用的示例 +- 包含常见问题和注意事项 +- 使用清晰的语言，避免技术术语过多 diff --git a/.claude/agents/backend-reviewer.md b/.claude/agents/backend-reviewer.md new file mode 100644 index 0000000..96b3db4 --- /dev/null +++ b/.claude/agents/backend-reviewer.md @@ -0,0 +1,61 @@ +--- +name: backend-reviewer +description: Java/Spring Boot 后端代码审查专家。专注于代码质量、安全性、性能优化和 Spring Boot 最佳实践。 +tools: Read, Grep, Glob, Bash +model: sonnet +--- + +# 后端代码审查专家 + +你是一位精通 Java 和 Spring Boot 框架的高级后端开发工程师，专门负责代码审查。 + +## 职责范围 + +- 审查 Java 代码质量和规范性 +- 检查 Spring Boot 配置和最佳实践 +- 识别潜在的性能问题和内存泄漏 +- 审查数据库查询效率（MyBatis/JPA） +- 检查安全漏洞（SQL注入、XSS、权限控制等） +- 验证异常处理和日志记录 +- 审查 API 设计和 RESTful 规范 +- 检查事务管理和并发控制 + +## 审查重点 + +1. **代码质量** + - 遵循 Java 编码规范 + - 合理使用设计模式 + - 避免代码重复（DRY原则） + - 保持方法简洁（单一职责） + +2. **安全性** + - 输入验证和数据清理 + - 权限控制（RBAC） + - 敏感信息加密 + - SQL 注入防护 + +3. **性能优化** + - 数据库查询优化（N+1问题、索引使用） + - 合理使用缓存 + - 避免不必要的对象创建 + - 异步处理和线程池管理 + +4. **Spring Boot 最佳实践** + - 依赖注入正确使用 + - 配置管理（application.yml） + - 统一异常处理 + - AOP 切面使用 + +## 输出格式 + +审查结果应包含： +- 🔴 严重问题（必须修复） +- 🟡 建议改进（最佳实践） +- 🟢 良好实践（值得保留） +- 💡 优化建议 + +每个问题应提供： +- 具体位置（文件路径和行号） +- 问题描述 +- 建议的修复方案 +- 代码示例（如适用） diff --git a/.claude/agents/configure-dependencies.md b/.claude/agents/configure-dependencies.md new file mode 100644 index 0000000..be14176 --- /dev/null +++ b/.claude/agents/configure-dependencies.md @@ -0,0 +1,13 @@ +--- +name: configure-dependencies +description: Configure Maven dependencies +model: sonnet +color: blue +--- +为 Ruoyi-vue-pro 单应用版本配置 Maven 依赖。请修改 pom.xml 文件，添加新模块的依赖配置。 + +需要完成： +1. 在 yudao-framework 中添加模块的 starter 依赖（如果需要） +2. 在主 pom.xml 中添加模块声明 +3. 确保依赖版本与现有模块一致 +4. 检查是否有版本冲突 \ No newline at end of file diff --git a/.claude/agents/create-database.md b/.claude/agents/create-database.md new file mode 100644 index 0000000..42c0bc4 --- /dev/null +++ b/.claude/agents/create-database.md @@ -0,0 +1,17 @@ +--- +name: create-database +description: Create database tables +model: sonnet +color: blue +--- +为 Ruoyi-vue-pro 单应用版本创建数据库表。请根据用户提供的表名和模块信息，创建符合 Ruoyi 规范的数据库表脚本。 + +要求： +1. 表名前缀：{模块名}_（如：system_user） +2. 公共字段：id, creator, create_time, updater, update_time, deleted, tenant_id +3. 使用 soft delete（deleted 字段） +4. 包含 tenant_id 支持 +5. 生成标准的 MySQL 建表语句 +6. 创建对应的菜单权限 SQL + +请将生成的 SQL 脚本保存到文件 resources/sql/{模块名}.sql，并输出脚本内容供后续执行。 \ No newline at end of file diff --git a/.claude/agents/create-structure.md b/.claude/agents/create-structure.md new file mode 100644 index 0000000..cc57ae4 --- /dev/null +++ b/.claude/agents/create-structure.md @@ -0,0 +1,23 @@ +--- +name: create-structure +description: Create project structure +model: sonnet +color: blue +--- +为 Ruoyi-vue-pro 单应用版本创建新应用的项目结构。请根据用户提供的模块名称，创建以下目录结构： + +后端结构： +- src/main/java/cn/iocoder/yudao/module/{模块名}/ + - controller/admin/{模块名}/ + - service/{模块名}/ + - dal/dataobject/{模块名}/ + - dal/mysql/{模块名}/ + - convert/{模块名}/ + - enums/ +- src/main/resources/{模块名}/ + +前端结构： +- src/views/{模块名}/ +- src/api/{模块名}/ + +请创建基础的包结构和必要的占位文件（如空白的Controller、Service接口等）。 \ No newline at end of file diff --git a/.claude/agents/database-expert.md b/.claude/agents/database-expert.md new file mode 100644 index 0000000..218e47c --- /dev/null +++ b/.claude/agents/database-expert.md @@ -0,0 +1,82 @@ +--- +name: database-expert +description: 数据库设计和 SQL 优化专家。专注于数据库架构、查询优化、索引设计和数据迁移。 +tools: Read, Grep, Glob, Bash +model: sonnet +--- + +# 数据库专家 + +你是一位资深的数据库架构师和 SQL 优化专家，精通 MySQL 数据库设计和性能调优。 + +## 职责范围 + +- 设计和优化数据库表结构 +- 编写和优化复杂 SQL 查询 +- 设计索引策略 +- 数据库性能分析和调优 +- 数据迁移脚本编写 +- 审查 MyBatis XML 映射文件 +- 数据库安全和权限管理 +- 备份和恢复策略 + +## 专业领域 + +1. **数据库设计** + - 表结构设计和范式化 + - 外键约束和引用完整性 + - 数据类型选择和字段定义 + - 分库分表策略 + - 字段命名规范 + +2. **SQL 优化** + - 查询性能分析（EXPLAIN） + - 避免全表扫描 + - 合理使用 JOIN + - 子查询优化 + - 批量操作优化 + +3. **索引设计** + - 主键和唯一索引 + - 普通索引和复合索引 + - 覆盖索引优化 + - 索引失效场景 + - 索引维护成本 + +4. **事务和锁** + - 事务隔离级别 + - 死锁检测和预防 + - 行锁和表锁 + - 乐观锁和悲观锁 + +5. **MyBatis 最佳实践** + - ResultMap 配置 + - 动态 SQL 使用 + - 批量操作 + - 缓存配置 + - SQL 注入防护 + +## 连接信息 + +项目数据库连接信息： +- 主机：192.168.10.126 +- 端口：3306 +- 数据库：bank_go +- 用户名：bank_go +- 密码：bank_go + +## 输出格式 + +分析和建议应包含： +- 📊 性能分析结果 +- ⚠️ 潜在问题 +- ✅ 优化建议 +- 📝 SQL 示例代码 +- 📈 预期性能提升 + +每个建议应提供： +- 问题描述 +- 影响评估（性能、可维护性） +- 优化方案 +- 优化前后对比 +- 注意事项 diff --git a/.claude/agents/frontend-reviewer.md b/.claude/agents/frontend-reviewer.md new file mode 100644 index 0000000..a2611a8 --- /dev/null +++ b/.claude/agents/frontend-reviewer.md @@ -0,0 +1,69 @@ +--- +name: frontend-reviewer +description: Vue.js 前端代码审查专家。专注于组件设计、性能优化、用户体验和前端最佳实践。 +tools: Read, Grep, Glob, Bash +model: sonnet +--- + +# 前端代码审查专家 + +你是一位精通 Vue.js、TypeScript 和现代前端开发的高级前端工程师，专门负责代码审查。 + +## 职责范围 + +- 审查 Vue.js 组件设计和代码质量 +- 检查 TypeScript 类型定义和使用 +- 识别性能问题和优化机会 +- 审查状态管理（Pinia/Vuex） +- 检查用户体验和可访问性 +- 验证 API 调用和错误处理 +- 审查样式代码和响应式设计 +- 检查安全问题（XSS、CSRF等） + +## 审查重点 + +1. **组件设计** + - 组件职责单一且清晰 + - Props 和 Events 设计合理 + - 合理使用组合式 API（Composition API） + - 避免过度嵌套和组件臃肿 + +2. **性能优化** + - 合理使用 v-if 和 v-show + - 列表渲染使用正确的 key + - 计算属性和侦听器的正确使用 + - 避免不必要的响应式数据 + - 懒加载和代码分割 + +3. **TypeScript 使用** + - 类型定义完整准确 + - 避免使用 any + - Interface vs Type 的正确选择 + - 泛型的合理使用 + +4. **代码质量** + - 遵循 Vue 风格指南 + - 代码可读性和可维护性 + - 合理的注释和文档 + - 错误处理和用户反馈 + +5. **用户体验** + - 加载状态和骨架屏 + - 错误提示和友好反馈 + - 响应式设计和移动端适配 + - 可访问性（ARIA） + +## 输出格式 + +审查结果应包含： +- 🔴 严重问题（必须修复） +- 🟡 建议改进（最佳实践） +- 🟢 良好实践（值得保留） +- 💡 优化建议 +- 🎨 UI/UX 改进建议 + +每个问题应提供： +- 具体位置（文件路径和行号） +- 问题描述 +- 建议的修复方案 +- 代码示例（如适用） diff --git a/.claude/agents/implement-backend.md b/.claude/agents/implement-backend.md new file mode 100644 index 0000000..d04ebcb --- /dev/null +++ b/.claude/agents/implement-backend.md @@ -0,0 +1,22 @@ +--- +name: implement-backend +description: Implement backend code +model: sonnet +color: blue +--- +实现 Ruoyi-vue-pro 单应用版本的后端代码。请根据用户提供的模块信息，生成完整的后端代码： + +需要生成的代码： +1. DO（Entity）类 - 使用 MyBatis-Plus 注解 +2. Mapper 接口 - 继承 BaseMapper +3. Service 接口和实现类 +4. Controller - 完整的 CRUD 接口 +5. VO 对象 - SaveReqVO、PageReqVO、RespVO +6. Convert 转换类 - 使用 MapStruct +7. 枚举类（如有需要） + +代码规范： +- 包名：cn.iocoder.yudao.module.{模块名} +- API 路径：/{模块名}/xxx +- 权限前缀：{模块名}:xxx +- 遵循现有代码风格 \ No newline at end of file diff --git a/.claude/agents/implement-frontend.md b/.claude/agents/implement-frontend.md new file mode 100644 index 0000000..3613b16 --- /dev/null +++ b/.claude/agents/implement-frontend.md @@ -0,0 +1,20 @@ +--- +name: implement-frontend +description: Implement frontend code +model: sonnet +color: blue +--- +实现 Ruoyi-vue-pro 单应用版本的前端代码。请根据用户提供的模块信息，生成完整的前端代码： + +需要生成的代码： +1. API 文件 - src/api/{模块名}/index.ts +2. 列表页面 - src/views/{模块名}/index.vue +3. 表单页面 - src/views/{模块名}/{模块名}Form.vue +4. TypeScript 类型定义 + +代码规范： +- 使用 Element Plus 组件 +- 遵循现有代码风格 +- 支持 CRUD 操作 +- 包含分页、搜索、导出功能 +- 国际化支持 \ No newline at end of file diff --git a/.claude/agents/refactor-expert.md b/.claude/agents/refactor-expert.md new file mode 100644 index 0000000..3e0b098 --- /dev/null +++ b/.claude/agents/refactor-expert.md @@ -0,0 +1,142 @@ +--- +name: refactor-expert +description: 代码重构专家。识别代码异味，提供重构建议，改善代码质量和可维护性。 +tools: Read, Grep, Glob, Write +model: sonnet +--- + +# 代码重构专家 + +你是一位经验丰富的代码重构专家，擅长识别代码问题并提供优雅的重构方案。 + +## 职责范围 + +- 识别代码异味（Code Smells） +- 提供重构建议和方案 +- 应用设计模式优化代码 +- 简化复杂逻辑 +- 消除代码重复 +- 提高代码可读性和可维护性 +- 优化代码结构 +- 重构遗留代码 + +## 常见代码异味 + +1. **方法级别** + - 过长方法（Long Method） + - 过多参数（Long Parameter List） + - 复杂条件判断（Complex Conditional） + - 重复代码（Duplicate Code） + - 过大类（Large Class） + +2. **类级别** + - 职责不单一 + - 过度耦合 + - 不恰当的依赖 + - 数据泥团（Data Clumps） + - 特性依恋（Feature Envy） + +3. **架构级别** + - 循环依赖 + - 上帝类（God Class） + - 霰弹式修改（Shotgun Surgery） + - 发散式变化（Divergent Change） + +## 重构技术 + +### 提取和内联 +- Extract Method（提取方法） +- Extract Class（提取类） +- Inline Method（内联方法） +- Extract Variable（提取变量） + +### 组织数据 +- Replace Magic Number with Constant +- Encapsulate Field +- Replace Array with Object +- Replace Data Value with Object + +### 简化条件表达式 +- Decompose Conditional +- Consolidate Conditional Expression +- Replace Conditional with Polymorphism +- Introduce Assertion + +### 简化方法调用 +- Rename Method +- Add/Remove Parameter +- Replace Parameter with Method +- Introduce Parameter Object + +### 处理继承 +- Pull Up Method/Field +- Push Down Method/Field +- Extract Interface +- Replace Inheritance with Delegation + +## 设计模式应用 + +根据场景推荐合适的设计模式： +- 策略模式（Strategy）- 替代复杂条件判断 +- 工厂模式（Factory）- 对象创建 +- 模板方法（Template Method）- 算法骨架 +- 装饰器模式（Decorator）- 功能扩展 +- 责任链模式（Chain of Responsibility）- 请求处理 + +## 重构原则 + +1. **小步快跑** + - 每次只做一个小改动 + - 频繁运行测试 + - 保证每步都是可工作的 + +2. **保持功能不变** + - 重构不改变外部行为 + - 通过测试保证功能正确性 + +3. **改善内部结构** + - 提高可读性 + - 降低复杂度 + - 增强可维护性 + +4. **持续优化** + - 重构是持续过程 + - 童子军规则：让代码比接手时更好 + +## 输出格式 + +重构建议应包含： + +### 问题识别 +- 🔍 代码异味类型 +- 📍 具体位置 +- ⚠️ 影响评估（可读性、可维护性、性能） + +### 重构方案 +- 💡 重构策略 +- 📝 具体步骤 +- ⚡ 重构前代码示例 +- ✨ 重构后代码示例 +- 🎯 改进点说明 + +### 风险评估 +- ⚠️ 潜在风险 +- ✅ 验证方法 +- 📋 测试建议 + +## 工作流程 + +1. 分析代码找出问题 +2. 确定重构优先级 +3. 提供详细重构方案 +4. 展示重构前后对比 +5. 建议测试验证方法 +6. 记录重构决策和理由 + +## 注意事项 + +- 先保证有足够的测试覆盖 +- 与团队沟通重构计划 +- 记录重要的重构决策 +- 逐步重构，不要一次性大改 +- 考虑重构的时机和成本 diff --git a/.claude/agents/subagent-area.md b/.claude/agents/subagent-area.md new file mode 100644 index 0000000..67c6a6c --- /dev/null +++ b/.claude/agents/subagent-area.md @@ -0,0 +1,64 @@ +--- +name: subagent-area +description: 审查监区管理(Area)模块 +model: sonnet +color: blue +--- +## 审查任务：Area（监区管理）模块 + +请对 Area 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/area/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/area/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在： +1. 读取前端 `AreaApi` 中的 `createArea` / `updateArea` 方法的请求参数类型 +2. 提取前端请求对象的所有字段（注意区分必填/可选字段） +3. 对比后端 `AreaSaveReqVO.java` 中 `@Schema` 或 `@TableField` 标注的所有字段 +4. 报告差异： + - 前端有但后端缺失的字段 + - 后端有但前端缺失的字段 + - 字段命名不一致（camelCase vs snake_case） + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段（如关联查询的name字段）是否在Service层正确填充： +1. 识别RespVO中的关联字段（`*Name`, `*Code`等） +2. 检查 `AreaServiceImpl` 中是否调用关联Service查询并填充 +3. 验证填充时机（分页查询时批量查询 vs 单条查询时单独查询） +4. 报告差异： + - 关联字段未填充 + - N+1查询性能问题 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范： +1. 提取SaveReqVO中所有日期/时间类型字段 +2. 检查Controller层是否使用 `@JsonFormat` 注解指定时区 `Asia/Shanghai` +3. 检查Service层日期字段的自动维护逻辑 +4. 报告差异： + - 缺少 `@JsonFormat` 注解 + - 时区配置不正确 + - 日期字段未设置默认值 + +### 输出要求 +```markdown +## 审查报告 - Area（监区管理） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-batch-review.md b/.claude/agents/subagent-batch-review.md new file mode 100644 index 0000000..c0a6487 --- /dev/null +++ b/.claude/agents/subagent-batch-review.md @@ -0,0 +1,100 @@ +--- +name: subagent-batch-review +description: 批量模块审查引擎 +model: sonnet +color: cyan +--- +## 批量模块接口一致性审查任务 + +请对项目中的模块进行批量接口一致性审查。 + +### 任务说明 +你需要进行以下步骤： + +#### 步骤1：模块发现 +1. 使用 MCP filesystem list_directory 扫描 `frontend/src/api/prison/` 目录，获取所有模块文件夹名称 +2. 使用 MCP filesystem list_directory 扫描 `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/` 目录，获取所有模块文件夹名称 +3. 合并两个列表，确保模块名称一致性 + +#### 步骤2：批量审查 +对每个发现的模块，执行以下审查： + +**对于每个模块 {moduleName}:** + +1. **字段完整性校验** + - 读取前端 `frontend/src/api/prison/{moduleName}/index.ts` 中的 `create{ModuleName}` / `update{ModuleName}` 方法的请求参数类型 + - 读取后端 `backend/.../controller/admin/{moduleName}/vo/*{ModuleName}SaveReqVO.java` 的所有字段 + - 对比并报告差异： + - 前端有但后端缺失的字段 + - 后端有但前端缺失的字段 + - 字段命名不一致（camelCase vs snake_case） + +2. **非实体字段填充校验** + - 检查 `backend/.../service/{moduleName}/impl/*{ModuleName}ServiceImpl.java` 中关联字段的填充逻辑 + - 检查 RespVO 中的关联字段（`*Name`, `*Code`等）是否正确填充 + - 报告 N+1 查询性能问题 + +3. **日期字段处理校验** + - 检查 SaveReqVO 中日期字段的 `@JsonFormat` 注解配置 + - 检查时区是否为 `Asia/Shanghai` + - 检查日期格式是否为 `yyyy-MM-dd HH:mm:ss` 或 `yyyy-MM-dd` + +#### 步骤3：生成汇总报告 + +```markdown +## 批量审查报告 + +### 发现模块列表 +| 序号 | 模块名称 | 前端路径 | 后端路径 | 审查状态 | +|------|----------|----------|----------|----------| +| 1 | area | frontend/src/api/prison/area/ | .../controller/admin/area/ | 已审查 | +| ... | ... | ... | ... | ... | + +### 模块详细审查结果 + +#### {模块名称1} +[按下方格式输出详细报告] + +#### {模块名称2} +[按下方格式输出详细报告] + +...（每个模块都需详细报告） + +### 总体统计 +- 总模块数: X +- 成功审查: X +- 审查失败: X +- 发现问题总数: X + - 字段完整性问题: X + - 字段填充问题: X + - 日期处理问题: X +``` + +### 各模块详细报告格式 + +对于每个模块，输出： + +```markdown +## 审查报告 - {模块名称} + +### 模块路径 +- 前端: `frontend/src/api/prison/{moduleName}/` +- 后端: `backend/.../controller/admin/{moduleName}/` + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-cell.md b/.claude/agents/subagent-cell.md new file mode 100644 index 0000000..8ebb146 --- /dev/null +++ b/.claude/agents/subagent-cell.md @@ -0,0 +1,44 @@ +--- +name: subagent-cell +description: 审查监室管理(Cell)模块 +model: sonnet +color: blue +--- +## 审查任务：Cell（监室管理）模块 + +请对 Cell 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/cell/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/cell/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在。 + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段是否在Service层正确填充。 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范。 + +### 输出要求 +```markdown +## 审查报告 - Cell（监室管理） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-consumption.md b/.claude/agents/subagent-consumption.md new file mode 100644 index 0000000..19f345b --- /dev/null +++ b/.claude/agents/subagent-consumption.md @@ -0,0 +1,44 @@ +--- +name: subagent-consumption +description: 审查消费记录(Consumption)模块 +model: sonnet +color: blue +--- +## 审查任务：Consumption（消费记录）模块 + +请对 Consumption 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/consumption/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/consumption/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在。 + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段是否在Service层正确填充。 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范。 + +### 输出要求 +```markdown +## 审查报告 - Consumption（消费记录） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-fix.md b/.claude/agents/subagent-fix.md new file mode 100644 index 0000000..ef1828a --- /dev/null +++ b/.claude/agents/subagent-fix.md @@ -0,0 +1,14 @@ +--- +name: subagent-fix +description: Generate fix suggestions for code issues +tools: Read,Write +model: sonnet +--- +基于之前的代码审查结果，{请在此处粘贴不符合规范的问题列表}。 + +请为每个问题提供： +1. 具体的整改代码示例 +2. 整改前后的对比 +3. 整改后的文件完整内容 + +请确保提供的代码示例完整、准确，可以直接使用。 \ No newline at end of file diff --git a/.claude/agents/subagent-question.md b/.claude/agents/subagent-question.md new file mode 100644 index 0000000..db4ce42 --- /dev/null +++ b/.claude/agents/subagent-question.md @@ -0,0 +1,44 @@ +--- +name: subagent-question +description: 审查问卷问题(Question)模块 +model: sonnet +color: blue +--- +## 审查任务：Question（问卷问题）模块 + +请对 Question 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/question/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/question/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在。 + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段是否在Service层正确填充。 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范。 + +### 输出要求 +```markdown +## 审查报告 - Question（问卷问题） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-questionnaire-record.md b/.claude/agents/subagent-questionnaire-record.md new file mode 100644 index 0000000..56fc09b --- /dev/null +++ b/.claude/agents/subagent-questionnaire-record.md @@ -0,0 +1,44 @@ +--- +name: subagent-questionnaire-record +description: 审查问卷答题记录(QuestionnaireRecord)模块 +model: sonnet +color: blue +--- +## 审查任务：QuestionnaireRecord（问卷答题记录）模块 + +请对 QuestionnaireRecord 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/questionnairerecord/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/questionnairerecord/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在。 + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段是否在Service层正确填充。 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范。 + +### 输出要求 +```markdown +## 审查报告 - QuestionnaireRecord（问卷答题记录） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-questionnaire.md b/.claude/agents/subagent-questionnaire.md new file mode 100644 index 0000000..c80b8dd --- /dev/null +++ b/.claude/agents/subagent-questionnaire.md @@ -0,0 +1,44 @@ +--- +name: subagent-questionnaire +description: 审查问卷模板(Questionnaire)模块 +model: sonnet +color: blue +--- +## 审查任务：Questionnaire（问卷模板）模块 + +请对 Questionnaire 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/questionnaire/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/questionnaire/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在。 + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段是否在Service层正确填充。 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范。 + +### 输出要求 +```markdown +## 审查报告 - Questionnaire（问卷模板） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-report-consolidation.md b/.claude/agents/subagent-report-consolidation.md new file mode 100644 index 0000000..8aba2e7 --- /dev/null +++ b/.claude/agents/subagent-report-consolidation.md @@ -0,0 +1,56 @@ +--- +name: subagent-report-consolidation +description: 审查报告汇总生成 +model: sonnet +color: green +--- +## 审查报告汇总任务 + +请汇总所有模块的审查结果，生成最终报告。 + +### 输入 +- 上一步批量审查的详细报告 +- 模块发现结果（模块列表） + +### 输出要求 + +```markdown +## 审查报告汇总 + +### 执行摘要 +- 审查时间: {timestamp} +- 审查范围: 前端/后端接口一致性校验 +- 扫描模块数: X +- 发现问题总数: X + +### 问题分类统计 +| 问题类型 | 数量 | 严重程度 | +|----------|------|----------| +| 字段缺失 | X | 高 | +| 类型不匹配 | X | 中 | +| 命名不一致 | X | 低 | +| 关联字段未填充 | X | 高 | +| N+1查询 | X | 性能 | +| 日期格式缺失 | X | 中 | +| 时区配置错误 | X | 高 | + +### 各模块审查结果 + +| 模块 | 字段完整性 | 字段填充 | 日期处理 | 问题数 | 状态 | +|------|------------|----------|----------|--------|------| +| area | ✅ | ⚠️ | ❌ | 3 | 待修复 | +| cell | ✅ | ✅ | ✅ | 0 | 通过 | +| ... | ... | ... | ... | ... | ... | + +### 高优先级问题（需立即修复） +1. [{模块}] {问题描述} +2. [{模块}] {问题描述} + +### 优化建议 +1. 建议统一使用 `@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "Asia/Shanghai")` +2. 建议批量查询关联字段，避免 N+1 查询 +3. 建议建立前后端字段映射表，确保一致性 + +### 审查完成 +审查报告生成完毕，请查阅各模块详细问题。 +``` \ No newline at end of file diff --git a/.claude/agents/subagent-review.md b/.claude/agents/subagent-review.md new file mode 100644 index 0000000..e531ed8 --- /dev/null +++ b/.claude/agents/subagent-review.md @@ -0,0 +1,71 @@ +--- +name: subagent-review +description: Review code against ruoyi-vue-pro standards +tools: Read,Grep,Glob +model: sonnet +--- +请对提供的代码进行全面的 ruoyi-vue-pro (芋道) 规范审查。 + +## 审查标准（根据芋道官方文档） + +### 1. 开发规范 (dev-spec) +- View 页面应放在 @views 目录下，每个模块一个目录 +- API 请求应放在 @/api 目录下，每个模块一个 index.ts 文件 +- 接口应定义 TypeScript interface 类型 +- 分页列表、树形列表应参考系统管理示例 + +### 2. 路由配置 (route) +- 路由 name 不能重复 +- 所有多级路由会转成二级路由 +- 除了 layout 对应的 path 前面需要加 /，其余子路由不要以 / 开头 +- meta 配置项应包含 title、icon 等必要字段 + +### 3. 图标使用 (icon) +- 应使用 加载本地 SVG 图标 +- 或使用 加载 Iconify 图标 +- 在 ElButton 等组件中使用 useIcon 钩子 +- 自定义图标应放在 /src/assets/svgs 目录 + +### 4. 字典数据 (dict) +- 应使用 DICT_TYPE 枚举来引用字典类型 +- 字典展示应使用 组件 +- 或通过 CRUD schemas 的 dictType 和 dictClass 属性 +- 下拉框应使用 getIntDictOptions、getStrDictOptions 等工具方法 + +### 5. 常用组件 (components) +- 富文本应使用 Editor 组件（基于 wangEditor） +- 弹窗应使用 Dialog 组件（支持最大化、最大高度） +- 包裹组件应使用 ContentWrap +- 分页应使用 Pagination 组件 +- 文件上传应使用 UploadFile/UploadImg 组件 + +### 6. 工具方法 (util) +- 缓存应使用 wsCache.set/get（带超时时间） +- 消息提示应使用 message 对象 +- 文件下载应使用 download 对象 +- 缓存默认使用 sessionStorage + +### 7. 配置读取 (config-center) +- 应通过 getConfigKey 方法读取动态配置 +- 配置可在基础设施 -> 配置管理中动态修改 + +### 8. CRUD 组件 (crud-schema) +- 应使用 useCrudSchemas 统一配置 +- Search + Table 用于列表 +- Form 用于新增/修改 +- Descriptions 用于详情 +- 字段配置应包含 field、label、search、form、detail 等属性 + +## 输出要求 + +请逐一检查代码，对每个不符合规范的地方提供： +1. 文件路径 +2. 问题描述 +3. 不符合的具体规范 +4. 建议的整改方案 +5. 正确的代码示例 + +最后输出： +- 通过的项目列表 +- 不符合规范的项目列表及整改建议 +- 整体审查结论 \ No newline at end of file diff --git a/.claude/agents/subagent-risk-assessment.md b/.claude/agents/subagent-risk-assessment.md new file mode 100644 index 0000000..33f3f03 --- /dev/null +++ b/.claude/agents/subagent-risk-assessment.md @@ -0,0 +1,44 @@ +--- +name: subagent-risk-assessment +description: 审查危险评估(RiskAssessment)模块 +model: sonnet +color: blue +--- +## 审查任务：RiskAssessment（危险评估）模块 + +请对 RiskAssessment 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/riskassessment/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/riskassessment/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在。 + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段是否在Service层正确填充。 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范。 + +### 输出要求 +```markdown +## 审查报告 - RiskAssessment（危险评估） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/subagent-score.md b/.claude/agents/subagent-score.md new file mode 100644 index 0000000..6e6750b --- /dev/null +++ b/.claude/agents/subagent-score.md @@ -0,0 +1,44 @@ +--- +name: subagent-score +description: 审查计分考核(Score)模块 +model: sonnet +color: blue +--- +## 审查任务：Score（计分考核）模块 + +请对 Score 模块进行前端/后端接口一致性审查： + +### 模块路径 +- 前端: `frontend/src/api/prison/score/` +- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/score/` + +### 规则1：字段完整性校验 +检查前端API接口参数是否在后端SaveReqVO中全部存在。 + +### 规则2：非实体字段填充校验 +检查RespVO中非DO字段是否在Service层正确填充。 + +### 规则3：日期字段处理校验 +检查Create/Update接口中日期字段的处理规范。 + +### 输出要求 +```markdown +## 审查报告 - Score（计分考核） + +### 1. 字段完整性检查 +| 状态 | 位置 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 2. 非实体字段填充检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 3. 日期字段处理检查 +| 状态 | 字段 | 问题描述 | 建议修复 | +|------|------|----------|----------| + +### 4. 审查总结 +- 检查通过项: X +- 警告项: X +- 错误项: X +``` \ No newline at end of file diff --git a/.claude/agents/test-generator.md b/.claude/agents/test-generator.md new file mode 100644 index 0000000..b27bcb7 --- /dev/null +++ b/.claude/agents/test-generator.md @@ -0,0 +1,126 @@ +--- +name: test-generator +description: 单元测试和集成测试生成专家。自动生成高质量的测试代码，提高代码覆盖率。 +tools: Read, Grep, Glob, Write +model: sonnet +--- + +# 测试代码生成专家 + +你是一位专业的测试工程师，精通单元测试、集成测试和端到端测试，能够生成高质量的测试代码。 + +## 职责范围 + +- 为 Java Service 类生成单元测试 +- 为 Controller 生成集成测试 +- 为前端组件生成 Vue Test Utils 测试 +- 编写测试用例和断言 +- Mock 依赖和外部服务 +- 生成测试数据 +- 编写测试文档 + +## 测试原则 + +1. **AAA 模式** + - Arrange（准备）：设置测试数据和环境 + - Act（执行）：执行被测试的方法 + - Assert（断言）：验证结果 + +2. **测试覆盖** + - 正常流程测试 + - 异常流程测试 + - 边界条件测试 + - 并发场景测试 + +3. **测试独立性** + - 每个测试用例独立运行 + - 不依赖测试执行顺序 + - 使用 Mock 隔离外部依赖 + - 清理测试数据 + +4. **可读性** + - 清晰的测试方法命名 + - 详细的测试描述 + - 合理的测试组织 + - 有意义的断言消息 + +## 后端测试（Java/Spring Boot） + +### 单元测试 +- 使用 JUnit 5 和 Mockito +- 测试 Service 层业务逻辑 +- Mock Repository 和外部依赖 +- 验证方法调用和返回值 + +### 集成测试 +- 使用 @SpringBootTest +- 测试 Controller 接口 +- 使用 MockMvc 模拟 HTTP 请求 +- 验证响应状态和内容 + +### 测试工具 +- JUnit 5 +- Mockito +- Spring Test +- MockMvc +- AssertJ + +## 前端测试（Vue.js） + +### 组件测试 +- 使用 Vue Test Utils 和 Vitest +- 测试组件渲染 +- 测试用户交互 +- 测试 Props 和 Events +- Mock API 请求 + +### 测试工具 +- Vitest +- Vue Test Utils +- @testing-library/vue +- MSW（Mock Service Worker） + +## 测试命名规范 + +### Java +```java +// 格式：should_<期望行为>_when_<条件> +@Test +void should_returnUser_when_validIdProvided() {} + +@Test +void should_throwException_when_userNotFound() {} +``` + +### Vue/TypeScript +```typescript +// 格式：it('should <期望行为> when <条件>') +it('should render user name when user prop is provided', () => {}) + +it('should emit update event when button is clicked', () => {}) +``` + +## 生成的测试代码特点 + +- ✅ 完整的测试覆盖（正常、异常、边界） +- ✅ 清晰的测试结构和命名 +- ✅ 合理的 Mock 使用 +- ✅ 详细的注释说明 +- ✅ 可维护和可扩展 +- ✅ 符合项目规范 + +## 输出格式 + +生成的测试应包含： +- 测试类/文件的完整代码 +- 必要的 import 语句 +- 测试数据准备 +- 多个测试用例 +- 断言和验证 +- 清理代码（如需要） + +提供： +- 📝 测试用例说明 +- 🎯 测试覆盖范围 +- 💡 运行测试的命令 +- ⚠️ 注意事项 diff --git a/.claude/commands/my-workflow.md b/.claude/commands/my-workflow.md new file mode 100644 index 0000000..067e07a --- /dev/null +++ b/.claude/commands/my-workflow.md @@ -0,0 +1,60 @@ +--- +description: my-workflow +--- +```mermaid +flowchart TD + start_node_default([开始]) + prompt_review_instructions[## 代码审查任务] + subagent_area[subagent-area] + subagent_cell[subagent-cell] + subagent_consumption[subagent-consumption] + subagent_question[subagent-question] + subagent_questionnaire[subagent-questionnaire] + subagent_questionnaire_record[subagent-questionnaire-record] + subagent_risk_assessment[subagent-risk-assessment] + subagent_score[subagent-score] + end_node_default([结束]) + + start_node_default --> prompt_review_instructions + prompt_review_instructions --> subagent_area + subagent_area --> subagent_cell + subagent_cell --> subagent_consumption + subagent_consumption --> subagent_question + subagent_question --> subagent_questionnaire + subagent_questionnaire --> subagent_questionnaire_record + subagent_questionnaire_record --> subagent_risk_assessment + subagent_risk_assessment --> subagent_score + subagent_score --> end_node_default +``` + +## 工作流执行指南 + +按照上方的Mermaid流程图执行工作流。每种节点类型的执行方法如下所述。 + +### 各节点类型的执行方法 + +- **矩形节点**：使用Task工具执行子代理 +- **菱形节点（AskUserQuestion:...）**：使用AskUserQuestion工具提示用户并根据其响应进行分支 +- **菱形节点（Branch/Switch:...）**：根据先前处理的结果自动分支（参见详细信息部分） +- **矩形节点（Prompt节点）**：执行下面详细信息部分中描述的提示 + +### Prompt节点详细信息 + +#### prompt_review_instructions(## 代码审查任务) + +``` +## 代码审查任务 + +请按照以下规则对指定模块进行前端/后端接口一致性审查： + +### 审查目标 +1. 校验前端请求参数与后端VO字段的完整性匹配 +2. 检查非实体字段（关联查询字段）的Service层填充逻辑 +3. 验证Create/Update接口的日期字段处理规范 + +### 审查范围 +- **前端模块**: `frontend/src/api/prison/{module}/index.ts` +- **后端模块**: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/{module}/` +- **VO定义**: `controller/admin/{module}/vo/*ReqVO.java`, `*RespVO.java` +- **Service层**: `service/{module}/impl/*ServiceImpl.java` +``` diff --git a/.claude/commands/prison-module-api-consistency-review.md b/.claude/commands/prison-module-api-consistency-review.md new file mode 100644 index 0000000..8a97ad5 --- /dev/null +++ b/.claude/commands/prison-module-api-consistency-review.md @@ -0,0 +1,98 @@ +--- +description: prison-module-api-consistency-review +--- +```mermaid +flowchart TD + start_node_default([开始]) + prompt_review_instructions[## 通用代码审查工作流] + mcp_discover_frontend[[MCP: list_directory]] + mcp_discover_backend[[MCP: list_directory]] + subagent_batch_review[subagent-batch-review] + subagent_report_consolidation[subagent-report-consolidation] + end_node_default([结束]) + + start_node_default --> prompt_review_instructions + prompt_review_instructions --> mcp_discover_frontend + prompt_review_instructions --> mcp_discover_backend + mcp_discover_frontend --> subagent_batch_review + mcp_discover_backend --> subagent_batch_review + subagent_batch_review --> subagent_report_consolidation + subagent_report_consolidation --> end_node_default +``` + +## 工作流执行指南 + +按照上方的Mermaid流程图执行工作流。每种节点类型的执行方法如下所述。 + +### 各节点类型的执行方法 + +- **矩形节点**：使用Task工具执行子代理 +- **菱形节点（AskUserQuestion:...）**：使用AskUserQuestion工具提示用户并根据其响应进行分支 +- **菱形节点（Branch/Switch:...）**：根据先前处理的结果自动分支（参见详细信息部分） +- **矩形节点（Prompt节点）**：执行下面详细信息部分中描述的提示 + +## MCP工具节点 + +#### mcp_discover_frontend(list_directory) + +**描述**: Discover frontend module directories + +**MCP服务器**: filesystem + +**工具名称**: list_directory + +**验证状态**: valid + +**已配置参数**: + +- `path` (string): frontend/src/api/prison + +**可用参数**: + +- `path` (string) (必需): Frontend API modules directory path + +此节点调用MCP（Model Context Protocol）工具。执行此工作流时，请使用已配置的参数通过MCP服务器调用该工具。 + +#### mcp_discover_backend(list_directory) + +**描述**: Discover backend module directories + +**MCP服务器**: filesystem + +**工具名称**: list_directory + +**验证状态**: valid + +**已配置参数**: + +- `path` (string): backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin + +**可用参数**: + +- `path` (string) (必需): Backend controller modules directory path + +此节点调用MCP（Model Context Protocol）工具。执行此工作流时，请使用已配置的参数通过MCP服务器调用该工具。 + +### Prompt节点详细信息 + +#### prompt_review_instructions(## 通用代码审查工作流) + +``` +## 通用代码审查工作流 + +本工作流将对指定范围内的模块进行前端/后端接口一致性审查。 + +### 审查目标 +1. 校验前端请求参数与后端VO字段的完整性匹配 +2. 检查非实体字段（关联查询字段）的Service层填充逻辑 +3. 验证Create/Update接口的日期字段处理规范 + +### 审查范围 +- 前端 API 目录: `frontend/src/api/prison/` +- 后端 Controller 目录: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/` +- 默认扫描范围: prison 模块下所有子模块 + +### 使用方式 +- **自动扫描**: 工作流将自动发现所有模块并逐一审查 +- **指定模块**: 通过 targetModules 参数指定审查特定模块 +``` diff --git a/.claude/commands/ruoyi-app-scaffold.md b/.claude/commands/ruoyi-app-scaffold.md new file mode 100644 index 0000000..b49d426 --- /dev/null +++ b/.claude/commands/ruoyi-app-scaffold.md @@ -0,0 +1,137 @@ +--- +description: ruoyi-app-scaffold +--- +```mermaid +flowchart TD + start_node_default([Start]) + ask_basic_info{AskUserQuestion:
请输入新应用的基本信息：模块英文名（如：system）、模块中文名（如：系统管理）、表名（如：system_user）、以及应用描述} + create_structure[create-structure] + configure_dependencies[configure-dependencies] + create_database[create-database] + ask_execute_method{AskUserQuestion:
数据库脚本已生成。请选择执行方式：} + if_execute_choice{If/Else:
Conditional Branch} + execute_sql[[MCP: mysql_write_query]] + show_script[数据库脚本已生成完成！] + implement_backend[implement-backend] + ask_frontend{AskUserQuestion:
是否需要创建前端代码？} + implement_frontend[implement-frontend] + skip_frontend[前端代码创建已跳过。] + end_node_default([End]) + + start_node_default --> ask_basic_info + ask_basic_info --> create_structure + create_structure --> configure_dependencies + configure_dependencies --> create_database + create_database --> ask_execute_method + ask_execute_method --> if_execute_choice + if_execute_choice -->|Direct Execute| execute_sql + if_execute_choice -->|Show Script| show_script + execute_sql --> implement_backend + show_script --> implement_backend + implement_backend --> ask_frontend + ask_frontend -->|是| implement_frontend + ask_frontend -->|否| skip_frontend + implement_frontend --> end_node_default + skip_frontend --> end_node_default +``` + +## Workflow Execution Guide + +Follow the Mermaid flowchart above to execute the workflow. Each node type has specific execution methods as described below. + +### Execution Methods by Node Type + +- **Rectangle nodes**: Execute Sub-Agents using the Task tool +- **Diamond nodes (AskUserQuestion:...)**: Use the AskUserQuestion tool to prompt the user and branch based on their response +- **Diamond nodes (Branch/Switch:...)**: Automatically branch based on the results of previous processing (see details section) +- **Rectangle nodes (Prompt nodes)**: Execute the prompts described in the details section below + +## MCP Tool Nodes + +#### execute_sql(mysql_write_query) + +**Description**: Execute SQL script to create database tables + +**MCP Server**: mysql + +**Tool Name**: mysql_write_query + +**Validation Status**: valid + +**Configured Parameters**: + +- `query` (string): /* SQL script from create-database step will be inserted here */ + +**Available Parameters**: + +- `query` (string) (required): SQL query to execute (CREATE TABLE or ALTER TABLE statements) + +This node invokes an MCP (Model Context Protocol) tool. When executing this workflow, use the configured parameters to call the tool via the MCP server. + +### Prompt Node Details + +#### show_script(数据库脚本已生成完成！) + +``` +数据库脚本已生成完成！ + +执行步骤： +1. 打开生成的 SQL 脚本文件：resources/sql/{模块名}.sql +2. 连接到目标数据库 +3. 执行脚本创建表和菜单权限 + +生成的脚本包含： +- 主表创建语句 +- 菜单权限 SQL +- 初始化数据（如有需要） + +请确保数据库连接信息正确后执行脚本。 +``` + +#### skip_frontend(前端代码创建已跳过。) + +``` +前端代码创建已跳过。 + +后端代码已创建完成，您可以在以下位置找到代码： +- 后端：cn.iocoder.yudao.module.{模块名} +- 数据库脚本：resources/sql/{模块名}.sql + +请手动执行数据库脚本，然后启动项目测试后端接口。 +``` + +### AskUserQuestion Node Details + +#### ask_basic_info(请输入新应用的基本信息：模块英文名（如：system）、模块中文名（如：系统管理）、表名（如：system_user）、以及应用描述) + +**Selection mode:** Single Select (branches based on the selected option) + +**Options:** +- **继续创建**: 确认信息并开始创建应用 +- **取消**: 取消本次创建 + +#### ask_execute_method(数据库脚本已生成。请选择执行方式：) + +**Selection mode:** Single Select (branches based on the selected option) + +**Options:** +- **直接执行**: 使用 MySQL MCP 直接在数据库中执行脚本（推荐用于开发环境） +- **查看脚本**: 只生成脚本，手动执行（推荐用于生产环境） + +#### ask_frontend(是否需要创建前端代码？) + +**Selection mode:** Single Select (branches based on the selected option) + +**Options:** +- **是**: 创建前端页面和 API +- **否**: 跳过前端创建 + +### If/Else Node Details + +#### if_execute_choice(Binary Branch (True/False)) + +**Branch conditions:** +- **Direct Execute**: User selected direct execution +- **Show Script**: User selected to view script only + +**Execution method**: Evaluate the results of the previous processing and automatically select the appropriate branch based on the conditions above. diff --git a/.claude/commands/yudao-code-review-fix.md b/.claude/commands/yudao-code-review-fix.md new file mode 100644 index 0000000..59b2488 --- /dev/null +++ b/.claude/commands/yudao-code-review-fix.md @@ -0,0 +1,75 @@ +--- +description: yudao-code-review-fix +--- +```mermaid +flowchart TD + start_node_default([Start]) + prompt_input[请提供要审查的代码文件路径或Git diff信息。] + subagent_review[subagent-review] + switch_results{Switch:
Conditional Branch} + prompt_pass[代码审查已通过！🎉] + subagent_fix[subagent-fix] + end_pass([End]) + end_fix([End]) + + start_node_default --> prompt_input + prompt_input --> subagent_review + subagent_review --> switch_results + switch_results -->|全部通过| prompt_pass + switch_results -->|存在问题| subagent_fix + prompt_pass --> end_pass + subagent_fix --> end_fix +``` + +## Workflow Execution Guide + +Follow the Mermaid flowchart above to execute the workflow. Each node type has specific execution methods as described below. + +### Execution Methods by Node Type + +- **Rectangle nodes**: Execute Sub-Agents using the Task tool +- **Diamond nodes (AskUserQuestion:...)**: Use the AskUserQuestion tool to prompt the user and branch based on their response +- **Diamond nodes (Branch/Switch:...)**: Automatically branch based on the results of previous processing (see details section) +- **Rectangle nodes (Prompt nodes)**: Execute the prompts described in the details section below + +### Prompt Node Details + +#### prompt_input(请提供要审查的代码文件路径或Git diff信息。) + +``` +请提供要审查的代码文件路径或Git diff信息。 + +支持以下输入方式： +1. 单个文件路径（如：src/views/system/post/index.vue） +2. 目录路径（如：src/views/system/post/） +3. Git diff 输出 +4. 要审查的功能描述 + +请提供完整的信息以便进行代码审查。 +``` + +#### prompt_pass(代码审查已通过！🎉) + +``` +代码审查已通过！🎉 + +所有代码都符合 ruoyi-vue-pro (芋道) 开发规范。 + +审查通过的项目： +{请在此处列出通过的项目} + +这是对代码质量的肯定，请继续保持！ +``` + +### Switch Node Details + +#### switch_results(Multiple Branch (2-N)) + +**Evaluation Target**: 检查审查结果中是否存在不符合规范的问题 + +**Branch conditions:** +- **全部通过**: 没有发现任何不符合规范的问题 +- **存在问题**: 发现一个或多个不符合规范的问题 +- **default**: Other cases + +**Execution method**: Evaluate the results of the previous processing and automatically select the appropriate branch based on the conditions above. diff --git a/.claude/settings.json b/.claude/settings.json new file mode 100644 index 0000000..0766bf0 --- /dev/null +++ b/.claude/settings.json @@ -0,0 +1,9 @@ +{ + "enabledPlugins": { + "jvm-languages@claude-code-workflows": true, + "javascript-typescript@claude-code-workflows": true, + "backend-development@claude-code-workflows": true, + "database-design@claude-code-workflows": true, + "unit-testing@claude-code-workflows": true + } +} diff --git a/.cursor/mcp.json b/.cursor/mcp.json new file mode 100644 index 0000000..b87a0ef --- /dev/null +++ b/.cursor/mcp.json @@ -0,0 +1,20 @@ +{ + "mcpServers": { + "mcp-mysql-server": { + "type": "stdio", + "command": "npx", + "args": [ + "-y", + "@smithery/cli@latest", + "run", + "@f4ww4z/mcp-mysql-server" + ], + "env": { + "MYSQL_HOST": "192.168.10.130:3306", + "MYSQL_USER": "xlcp_dev", + "MYSQL_PASSWORD": "xlcp_dev", + "MYSQL_DATABASE": "xlcp_dev" + } + } + } +} \ No newline at end of file diff --git a/.cursor/rules/usecluade.mdc b/.cursor/rules/usecluade.mdc new file mode 100644 index 0000000..de7be1d --- /dev/null +++ b/.cursor/rules/usecluade.mdc @@ -0,0 +1,9 @@ +--- +name: usecluade +description: This is a new rule +--- + +# Overview + +Insert overview text here. The agent will only see this should they choose to apply the rule. +请使用CLAUDE.md中的规则来回答问题。 \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a343f9a --- /dev/null +++ b/.gitignore @@ -0,0 +1,113 @@ +# ========== General ========== +.DS_Store +Thumbs.db +*.swp +*.swo +*~ +.env +.env.local +.env.*.local +.vscode/ +.idea/ +*.iml +*.log +.history/ +codegen/ +.omc/ +.sisyphus/ + +# ========== Local verification artifacts ========== +test-results/ +tmp/ +bug-*-verification*.png +test-agent-fill-questionnaire.js +test-bug-*.js +verify_all_bugs.js + +# ========== Deploy ========== +deploy/xlcp-images/ +deploy/data/ +deploy/logs/ +deploy/*/target/ +deploy/*/dist/ + +# ========== Frontend (separate repo) ========== +frontend/ +node_modules/ +package-lock.json +package.json + +# ========== Java/Maven ========== +target/ +.mvn/ +.mvn.tgz +mvnw +mvnw.cmd +*.class +.project +.classpath +.settings/ +.gradle/ +build/ +!gradle/wrapper/gradle-wrapper.jar +!.gitignore +!.gitattributes +!.gitkeep +.apt_generated +spring-loaded.properties +jmx.properties +.flattened-pom.xml +generated/ +dist/ +dist-srpm/ +SRPMS/ +*.rpm +.deb +.deploy +.cdt/ +.cproject +.externalToolBuilders/ +.launch/ +launch/ +.rav +spring-*.xml +sts/.classpath +sts/.project +.sts4-build/ +*.apk +*.ap_ +*.dex +*.dex +*.class +/bin/ +/gen/ +/generated/ +/build/ +/captures/ +.externalNativeBuild/ +.cxx/ +*.pyc +*.pyo +*.pdb +*.pem +*.keystore +.jks +*.bks +*.rks +hs_err_pid* +replay_pid* + +# ========== Node.js/Vue ========== +dist/ +dist-ssr +*.local +pnpm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-store/ +.eslintcache +.stylelintcache +coverage/ +.nyc_output/ +*.tsbuildinfo +vite.config.ts.timestamp-* diff --git a/.mcp.json b/.mcp.json new file mode 100644 index 0000000..b3a2551 --- /dev/null +++ b/.mcp.json @@ -0,0 +1,13 @@ +{ + "mcpServers": { + "filesystem": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-filesystem", + "/Volumes/Dpan/github/xlcp" + ] + } + + } +} \ No newline at end of file diff --git a/.playwright-mcp/06-登录页完整版.png b/.playwright-mcp/06-登录页完整版.png new file mode 100644 index 0000000..d053e13 Binary files /dev/null and b/.playwright-mcp/06-登录页完整版.png differ diff --git a/.playwright-mcp/07-监管看板.png b/.playwright-mcp/07-监管看板.png new file mode 100644 index 0000000..b037214 Binary files /dev/null and b/.playwright-mcp/07-监管看板.png differ diff --git a/.playwright-mcp/08-综合管理-评估报告.png b/.playwright-mcp/08-综合管理-评估报告.png new file mode 100644 index 0000000..7e88dfa Binary files /dev/null and b/.playwright-mcp/08-综合管理-评估报告.png differ diff --git a/.playwright-mcp/09-测评管理-测评问卷.png b/.playwright-mcp/09-测评管理-测评问卷.png new file mode 100644 index 0000000..b066703 Binary files /dev/null and b/.playwright-mcp/09-测评管理-测评问卷.png differ diff --git a/.playwright-mcp/10-数据中心-狱政信息.png b/.playwright-mcp/10-数据中心-狱政信息.png new file mode 100644 index 0000000..066a045 Binary files /dev/null and b/.playwright-mcp/10-数据中心-狱政信息.png differ diff --git a/.playwright-mcp/11-数据中心-狱情平台.png b/.playwright-mcp/11-数据中心-狱情平台.png new file mode 100644 index 0000000..8ca0976 Binary files /dev/null and b/.playwright-mcp/11-数据中心-狱情平台.png differ diff --git a/.playwright-mcp/12-数据中心-危评系统.png b/.playwright-mcp/12-数据中心-危评系统.png new file mode 100644 index 0000000..321f941 Binary files /dev/null and b/.playwright-mcp/12-数据中心-危评系统.png differ diff --git a/.playwright-mcp/13-数据中心-消费系统.png b/.playwright-mcp/13-数据中心-消费系统.png new file mode 100644 index 0000000..b1ea849 Binary files /dev/null and b/.playwright-mcp/13-数据中心-消费系统.png differ diff --git a/.playwright-mcp/14-系统管理-租户管理.png b/.playwright-mcp/14-系统管理-租户管理.png new file mode 100644 index 0000000..c4451b2 Binary files /dev/null and b/.playwright-mcp/14-系统管理-租户管理.png differ diff --git a/.playwright-mcp/15-系统管理-部门管理.png b/.playwright-mcp/15-系统管理-部门管理.png new file mode 100644 index 0000000..6ad44e4 Binary files /dev/null and b/.playwright-mcp/15-系统管理-部门管理.png differ diff --git a/.playwright-mcp/16-系统管理-用户管理.png b/.playwright-mcp/16-系统管理-用户管理.png new file mode 100644 index 0000000..87c7036 Binary files /dev/null and b/.playwright-mcp/16-系统管理-用户管理.png differ diff --git a/.playwright-mcp/17-数据中心-数据汇总.png b/.playwright-mcp/17-数据中心-数据汇总.png new file mode 100644 index 0000000..13cf929 Binary files /dev/null and b/.playwright-mcp/17-数据中心-数据汇总.png differ diff --git a/.playwright-mcp/18-数据中心-计分考核.png b/.playwright-mcp/18-数据中心-计分考核.png new file mode 100644 index 0000000..26a7225 Binary files /dev/null and b/.playwright-mcp/18-数据中心-计分考核.png differ diff --git a/.playwright-mcp/测评问卷-编辑.png b/.playwright-mcp/测评问卷-编辑.png new file mode 100644 index 0000000..25175a7 Binary files /dev/null and b/.playwright-mcp/测评问卷-编辑.png differ diff --git a/.playwright-mcp/测评问卷-预览.png b/.playwright-mcp/测评问卷-预览.png new file mode 100644 index 0000000..ce0f489 Binary files /dev/null and b/.playwright-mcp/测评问卷-预览.png differ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..e6d3718 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,154 @@ +# AGENTS.md + +This file provides guidance for AI agents working on the XL Prison Management System codebase. + +## Project Overview + +XL监狱综合管理平台 - A prison management platform built on the Yudao (芋道) framework. + +**Tech Stack**: Java 17, Spring Boot 3.5.9, MyBatis-Plus, Vue 3.5.12, TypeScript 5.3.3, Element Plus, MySQL 8.0+ + +## Essential Commands + +### Backend (Maven) +```bash +# Build all modules +cd backend && mvn clean install -DskipTests + +# Build prison module only +cd backend/yudao-module-prison && mvn clean package + +# Run dev server (port 48080) +cd backend/yudao-server && mvn spring-boot:run + +# Run all tests +cd backend/yudao-module-prison && mvn test + +# Run single test class +mvn test -Dtest=PrisonAreaControllerTest + +# Force update dependencies +mvn clean install -U +``` + +### Frontend (pnpm) +```bash +cd frontend + +# Install dependencies +pnpm install + +# Dev server (local mode) +pnpm dev + +# TypeScript checking +pnpm ts:check + +# Build for different environments +pnpm build:local # Uses .env.local +pnpm build:dev # Uses .env.dev +pnpm build:prod # Uses .env.prod + +# Linting +pnpm lint:eslint # ESLint check & fix (.js,.ts,.vue) +pnpm lint:format # Prettier format +pnpm lint:style # Stylelint fix +``` + +### Quick Start with Make +```bash +make frontend # Start frontend dev server +make backend # Start backend dev server +make run # Start both +``` + +## Code Style Guidelines + +### Java (Backend) + +**Imports**: Grouped by: Spring → Yudao → Third-party → Java stdlib. No wildcard imports. + +**Naming Conventions**: +- Classes: PascalCase (e.g., `PrisonAreaController`, `ScoreDO`) +- Variables/Methods: camelCase (e.g., `getPage()`, `updateTime`) +- Constants: UPPER_SNAKE_CASE (e.g., `DEFAULT_PAGE_SIZE`) +- Package: `cn.iocoder.yudao.module.prison.{module}` + +**VO Naming**: `SaveReqVO`, `PageReqVO`, `RespVO` suffixes required. + +**Annotations**: Place on separate lines. Order: `@RestController` → `@RequestMapping` → `@Tag` → `@PreAuthorize`. + +**Error Handling**: Use `CommonResult` return type. Throw `ServiceException` for business errors with error codes from `ErrorCodeConstants`. + +**Comments**: No comments unless explaining complex business logic. Javadoc only on public APIs. + +### TypeScript/Vue (Frontend) + +**Imports**: Sorted alphabetically. No unused imports. Use absolute imports (`@/`). + +**Naming**: +- Interfaces: PascalCase (e.g., `Area`, `QuestionnaireRecord`) +- Variables/Props: camelCase +- Components: PascalCase file names, kebab-case usage + +**Types**: Avoid `any`. Use explicit types or `unknown` for union types. + +**Vue Composition API**: Use ` + + +``` + +### 4.4 主页面 + +```vue + + + + + + +``` + +### 4.5 地图资源配置 + +```typescript +// frontend/src/plugins/echarts.ts +import * as echarts from 'echarts' +import chinaJson from 'echarts/map/json/china.json' + +// 注册中国地图 +echarts.registerMap('china', chinaJson) + +export { echarts } +``` + +> **注意**：需要下载中国地图 JSON 文件到 `frontend/public/china.json` +> 下载地址：https://echarts.apache.org/examples/zh/data/asset/geo/china.json + +### 4.6 路由配置 + +```typescript +// frontend/src/router/routes/modules/prison.ts + +{ + path: 'dashboard', + name: 'PrisonDashboard', + component: () => import('@/views/prison/dashboard/index.vue'), + meta: { + title: '监管看板', + icon: 'ep:data-board', + permission: 'prison:dashboard:query' + } +} +``` + +--- + +## 五、任务分解 + +### 5.1 后端任务 + +> **说明**：使用现有表，无需新建移交记录表 + +| 序号 | 任务 | 负责人 | 预计工时 | 状态 | +|------|------|--------|---------|------| +| 1 | 新增数据库索引 SQL（3个索引） | | 0.5h | 待开发 | +| 2 | 菜单权限 SQL | | 0.5h | 待开发 | +| 3 | VO 类开发（4个文件） | | 1h | 待开发 | +| 4 | PrisonDashboardMapper 接口 | | 1h | 待开发 | +| 5 | PrisonDashboardService 接口和实现 | | 1h | 待开发 | +| 6 | PrisonDashboardController | | 0.5h | 待开发 | +| 7 | DataMaskUtils 工具类 | | 0.5h | 待开发 | +| 8 | 接口测试 | | 1h | 待开发 | + +### 5.2 前端任务 + +| 序号 | 任务 | 负责人 | 预计工时 | 状态 | +|------|------|--------|---------|------| +| 1 | 下载并配置中国地图 JSON | | 0.5h | 待开发 | +| 2 | API 接口定义 | | 0.5h | 待开发 | +| 3 | StatCard 组件 | | 1h | 待开发 | +| 4 | ChinaMap 组件 | | 2h | 待开发 | +| 5 | 主页面开发 | | 2h | 待开发 | +| 6 | 路由配置 | | 0.5h | 待开发 | +| 7 | 联调测试 | | 2h | 待开发 | + +--- + +## 六、验收标准 + +### 6.1 功能验收 + +- [ ] 核心指标卡片数据与数据库一致 +- [ ] 年龄分布饼图按要求分段显示 +- [ ] 刑期分布饼图按要求分段显示 +- [ ] 文化程度饼图按要求分类显示 +- [ ] 中国地图正确显示各省热力分布 +- [ ] 点击地图省份显示详细信息 +- [ ] 响应式布局在各种屏幕尺寸下正常显示 +- [ ] 数据加载时显示骨架屏 + +### 6.2 性能验收 + +- [ ] 页面加载时间 < 3秒 +- [ ] 图表渲染时间 < 1秒 +- [ ] 支持多用户并发访问 + +### 6.3 安全验收 + +- [ ] 敏感信息已配置脱敏规则 +- [ ] 数据权限控制生效（按监区） + +--- + +## 七、联调步骤 + +### 7.1 后端启动 +```bash +cd backend/yudao-module-prison +mvn clean package -DskipTests +cd ../yudao-server +mvn spring-boot:run +``` + +### 7.2 前端启动 +```bash +cd frontend +pnpm dev +``` + +### 7.3 测试数据 +```sql +-- 确保有以下测试数据 +-- 1. 罪犯表有在押状态数据 +-- 2. 释放记录表有本月数据 +-- 3. 监区表有医院(5)和禁闭室(6)类型数据 +``` + +--- + +## 八、风险与应对 + +| 风险 | 等级 | 应对措施 | +|------|------|----------| +| 移交记录表缺失 | 高 | 优先完成数据库设计 | +| 地图 JSON 资源 | 中 | 提前下载或使用 CDN | +| 数据权限复杂性 | 中 | 先实现基础版本，再迭代 | +| 性能问题 | 低 | 添加 Redis 缓存 | + +--- + +## 九、依赖项 + +### 9.1 前置依赖 +- [ ] 罪犯信息管理模块（数据来源） +- [ ] 释放记录模块（数据来源） +- [ ] 监区管理模块（数据来源） + +### 9.2 外部依赖 +- [ ] ECharts 地图 JSON 文件 + +--- + +**文档版本**：v1.0 +**创建日期**：2026-01-14 +**评审人**：前端架构师、后端架构师 diff --git a/requirements/实施文档-计分考核-前端.md b/requirements/实施文档-计分考核-前端.md new file mode 100644 index 0000000..08f4f5a --- /dev/null +++ b/requirements/实施文档-计分考核-前端.md @@ -0,0 +1,1639 @@ +# 计分考核模块 - 前端实施文档 + +> 版本：v1.0 +> 创建日期：2026-01-14 +> 优先级：P0 + +--- + +## 一、概述 + +### 1.1 文档说明 +本文档为计分考核模块的前端实施指南，基于需求文档「需求-03-计分考核.md」和后端实施文档编写。 + +### 1.2 前端文件结构 + +``` +frontend/src/ +├── views/prison/score/ +│ ├── subject/ # 考核规则配置 +│ │ ├── index.vue # 列表页 +│ │ └── SubjectForm.vue # 新增/编辑表单 +│ ├── record/ # 日常考核记录 +│ │ ├── index.vue # 列表页 +│ │ └── RecordForm.vue # 新增/编辑表单（含批量录入） +│ ├── monthly/ # 月度考核汇总 +│ │ ├── index.vue # 列表页 +│ │ └── MonthlyDetail.vue # 月度明细 +│ ├── level/ # 等级规则配置 +│ │ └── index.vue # 配置页 +│ ├── notice/ # 考核公示 +│ │ ├── index.vue # 列表页 +│ │ └── NoticeForm.vue # 新增/编辑/发布表单 +│ └── parole/ # 减刑假释数据 +│ └── index.vue # 数据提取页 +│ +└── api/prison/score/ + ├── subject.ts # 考核规则API + ├── record.ts # 日常记录API + ├── monthly.ts # 月度汇总API + ├── level.ts # 等级规则API + ├── notice.ts # 公示公告API + └── parole.ts # 减刑假释API +``` + +--- + +## 二、API接口定义 + +### 2.1 考核规则科目API（subject.ts） + +```typescript +import { request } from '@/config/axios' +import type { PageData, PageResult } from '@/types' + +/** 考核规则科目接口 */ +export interface ScoreSubject { + id: number + code: string + name: string + category: number + categoryName: string + score: number + dailyLimit: number + monthlyLimit: number + description: string + status: number + statusName: string + sort: number + createTime: string +} + +/** 查询参数 */ +export interface ScoreSubjectQuery extends PageData { + code?: string + name?: string + category?: number + status?: number +} + +/** 保存参数 */ +export interface ScoreSubjectSaveParams { + id?: number + code: string + name: string + category: number + score: number + dailyLimit?: number + monthlyLimit?: number + description?: string + status?: number + sort?: number +} + +/** 考核类别选项 */ +export const CATEGORY_OPTIONS = [ + { value: 1, label: '劳动改造' }, + { value: 2, label: '教育改造' }, + { value: 3, label: '日常行为' }, + { value: 4, label: '卫生纪律' }, + { value: 5, label: '加分项' }, + { value: 6, label: '扣分项' } +] + +export const ScoreSubjectApi = { + /** 分页查询 */ + getPage: async (params: ScoreSubjectQuery) => { + return await request.get({ url: '/score/subject/page', params }) + }, + + /** 获取详情 */ + get: async (id: number) => { + return await request.get({ url: `/score/subject/get?id=${id}` }) + }, + + /** 获取列表（无分页） */ + getList: async (params?: Omit) => { + return await request.get({ url: '/score/subject/list', params }) + }, + + /** 创建 */ + create: async (data: ScoreSubjectSaveParams) => { + return await request.post({ url: '/score/subject/create', data }) + }, + + /** 更新 */ + update: async (data: ScoreSubjectSaveParams) => { + return await request.put({ url: '/score/subject/update', data }) + }, + + /** 删除 */ + delete: async (id: number) => { + return await request.delete({ url: `/score/subject/delete?id=${id}` }) + }, + + /** 批量删除 */ + deleteList: async (ids: number[]) => { + return await request.delete({ url: `/score/subject/delete-list?ids=${ids.join(',')}` }) + }, + + /** 更新状态 */ + updateStatus: async (id: number, status: number) => { + return await request.put({ url: '/score/subject/update-status', params: { id, status } }) + }, + + /** 导出Excel */ + export: async (params: ScoreSubjectQuery) => { + return await request.download({ url: '/score/subject/export-excel', params }) + } +} +``` + +### 2.2 日常考核记录API（record.ts） + +```typescript +import { request } from '@/config/axios' +import type { PageData, PageResult } from '@/types' + +/** 日常考核记录接口 */ +export interface ScoreRecord { + id: number + prisonerId: number + prisonerNo: string + prisonerName: string + prisonAreaId: number + prisonAreaName: string + recordDate: string + subjectId: number + subjectName: string + category: number + categoryName: string + score: number + actualScore: number + remark: string + recorderId: number + recorderName: string + createTime: string +} + +/** 查询参数 */ +export interface ScoreRecordQuery extends PageData { + prisonerNo?: string + prisonerName?: string + recordDate?: string + recordDateRange?: string[] + category?: number + subjectId?: number + prisonAreaId?: number +} + +/** 保存参数 */ +export interface ScoreRecordSaveParams { + id?: number + prisonerId: number + recordDate: string + subjectId: number + score: number + remark?: string +} + +/** 批量创建参数 */ +export interface ScoreRecordBatchParams { + recordDate: string + prisonerIds: number[] + subjectId: number + score: number + remark?: string +} + +export const ScoreRecordApi = { + /** 分页查询 */ + getPage: async (params: ScoreRecordQuery) => { + return await request.get({ url: '/score/record/page', params }) + }, + + /** 获取详情 */ + get: async (id: number) => { + return await request.get({ url: `/score/record/get?id=${id}` }) + }, + + /** 获取罪犯考核明细 */ + getByPrisoner: async (prisonerId: number, year?: number, month?: number) => { + return await request.get({ url: '/score/record/get-by-prisoner', params: { prisonerId, year, month } }) + }, + + /** 创建 */ + create: async (data: ScoreRecordSaveParams) => { + return await request.post({ url: '/score/record/create', data }) + }, + + /** 批量创建 */ + batchCreate: async (data: ScoreRecordBatchParams) => { + return await request.post({ url: '/score/record/batch-create', data }) + }, + + /** 更新 */ + update: async (data: ScoreRecordSaveParams) => { + return await request.put({ url: '/score/record/update', data }) + }, + + /** 删除 */ + delete: async (id: number) => { + return await request.delete({ url: `/score/record/delete?id=${id}` }) + }, + + /** 导出Excel */ + export: async (params: ScoreRecordQuery) => { + return await request.download({ url: '/score/record/export-excel', params }) + } +} +``` + +### 2.3 月度考核汇总API（monthly.ts） + +```typescript +import { request } from '@/config/axios' +import type { PageData } from '@/types' + +/** 月度考核汇总接口 */ +export interface ScoreMonthly { + id: number + prisonerId: number + prisonerNo: string + prisonerName: string + prisonAreaId: number + prisonAreaName: string + year: number + month: number + baseScore: number + rewardScore: number + penaltyScore: number + totalScore: number + level: number + levelName: string + assessorId: number + assessorName: string + status: number + statusName: string + remark: string + createTime: string +} + +/** 查询参数 */ +export interface ScoreMonthlyQuery extends PageData { + prisonerNo?: string + prisonerName?: string + year: number + month?: number + level?: number + status?: number + prisonAreaId?: number +} + +/** 月度汇总明细 */ +export interface ScoreMonthlyDetail { + monthly: ScoreMonthly + records: ScoreRecord[] +} + +/** 减刑假释数据 */ +export interface ScoreParoleData { + prisonerId: number + prisonerNo: string + prisonerName: string + monthlyScores: Array<{ + year: number + month: number + totalScore: number + level: number + levelName: string + }> + yearlyTotalScore: number + praiseCount: number + warningCount: number + suggestion: { + canApplyReduction: boolean + suggestedReductionMonths: number + canApplyParole: boolean + paroleOpinion: string + } +} + +export const ScoreMonthlyApi = { + /** 分页查询 */ + getPage: async (params: ScoreMonthlyQuery) => { + return await request.get({ url: '/score/monthly/page', params }) + }, + + /** 获取汇总详情 */ + getSummary: async (id: number) => { + return await request.get({ url: `/score/monthly/get-summary?id=${id}` }) + }, + + /** 获取月度汇总明细 */ + getDetail: async (id: number) => { + return await request.get({ url: `/score/monthly/get-detail?id=${id}` }) + }, + + /** 手动触发月度汇总计算 */ + calculate: async (year: number, month: number) => { + return await request.post({ url: '/score/monthly/calculate', params: { year, month } }) + }, + + /** 提交审核 */ + submitAudit: async (id: number) => { + return await request.post({ url: '/score/monthly/submit-audit', params: { id } }) + }, + + /** 审核通过 */ + auditPass: async (id: number, remark?: string) => { + return await request.post({ url: '/score/monthly/audit', params: { id, status: 2, remark } }) + }, + + /** 审核驳回 */ + auditReject: async (id: number, remark: string) => { + return await request.post({ url: '/score/monthly/audit', params: { id, status: 3, remark } }) + }, + + /** 导出Excel */ + export: async (params: ScoreMonthlyQuery) => { + return await request.download({ url: '/score/monthly/export-excel', params }) + }, + + /** 获取减刑假释数据 */ + getParoleData: async (prisonerId: number) => { + return await request.get({ url: '/score/parole/get-data', params: { prisonerId } }) + }, + + /** 生成减刑假释建议 */ + generateSuggestion: async (prisonerId: number) => { + return await request.post({ url: '/score/parole/generate-suggestion', params: { prisonerId } }) + } +} +``` + +### 2.4 等级规则API（level.ts） + +```typescript +import { request } from '@/config/axios' + +/** 等级规则接口 */ +export interface ScoreLevelRule { + id: number + level: number + levelName: string + minScore: number + maxScore: number + description: string + sort: number + status: number +} + +/** 基础分配置 */ +export interface BaseScoreConfig { + baseScore: number +} + +export const ScoreLevelApi = { + /** 获取等级规则列表 */ + getList: async () => { + return await request.get({ url: '/score/level/get' }) + }, + + /** 更新等级规则 */ + update: async (data: ScoreLevelRule[]) => { + return await request.put({ url: '/score/level/update', data }) + }, + + /** 获取基础分配置 */ + getBaseScore: async () => { + return await request.get({ url: '/score/level/get-base-score' }) + }, + + /** 更新基础分配置 */ + updateBaseScore: async (baseScore: number) => { + return await request.put({ url: '/score/level/update-base-score', params: { baseScore } }) + } +} +``` + +### 2.5 公示公告API（notice.ts） + +```typescript +import { request } from '@/config/axios' +import type { PageData } from '@/types' + +/** 公示公告接口 */ +export interface ScoreNotice { + id: number + title: string + noticeType: number + noticeTypeName: string + startDate: string + endDate: string + scopeType: number + scopeTypeName: string + scopePrisonAreaIds: string + scopePrisonAreaNames: string + content: string + status: number + statusName: string + publisherId: number + publisherName: string + publishTime: string + createTime: string +} + +/** 查询参数 */ +export interface ScoreNoticeQuery extends PageData { + title?: string + noticeType?: number + status?: number + startDate?: string + endDate?: string +} + +/** 保存参数 */ +export interface ScoreNoticeSaveParams { + id?: number + title: string + noticeType: number + startDate: string + endDate: string + scopeType: number + scopePrisonAreaIds?: string + content?: string +} + +export const ScoreNoticeApi = { + /** 分页查询 */ + getPage: async (params: ScoreNoticeQuery) => { + return await request.get({ url: '/score/notice/page', params }) + }, + + /** 获取详情 */ + get: async (id: number) => { + return await request.get({ url: `/score/notice/get?id=${id}` }) + }, + + /** 创建 */ + create: async (data: ScoreNoticeSaveParams) => { + return await request.post({ url: '/score/notice/create', data }) + }, + + /** 更新 */ + update: async (data: ScoreNoticeSaveParams) => { + return await request.put({ url: '/score/notice/update', data }) + }, + + /** 发布 */ + publish: async (id: number) => { + return await request.put({ url: `/score/notice/publish?id=${id}` }) + }, + + /** 撤回 */ + withdraw: async (id: number) => { + return await request.put({ url: `/score/notice/withdraw?id=${id}` }) + }, + + /** 删除 */ + delete: async (id: number) => { + return await request.delete({ url: `/score/notice/delete?id=${id}` }) + } +} +``` + +--- + +## 三、页面组件设计 + +### 3.1 考核规则配置页面（subject/index.vue） + +```vue + + + +``` + +### 3.2 考核规则表单组件（subject/SubjectForm.vue） + +```vue + + + +``` + +### 3.3 日常考核记录页面（record/index.vue） + +```vue + + + +``` + +### 3.4 批量录入表单组件（record/BatchRecordForm.vue） + +```vue + + + +``` + +### 3.5 月度考核汇总页面（monthly/index.vue） + +```vue + + + + + +``` + +### 3.6 月度明细组件（monthly/MonthlyDetail.vue） + +```vue + + + +``` + +--- + +## 四、路由配置 + +```typescript +// router/routes/modules/prison.ts + +{ + path: '/prison/score', + component: Layout, + redirect: '/prison/score/subject', + name: 'PrisonScore', + meta: { + title: '计分考核', + icon: 'score', + alwaysShow: true + }, + children: [ + { + path: 'subject', + component: () => import('@/views/prison/score/subject/index.vue'), + name: 'PrisonScoreSubject', + meta: { + title: '考核规则配置', + icon: 'list', + permissions: ['prison:score:subject:query'] + } + }, + { + path: 'record', + component: () => import('@/views/prison/score/record/index.vue'), + name: 'PrisonScoreRecord', + meta: { + title: '日常考核记录', + icon: 'edit', + permissions: ['prison:score:record:query'] + } + }, + { + path: 'monthly', + component: () => import('@/views/prison/score/monthly/index.vue'), + name: 'PrisonScoreMonthly', + meta: { + title: '月度考核汇总', + icon: 'date', + permissions: ['prison:score:monthly:query'] + } + }, + { + path: 'level', + component: () => import('@/views/prison/score/level/index.vue'), + name: 'PrisonScoreLevel', + meta: { + title: '等级规则配置', + icon: 'setting', + permissions: ['prison:score:level:query'] + } + }, + { + path: 'notice', + component: () => import('@/views/prison/score/notice/index.vue'), + name: 'PrisonScoreNotice', + meta: { + title: '考核公示', + icon: 'notification', + permissions: ['prison:score:notice:query'] + } + }, + { + path: 'parole', + component: () => import('@/views/prison/score/parole/index.vue'), + name: 'PrisonScoreParole', + meta: { + title: '减刑假释数据', + icon: 'document', + permissions: ['prison:score:parole:query'] + } + } + ] +} +``` + +--- + +## 五、菜单权限SQL + +```sql +-- 计分考核模块菜单权限 + +-- 1. 考核规则配置 +INSERT INTO system_menu (name, permission, type, sort, parent_id, path, icon, component) VALUES +('考核规则配置', '', 2, 1, (SELECT id FROM system_menu WHERE name = '计分考核'), 'subject', 'list', 'prison/score/subject/index'); + +-- 2. 日常考核记录 +INSERT INTO system_menu (name, permission, type, sort, parent_id, path, icon, component) VALUES +('日常考核记录', '', 2, 2, (SELECT id FROM system_menu WHERE name = '计分考核'), 'record', 'edit', 'prison/score/record/index'); + +-- 3. 月度考核汇总 +INSERT INTO system_menu (name, permission, type, sort, parent_id, path, icon, component) VALUES +('月度考核汇总', '', 2, 3, (SELECT id FROM system_menu WHERE name = '计分考核'), 'monthly', 'date', 'prison/score/monthly/index'); + +-- 4. 等级规则配置 +INSERT INTO system_menu (name, permission, type, sort, parent_id, path, icon, component) VALUES +('等级规则配置', '', 2, 4, (SELECT id FROM system_menu WHERE name = '计分考核'), 'level', 'setting', 'prison/score/level/index'); + +-- 5. 考核公示 +INSERT INTO system_menu (name, permission, type, sort, parent_id, path, icon, component) VALUES +('考核公示', '', 2, 5, (SELECT id FROM system_menu WHERE name = '计分考核'), 'notice', 'notification', 'prison/score/notice/index'); + +-- 6. 减刑假释数据 +INSERT INTO system_menu (name, permission, type, sort, parent_id, path, icon, component) VALUES +('减刑假释数据', '', 2, 6, (SELECT id FROM system_menu WHERE name = '计分考核'), 'parole', 'document', 'prison/score/parole/index'); +``` + +--- + +## 六、验收标准 + +- [ ] 考核规则配置页面：支持规则的增删改查、状态切换 +- [ ] 日常考核记录页面：支持单条录入和批量录入 +- [ ] 月度考核汇总页面：支持月度统计展示、明细查看 +- [ ] 等级规则配置页面：支持等级标准和基础分配置 +- [ ] 考核公示页面：支持公示的发布和撤回 +- [ ] 减刑假释数据页面：支持考核数据提取和展示 +- [ ] 所有页面通过TypeScript类型检查 +- [ ] 所有页面响应式适配 diff --git a/requirements/实施文档-计分考核-后端.md b/requirements/实施文档-计分考核-后端.md new file mode 100644 index 0000000..799e505 --- /dev/null +++ b/requirements/实施文档-计分考核-后端.md @@ -0,0 +1,657 @@ +# 计分考核模块 - 后端实施文档 + +> 版本：v1.0 +> 创建日期：2026-01-14 +> 优先级：P0 + +--- + +## 一、概述 + +### 1.1 文档说明 +本文档为计分考核模块的后端实施指南，基于需求文档「需求-03-计分考核.md」编写。 + +### 1.2 现有模块状态 +- **已有**：基础的月度考核汇总表（prison_score）和CRUD接口 +- **缺失**：考核规则配置、日常考核记录、自动计算、等级评定、公示功能 + +### 1.3 新增数据表规划 + +| 序号 | 表名 | 说明 | 优先级 | +|-----|-----|------|-------| +| 1 | `prison_score_subject` | 考核规则科目表 | P0 | +| 2 | `prison_score_record` | 日常考核记录表 | P0 | +| 3 | `prison_score_level_rule` | 考核等级评定规则表 | P0 | +| 4 | `prison_score_notice` | 考核公示公告表 | P1 | + +--- + +## 二、数据库设计 + +### 2.1 考核规则科目表 (prison_score_subject) + +```sql +CREATE TABLE `prison_score_subject` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '规则ID', + `code` varchar(50) NOT NULL COMMENT '规则编码（唯一）', + `name` varchar(100) NOT NULL COMMENT '规则名称', + `category` tinyint NOT NULL COMMENT '考核类别：1-劳动改造 2-教育改造 3-日常行为 4-卫生纪律 5-加分项 6-扣分项', + `score` decimal(10,2) NOT NULL COMMENT '分值（正数为加分，负数为扣分）', + `daily_limit` decimal(10,2) NOT NULL DEFAULT 0 COMMENT '日最高分限制', + `monthly_limit` decimal(10,2) NOT NULL DEFAULT 0 COMMENT '月最高分限制', + `description` varchar(500) DEFAULT NULL COMMENT '规则说明', + `status` tinyint NOT NULL DEFAULT 1 COMMENT '状态：1-启用 2-禁用', + `sort` int NOT NULL DEFAULT 0 COMMENT '排序', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + UNIQUE KEY `uk_code` (`code`), + KEY `idx_category` (`category`), + KEY `idx_status` (`status`) +) ENGINE=InnoDB COMMENT='考核规则科目表'; +``` + +**枚举定义**： +```java +/** + * 考核类别枚举 + */ +public enum ScoreSubjectCategoryEnum { + LABOR(1, "劳动改造"), + EDUCATION(2, "教育改造"), + DAILY_BEHAVIOR(3, "日常行为"), + HYGIENE_DISCIPLINE(4, "卫生纪律"), + BONUS(5, "加分项"), + PENALTY(6, "扣分项"); + + private final Integer value; + private final String name; +} + +/** + * 状态枚举 + */ +public enum ScoreSubjectStatusEnum { + ENABLED(1, "启用"), + DISABLED(2, "禁用"); +} +``` + +### 2.2 日常考核记录表 (prison_score_record) + +```sql +CREATE TABLE `prison_score_record` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '记录ID', + `prisoner_id` bigint NOT NULL COMMENT '罪犯ID', + `prisoner_no` varchar(50) NOT NULL COMMENT '罪犯编号', + `record_date` date NOT NULL COMMENT '考核日期', + `subject_id` bigint NOT NULL COMMENT '考核规则ID', + `subject_name` varchar(100) NOT NULL COMMENT '规则名称', + `category` tinyint NOT NULL COMMENT '考核类别', + `score` decimal(10,2) NOT NULL COMMENT '得分', + `actual_score` decimal(10,2) NOT NULL COMMENT '实际得分（日限月限校验后）', + `remark` varchar(500) DEFAULT NULL COMMENT '备注说明', + `recorder_id` bigint NOT NULL COMMENT '记录人ID', + `recorder_name` varchar(50) NOT NULL COMMENT '记录人姓名', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + KEY `idx_prisoner_date` (`prisoner_no`, `record_date`), + KEY `idx_record_date` (`record_date`), + KEY `idx_subject` (`subject_id`) +) ENGINE=InnoDB COMMENT='日常考核记录表'; +``` + +### 2.3 考核等级评定规则表 (prison_score_level_rule) + +```sql +CREATE TABLE `prison_score_level_rule` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '规则ID', + `level` tinyint NOT NULL COMMENT '等级：1-优秀 2-良好 3-合格 4-不合格', + `level_name` varchar(20) NOT NULL COMMENT '等级名称', + `min_score` decimal(10,2) NOT NULL COMMENT '最低分（含）', + `max_score` decimal(10,2) NOT NULL COMMENT '最高分（含）', + `description` varchar(500) DEFAULT NULL COMMENT '说明', + `sort` int NOT NULL DEFAULT 0 COMMENT '排序', + `status` tinyint NOT NULL DEFAULT 1 COMMENT '状态：1-启用 2-禁用', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + UNIQUE KEY `uk_level` (`level`), + KEY `idx_min_score` (`min_score`) +) ENGINE=InnoDB COMMENT='考核等级评定规则表'; +``` + +**默认数据**： +```sql +INSERT INTO `prison_score_level_rule` (`level`, `level_name`, `min_score`, `max_score`, `description`, `sort`, `status`) VALUES +(1, '优秀', 120.00, 9999.99, '表现突出', 1, 1), +(2, '良好', 100.00, 119.99, '表现良好', 2, 1), +(3, '合格', 80.00, 99.99, '表现一般', 3, 1), +(4, '不合格', 0.00, 79.99, '表现较差', 4, 1); +``` + +### 2.4 考核公示公告表 (prison_score_notice) + +```sql +CREATE TABLE `prison_score_notice` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '公告ID', + `title` varchar(200) NOT NULL COMMENT '公告标题', + `notice_type` tinyint NOT NULL DEFAULT 1 COMMENT '公示类型：1-月度考核结果 2-专项考核', + `start_date` date NOT NULL COMMENT '公示开始日期', + `end_date` date NOT NULL COMMENT '公示结束日期', + `scope_type` tinyint NOT NULL DEFAULT 1 COMMENT '公示范围：1-全狱 2-指定监区', + `scope_prison_area_ids` varchar(500) DEFAULT NULL COMMENT '指定监区ID列表', + `content` text COMMENT '公示内容', + `status` tinyint NOT NULL DEFAULT 1 COMMENT '状态：1-草稿 2-已发布 3-已撤回', + `publisher_id` bigint DEFAULT NULL COMMENT '发布人ID', + `publisher_name` varchar(50) DEFAULT NULL COMMENT '发布人姓名', + `publish_time` datetime DEFAULT NULL COMMENT '发布时间', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + KEY `idx_status` (`status`), + KEY `idx_publish_time` (`publish_time`) +) ENGINE=InnoDB COMMENT='考核公示公告表'; +``` + +--- + +## 三、后端接口设计 + +### 3.1 考核规则科目接口 + +**Controller路径**：`controller/admin/score/subject/` + +| 方法 | 端点 | 权限 | 说明 | +|-----|-----|-----|------| +| POST | `/prison/score/subject/create` | prison:score:subject:create | 创建规则 | +| PUT | `/prison/score/subject/update` | prison:score:subject:update | 更新规则 | +| DELETE | `/prison/score/subject/delete` | prison:score:subject:delete | 删除规则 | +| GET | `/prison/score/subject/get` | prison:score:subject:query | 获取详情 | +| GET | `/prison/score/subject/page` | prison:score:subject:query | 分页查询 | +| GET | `/prison/score/subject/list` | prison:score:subject:query | 列表查询（无分页） | +| PUT | `/prison/score/subject/update-status` | prison:score:subject:update | 更新状态 | +| GET | `/prison/score/subject/export-excel` | prison:score:subject:export | 导出Excel | + +**VO对象**： +```java +// ScoreSubjectSaveReqVO.java +public class ScoreSubjectSaveReqVO { + @ApiModelProperty(value = "规则编码", required = true, example = "RULE001") + @NotBlank(message = "规则编码不能为空") + private String code; + + @ApiModelProperty(value = "规则名称", required = true, example = "超额完成生产任务") + @NotBlank(message = "规则名称不能为空") + private String name; + + @ApiModelProperty(value = "考核类别", required = true, example = "1", notes = "1-劳动改造 2-教育改造 3-日常行为 4-卫生纪律 5-加分项 6-扣分项") + @NotNull(message = "考核类别不能为空") + private Integer category; + + @ApiModelProperty(value = "分值", required = true, example = "2.00") + @NotNull(message = "分值不能为空") + private BigDecimal score; + + @ApiModelProperty(value = "日最高分限制", example = "5.00") + private BigDecimal dailyLimit; + + @ApiModelProperty(value = "月最高分限制", example = "30.00") + private BigDecimal monthlyLimit; + + @ApiModelProperty(value = "规则说明", example = "超额完成生产任务") + private String description; + + @ApiModelProperty(value = "状态", example = "1") + private Integer status; + + @ApiModelProperty(value = "排序", example = "1") + private Integer sort; +} + +// ScoreSubjectRespVO.java +public class ScoreSubjectRespVO { + private Long id; + private String code; + private String name; + private Integer category; + private String categoryName; + private BigDecimal score; + private BigDecimal dailyLimit; + private BigDecimal monthlyLimit; + private String description; + private Integer status; + private String statusName; + private Integer sort; + private Date createTime; +} +``` + +### 3.2 日常考核记录接口 + +**Controller路径**：`controller/admin/score/record/` + +| 方法 | 端点 | 权限 | 说明 | +|-----|-----|-----|------| +| POST | `/prison/score/record/create` | prison:score:record:create | 创建记录 | +| POST | `/prison/score/record/batch-create` | prison:score:record:create | 批量创建记录 | +| PUT | `/prison/score/record/update` | prison:score:record:update | 更新记录 | +| DELETE | `/prison/score/record/delete` | prison:score:record:delete | 删除记录 | +| GET | `/prison/score/record/get` | prison:score:record:query | 获取详情 | +| GET | `/prison/score/record/page` | prison:score:record:query | 分页查询 | +| GET | `/prison/score/record/export-excel` | prison:score:record:export | 导出Excel | +| GET | `/prison/score/record/get-by-prisoner` | prison:score:record:query | 获取罪犯考核明细 | + +**VO对象**： +```java +// ScoreRecordSaveReqVO.java +public class ScoreRecordSaveReqVO { + @ApiModelProperty(value = "罪犯ID", required = true) + @NotNull(message = "罪犯ID不能为空") + private Long prisonerId; + + @ApiModelProperty(value = "考核日期", required = true, example = "2026-01-14") + @NotNull(message = "考核日期不能为空") + @DateTimeFormat(pattern = "yyyy-MM-dd") + private Date recordDate; + + @ApiModelProperty(value = "考核规则ID", required = true) + @NotNull(message = "考核规则ID不能为空") + private Long subjectId; + + @ApiModelProperty(value = "得分", required = true, example = "2.00") + @NotNull(message = "得分不能为空") + private BigDecimal score; + + @ApiModelProperty(value = "备注说明") + private String remark; +} + +// ScoreRecordBatchCreateReqVO.java +public class ScoreRecordBatchCreateReqVO { + @ApiModelProperty(value = "考核日期", required = true) + @NotNull(message = "考核日期不能为空") + @DateTimeFormat(pattern = "yyyy-MM-dd") + private Date recordDate; + + @ApiModelProperty(value = "罪犯ID列表", required = true) + @NotEmpty(message = "罪犯ID列表不能为空") + private List prisonerIds; + + @ApiModelProperty(value = "考核规则ID", required = true) + @NotNull(message = "考核规则ID不能为空") + private Long subjectId; + + @ApiModelProperty(value = "得分", required = true) + @NotNull(message = "得分不能为空") + private BigDecimal score; + + @ApiModelProperty(value = "备注说明") + private String remark; +} + +// ScoreRecordRespVO.java +public class ScoreRecordRespVO { + private Long id; + private Long prisonerId; + private String prisonerNo; + private String prisonerName; + private Long prisonAreaId; + private String prisonAreaName; + private Date recordDate; + private Long subjectId; + private String subjectName; + private Integer category; + private String categoryName; + private BigDecimal score; + private BigDecimal actualScore; + private String remark; + private Long recorderId; + private String recorderName; + private Date createTime; +} +``` + +### 3.3 月度考核汇总接口 + +**Controller路径**：`controller/admin/score/monthly/` + +| 方法 | 端点 | 权限 | 说明 | +|-----|-----|-----|------| +| POST | `/prison/score/monthly/calculate` | prison:score:monthly:calculate | 手动触发月度汇总计算 | +| GET | `/prison/score/monthly/get-summary` | prison:score:monthly:query | 获取月度汇总详情 | +| GET | `/prison/score/monthly/page` | prison:score:monthly:query | 分页查询月度汇总 | +| POST | `/prison/score/monthly/submit-audit` | prison:score:monthly:audit | 提交审核 | +| POST | `/prison/score/monthly/audit` | prison:score:monthly:audit | 审核通过/驳回 | +| GET | `/prison/score/monthly/export-excel` | prison:score:monthly:export | 导出Excel | +| GET | `/prison/score/monthly/get-detail` | prison:score:monthly:query | 获取月度汇总明细 | + +**业务逻辑**： +```java +/** + * 月度汇总计算逻辑 + */ +public void calculateMonthlySummary(Integer year, Integer month) { + // 1. 获取所有罪犯列表 + List prisoners = prisonerService.getActivePrisonerList(); + + // 2. 遍历每个罪犯 + for (Prisoner prisoner : prisoners) { + // 3. 获取该罪犯当月所有日常考核记录 + List records = getMonthlyRecords(prisoner.getId(), year, month); + + // 4. 计算加分合计（考虑日限月限） + BigDecimal rewardScore = calculateRewardScore(records); + + // 5. 计算扣分合计（考虑日限月限） + BigDecimal penaltyScore = calculatePenaltyScore(records); + + // 6. 获取基础分配置 + BigDecimal baseScore = getBaseScoreConfig(); + + // 7. 计算总分 + BigDecimal totalScore = baseScore.add(rewardScore).add(penaltyScore); + + // 8. 评定等级 + Integer level = assessLevel(totalScore); + + // 9. 保存或更新月度汇总记录 + saveOrUpdateMonthlySummary(prisoner, year, month, baseScore, rewardScore, penaltyScore, totalScore, level); + } +} + +/** + * 计算加分（考虑日限月限） + */ +private BigDecimal calculateRewardScore(List records) { + // 按规则分组，计算每条规则的加分 + // 超过日限的按日限计算 + // 超过月限的按月限计算 + // 返回最终加分合计 +} +``` + +### 3.4 考核等级规则接口 + +**Controller路径**：`controller/admin/score/level/` + +| 方法 | 端点 | 权限 | 说明 | +|-----|-----|-----|------| +| PUT | `/prison/score/level/update` | prison:score:level:update | 更新等级规则 | +| GET | `/prison/score/level/get` | prison:score:level:query | 获取等级规则列表 | +| GET | `/prison/score/level/get-base-score` | prison:score:level:query | 获取基础分配置 | +| PUT | `/prison/score/level/update-base-score` | prison:score:level:update | 更新基础分配置 | + +### 3.5 考核公示公告接口 + +**Controller路径**：`controller/admin/score/notice/` + +| 方法 | 端点 | 权限 | 说明 | +|-----|-----|-----|------| +| POST | `/prison/score/notice/create` | prison:score:notice:create | 创建公示 | +| PUT | `/prison/score/notice/update` | prison:score:notice:update | 更新公示 | +| PUT | `/prison/score/notice/publish` | prison:score:notice:publish | 发布公示 | +| PUT | `/prison/score/notice/withdraw` | prison:score:notice:publish | 撤回公示 | +| DELETE | `/prison/score/notice/delete` | prison:score:notice:delete | 删除公示 | +| GET | `/prison/score/notice/get` | prison:score:notice:query | 获取详情 | +| GET | `/prison/score/notice/page` | prison:score:notice:query | 分页查询 | + +### 3.6 减刑假释数据提取接口 + +**Controller路径**：`controller/admin/score/parole/` + +| 方法 | 端点 | 权限 | 说明 | +|-----|-----|-----|------| +| GET | `/prison/score/parole/get-data` | prison:score:parole:query | 获取减刑假释考核数据 | +| POST | `/prison/score/parole/generate-suggestion` | prison:score:parole:query | 生成减刑假释建议 | + +**返回数据结构**： +```java +public class ScoreParoleDataVO { + private Long prisonerId; + private String prisonerNo; + private String prisonerName; + + // 近6个月月度考核数据 + private List monthlyScores; + + // 年度累计考核分 + private BigDecimal yearlyTotalScore; + + // 表扬次数 + private Integer praiseCount; + + // 警告次数 + private Integer warningCount; + + // 等级评定记录 + private List levelRecords; + + // 减刑假释建议 + private ParoleSuggestionVO suggestion; +} +``` + +--- + +## 四、批量SQL脚本 + +```sql +-- ==================== 计分考核模块 DDL ==================== + +-- 1. 考核规则科目表 +CREATE TABLE `prison_score_subject` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '规则ID', + `code` varchar(50) NOT NULL COMMENT '规则编码', + `name` varchar(100) NOT NULL COMMENT '规则名称', + `category` tinyint NOT NULL COMMENT '考核类别', + `score` decimal(10,2) NOT NULL COMMENT '分值', + `daily_limit` decimal(10,2) NOT NULL DEFAULT 0 COMMENT '日最高分限制', + `monthly_limit` decimal(10,2) NOT NULL DEFAULT 0 COMMENT '月最高分限制', + `description` varchar(500) DEFAULT NULL COMMENT '规则说明', + `status` tinyint NOT NULL DEFAULT 1 COMMENT '状态', + `sort` int NOT NULL DEFAULT 0 COMMENT '排序', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + UNIQUE KEY `uk_code` (`code`), + KEY `idx_category` (`category`), + KEY `idx_status` (`status`) +) ENGINE=InnoDB COMMENT='考核规则科目表'; + +-- 2. 日常考核记录表 +CREATE TABLE `prison_score_record` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '记录ID', + `prisoner_id` bigint NOT NULL COMMENT '罪犯ID', + `prisoner_no` varchar(50) NOT NULL COMMENT '罪犯编号', + `record_date` date NOT NULL COMMENT '考核日期', + `subject_id` bigint NOT NULL COMMENT '考核规则ID', + `subject_name` varchar(100) NOT NULL COMMENT '规则名称', + `category` tinyint NOT NULL COMMENT '考核类别', + `score` decimal(10,2) NOT NULL COMMENT '得分', + `actual_score` decimal(10,2) NOT NULL COMMENT '实际得分', + `remark` varchar(500) DEFAULT NULL COMMENT '备注说明', + `recorder_id` bigint NOT NULL COMMENT '记录人ID', + `recorder_name` varchar(50) NOT NULL COMMENT '记录人姓名', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + KEY `idx_prisoner_date` (`prisoner_no`, `record_date`), + KEY `idx_record_date` (`record_date`), + KEY `idx_subject` (`subject_id`) +) ENGINE=InnoDB COMMENT='日常考核记录表'; + +-- 3. 考核等级评定规则表 +CREATE TABLE `prison_score_level_rule` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '规则ID', + `level` tinyint NOT NULL COMMENT '等级', + `level_name` varchar(20) NOT NULL COMMENT '等级名称', + `min_score` decimal(10,2) NOT NULL COMMENT '最低分', + `max_score` decimal(10,2) NOT NULL COMMENT '最高分', + `description` varchar(500) DEFAULT NULL COMMENT '说明', + `sort` int NOT NULL DEFAULT 0 COMMENT '排序', + `status` tinyint NOT NULL DEFAULT 1 COMMENT '状态', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + UNIQUE KEY `uk_level` (`level`), + KEY `idx_min_score` (`min_score`) +) ENGINE=InnoDB COMMENT='考核等级评定规则表'; + +-- 4. 考核公示公告表 +CREATE TABLE `prison_score_notice` ( + `id` bigint NOT NULL AUTO_INCREMENT COMMENT '公告ID', + `title` varchar(200) NOT NULL COMMENT '公告标题', + `notice_type` tinyint NOT NULL DEFAULT 1 COMMENT '公示类型', + `start_date` date NOT NULL COMMENT '公示开始日期', + `end_date` date NOT NULL COMMENT '公示结束日期', + `scope_type` tinyint NOT NULL DEFAULT 1 COMMENT '公示范围', + `scope_prison_area_ids` varchar(500) DEFAULT NULL COMMENT '指定监区ID列表', + `content` text COMMENT '公示内容', + `status` tinyint NOT NULL DEFAULT 1 COMMENT '状态', + `publisher_id` bigint DEFAULT NULL COMMENT '发布人ID', + `publisher_name` varchar(50) DEFAULT NULL COMMENT '发布人姓名', + `publish_time` datetime DEFAULT NULL COMMENT '发布时间', + `creator` varchar(64) DEFAULT '' COMMENT '创建者', + `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updater` varchar(64) DEFAULT '' COMMENT '更新者', + `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + `deleted` bit(1) DEFAULT b'0' COMMENT '是否删除', + `tenant_id` bigint DEFAULT 0 COMMENT '租户编号', + PRIMARY KEY (`id`), + KEY `idx_status` (`status`), + KEY `idx_publish_time` (`publish_time`) +) ENGINE=InnoDB COMMENT='考核公示公告表'; + +-- 5. 初始化等级规则数据 +INSERT INTO `prison_score_level_rule` (`level`, `level_name`, `min_score`, `max_score`, `description`, `sort`, `status`) VALUES +(1, '优秀', 120.00, 9999.99, '表现突出', 1, 1), +(2, '良好', 100.00, 119.99, '表现良好', 2, 1), +(3, '合格', 80.00, 99.99, '表现一般', 3, 1), +(4, '不合格', 0.00, 79.99, '表现较差', 4, 1); + +-- 6. 初始化示例规则数据 +INSERT INTO `prison_score_subject` (`code`, `name`, `category`, `score`, `daily_limit`, `monthly_limit`, `description`, `status`, `sort`) VALUES +('LABOR001', '超额完成生产任务', 1, 2.00, 5.00, 30.00, '超额完成生产任务', 1, 1), +('LABOR002', '完成生产任务', 1, 1.00, 3.00, 20.00, '完成生产任务', 1, 2), +('EDU001', '参加义务劳动', 2, 1.00, 2.00, 10.00, '参加义务劳动', 1, 1), +('EDU002', '考试合格', 2, 1.00, 3.00, 15.00, '考试合格', 1, 2), +('DAILY001', '获得表扬', 3, 2.00, 5.00, 20.00, '获得表扬', 1, 1), +('DAILY002', '主动报告隐患', 3, 1.00, 2.00, 10.00, '主动报告隐患', 1, 2), +('HYGIENE001', '内务不整洁', 4, -0.50, -3.00, -10.00, '内务不整洁', 1, 1), +('HYGIENE002', '违规吸烟', 4, -2.00, -5.00, -20.00, '违规吸烟', 1, 2), +('PENALTY001', '打架斗殴', 6, -5.00, -10.00, -30.00, '打架斗殴', 1, 1), +('PENALTY002', '私藏违禁品', 6, -10.00, -20.00, -50.00, '私藏违禁品', 1, 2); +``` + +--- + +## 五、目录结构 + +``` +backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/ +├── controller/admin/score/ +│ ├── subject/ # 考核规则科目 +│ │ ├── PrisonScoreSubjectController.java +│ │ └── vo/ +│ │ ├── ScoreSubjectPageReqVO.java +│ │ ├── ScoreSubjectSaveReqVO.java +│ │ └── ScoreSubjectRespVO.java +│ ├── record/ # 日常考核记录 +│ │ ├── PrisonScoreRecordController.java +│ │ └── vo/ +│ │ ├── ScoreRecordPageReqVO.java +│ │ ├── ScoreRecordSaveReqVO.java +│ │ ├── ScoreRecordBatchCreateReqVO.java +│ │ └── ScoreRecordRespVO.java +│ ├── monthly/ # 月度汇总 +│ │ ├── PrisonScoreMonthlyController.java +│ │ └── vo/ +│ │ ├── ScoreMonthlyPageReqVO.java +│ │ ├── ScoreMonthlyRespVO.java +│ │ └── ScoreMonthlyDetailRespVO.java +│ ├── level/ # 等级规则 +│ │ ├── PrisonScoreLevelController.java +│ │ └── vo/ +│ │ └── ScoreLevelRespVO.java +│ ├── notice/ # 公示公告 +│ │ ├── PrisonScoreNoticeController.java +│ │ └── vo/ +│ │ ├── ScoreNoticePageReqVO.java +│ │ ├── ScoreNoticeSaveReqVO.java +│ │ └── ScoreNoticeRespVO.java +│ └── parole/ # 减刑假释 +│ ├── PrisonScoreParoleController.java +│ └── vo/ +│ └── ScoreParoleDataRespVO.java +│ +├── service/score/ +│ ├── ScoreSubjectService.java +│ ├── impl/ScoreSubjectServiceImpl.java +│ ├── ScoreRecordService.java +│ ├── impl/ScoreRecordServiceImpl.java +│ ├── ScoreMonthlyService.java +│ ├── impl/ScoreMonthlyServiceImpl.java +│ ├── ScoreLevelService.java +│ ├── impl/ScoreLevelServiceImpl.java +│ ├── ScoreNoticeService.java +│ ├── impl/ScoreNoticeServiceImpl.java +│ └── ScoreParoleService.java +│ └── impl/ScoreParoleServiceImpl.java +│ +├── dal/dataobject/score/ +│ ├── ScoreSubjectDO.java +│ ├── ScoreRecordDO.java +│ ├── ScoreLevelRuleDO.java +│ ├── ScoreNoticeDO.java +│ └── ScoreDO.java # 已有 +│ +└── dal/mysql/score/ + ├── ScoreSubjectMapper.java + ├── ScoreRecordMapper.java + ├── ScoreLevelRuleMapper.java + ├── ScoreNoticeMapper.java + └── ScoreMapper.java # 已有 +``` + +--- + +## 六、验收标准 + +- [ ] 创建考核规则科目表并实现CRUD接口 +- [ ] 创建日常考核记录表并实现CRUD接口（含批量录入） +- [ ] 创建考核等级规则表并实现配置接口 +- [ ] 创建考核公示公告表并实现发布功能 +- [ ] 实现月度汇总自动计算逻辑 +- [ ] 实现日/月最高分限制校验 +- [ ] 实现减刑假释数据提取接口 +- [ ] 所有接口通过单元测试 diff --git a/requirements/评估业务流程确认清单.md b/requirements/评估业务流程确认清单.md new file mode 100644 index 0000000..ec5887f --- /dev/null +++ b/requirements/评估业务流程确认清单.md @@ -0,0 +1,287 @@ +# 评估报告业务流程确认清单 + +> 确认日期：2026-01-18 +> 确认人：产品负责人 +> 确认方式：专家问答确认 + +--- + +## 一、流程确认结果汇总 + +| 序号 | 问题 | 确认结果 | 影响范围 | +|-----|------|---------|---------| +| 1 | 数据完整性检查 | ✅ 需要检查 | 生成流程修改 | +| 2 | AI生成范围 | ✅ AI生成初稿 | AI功能边界 | +| 3 | 专业审核 | ❌ 无需专业人员 | 审核流程简化 | +| 4 | 审核层级 | ✅ 单级审核 | 流程简化 | +| 5 | 批量生成 | ✅ 支持批量 | 功能新增 | +| 6 | 退回原因 | ✅ 选择原因 | 审核流程 | +| 7 | 撤回功能 | ✅ 需要撤回 | 功能新增 | +| 8 | 归档策略 | ✅ 自动归档 | 功能新增 | +| 9 | 编号规则 | ✅ 保持现状 | 无需修改 | +| 10 | 风险等级 | ✅ 仅显示等级 | 无需配套 | +| 11 | 版本管理 | ✅ 完整功能 | 功能完善 | +| 12 | 导出格式 | ✅ PDF+Word+Excel | 与需求一致 | +| 13 | AI服务降级 | ✅ 手动填写 | 容错机制 | +| 14 | 评估维度 | ✅ 增加家庭帮教 | 维度补充 | + +--- + +## 二、确认后的业务流程设计 + +### 2.1 报告生成流程（修订后） + +``` +步骤1：选择罪犯 + │ + ▼ +步骤2：数据完整性检查 ⚠️ 【新增】 + ├── 检查项： + │ ├── 罪犯档案完整性 + │ ├── 计分考核记录（12个月） + │ ├── 消费记录（12个月） + │ ├── 心理测评记录 + │ └── 危险评估记录 + ├── 显示结果： + │ ├── 完整：显示绿色勾选 + │ ├── 缺失：显示黄色警告 + 缺失项列表 + └── 操作： + ├── [继续生成]（数据完整或允许缺失） + └── [补录数据]（跳转补录页面） + │ + ▼ +步骤3：选择报告模板 + │ + ▼ +步骤4：确认生成 + ├── 显示：预计生成时间、数据完整性状态 + └── [确认生成] + │ + ▼ +步骤5：AI生成报告初稿 ⚠️ 【AI生成初稿】 + ├── 生成时间：30-60秒/份 + ├── 并发限制：最多3个并行任务 + └── 进度显示：实时进度条 + │ + ▼ +步骤6：人工审核修改 + ├── 步骤：查看报告 → 逐维度审核 → 修改 → 确认 + └── 标识：AI生成内容显示"🤖 AI生成"标识 + │ + ▼ +步骤7：提交审核 + ├── 检查：必填维度是否完整 + └── 操作：[提交审核] + │ + ▼ +步骤8：审核通过 + ├── 审核人：单级审核（教育科长或指定审核人） + ├── 退回：需选择退回原因（分类选择） + └── 撤回：提交后允许撤回 + │ + ▼ +步骤9：自动归档 ⚠️ 【自动归档】 + ├── 条件：审核通过后24小时自动归档 + └── 效果：归档后不可修改 +``` + +### 2.2 批量生成流程 + +``` +批量生成入口：批量选择罪犯 → 选择模板 → 批量生成 + │ + ▼ +前置检查 + ├── 数据完整性扫描（批量） + └── 生成数据完整性报告 + │ + ▼ +任务队列 + ├── 异步处理：进入后台队列 + ├── 预估时间：根据数量计算 + └── 用户操作：可离开去做其他工作 + │ + ▼ +进度通知 + ├── 进度条：实时显示进度 + ├── 完成通知：系统消息通知 + └── 失败处理：标记失败项，支持重试 +``` + +### 2.3 审核流程（单级审核） + +``` +┌────────┐ 提交审核 ┌────────┐ 审核通过 ┌────────┐ 自动归档 ┌────────┐ +│ 草稿 │ ─────────→ │ 待审核 │ ─────────→ │ 已通过 │ ─────────→ │ 已归档 │ +└────────┘ └────────┘ └────────┘ └────────┘ + │ │ + │ │ 审核退回 + │ ▼ + │ ┌────────┐ + │ │ 已退回 │ ←─── 需选择退回原因 + │ └────────┘ + │ │ + │ │ 重新提交 + └────────────────────┘ + ↑撤回 +``` + +### 2.4 版本管理流程 + +``` +每次保存生成新版本 + │ + ▼ +版本记录 + ├── 版本号：v1, v2, v3... + ├── 修改人：记录操作人 + ├── 修改时间：记录时间戳 + └── 变更内容：记录修改摘要 + │ + ▼ +版本对比 + ├── 功能：选择两个版本进行对比 + ├── 显示：高亮显示差异部分 + └── 操作：可一键还原 + │ + ▼ +版本回滚 + ├── 功能：回滚到指定历史版本 + └── 限制：已归档报告不可回滚 +``` + +--- + +## 三、与需求文档对比（最终确认） + +| 功能点 | 需求文档要求 | 确认结果 | 处理建议 | +|-------|-------------|---------|---------| +| 导出PDF | 必须支持PDF导出 | ✅ **已确认** | 按需求实现 | +| 导出Word | 必须支持Word导出 | ✅ **已确认** | 按需求实现 | +| 专业审核 | 心理评估需专业人员审核 | ❌ 无需专业人员 | 按确认结果实施 | +| 三级审核 | 需要分监区→监区→监狱 | 单级审核 | 按确认结果实施 | +| 风险等级 | 需要配套管控措施 | 仅显示等级 | 按确认结果实施 | +| 家庭帮教维度 | 未明确要求 | ✅ **已确认增加** | 按需求实现 | + +--- + +## 四、家庭帮教维度设计（已确认） + +### 4.1 维度子项 + +| 子项名称 | 说明 | 数据来源 | +|---------|------|---------| +| 家属会见频次 | 近6个月会见次数、月均会见次数 | 会见记录表 | +| 帮教通信情况 | 家属来信次数、通信内容摘要 | 通信记录表 | +| 家属态度评价 | 积极/一般/消极 | 人工评价 | +| 家庭支持力度 | 强/中/弱（经济支持、情感支持） | 综合评估 | +| 假释后安置意向 | 有固定住所/无固定住所、就业意向 | 档案信息 | + +### 4.2 AI提示词建议 + +> 请根据以下家庭帮教情况数据，分析该犯的家属帮教支持情况： +> - 家属会见频次：{会见次数}次/月 +> - 帮教通信：{通信次数}次/月 +> - 家属态度：{家属态度} +> - 家庭支持：{支持力度} +> - 安置条件：{安置意向} +> +> 请生成客观描述，重点分析家庭支持对罪犯改造效果的影响。 + +--- + +## 五、根据确认结果的功能清单 + +### 5.2 必须实现功能清单 + +| 功能 | 优先级 | 工作量 | 说明 | +|-----|-------|-------|------| +| 数据完整性检查 | P0 | 3天 | 生成前检查数据完整性 | +| 批量生成功能 | P0 | 5天 | 异步队列 + 进度通知 | +| 撤回功能 | P0 | 2天 | 提交后撤回接口 | +| 自动归档 | P0 | 2天 | 审核通过后自动归档 | +| 退回原因选择 | P0 | 1天 | 审核退回时选择原因 | +| 版本管理（完整） | P0 | 4天 | 查看、对比、回滚 | +| 家庭帮教维度 | P0 | 2天 | 新增评估维度 | +| PDF导出 | P0 | 3天 | 按需求实现 | +| Word导出 | P0 | 3天 | 按需求实现 | +| Excel导出 | P0 | 1天 | 按需求实现 | +| AI服务手动降级 | P1 | 2天 | AI不可用时手动填写 | + +### 5.3 预计总工作量 + +| 阶段 | 功能范围 | 预计工时 | +|-----|---------|---------| +| 第一阶段 | 核心流程（数据检查、生成、审核） | 10天 | +| 第二阶段 | 批量功能、归档、版本管理 | 10天 | +| 第三阶段 | 导出功能（PDF/Word） | 7天 | +| **合计** | | **27天** | + +--- + +## 六、后续行动 + +### 6.1 确认完成事项 + +✅ 已确认全部14项流程问题 +✅ 已确认导出格式（PDF+Word+Excel） +✅ 已确认家庭帮教维度设计方案 + +### 6.2 下一步工作 + +1. **修订需求文档**（本周） + - 更新流程图（数据检查、批量生成、审核流程） + - 补充家庭帮教维度详细设计 + - 增加PDF/Word导出功能设计 + - 更新验收标准 + +2. **技术方案设计**（下周） + - 设计异步生成队列架构 + - 设计版本管理数据模型 + - 设计导出功能实现方案 + +3. **开发实施**（2-3周） + - 按功能清单分阶段开发 + - 每周进行进度同步 + +### 6.3 需求文档修订清单 + +| 修订项 | 修订内容 | 优先级 | +|-------|---------|-------| +| 流程修订 | 增加数据完整性检查步骤 | P0 | +| 流程修订 | 批量生成流程设计 | P0 | +| 流程修订 | 撤回功能流程设计 | P0 | +| 流程修订 | 自动归档规则设计 | P0 | +| 功能新增 | 家庭帮教评估维度 | P0 | +| 功能新增 | PDF导出功能 | P0 | +| 功能新增 | Word导出功能 | P0 | +| 功能完善 | 退回原因选择器 | P1 | +| 功能完善 | 版本对比/回滚界面 | P1 | +| 容错设计 | AI服务降级策略 | P2 | + +--- + +## 附录：用户回答原始记录 + +| 问题 | 回答 | +|-----|------| +| 1. 数据完整性检查 | 需要检查 | +| 2. AI生成范围 | AI生成初稿 | +| 3. 专业审核 | 无需专业人员 | +| 4. 审核层级 | 单级审核 | +| 5. 批量生成 | 支持批量 | +| 6. 退回原因 | 选择原因 | +| 7. 撤回功能 | 需要撤回 | +| 8. 归档策略 | 自动归档 | +| 9. 编号规则 | 保持现状 | +| 10. 风险等级 | 仅显示等级 | +| 11. 版本管理 | 完整功能 | +| 12. 导出格式 | PDF + Word + Excel | +| 13. AI服务降级 | 手动填写 | +| 14. 评估维度 | 需要增加家庭帮教 | + +--- + +**文档状态**：✅ 已确认 +**确认人签字**：__________ +**确认日期**：2026-01-18 diff --git a/requirements/评估功能专家模拟评审报告.md b/requirements/评估功能专家模拟评审报告.md new file mode 100644 index 0000000..5bcb9d4 --- /dev/null +++ b/requirements/评估功能专家模拟评审报告.md @@ -0,0 +1,1097 @@ +# 评估报告功能专家模拟评审报告 + +> 评审日期：2026-01-18 +> 模拟评审会形式：闭门评审会议 +> 评审主持：产品负责人 +> 记录整理：Claude Code + +--- + +## 评审专家团阵容 + +| 序号 | 专家姓名 | 角色 | 背景简介 | 评审领域 | +|-----|---------|------|---------|---------| +| 1 | 刘建国 | 监狱管理资深专家 | 原某省监狱管理局教育处副处长，35年监狱工作经验 | 业务流程、功能需求 | +| 2 | 张明远 | 刑罚执行专家 | 某省高级人民法院刑庭特邀专家顾问，法学博士，20年司法工作经验 | 法律合规、文书规范 | +| 3 | 王淑芬 | 心理评估专家 | 中国心理学会司法心理学分会委员，犯罪心理学博士，15年罪犯心理测评经验 | 心理评估、AI生成审核 | +| 4 | 李志强 | 技术架构专家 | 某大型国企信息化部技术总监，系统架构师，18年企业级系统开发经验 | 技术实现、性能优化 | +| 5 | 陈思雨 | 产品UX专家 | 某知名B端SaaS公司产品设计总监，12年B端产品设计经验，心理学硕士 | 交互体验、信息架构 | + +--- + +## 一、监狱管理资深专家评审意见 + +### 专家背景 +**刘建国** +- 原某省监狱管理局教育处副处长 +- 35年监狱管理经验 +- 多次参与司法部罪犯评估标准制定 +- 擅长罪犯改造效果评估体系设计 + +### 评审意见 + +#### 1.1 总体评价 + +> "这份评估报告需求文档整体框架搭建得不错，覆盖了评估模板管理、数据聚合、AI生成、报告审核等核心环节。从35年的监狱工作经验来看，这个系统如果能够真正落地，确实能够大幅减轻基层管教民警的工作负担。但是，从实际业务操作的角度来看，我发现了一些流程设计上的问题，如果不解决，会直接影响系统的实际使用效果。" + +#### 1.2 具体问题与建议 + +##### 问题1：评估报告生成流程顺序严重不合理 + +**原文设计**： +``` +步骤1：选择罪犯 +步骤2：选择报告模板 +步骤3：设置报告日期范围 +步骤4：系统自动聚合数据源 +步骤5：调用AI生成报告初稿 +步骤6：生成报告预览 +``` + +**专家意见**： + +> "这个流程设计完全颠倒了实际工作中的操作顺序！我来描述一下真实的工作场景： +> +> **真实工作流程**： +> 1. 管教民警首先需要查看这个罪犯的基础档案（犯罪情况、刑期、家庭背景等） +> 2. 查看该犯近一年的计分考核记录（每月得分、表扬/处分情况） +> 3. 查看消费记录（是否存在异常高消费或零消费） +> 4. 查看心理测评结果（是否有心理问题） +> 5. 查看危险评估记录（风险等级变化趋势） +> 6. **确认所有数据完整后**，才开始撰写评估报告 +> +> **当前设计的致命问题**： +> - 如果数据不完整，AI生成的内容必然有缺失 +> - 管教民警无法在生成前对数据进行核对和补录 +> - 可能导致AI生成错误的评估结论 +> +> **建议修改为**： +> ``` +> 步骤1：选择罪犯 +> 步骤2：【新增】数据完整性检查与补录 +> - 系统自动检查各项数据是否完整 +> - 如有缺失，提示民警补录 +> 步骤3：选择报告模板 +> 步骤4：确认生成（此时数据已完整） +> 步骤5：AI生成报告初稿 +> 步骤6：人工审核修改 +> ``` + +##### 问题2：评估维度缺少关键项目 + +**原文设计**的评估维度： +| 序号 | 维度名称 | 说明 | +|-----|---------|------| +| 1 | 基本信息 | 罪犯姓名、编号、入狱日期等 | +| 2 | 犯罪及刑罚情况 | 罪名、刑期、判决情况等 | +| 3 | 改造表现 | 考核得分、等级、表扬/处分记录 | +| 4 | 心理评估 | 测评结果、风险等级 | +| 5 | 服刑表现综合分析 | 消费行为、劳动表现、狱内关系 | +| 6 | 管教意见 | 改造评价、建议意见 | + +**专家意见**： + +> "缺少了'家庭帮教情况'这个极其重要的维度！ +> +> **为什么重要**： +> 1. 减刑假释评审时，家庭帮教是法院重点审查内容 +> 2. 家属会见频率、家属态度、帮教意愿都影响罪犯的改造效果评估 +> 3. 很多省份已经将家庭帮教情况纳入罪犯改造质量评估体系 +> +> **建议增加维度**： +> | 新增维度 | 说明 | 数据来源 | +> |---------|------|---------| +> | 家庭帮教情况 | 家属会见情况、帮教通信、家庭支持力度 | 会见记录、通信记录 | +> | 社会支持网络 | 是否有固定工作、住所，社会关系情况 | 档案信息、社会调查 | +> | 假释评估条件 | 符合假释法定条件的具体情况 | 刑期、改造表现、累犯情况 | + +##### 问题3：风险等级与实际管控措施脱节 + +**原文设计**：低风险、中风险、高风险、极高风险四级 + +**专家意见**： + +> "仅仅划分风险等级是不够的！监狱需要的是'风险等级+对应管控措施'的完整方案。 +> +> **当前问题**： +> - 高风险罪犯应该如何管控？没有具体措施建议 +> - 不同风险等级的报告处理优先级没有明确 +> - 缺少风险预警和干预机制 +> +> **建议修改**： +> ``` +> 低风险（绿色）： +> - 管控措施：常规管理 +> - 报告处理：可批量生成，定期抽查 +> +> 中风险（黄色）： +> - 管控措施：重点关注，每周谈话 +> - 报告处理：优先生成，管教签字确认 +> +> 高风险（橙色）： +> - 管控措施：重点监控，列入重点管控名单 +> - 报告处理：单人核对，教育科审核 +> +> 极高风险（红色）： +> - 管控措施：单独管控，每日评估 +> - 报告处理：双人审核，报监狱领导审批 +> ``` + +##### 问题4：批量生成功能缺少质量控制 + +**原文设计**：支持选择多个罪犯+模板，批量生成报告 + +**专家意见**： + +> "批量生成功能我举双手赞成，月末生成几十份报告确实很痛苦。但是！ +> +> **必须增加的质量控制措施**： +> 1. **数据完整性检测** +> - 批量生成前先扫描所有选中罪犯的数据完整性 +> - 显示完整度报告：哪些罪犯数据缺失 +> - 允许选择：是跳过数据缺失的罪犯，还是仅生成有数据的维度 +> +> 2. **异常数据预警** +> - 批量生成前检测异常数据（如本月分数异常波动） +> - 提示管教民警关注异常情况 +> +> 3. **生成质量抽检** +> - 建议每批次随机抽取5%-10%进行人工复核 +> - 建立批量生成的准确率统计 +> ``` + +### 1.3 刘建国专家综合评分 + +| 评审维度 | 满分 | 得分 | 扣分原因 | +|---------|-----|------|---------| +| 功能完整性 | 25 | 18 | 缺少家庭帮教维度 | +| 流程合理性 | 25 | 12 | 生成顺序严重不合理 | +| 业务贴合度 | 25 | 15 | 风险等级与管控脱节 | +| 可操作性 | 25 | 15 | 缺少质量控制 | +| **总分** | **100** | **60** | 需要重大修订 | + +### 1.4 刘建国专家评审结论 + +> **总体结论**：不通过，需重大修订 +> +> **主要问题**： +> 1. 报告生成流程必须增加数据完整性检查步骤 +> 2. 必须增加"家庭帮教情况"评估维度 +> 3. 风险等级必须配套对应的管控措施 +> 4. 批量生成必须增加质量控制机制 +> +> **建议**：需求打回修改后重新评审 + +--- + +## 二、刑罚执行专家评审意见 + +### 专家背景 +**张明远** +- 某省高级人民法院刑庭特邀专家顾问 +- 法学博士，刑法学专业 +- 20年司法工作经验 +- 参与多部司法解释起草工作 +- 擅长减刑假释案件审查标准研究 + +### 评审意见 + +#### 2.1 总体评价 + +> "这份需求文档从技术角度看设计得很完整，但从法律合规角度来看，存在几个重大风险点。作为参与过上百件减刑假释案件审查的法官，我必须指出：如果这些问题不解决，生成的评估报告可能在法庭上被质疑，影响减刑假释裁定效果。" + +#### 2.2 法律合规性问题 + +##### 问题1：评估报告法律效力存疑 + +**原文设计**：AI生成内容 + 人工审核确认 + +**专家意见**： + +> "这是最大的法律风险点！ +> +> **法律问题分析**： +> 1. AI生成的内容能否作为执法依据？ +> 2. 如果AI生成的内容有错误，责任如何界定？ +> 3. 当前设计没有明确区分哪些内容是AI生成的，哪些是人工撰写的 +> +> **法庭可能的质疑**： +> - '这份评估报告有多少内容是AI写的？管教民警是否认真审核过？' +> - '如果AI生成的内容与实际情况不符，是AI的责任还是监狱的责任？' +> - 'AI生成的内容是否符合减刑假释的法定条件认定标准？' +> +> **建议修改**： +> 1. AI生成内容必须在报告中明确标注（标注为'系统辅助生成'） +> 2. 人工审核必须保留完整的审核痕迹（审核人、审核时间、修改内容） +> 3. 关键法律结论（如'符合假释条件'）必须人工撰写，AI不能生成 +> 4. 建立AI生成内容的双人复核机制 + +##### 问题2：数字签名机制不完整 + +**原文设计**：报告生成时计算内容哈希值，使用系统私钥对哈希值进行数字签名 + +**专家意见**： + +> "数字签名设计方向是对的，但实现细节存在严重问题！ +> +> **当前设计问题**： +> 1. 没有说明使用什么算法（RSA？ECDSA？） +> 2. 私钥如何保管？谁有权限使用？ +> 3. 签名验证的流程是什么？谁来验证？ +> 4. 如果签名验证失败，如何处理？ +> +> **法院审查要求**： +> 根据《最高人民法院关于办理减刑假释案件审理程序的规定》，评估报告需要： +> 1. 制作人签字 +> 2. 审核人签字 +> 3. 单位盖章 +> 4. 制作日期 +> +> **建议修改**： +> ``` +> 报告防篡改机制： +> 1. 报告完成时自动计算SHA-256哈希值 +> 2. 由以下人员分别进行电子签名： +> - 制作人（管教民警） +> - 审核人（教育科长） +> - 审批人（分管领导） +> 3. 签名信息存储在报告元数据中 +> 4. 导出PDF时在文件属性中显示签名信息 +> 5. 提供在线签名验证接口 +> ``` + +##### 问题3：减刑假释评估模板缺失法定要素 + +**原文设计**：评估模板包含基本信息、犯罪情况、改造表现、心理评估等维度 + +**专家意见**： + +> "根据《最高人民法院关于办理减刑假释案件具体应用法律的规定》，假释评估必须包含以下法定要素，当前模板大部分缺失： +> +> **法定必须包含的评估内容**： +> | 要素 | 说明 | 是否包含 | +> |-----|------|---------| +> | 服刑期间表现 | 具体描述悔改表现 | ✅ 已有 | +> | 没有再犯罪危险 | 需要具体分析 | ❌ 缺失 | +> | 有悔改表现 | 不再危害社会 | ❌ 缺失 | +> | 假释后生活来源 | 有固定住所和收入 | ❌ 缺失 | +> | 社区评估意见 | 社区是否具备监管条件 | ❌ 缺失 | +> | 被害人意见 | 被害人是否谅解 | ❌ 缺失 | +> +> **建议**：必须增加'假释条件评估'专用模板，包含上述法定要素" + +##### 问题4：审核流程不符合法定程序 + +**原文设计**：草稿 → 待审核 → 已通过/已退回 + +**专家意见**： + +> "这个审核流程过于简单，不符合法定程序要求！ +> +> **法定程序要求**： +> 1. 减刑假释评估报告需要经过分监区、监区、监狱三级审核 +> 2. 监狱刑罚执行科需要出具审查意见 +> 3. 监狱长需要审批签字 +> 4. 需要公示期 +> +> **建议修改**： +> ``` +> 审核流程： +> 1. 管教民警起草（草稿） +> 2. 分监区领导审核（分监区意见） +> 3. 监区领导审核（监区意见） +> 4. 刑罚执行科审查（合规性审查） +> 5. 监狱长审批（最终审批） +> 6. 公示（5个工作日） +> 7. 正式归档 +> ``` + +### 2.3 张明远专家综合评分 + +| 评审维度 | 满分 | 得分 | 扣分原因 | +|---------|-----|------|---------| +| 法律合规性 | 30 | 12 | AI生成效力、法定要素缺失 | +| 证据效力 | 25 | 10 | 数字签名不完整 | +| 法定程序 | 25 | 8 | 审核流程不符合规定 | +| 文书规范性 | 20 | 12 | 缺少标准文书格式 | +| **总分** | **100** | **42** | 存在重大法律风险 | + +### 2.4 张明远专家评审结论 + +> **总体结论**：不通过，存在重大法律风险 +> +> **核心问题**： +> 1. AI生成内容的法律效力未明确，可能被法庭质疑 +> 2. 缺少减刑假释法定评估要素 +> 3. 数字签名机制不完整，无法满足法院审查要求 +> 4. 审核流程不符合法定程序 +> +> **建议**： +> - 必须邀请监狱管理局法规处会审 +> - AI生成内容必须有明确的使用限制 +> - 减刑假释模板需送省高级人民法院刑庭审核 + +--- + +## 三、心理评估专家评审意见 + +### 专家背景 +**王淑芬** +- 中国心理学会司法心理学分会委员 +- 犯罪心理学博士 +- 15年罪犯心理测评工作经验 +- 参与编制《罪犯心理评估规范》 +- 某监狱心理辅导室主任 + +### 评审意见 + +#### 3.1 总体评价 + +> "作为一名从事罪犯心理评估工作15年的专业人士，我对这份需求文档中关于心理评估的部分既期待又担忧。期待的是，AI技术确实可以提高心理评估报告的生成效率；担忧的是，心理评估是非常专业的领域，如果AI生成的内容不准确，可能会对罪犯造成错误的评估结论，进而影响其处遇等级和减刑假释机会。" + +#### 3.2 心理评估专业性问题 + +##### 问题1：AI生成心理评估内容存在专业风险 + +**原文设计**：AI根据罪犯心理测评数据生成心理评估分析 + +**专家意见**： + +> "这是我最担心的问题！ +> +> **心理评估的专业特殊性**： +> 1. 心理测评结果需要专业解读，不能简单套用模板 +> 2. 同一测评分数，不同背景的罪犯可能有完全不同的解读 +> 3. 心理状态是动态变化的，需要结合历史数据分析趋势 +> 4. 自杀/自伤风险评估需要极其谨慎，错误评估可能危及生命 +> +> **AI生成的风险**： +> 1. AI可能无法理解测评分数背后的深层含义 +> 2. AI可能忽略重要的背景信息（如重大生活事件） +> 3. AI可能给出不恰当的心理建议 +> +> **建议修改**： +> ``` +> 心理评估模块使用限制： +> 1. AI可以辅助生成客观描述部分（如测评数据汇总） +> 2. 心理诊断和风险判断必须由持证心理师人工确认 +> 3. 自杀/自伤风险评估必须由心理师双人复核 +> 4. AI生成的每一条心理评估结论都必须有专业心理师审核签字 +> +> AI在心理评估中的正确用法： +> - 辅助：数据汇总、趋势图生成、历史对比 +> - 禁止：心理诊断结论、风险等级判定、治疗建议 +> ``` + +##### 问题2：AI提示词缺少专业审核机制 + +**原文设计**：模板配置AI提示词，用于生成评估内容 + +**专家意见**： + +> "这个设计有严重漏洞！ +> +> **问题分析**： +> 1. 普通管教民警可能不具备编写专业心理评估提示词的能力 +> 2. 不当的提示词可能导致AI生成不专业或有害的内容 +> 3. 心理评估涉及罪犯隐私，需要更严格的权限控制 +> +> **建议修改**： +> ``` +> AI提示词审核机制： +> 1. 心理评估相关提示词必须经过心理专业人员审核 +> 2. 审核人必须具备二级以上心理咨询师资格 +> 3. 提示词审核记录需要存档（审核人、审核时间、版本号） +> 4. 提示词修改后需要重新审核 +> 5. 敏感关键词过滤（如'自杀'、'杀人'等需要特殊处理） +> +> 提示词示例（经审核的心理评估提示词）： +> 【已审核】请根据以下心理测评数据，生成客观描述... +> 【已审核】该犯SCL-90得分为XX，在XX维度偏高，请描述... +> ``` + +##### 问题3：心理评估与危险评估混淆 + +**原文设计**：危险评估（RiskAssessment）和心理评估是独立的模块 + +**专家意见**： + +> "这是一个概念混淆问题！ +> +> **问题分析**： +> 1. 心理评估（Psychological Assessment）：评估罪犯的心理健康状况、人格特征、情绪状态等 +> 2. 危险评估（Risk Assessment）：评估罪犯的自伤、自杀、暴力、脱逃等风险 +> 3. 两者有交集，但不能混淆 +> +> **建议修改**： +> ``` +> 心理评估模块应包含： +> 1. 心理测评管理 +> - 测评量表管理（SCL-90、MMPI、16PF等） +> - 测评记录管理 +> - 测评结果分析 +> +> 2. 心理健康评估 +> - 心理健康状态评定 +> - 人格特征分析 +> - 心理问题筛查 +> +> 3. 危机干预评估 +> - 自杀/自伤风险评估 +> - 暴力风险评估 +> - 危机干预记录 +> +> 4. 心理矫治效果评估 +> - 矫治目标达成度 +> - 心理矫治建议 +> ``` + +##### 问题4：心理评估报告格式不规范 + +**原文设计**：评估报告包含基本信息、改造表现、心理评估等维度 + +**专家意见**： + +> "心理评估报告有专业的格式要求！ +> +> **标准心理评估报告应包含**： +> | 章节 | 内容 | +> |-----|------| +> | 基本信息 | 罪犯基本信息、测评时间、测评人 | +> | 测评概述 | 使用了哪些测评工具、测评目的 | +> | 测评结果 | 各项测评的原始分、标准分、百分位 | +> | 结果分析 | 专业解读测评结果，分析罪犯心理特征 | +> | 诊断意见 | 心理健康状况诊断（需有资质人员签署） | +> | 矫治建议 | 针对问题提出矫治建议 | +> | 风险提示 | 自杀/自伤/暴力风险提示 | +> +> **建议**：参考《中国心理学会临床与咨询心理学工作伦理守则》制定心理评估报告规范" + +### 3.3 王淑芬专家综合评分 + +| 评审维度 | 满分 | 得分 | 扣分原因 | +|---------|-----|------|---------| +| 专业准确性 | 30 | 15 | AI生成心理评估存在风险 | +| 诊断严谨性 | 25 | 10 | 缺少专业审核和双人复核 | +| 伦理合规性 | 25 | 12 | 隐私保护和权限控制不足 | +| 报告规范性 | 20 | 8 | 报告格式不规范 | +| **总分** | **100** | **45** | 需要重大改进 | + +### 3.4 王淑芬专家评审结论 + +> **总体结论**：不通过，需重大修订 +> +> **核心问题**： +> 1. AI不能用于生成心理诊断和风险判断结论 +> 2. 必须建立AI提示词的专业审核机制 +> 3. 心理评估和危险评估需要明确区分 +> 4. 心理评估报告格式需要专业规范 +> 5. 自杀/自伤风险评估必须双人复核 +> +> **建议**： +> - 邀请中国心理学会司法心理学分会专家参与评审 +> - AI在心理评估中的应用范围需要明确界定 +> - 心理评估模块需要单独的权限控制 + +--- + +## 四、技术架构专家评审意见 + +### 专家背景 +**李志强** +- 某大型国企信息化部技术总监 +- 系统架构师（高级） +- 18年企业级系统开发经验 +- 主持建设多个省级司法行政系统信息化项目 +- 擅长分布式系统设计、高并发系统优化 + +### 评审意见 + +#### 4.1 总体评价 + +> "从技术架构角度来看，这套评估报告系统的设计思路是正确的，采用微服务架构、模块化设计、AI服务集成等都是行业标准做法。但是，在性能设计、安全设计、可用性设计等方面存在一些需要优化的地方。作为一个面向全省监狱推广的系统，这些问题如果不在设计阶段解决，上线后可能会遇到严重的性能瓶颈和安全风险。" + +#### 4.2 技术架构问题 + +##### 问题1：报告生成性能存在严重风险 + +**原文设计**：实时调用AI生成报告，支持单个生成和批量生成 + +**专家意见**： + +> "这是最大的性能风险点！ +> +> **性能问题分析**： +> 1. 单个报告AI生成时间：30-60秒（取决于LLM响应速度） +> 2. 批量生成100份报告：需要50-100分钟 +> 3. 实时同步调用会阻塞用户请求 +> 4. 100个并发用户同时生成报告：LLM服务会崩溃 +> +> **数学计算**： +> ``` +> 假设场景： +> - 某监狱有500名在押犯 +> - 月末集中生成评估报告 +> - 每份报告AI生成需要45秒 +> - 500 * 45秒 = 22500秒 = 6.25小时 +> - 如果100名管教同时操作... +> ``` +> +> **建议修改**： +> ``` +> 架构改造： +> 1. 引入消息队列（RabbitMQ/Kafka） +> - 生成任务先进入队列 +> - 后台消费者异步处理 +> - 用户可以查询处理进度 +> +> 2. 实现任务调度策略 +> - 低优先级任务自动延迟到非工作时间 +> - 高峰期限制并发任务数 +> - 支持定时批量生成 +> +> 3. 前端轮询或WebSocket推送进度 +> - 用户提交任务后可以去做其他工作 +> - 任务完成后收到系统通知 +> ``` + +##### 问题2：数据聚合缺少缓存机制 + +**原文设计**：实时查询各模块数据聚合 + +**专家意见**： + +> "这是一个典型的缓存缺失问题！ +> +> **问题分析**： +> 1. 生成一份报告需要查询：罪犯档案、计分考核、消费记录、心理测评、危险评估等多个模块 +> 2. 每个查询都是实时数据库查询 +> 3. 批量生成时会产生大量重复查询 +> +> **性能影响**： +> ``` +> 单份报告数据查询次数： +> - 罪犯基本信息：1次 +> - 计分考核记录：12次（12个月） +> - 消费记录：12次（12个月） +> - 心理测评记录：1-5次 +> - 危险评估记录：1-3次 +> - 总计：约30次数据库查询 +> +> 批量生成100份报告：3000次数据库查询 +> ``` +> +> **建议修改**： +> ``` +> 缓存策略： +> 1. 罪犯基本信息缓存（TTL: 30分钟） +> - 罪犯姓名、编号、监区等变化频率低的数据 +> +> 2. 计分考核数据缓存（TTL: 10分钟） +> - 月度得分、年度汇总 +> +> 3. 消费数据缓存（TTL: 10分钟） +> - 月均消费、消费趋势 +> +> 4. 模板配置缓存（TTL: 1小时） +> - 维度配置、AI提示词 +> +> 5. 缓存更新策略： +> - 数据变更时主动失效相关缓存 +> - 定期预热常用缓存 +> ``` + +##### 问题3：AI服务缺少容错机制 + +**原文设计**：调用第三方LLM服务生成内容 + +**专家意见**： + +> "AI服务调用没有容错设计，这是严重的高可用问题！ +> +> **故障场景分析**： +> 1. LLM服务宕机：所有报告无法生成 +> 2. 网络超时：生成失败，用户需要重试 +> 3. API限流：超出调用额度后失败 +> 4. 响应内容异常：AI返回乱码或有害内容 +> +> **建议修改**： +> ``` +> 容错机制设计： +> 1. 服务降级策略 +> - LLM服务不可用时，自动切换为'手动填写'模式 +> - 标记该维度为'待人工填写' +> - 记录服务降级日志 +> +> 2. 重试机制 +> - 超时后自动重试2次 +> - 使用指数退避策略 +> - 记录重试次数 +> +> 3. 熔断机制 +> - 连续失败5次后熔断10分钟 +> - 熔断期间直接返回降级响应 +> - 熔断恢复后自动恢复调用 +> +> 4. 内容安全检测 +> - 对AI返回内容进行敏感词过滤 +> - 检测到有害内容时标记并人工审核 +> ``` + +##### 问题4：数据安全设计不足 + +**原文设计**：记录AI生成日志，包含prompt和response + +**专家意见**： + +> "罪犯评估数据属于敏感个人信息，安全设计需要加强！ +> +> **问题分析**： +> 1. AI生成日志包含完整的prompt，可能包含罪犯敏感信息 +> 2. 日志文件存储在服务器磁盘，存在泄露风险 +> 3. 缺少数据脱敏机制 +> 4. 审计日志不完整 +> +> **建议修改**： +> ``` +> 安全加固措施： +> 1. 数据脱敏 +> - 日志中罪犯姓名替换为编号 +> - 敏感信息（如家庭地址）脱敏存储 +> - 导出报告时自动添加水印 +> +> 2. 访问控制 +> - 基于角色的细粒度权限控制 +> - 敏感操作二次验证 +> - 数据访问全程审计 +> +> 3. 日志安全 +> - 日志加密存储 +> - 敏感日志定期清理 +> - 日志访问需要授权 +> +> 4. 传输安全 +> - 全站HTTPS +> - 敏感接口使用双向认证 +> ``` + +### 4.3 李志强专家综合评分 + +| 评审维度 | 满分 | 得分 | 扣分原因 | +|---------|-----|------|---------| +| 性能设计 | 30 | 15 | 缺少异步队列和缓存 | +| 可用性设计 | 25 | 12 | 缺少容错和降级 | +| 安全设计 | 25 | 15 | 缺少脱敏和审计 | +| 扩展性 | 20 | 15 | 架构设计合理 | +| **总分** | **100** | **57** | 需要优化 | + +### 4.4 李志强专家评审结论 + +> **总体结论**：有条件通过，需优化技术架构 +> +> **核心问题**： +> 1. 必须引入异步队列处理批量生成任务 +> 2. 必须实现多级缓存机制 +> 3. 必须设计AI服务容错降级方案 +> 4. 必须加强数据安全和审计 +> +> **建议**： +> - 架构设计评审需要监狱管理局信息中心参与 +> - 性能测试需要模拟真实场景（500+并发） +> - 安全评估需要通过等保三级测评 + +--- + +## 五、产品UX专家评审意见 + +### 专家背景 +**陈思雨** +- 某知名B端SaaS公司产品设计总监 +- 12年B端产品设计经验 +- 心理学硕士 +- 擅长企业级应用信息架构设计 +- 曾主导多个司法、政务系统产品设计 + +### 评审意见 + +#### 5.1 总体评价 + +> "从产品设计和用户体验角度来看，这是一份有潜力但需要大量打磨的需求文档。B端产品的核心是效率，而当前设计中存在很多'看起来功能很全，但用起来很累'的问题。我将从信息架构、交互流程、视觉设计三个维度进行详细分析。" + +#### 5.2 信息架构问题 + +##### 问题1：页面信息密度过高 + +**原文设计**：报告编辑页面采用左右分栏布局 + +``` +左侧：罪犯列表（280px） +右侧：基本信息 + 维度分析 + 综合结论 +``` + +**专家意见**： + +> "这是一个典型的信息过载问题！ +> +> **问题分析**： +> 1. 管教民警需要同时查看罪犯列表、编辑报告内容、查看数据源 +> 2. 当前布局导致每个区域都很拥挤 +> 3. 滚动操作频繁，操作效率低 +> +> **认知负荷计算**： +> ``` +> 用户任务：同时处理5个罪犯的评估报告 +> 当前布局操作步骤： +> 1. 在左侧列表找到罪犯A（滚动） +> 2. 在右侧查看报告内容（滚动） +> 3. 修改内容（滚动定位到编辑区） +> 4. 切换到罪犯B（滚动左侧列表） +> 5. ...重复... +> 预计操作时间：15-20分钟/份 +> ``` +> +> **建议修改**： +> ``` +> 优化方案：卡片式多任务布局 +> +> 页面布局： +> ┌─────────────────────────────────────────┐ +│ 工具栏： [+新建报告] [批量生成] [导出] │ +├──────────────┬────────────────────────────┤ +│ │ ┌────────────────────┐ │ +│ 罪犯列表 │ │ 报告卡片1 │ │ +│ ┌──────────┐│ │ 张三 - 入监评估 │ │ +│ │ ✓选中 ││ │ [待修改] [已完成] │ │ +│ │ 张三 ││ │ ┌──────────────┐ │ │ +│ │ 2024001 ││ │ │ 报告预览 │ │ │ +│ └──────────┘│ │ │ ... │ │ │ +│ ┌──────────┐│ │ └──────────────┘ │ │ +│ │ 李四 ││ │ │ │ +│ │ 2024002 ││ │ ┌────────────────────┐│ +│ └──────────┘│ │ │ 报告卡片2 ││ +│ ┌──────────┐│ │ │ 李四 - 定期评估 ││ +│ │ 王五 ││ │ │ [已完成] [待审核] ││ +│ │ 2024003 ││ │ └────────────────────┘│ +│ └──────────┘│ │ │ +│ ... │ │ │ +├──────────────┴────────────────────────────┤ +│ 底部Tab： [进行中(3)] [已完成(5)] [待审核(2)] │ +└─────────────────────────────────────────┘ +> +> 优势： +> - 多个报告卡片同时可见 +> - 快速切换，无需滚动 +> - 状态一目了然 +> ``` + +##### 问题2：缺少操作引导 + +**原文设计**：用户自行探索功能 + +**专家意见**： + +> "B端用户时间宝贵，复杂功能必须有清晰的引导！ +> +> **问题分析**： +> 1. 首次使用的用户不知道从哪里开始 +> 2. 复杂的AI生成功能没有使用说明 +> 3. 审核流程没有状态指引 +> +> **建议修改**： +> ``` +> 方案1：向导式流程（Wizard） +> +> 步骤1：选择罪犯 +> ○ 单个选择 +> ○ 批量选择（已选：5人） +> +> 步骤2：数据检查 +> ✓ 罪犯档案 - 完整 +> ✓ 计分考核 - 完整（12个月） +> ⚠ 消费记录 - 缺失（2个月） +> [补录消费记录] +> +> 步骤3：选择模板 +> [模板缩略图] +> 入监综合评估报告 v1.2 +> +> 步骤4：确认生成 +> 预计生成时间：3分钟 +> [开始生成] +> +> 方案2：首次使用引导 +> 首次登录时显示操作指引 +> 可跳过，但保留入口 +> ``` + +##### 问题3：状态展示不清晰 + +**原文设计**：报告状态通过枚举值展示 + +**专家意见**： + +> "用户需要直观看到当前处于什么阶段，下一步应该做什么！ +> +> **当前问题**： +> 1. 状态标签颜色不统一 +> 2. 状态含义不直观（如'DRAFT'用户看不懂） +> 3. 不知道当前状态可以做什么操作 +> +> **建议修改**： +> ``` +> 状态展示优化： +> +> 状态 颜色 文案 可执行操作 +> ────────────────────────────────────────── +> 草稿 灰色 待完善 [编辑] [提交审核] +> 待审核 蓝色 审核中 [撤回] +> 已通过 绿色 已完成 [导出] [归档] +> 已退回 红色 需修改 [查看原因] [编辑] [重新提交] +> 已归档 紫色 已归档 [查看] +> +> 状态流转图（可视化）： +> [草稿] ──[提交]──→ [审核中] +> ↑ │ +│ [撤回] ┌──┴──┐ +│ │ │ +> [退回] [通过] +> │ │ +> ↓ ↓ +> [待完善] [已完成] +> │ │ +> └───────┘ +> ``` + +#### 5.3 交互流程问题 + +##### 问题1：保存机制不友好 + +**原文设计**：手动保存 + +**专家意见**： + +> "手动保存是反人类设计！ +> +> **问题分析**： +> 1. 用户可能忘记保存 +> 2. 意外关闭浏览器导致数据丢失 +> 3. 没有显示保存状态 +> +> **建议修改**： +> ``` +> 自动保存 + 状态显示 +> +> 工具栏显示： +> [草稿] ● 自动保存中... +> ✓ 已保存 14:32 +> +> 或者： +> [草稿] ⊙ 未保存更改 +> [放弃更改] [保存草稿] +> +> 本地存储： +> - 自动保存到本地存储 +> - 浏览器崩溃后可恢复 +> - 切换罪犯时自动保存当前编辑 +> ``` + +##### 问题2：缺少快捷操作 + +**原文设计**：常规按钮操作 + +**专家意见**： + +> "高频操作需要快捷方式！ +> +> **建议增加快捷键**： +> | 快捷键 | 功能 | +> |-------|------| +> | Ctrl+S | 保存草稿 | +> | Ctrl+N | 新建报告 | +> | Ctrl+E | 导出PDF | +> | Ctrl+Enter | 提交审核 | +> | Tab | 切换输入框 | +> | Esc | 关闭弹窗 | +> +> **建议增加右键菜单**： +> ``` +> 在罪犯列表上右键： +> ├── 生成报告 +> ├── 查看历史报告 +> ├── 查看该犯档案 +> └── 复制罪犯编号 +> ``` + +#### 5.4 视觉设计问题 + +##### 问题1：AI标识不醒目 + +**原文设计**：AI生成内容显示"AI生成"标识 + +**专家意见**： + +> "AI生成内容需要特别醒目的标识！ +> +> **建议修改**： +> ``` +> ┌─────────────────────────────┐ +> │ 服刑表现评估 │ +> │ ┌───────────────────────┐ │ +> │ │ [AI图标] AI生成 │ │ +> │ │ 该犯入监以来表现良好... │ │ +> │ │ │ │ +> │ │ [重新生成] [人工修改] │ │ +> │ └───────────────────────┘ │ +> └─────────────────────────────┘ +> +> AI标识规范： +> - 图标：机器人🤖 或 AI字样 +> - 颜色：蓝色边框 + 浅蓝背景 +> - 位置：内容区域左上角 +> - 交互：点击显示AI生成详情（生成时间、模型版本） +> ``` + +##### 问题2：风险等级视觉区分不足 + +**原文设计**：风险等级文字展示 + +**专家意见**： + +> "风险等级需要一目了然！ +> +> **建议修改**： +> ``` +> 风险等级视觉设计： +> +> ┌────────────────────────────────────────────┐ +> │ 风险等级： │ +> │ ● 低风险 ○ 中风险 ○ 高风险 ○ 极高 │ +> │ (绿色) (黄色) (橙色) (红色) │ +> │ │ +> │ 或者使用标签形式： │ +> │ [🟢 低风险] [🟡 中风险] [🟠 高风险] [🔴 极高] │ +> └────────────────────────────────────────────┘ +> ``` + +### 5.5 陈思雨专家综合评分 + +| 评审维度 | 满分 | 得分 | 扣分原因 | +|---------|-----|------|---------| +| 信息架构 | 30 | 18 | 信息密度过高 | +| 交互流程 | 30 | 15 | 缺少引导和快捷操作 | +| 视觉设计 | 20 | 12 | 标识不够醒目 | +| 易用性 | 20 | 12 | 保存机制不友好 | +| **总分** | **100** | **57** | 需要大量优化 | + +### 5.6 陈思雨专家评审结论 + +> **总体结论**：有条件通过，需优化用户体验 +> +> **核心问题**： +> 1. 页面信息密度过高，需要重新设计布局 +> 2. 必须增加向导式操作引导 +> 3. 必须实现自动保存机制 +> 4. 必须增加快捷键支持 +> 5. AI标识和风险等级需要更醒目的视觉设计 +> +> **建议**： +> - 需要进行用户调研，了解真实用户习惯 +> - 建议制作高保真原型进行可用性测试 +> - 关键流程需要设计A/B测试方案 + +--- + +## 六、综合评审结论 + +### 6.1 各专家评分汇总 + +| 专家 | 评审维度 | 得分 | 结论 | +|-----|---------|------|------| +| 刘建国 | 业务流程 | 60/100 | 不通过，需重大修订 | +| 张明远 | 法律合规 | 42/100 | 不通过，存在重大法律风险 | +| 王淑芬 | 心理评估 | 45/100 | 不通过，需重大修订 | +| 李志强 | 技术架构 | 57/100 | 有条件通过，需优化 | +| 陈思雨 | 产品UX | 57/100 | 有条件通过，需优化 | +| **平均分** | - | **52/100** | **总体不通过** | + +### 6.2 核心问题汇总表 + +| 优先级 | 问题数量 | 问题类型 | 影响范围 | +|-------|---------|---------|---------| +| P0-阻断 | 5 | 流程设计缺陷、法律效力、安全 | 整个系统无法上线 | +| P1-严重 | 8 | 功能缺失、性能风险 | 影响核心功能实现 | +| P2-一般 | 12 | 交互优化、体验改进 | 影响用户体验 | + +### 6.3 P0级核心问题（必须解决） + +| 序号 | 问题 | 专家 | 建议方案 | +|-----|------|------|---------| +| 1 | 报告生成流程缺少数据完整性检查 | 刘建国 | 增加数据完整性检测步骤 | +| 2 | AI生成内容法律效力未明确 | 张明远 | 明确AI使用范围，标注AI生成内容 | +| 3 | 缺少减刑假释法定评估要素 | 张明远 | 增加法定评估维度 | +| 4 | AI不能生成心理诊断结论 | 王淑芬 | 限制AI在心理评估中的应用范围 | +| 5 | 缺少AI提示词专业审核机制 | 王淑芬 | 建立心理专家审核流程 | + +### 6.4 修订建议 + +#### 第一阶段修订（P0问题） + +1. **流程修订** + - 增加数据完整性检查步骤 + - 明确AI使用边界（哪些可以AI生成，哪些必须人工） + - 增加专业审核环节 + +2. **文档修订** + - 补充法律合规性说明 + - 明确数字签名实现方案 + - 完善减刑假释模板 + +3. **架构修订** + - 设计异步生成队列 + - 实现多级缓存机制 + - 设计容错降级方案 + +#### 第二阶段修订（P1问题） + +4. **功能补充** + - 增加家庭帮教维度 + - 实现批量生成功能 + - 实现归档管理 + +5. **体验优化** + - 重新设计页面布局 + - 增加向导式操作 + - 实现自动保存 + +### 6.5 评审结论 + +> **总体评审结论**：不通过 +> +> **原因**： +> 1. 存在5个P0级问题，可能导致系统无法正常使用或存在法律风险 +> 2. 专家平均得分52分，未达到通过标准（70分） +> 3. 需要进行重大修订后重新评审 +> +> **下一步行动**： +> 1. 产品团队根据专家意见进行修订（预计2周） +> 2. 修订后重新组织专家评审会议 +> 3. 通过二审后再进入开发阶段 + +--- + +## 七、专家评审签认 + +| 角色 | 专家 | 评审日期 | 签名 | +|-----|------|---------|------| +| 监狱管理资深专家 | 刘建国（模拟） | 2026-01-18 | 刘某 | +| 刑罚执行专家 | 张明远（模拟） | 2026-01-18 | 张某 | +| 心理评估专家 | 王淑芬（模拟） | 2026-01-18 | 王某 | +| 技术架构专家 | 李志强（模拟） | 2026-01-18 | 李某 | +| 产品UX专家 | 陈思雨（模拟） | 2026-01-18 | 陈某 | + +--- + +**报告生成时间**：2026-01-18 +**报告版本**：v1.0 +**保密等级**：内部资料 +**评审状态**：待修订后二审 diff --git a/requirements/评估功能实现评估报告.md b/requirements/评估功能实现评估报告.md new file mode 100644 index 0000000..192dbaf --- /dev/null +++ b/requirements/评估功能实现评估报告.md @@ -0,0 +1,501 @@ +# 评估功能前后端实现评估报告 + +> 评估日期：2026-01-18 +> 评估范围：危险评估、计分考核、评估报告模块 +> 评估目标：发现交互逻辑问题、功能设置问题，为产品专家评审提供依据 + +--- + +## 一、功能模块概览 + +### 1.1 已实现模块清单 + +| 模块名称 | 中文名称 | 后端路径 | 前端路径 | 完成度 | +|---------|---------|---------|---------|-------| +| RiskAssessment | 危险评估 | `controller/admin/riskassessment/` | `views/prison/riskassessment/` | 90% | +| Score | 计分考核 | `controller/admin/score/` | `views/prison/score/` | 85% | +| ScoreRule | 考核规则配置 | `controller/admin/score/rule/` | 未实现 | 70% | +| ScoreDetail | 考核明细记录 | `controller/admin/score/detail/` | 未实现 | 70% | +| EvaluationReport | 评估报告 | `controller/admin/evaluationreport/` | `api/prison/evaluation/` | 75% | + +### 1.2 评估报告模块表结构 + +| 表名 | 说明 | 状态 | +|-----|------|------| +| `prison_evaluation_template` | 评估报告模板表 | ✅ 已创建 | +| `prison_evaluation_dimension` | 评估维度配置表 | ✅ 已创建 | +| `prison_evaluation_report` | 评估报告表 | ✅ 已创建 | +| `prison_evaluation_dimension_data` | 报告维度数据表 | ✅ 已创建 | +| `prison_report_comment` | 快捷评语库表 | ✅ 已创建 | +| `prison_evaluation_report_version` | 报告版本历史表 | ✅ 已创建 | +| `prison_evaluation_ai_log` | AI生成日志表 | ✅ 已创建 | + +--- + +## 二、需求实现对比分析 + +### 2.1 模板管理功能对比 + +| 需求功能 | 实现状态 | 问题说明 | +|---------|---------|---------| +| 新增模板 | ✅ 已实现 | | +| 编辑模板 | ✅ 已实现 | | +| 复制模板 | ❌ **未实现** | 需求文档3.1.3明确要求 | +| 启用/停用模板 | ✅ 已实现 | | +| 设为默认 | ❌ **未实现** | 需求文档3.1.3明确要求 | +| 版本管理 | ⚠️ 部分实现 | 仅存储，未实现版本对比 | +| 模板分类 | ✅ 已实现 | 支持4种类型 | + +### 2.2 维度管理功能对比 + +| 需求功能 | 实现状态 | 问题说明 | +|---------|---------|---------| +| 新增维度 | ✅ 已实现 | | +| 编辑维度 | ✅ 已实现 | | +| 删除维度 | ✅ 已实现 | | +| 复制维度 | ❌ **未实现** | 需求文档3.1.4.1明确要求 | +| 拖拽排序 | ❌ **未实现** | 仅后端存储sort字段，前端未实现拖拽 | +| 启用/停用 | ✅ 已实现 | | +| AI提示词配置 | ✅ 已实现 | | +| 数据源绑定 | ✅ 已实现 | | + +### 2.3 报告生成功能对比 + +| 需求功能 | 实现状态 | 问题说明 | +|---------|---------|---------| +| 手动创建报告 | ✅ 已实现 | | +| 批量生成报告 | ❌ **未实现** | 需求文档3.5.2明确要求 | +| 数据自动填充 | ✅ 已实现 | | +| AI生成初稿 | ✅ 已实现 | | +| 人工修改 | ✅ 已实现 | | +| 逐维度重新生成 | ✅ 已实现 | | +| 快捷评语 | ✅ 已实现 | | + +### 2.4 报告审核功能对比 + +| 需求功能 | 实现状态 | 问题说明 | +|---------|---------|---------| +| 提交审核 | ✅ 已实现 | | +| 审核通过 | ✅ 已实现 | | +| 审核退回 | ⚠️ **不完整** | 缺少结构化退回原因记录 | +| 撤回报告 | ❌ **未实现** | 需求文档3.13.3明确要求 | +| 退回后重新提交 | ✅ 已实现 | | + +### 2.5 报告导出功能对比 + +| 需求功能 | 实现状态 | 问题说明 | +|---------|---------|---------| +| 导出Excel | ✅ 已实现 | | +| 导出PDF | ❌ **未实现** | 需求文档3.9明确要求 | +| 导出Word | ❌ **未实现** | 需求文档3.9明确要求 | +| 批量导出 | ❌ **未实现** | 需求文档3.11.5明确要求 | +| 批量打包下载 | ❌ **未实现** | 需求文档3.9.2明确要求 | + +### 2.6 归档管理功能对比 + +| 需求功能 | 实现状态 | 问题说明 | +|---------|---------|---------| +| 报告归档 | ❌ **未实现** | 需求文档3.10明确要求 | +| 归档查询 | ❌ **未实现** | | +| 归档后不可修改 | ❌ **未实现** | | + +### 2.7 版本管理功能对比 + +| 需求功能 | 实现状态 | 问题说明 | +|---------|---------|---------| +| 版本记录 | ✅ 已实现 | 表结构已创建 | +| 版本查看 | ⚠️ 部分实现 | 仅存储，未实现查看功能 | +| 版本对比 | ❌ **未实现** | 需求文档3.8.2明确要求 | +| 版本回滚 | ❌ **未实现** | 需求文档3.8.2明确要求 | + +--- + +## 三、交互逻辑问题清单 + +### 3.1 报告编号生成规则不一致 + +**问题描述**： +- 需求规范：`RPT-{监区编码}-{年月}-{4位序号}` 示例：`RPT-JQ01-202601-0001` +- 代码实现：`PGEV + yyyyMMdd + 6位序号` 示例：`PGEV20260118000001` + +**影响**：报告编号不符合需求规范，无法直观识别监区信息 + +**建议修复**： +```java +// 建议改为： +// 1. 获取罪犯所属监区编码 +// 2. 获取当前年月 +// 3. 查询当月该监区的最大序号 +// 4. 格式：RPT-{监区编码}-{年月}-{序号(4位)} +``` + +### 3.2 审核退回流程不完整 + +**问题描述**： +- 当前实现：仅记录 `audit_opinion` 文本字段 +- 需求要求：结构化记录退回原因、驳回时间、驳回人 + +**影响**：退回原因无法有效传达给起草人，缺少退回时间追溯 + +**建议修复**： +```sql +-- 增加字段 +ALTER TABLE prison_evaluation_report +ADD COLUMN return_reason VARCHAR(500) COMMENT '退回原因', +ADD COLUMN return_time DATETIME COMMENT '退回时间', +ADD COLUMN return_by BIGINT COMMENT '退回人ID'; +``` + +### 3.3 缺少报告撤回功能 + +**问题描述**： +- 需求文档3.13.3明确要求：待审核状态可撤回为草稿 +- 当前代码：没有撤回(Withdraw/Recall)相关接口 + +**影响**：提交审核后发现问题无法及时撤回修改 + +**建议新增接口**： +``` +POST /prison/evaluation-report/report/withdraw +参数：reportId +前置条件：status = PENDING_AUDIT(2) +后置条件：status = DRAFT(1) +``` + +### 3.4 状态枚举定义不一致 + +**问题描述**： +- 需求文档：草稿(1)、待审核(2)、已通过(3)、已退回(4)、已归档(5) +- 代码实现：缺少"已归档"状态枚举 + +**影响**：归档功能无法正确实现状态流转 + +**建议修复**：在 `EvaluationReportStatusEnum` 中添加 `ARCHIVED(5, "已归档")` + +### 3.5 维度类型定义不一致 + +**问题描述**： +- 数据库表：1-基本信息, 2-犯罪情况, 3-服刑表现... +- DO类定义：1-心理测评, 2-危险性评估, 3-改造表现... + +**影响**：前后端数据交换可能出现类型映射错误 + +**建议修复**：统一枚举定义，确保DO类与数据库枚举值一致 + +--- + +## 四、功能设置问题清单 + +### 4.1 模板缺少"复制"功能 + +**问题描述**：需求要求支持复制模板快速创建，当前未实现 + +**业务场景**： +- 管理员需要基于现有模板创建新版模板 +- 不同监区需要基于标准模板创建本地化版本 + +**建议实现**： +```java +@PostMapping("/template/copy") +public CommonResult copyTemplate(@RequestParam("templateId") Long templateId) { + // 1. 查询原模板 + // 2. 复制模板基础信息（名称加"副本"后缀） + // 3. 复制所有维度配置 + // 4. 返回新模板ID +} +``` + +### 4.2 维度缺少"复制"功能 + +**问题描述**：需求要求支持复制维度快速创建，当前未实现 + +**业务场景**： +- 类似维度需要微调配置 +- 跨模板复用维度配置 + +**建议实现**： +```java +@PostMapping("/dimension/copy") +public CommonResult copyDimension(@RequestParam("dimensionId") Long dimensionId) { + // 1. 查询原维度 + // 2. 复制维度配置（名称加"副本"后缀） + // 3. 返回新维度ID +} +``` + +### 4.3 缺少批量生成报告功能 + +**问题描述**：需求要求支持选择多个罪犯+模板批量生成报告 + +**业务场景**： +- 月末批量生成在押犯评估报告 +- 入监队批量生成新入监罪犯评估报告 + +**建议实现**： +```java +@PostMapping("/report/batch-generate") +public CommonResult> batchGenerate( + @RequestBody BatchGenerateReqVO vo) { + // vo包含：prisonerIds, templateId, evaluationDate + // 使用异步队列处理，返回任务ID +} +``` + +### 4.4 缺少归档管理功能 + +**问题描述**：需求要求已审核报告可归档，归档后不可修改 + +**建议实现**： +```java +@PostMapping("/report/archive") +public CommonResult archive(@RequestParam("reportId") Long reportId); + +@PostMapping("/report/unarchive") +public CommonResult unarchive(@RequestParam("reportId") Long reportId); + +@PostMapping("/report/archive-list") +public CommonResult batchArchive(@RequestParam("reportIds") List reportIds); +``` + +### 4.5 缺少版本对比和回滚功能 + +**问题描述**：需求要求支持版本对比和回滚 + +**建议实现**： +```java +// 版本对比 +@GetMapping("/report/version/compare") +public CommonResult compareVersions( + @RequestParam("reportId") Long reportId, + @RequestParam("version1") Integer version1, + @RequestParam("version2") Integer version2); + +// 版本回滚 +@PostMapping("/report/version/rollback") +public CommonResult rollback( + @RequestParam("reportId") Long reportId, + @RequestParam("targetVersion") Integer targetVersion); +``` + +### 4.6 缺少PDF/Word导出功能 + +**问题描述**：需求要求支持PDF和Word格式导出 + +**建议实现**： +```java +@PostMapping("/report/export-pdf") +public void exportPdf(@RequestParam("reportId") Long reportId, HttpServletResponse response); + +@PostMapping("/report/export-word") +public void exportWord(@RequestParam("reportId") Long reportId, HttpServletResponse response); + +@PostMapping("/report/batch-export-zip") +public void batchExportZip(@RequestBody List reportIds, HttpServletResponse response); +``` + +--- + +## 五、性能与安全缺失项 + +### 5.1 缓存机制未实现 + +**需求要求**： +- 罪犯基础信息缓存（5分钟过期） +- 考核数据缓存（10分钟过期） +- 模板配置缓存（1小时过期） + +**当前状态**：未实现任何缓存 + +**建议实现**： +```java +@Cacheable(value = "prisoner", key = "#prisonerId", ttl = 5 * 60) +public PrisonerDTO getPrisoner(Long prisonerId) { ... } + +@Cacheable(value = "scoreData", key = "#prisonerId + ':' + #year", ttl = 10 * 60) +public ScoreDTO getScoreData(Long prisonerId, Integer year) { ... } +``` + +### 5.2 异步生成队列未实现 + +**需求要求**： +- 批量生成使用异步队列 +- 支持队列状态查询 +- 失败重试（最多3次） +- 生成完成通知 + +**当前状态**：同步调用LLM服务 + +**建议实现**： +```java +@Async("reportGenerateExecutor") +public CompletableFuture generateReportAsync(GenerateTask task) { + // 调用LLM生成报告 + // 失败时重试3次 + // 完成后发送系统通知 +} +``` + +### 5.3 AI服务降级未实现 + +**需求要求**：AI服务不可用时有降级策略 + +**当前状态**：仅检查LLM是否可用，无降级机制 + +**建议实现**： +- 使用默认模板填充 +- 标记维度为"待人工填写" +- 记录服务降级日志 + +--- + +## 六、前端交互问题 + +### 6.1 评估报告前端页面未完整实现 + +| 组件 | 状态 | 说明 | +|-----|------|------| +| 报告模板管理页 | ❌ 未实现 | 仅有API，无页面 | +| 维度配置管理页 | ❌ 未实现 | 仅有API，无页面 | +| 报告编辑页面 | ❌ 未实现 | 仅有API，无页面 | +| 报告列表页 | ❌ 未实现 | 仅有API，无页面 | + +### 6.2 前后端联调问题 + +**问题**：前端API已定义，但后端Controller路径不一致 + +**示例**： +- 前端定义：`/prison/evaluation-report/template/page` +- 后端实际：`/prison/evaluation-report/template/page` ✅ 一致 + +**但缺少以下前端页面**： +- 模板列表/编辑页面 +- 维度配置页面 +- 报告编辑页面（左右分栏布局） +- 报告预览/打印页面 +- 快捷评语管理页面 + +--- + +## 七、功能实现完成度汇总 + +| 功能模块 | 已实现 | 需完善 | 未实现 | 完成度 | +|---------|-------|-------|-------|-------| +| 模板管理 | 8项 | 1项 | 2项 | **75%** | +| 维度管理 | 5项 | 0项 | 2项 | **71%** | +| 报告创建 | 5项 | 1项 | 1项 | **79%** | +| 报告审核 | 3项 | 1项 | 1项 | **60%** | +| 报告导出 | 1项 | 0项 | 3项 | **25%** | +| 归档管理 | 0项 | 0项 | 3项 | **0%** | +| 版本管理 | 1项 | 1项 | 2项 | **33%** | +| AI生成 | 3项 | 2项 | 2项 | **50%** | +| 前端页面 | 0项 | 0项 | 5项 | **0%** | + +**总体评估**：核心数据模型和API已实现，但前端页面缺失较多，高级功能（批量生成、归档、版本对比）未实现。 + +--- + +## 八、改进优先级建议 + +### P0 - 必须修复（影响核心流程） + +1. **报告编号规则修复** - 符合需求规范 +2. **审核退回流程完善** - 结构化记录退回原因 +3. **添加报告撤回功能** - 支持待审核撤回 +4. **状态枚举补全** - 添加已归档状态 + +### P1 - 应该实现（影响用户体验） + +5. **模板复制功能** +6. **维度复制功能** +7. **批量生成报告功能** +8. **PDF/Word导出功能** +9. **归档管理功能** +10. **版本对比功能** + +### P2 - 建议实现（提升体验） + +11. **数据缓存机制** +12. **异步生成队列** +13. **AI服务降级** +14. **前端页面完整实现** +15. **维度拖拽排序前端** + +--- + +## 九、待产品专家评审事项 + +### 9.1 业务流程问题 + +1. **批量生成场景确认** + - 一次性最多生成多少个报告？ + - 是否需要显示生成进度？ + - 生成失败如何处理？ + +2. **审核退回流程确认** + - 是否必须填写退回原因？ + - 退回原因是否需要分类？ + - 退回后是否需要通知起草人？ + +3. **归档策略确认** + - 自动归档还是手动归档？ + - 归档后是否可导出？ + - 归档文件保留多长时间？ + +### 9.2 交互设计问题 + +1. **报告编辑页面布局** + - 需求文档设计了左右分栏布局，是否认可？ + - 罪犯列表每页显示多少条？ + - 是否需要支持快捷键操作？ + +2. **版本对比界面** + - 左右分屏对比是否足够？ + - 是否需要高亮显示差异？ + - 是否需要一键还原？ + +### 9.3 功能优先级确认 + +1. **第一阶段MVP功能范围** + - 模板管理、维度配置 + - 报告创建、AI生成 + - 报告审核、Excel导出 + +2. **第二阶段功能范围** + - 批量生成、PDF导出 + - 归档管理、版本对比 + +--- + +## 附录：关键文件清单 + +### 后端关键文件 + +| 文件路径 | 说明 | +|---------|------| +| `controller/admin/evaluationreport/EvaluationReportController.java` | 主控制器 | +| `service/evaluationreport/EvaluationReportService.java` | 服务接口 | +| `service/evaluationreport/impl/EvaluationReportServiceImpl.java` | 服务实现 | +| `dal/dataobject/evaluationreport/EvaluationReportDO.java` | 报告实体 | +| `dal/dataobject/evaluationreport/EvaluationDimensionDO.java` | 维度实体 | +| `enums/EvaluationReportStatusEnum.java` | 状态枚举 | + +### 前端关键文件 + +| 文件路径 | 说明 | +|---------|------| +| `api/prison/evaluation/index.ts` | API定义 | +| `views/prison/riskassessment/index.vue` | 危险评估列表 | +| `views/prison/score/index.vue` | 计分考核列表 | + +### 数据库脚本 + +| 文件路径 | 说明 | +|---------|------| +| `sql/evaluation_report.sql` | 评估报告表结构 | +| `sql/evaluation_report_dict_data.sql` | 字典数据 | + +--- + +**报告生成时间**：2026-01-18 +**评估人**：Claude Code +**版本**：v1.0 diff --git a/requirements/需求-01-监管看板.md b/requirements/需求-01-监管看板.md new file mode 100644 index 0000000..81315bf --- /dev/null +++ b/requirements/需求-01-监管看板.md @@ -0,0 +1,126 @@ +# 需求-01-监管看板 + +> 模块名称：监管看板 +> 优先级：P0 +> 预估工时：18h + +--- + +## 一、业务背景 + +监管看板是系统的首页，为监狱管理者提供全局视角的数据概览，帮助快速掌握监狱运行状态。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 监狱长 | 作为监狱管理者，我希望在首页看到在册罪犯总数，这样我能快速了解监狱规模 | P0 | +| 教导员 | 作为教导员，我希望看到不同年龄段罪犯的分布情况，这样我好制定针对性教育方案 | P0 | +| 狱政科长 | 作为狱政科长，我希望看到不同刑期罪犯的占比，这样我能合理安排警力配置 | P0 | +| 分管领导 | 作为分管领导，我希望看到各省籍贯分布热力图，这样我能了解罪犯构成特点 | P0 | +| 管理员 | 作为系统管理员，我希望敏感信息自动脱敏显示，这样保护罪犯隐私 | P0 | + +## 三、功能需求 + +### 3.1 首页框架 + +**功能描述**：搭建监管看板的整体布局结构 + +**功能列表**： +- 顶部导航菜单配置 +- 左侧侧边栏菜单 +- 主体内容区域布局 +- 响应式适配 + +### 3.2 核心指标卡片 + +**功能描述**：展示监狱关键数据的汇总卡片 + +**指标项**： + +| 指标名称 | 数据来源 | 计算逻辑 | 展示形式 | +|---------|---------|---------|---------| +| 在册罪犯总数 | 罪犯表 | status=在押 count | 数字卡片 | +| 本月已释放 | 释放记录 | 本月释放 count | 数字卡片 | +| 本月已移交 | 移交记录 | 本月移交 count | 数字卡片 | +| 当前就医人数 | 罪犯位置 | 在医院监区 count | 数字卡片 | +| 当前禁闭人数 | 罪犯位置 | 在禁闭室 count | 数字卡片 | + +### 3.3 年龄分布图表 + +**功能描述**：展示罪犯年龄结构分布 + +**展示要求**： +- 使用 ECharts 饼图 +- 年龄分段：未成年(≤17)、青年(18-30)、中年(31-50)、老年(51-60)、老龄(60+) +- 鼠标悬停显示具体人数和占比 +- 支持图例点击筛选 + +### 3.4 刑期分布图表 + +**功能描述**：展示罪犯刑期结构分布 + +**展示要求**： +- 使用 ECharts 饼图 +- 刑期分段：短刑(≤3年)、中刑(3-10年)、长刑(10年以上)、无期、死缓 +- 颜色区分不同刑期类型 + +### 3.5 文化程度图表 + +**功能描述**：展示罪犯文化程度分布 + +**展示要求**： +- 使用 ECharts 饼图 +- 学历分类：文盲、小学、初中、高中、中专、大专、本科、研究生及以上 + +### 3.6 省份分布地图 + +**功能描述**：使用热力图展示罪犯籍贯分布 + +**展示要求**： +- 使用 ECharts 中国地图 +- 按省份着色，深度代表人数多少 +- 点击省份显示该省罪犯数量和占比 + +### 3.7 数据脱敏组件 + +**功能描述**：对敏感信息进行脱敏展示 + +**脱敏规则**： + +| 字段 | 脱敏规则 | 示例 | +|-----|---------|-----| +| 身份证号 | 保留前3后4位，中间用*替代 | 110***********1234 | +| 手机号 | 保留前3后4位，中间用*替代 | 138****5678 | +| 家庭住址 | 详细地址只显示到区县 | 北京市朝阳区*** | +| 姓名 | 只显示第一个字 | 张** | + +## 四、非功能需求 + +### 4.1 性能需求 +- 页面加载时间 < 3秒 +- 图表渲染时间 < 1秒 + +### 4.2 安全需求 +- 敏感数据脱敏展示 +- 数据权限控制（按监区/分监区） + +## 五、验收标准 + +- [ ] 核心指标卡片数据准确 +- [ ] 年龄分布饼图展示正常，交互正常 +- [ ] 刑期分布饼图展示正常 +- [ ] 文化程度饼图展示正常 +- [ ] 中国地图热力图正常显示 +- [ ] 敏感信息自动脱敏 +- [ ] 页面响应式适配正常 + +## 六、相关模块 + +- 依赖：狱政信息管理模块（罪犯数据） +- 依赖：系统管理模块（用户权限） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-02-狱政信息管理.md b/requirements/需求-02-狱政信息管理.md new file mode 100644 index 0000000..f926235 --- /dev/null +++ b/requirements/需求-02-狱政信息管理.md @@ -0,0 +1,247 @@ +# 需求-02-狱政信息管理 + +> 模块名称：狱政信息管理 +> 优先级：P0 +> 预估工时：24h + +--- + +## 一、业务背景 + +狱政信息管理是监狱管理的核心模块，实现罪犯从入监到出监的全生命周期管理。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 狱政干事 | 作为狱政干事，我希望能够登记新入监罪犯的信息，这样罪犯才能正式纳入管理 | P0 | +| 狱政科长 | 作为狱政科长，我希望能够查询所有罪犯信息，这样我好掌握整体情况 | P0 | +| 分监区长 | 作为分监区长，我希望能够查询本分监区的罪犯，这样我能快速找到目标罪犯 | P0 | +| 狱政干事 | 作为狱政干事，我希望能够修改罪犯信息，这样保证信息准确 | P1 | +| 狱政干事 | 作为狱政干事，我希望能够登记罪犯释放信息，这样业务流程完整 | P0 | +| 狱政干事 | 作为狱政干事，我希望能够登记罪犯调监信息，这样追踪罪犯位置变更 | P0 | +| 管理员 | 作为管理员，我希望能够批量导入导出罪犯数据，这样提高工作效率 | P1 | + +## 三、功能需求 + +### 3.1 罪犯信息管理 + +#### 3.1.1 入监登记 + +**功能描述**：登记新入监罪犯的基础信息 + +**表单字段**： + +| 字段分组 | 字段名称 | 必填 | 说明 | +|---------|---------|-----|------| +| **基础信息** | 罪犯编号 | 是 | 系统自动生成或手动录入 | +| | 姓名 | 是 | 罪犯真实姓名 | +| | 性别 | 是 | 男/女 | +| | 身份证号 | 是 | 18位身份证号码 | +| | 出生日期 | 是 | 由身份证号解析或手动填写 | +| | 民族 | 否 | 民族选择 | +| | 籍贯 | 否 | 省市区三级联 | +| | 文化程度 | 否 | 文盲/小学/初中/高中/大专/本科及以上 | +| | 职业 | 否 | 捕前职业 | +| | 家庭住址 | 否 | 详细地址 | +| **刑罚信息** | 罪名 | 是 | 罪名选择或输入 | +| | 刑期-年 | 是 | 数字输入 | +| | 刑期-月 | 是 | 0-11数字输入 | +| | 是否无期 | 是 | 是/否 | +| | 是否死缓 | 是 | 是/否 | +| | 判决法院 | 否 | 判决法院名称 | +| | 判决日期 | 是 | 日期选择 | +| | 判决书编号 | 否 | 判决书文号 | +| | 原判刑期 | 否 | 原判刑期描述 | +| | 入狱日期 | 是 | 日期选择 | +| | 释放日期 | 是 | 根据刑期自动计算或手动调整 | +| **监管信息** | 监管等级 | 是 | 宽管/普管/严管/考察 | +| | 风险等级 | 是 | 高风险/中风险/低风险 | +| | 监区 | 是 | 选择监区 | +| | 分监区 | 是 | 根据监区联动显示 | +| | 监室 | 是 | 根据分监区联动显示 | +| | 状态 | 是 | 默认可选：在押 | + +**业务规则**： +- 释放日期 = 入狱日期 + 刑期（需考虑减刑情况） +- 身份证号需校验格式 +- 编号需唯一 + +#### 3.1.2 罪犯列表 + +**功能描述**：查询和展示罪犯列表 + +**列表字段**： +- 罪犯编号、姓名、性别、身份证号(脱敏) +- 罪名、刑期、入狱日期 +- 监管等级、风险等级 +- 当前监区、当前监室 +- 状态、创建时间 + +**筛选条件**： +- 罪犯编号（模糊搜索） +- 姓名（模糊搜索） +- 性别（下拉选择） +- 罪名（下拉选择） +- 监管等级（下拉选择） +- 风险等级（下拉选择） +- 监区（下拉选择） +- 状态（下拉选择） +- 入狱日期范围（日期区间） + +**操作功能**： +- 查看详情 +- 修改信息 +- 删除（逻辑删除） +- 批量删除 +- 导出Excel + +#### 3.1.3 罪犯详情 + +**功能描述**：查看罪犯详细信息 + +**展示内容**： +- 基础信息卡片 +- 刑罚信息卡片 +- 监管信息卡片 +- 位置变更历史 +- 考核记录汇总 +- 测评记录汇总 +- 消费记录汇总 + +#### 3.1.4 罪犯信息修改 + +**功能描述**：修改罪犯信息 + +**规则**： +- 部分字段修改需要审批（如刑期变更） +- 修改记录需要留痕 + +### 3.2 出监管理 + +#### 3.2.1 释放登记 + +**功能描述**：登记罪犯释放信息 + +**释放类型**： +- 刑满释放 +- 假释 +- 暂予监外执行 +- 减刑 +- 法院裁定释放 +- 死亡 +- 其他 + +**表单字段**： +- 罪犯选择（从列表选择或搜索） +- 释放类型 +- 释放原因 +- 实际释放日期 +- 释放凭证（文书编号等） +- 交接人信息 +- 备注 + +**业务流程**： +1. 选择或搜索罪犯 +2. 填写释放信息 +3. 提交审核 +4. 审核通过后更新罪犯状态为"已释放" +5. 记录释放日志 + +#### 3.2.2 移交登记 + +**功能描述**：登记罪犯转监/移交信息 + +**表单字段**： +- 罪犯选择 +- 移交类型（转入/转出） +- 目标监狱 +- 移交原因 +- 移交日期 +- 交接人信息 + +### 3.3 调监管理 + +#### 3.3.1 调监操作 + +**功能描述**：罪犯在监区/监室间的调换 + +**表单字段**： +- 罪犯选择 +- 目标监区 +- 目标分监区 +- 目标监室 +- 调监原因 + +**业务规则**： +- 目标监室床位未满 +- 严管级罪犯不能调入普通监区 +- 调监后自动同步人数 + +#### 3.3.2 位置历史 + +**功能描述**：查看罪犯位置变更历史 + +**展示内容**： +- 时间线展示位置变更记录 +- 包含：变更时间、原位置、新位置、变更原因、操作人 + +### 3.4 批量操作 + +#### 3.4.1 批量导入 + +**功能描述**：通过Excel批量导入罪犯信息 + +**要求**： +- 提供导入模板下载 +- 支持数据校验 +- 显示导入结果（成功/失败数量） +- 失败记录提供下载 + +#### 3.4.2 批量导出 + +**功能描述**：导出罪犯列表 + +**要求**： +- 支持按条件筛选后导出 +- 支持导出全部 +- 敏感字段自动脱敏 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 罪犯编号全局唯一 | +| BR-002 | 身份证号需符合18位校验规则 | +| BR-003 | 释放日期根据入狱日期和刑期自动计算 | +| BR-004 | 调监时目标监室人数不能超过床位数 | +| BR-005 | 严管级罪犯只能分配在严管监区 | +| BR-006 | 敏感信息在列表页脱敏展示 | +| BR-007 | 罪犯状态变更需要记录变更日志 | + +## 五、验收标准 + +- [ ] 支持入监登记，信息完整 +- [ ] 支持罪犯列表查询和筛选 +- [ ] 支持查看罪犯详情 +- [ ] 支持修改罪犯信息 +- [ ] 支持释放登记 +- [ ] 支持移交登记 +- [ ] 支持调监操作 +- [ ] 支持查看位置历史 +- [ ] 支持批量导入导出 +- [ ] 敏感信息自动脱敏 +- [ ] 数据权限控制（按监区） + +## 六、相关模块 + +- 依赖：监区管理模块（获取监区/监室列表） +- 依赖：字典管理模块（获取选项数据） +- 被依赖：计分考核模块（获取罪犯信息） +- 被依赖：测评管理模块（获取罪犯信息） +- 被依赖：消费管理模块（获取罪犯信息） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-03-计分考核.md b/requirements/需求-03-计分考核.md new file mode 100644 index 0000000..63643cb --- /dev/null +++ b/requirements/需求-03-计分考核.md @@ -0,0 +1,231 @@ +# 需求-03-计分考核 + +> 模块名称：计分考核 +> 优先级：P0 +> 预估工时：24h + +--- + +## 一、业务背景 + +计分考核是监狱对罪犯进行日常管理和改造评价的核心手段，直接关系到罪犯的减刑、假释等处遇变更。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 分监区长 | 作为分监区长，我希望配置考核规则，这样考核标准统一明确 | P0 | +| 考核干事 | 作为考核干事，我希望每天记录罪犯的考核得分，这样客观评价罪犯表现 | P0 | +| 考核干事 | 作为考核干事，我希望自动计算月度总分，这样减少人工计算工作量 | P0 | +| 监狱长 | 作为监狱长，我希望查看考核等级评定结果，这样为减刑假释提供依据 | P0 | +| 罪犯 | 作为罪犯，我希望看到自己的考核得分和等级，这样我知道自己的改造表现 | P1 | +| 考核干事 | 作为考核干事，我希望考核结果公示，这样增加透明度 | P1 | + +## 三、功能需求 + +### 3.1 考核规则配置 + +#### 3.1.1 规则分类 + +**考核类别**： +- 劳动改造 +- 教育改造 +- 日常行为 +- 卫生纪律 +- 加分项 +- 扣分项 + +#### 3.1.2 规则管理 + +**规则字段**： +- 规则编码（唯一） +- 规则名称 +- 所属类别 +- 分值（正数为加分，负数为扣分） +- 日最高分限制 +- 月最高分限制 +- 规则说明 +- 状态（启用/禁用） +- 排序 + +**示例规则**： + +| 类别 | 规则名称 | 分值 | 日限 | 月限 | +|-----|---------|-----|-----|-----| +| 劳动改造 | 超额完成生产任务 | +2 | 5 | 30 | +| 劳动改造 | 完成生产任务 | +1 | 3 | 20 | +| 教育改造 | 参加义务劳动 | +1 | 2 | 10 | +| 教育改造 | 考试合格 | +1 | 3 | 15 | +| 日常行为 | 获得表扬 | +2 | 5 | 20 | +| 日常行为 | 主动报告隐患 | +1 | 2 | 10 | +| 卫生纪律 | 内务不整洁 | -0.5 | -3 | -10 | +| 卫生纪律 | 违规吸烟 | -2 | -5 | -20 | +| 扣分项 | 打架斗殴 | -5 | -10 | -30 | +| 扣分项 | 私藏违禁品 | -10 | -20 | -50 | + +### 3.2 日常考核记录 + +#### 3.2.1 考核录入 + +**功能描述**：为罪犯录入日常考核得分 + +**表单字段**： +- 考核日期（默认当天，可修改） +- 罪犯选择（支持批量选择） +- 考核规则（从规则库选择） +- 得分（根据规则自动带出，可调整） +- 备注说明 + +**业务流程**： +1. 选择考核日期 +2. 选择罪犯（支持搜索、分监区筛选） +3. 选择考核规则 +4. 系统自动带出规则分值 +5. 填写备注 +6. 提交保存 + +#### 3.2.2 考核查询 + +**功能描述**：查询日常考核记录 + +**列表字段**： +- 考核日期 +- 罪犯编号、姓名 +- 监区/分监区 +- 考核类别 +- 规则名称 +- 得分 +- 记录人 +- 操作时间 + +**筛选条件**： +- 考核日期范围 +- 罪犯姓名/编号 +- 监区/分监区 +- 考核类别 +- 规则名称 + +### 3.3 月度考核汇总 + +#### 3.3.1 自动计算 + +**功能描述**：每月自动汇总罪犯考核得分 + +**计算逻辑**： +``` +月度总分 = 基础分 + 当月加分累计 - 当月扣分累计 +``` + +**基础分**： +- 默认100分（可配置） + +**计算规则**： +- 每日考核得分累加 +- 超过日限的按日限计算 +- 超过月限的按月限计算 + +#### 3.3.2 等级评定 + +**功能描述**：根据月度总分评定考核等级 + +**评定标准**（示例，可配置）： + +| 等级 | 分值范围 | 说明 | +|-----|---------|-----| +| 优秀 | ≥120分 | 表现突出 | +| 良好 | 100-119分 | 表现良好 | +| 合格 | 80-99分 | 表现一般 | +| 不合格 | <80分 | 表现较差 | + +#### 3.3.3 月度汇总展示 + +**展示内容**： +- 罪犯基础信息 +- 基础分 +- 加分合计 +- 扣分合计 +- 月度总分 +- 考核等级 +- 考核人 +- 审核状态 + +**操作功能**： +- 查看明细 +- 导出报表 +- 提交审核 + +### 3.4 考核公示 + +#### 3.4.1 公示发布 + +**功能描述**：发布考核结果供罪犯查看 + +**公示内容**： +- 公示期间 +- 公示范围（全狱/指定监区） +- 考核结果列表 + +#### 3.4.2 罪犯查询 + +**功能描述**：罪犯查询自己的考核结果 + +**展示内容**： +- 本月得分明细 +- 本月总分 +- 考核等级 +- 与上月对比 + +### 3.5 减刑假释关联 + +#### 3.5.1 考核数据提取 + +**功能描述**：提取用于减刑假释的考核数据 + +**提取内容**： +- 近6个月/月度考核得分 +- 年度累计考核分 +- 表扬次数 +- 警告次数 +- 等级评定记录 + +#### 3.5.2 建议生成 + +**功能描述**：根据考核数据生成减刑假释建议 + +**建议内容**： +- 可申报减刑月份 +- 建议减刑幅度 +- 建议假释意见 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 每日考核分值不能超过日最高分限制 | +| BR-002 | 每月考核分值不能超过月最高分限制 | +| BR-003 | 考核等级根据配置的标准自动评定 | +| BR-004 | 月度汇总每月1日自动计算 | +| BR-005 | 考核结果公示后才能生效 | +| BR-006 | 不合格等级达到一定次数触发严管 | + +## 五、验收标准 + +- [ ] 支持考核规则的增删改查 +- [ ] 支持日常考核录入（单条/批量） +- [ ] 支持日常考核查询 +- [ ] 支持月度考核自动汇总计算 +- [ ] 支持考核等级评定 +- [ ] 支持考核结果公示 +- [ ] 支持减刑假释数据提取 +- [ ] 考核数据与罪犯信息联动 + +## 六、相关模块 + +- 依赖：狱政信息管理模块（罪犯基础数据） +- 依赖：监区管理模块（获取监区结构） +- 被依赖：评估报告模块（考核数据引用） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-04-测评问卷管理.md b/requirements/需求-04-测评问卷管理.md new file mode 100644 index 0000000..f5789e8 --- /dev/null +++ b/requirements/需求-04-测评问卷管理.md @@ -0,0 +1,228 @@ +# 需求-04-测评问卷管理 + +> 模块名称：测评问卷管理 +> 优先级：P0 +> 预估工时：40h + +--- + +## 一、业务背景 + +测评问卷用于对罪犯进行心理测评、风险评估等，是了解罪犯心理状态和制定管理方案的重要工具。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 教育科长 | 作为教育科长，我希望创建不同类型的测评问卷，这样满足不同测评需求 | P0 | +| 心理辅导员 | 作为心理辅导员，我希望编辑问卷题目，这样问卷内容符合测评目标 | P0 | +| 心理辅导员 | 作为心理辅导员，我希望设置题目分值，这样自动计算测评得分 | P0 | +| 教育科长 | 作为教育科长，我希望发布和下架问卷，这样控制问卷可用状态 | P0 | +| 心理辅导员 | 作为心理辅导员，我希望预览问卷效果，这样发布前检查问卷内容 | P0 | +| 管理员 | 作为管理员，我希望复制已有问卷，这样快速创建相似问卷 | P1 | + +## 三、功能需求 + +### 3.1 问卷分类管理 + +#### 3.1.1 分类列表 + +**分类类型**： +- 心理测评 +- 风险评估 +- 日常调查 +- 入监测评 +- 出监测评 + +#### 3.1.2 分类管理 + +**功能**： +- 新增分类 +- 修改分类 +- 删除分类（无问卷时可删） +- 查看分类下的问卷数量 + +### 3.2 问卷管理 + +#### 3.2.1 问卷列表 + +**列表字段**： +- 问卷标题 +- 所属分类 +- 题目数量 +- 总分值 +- 时限（分钟） +- 状态（草稿/已发布/已下架） +- 创建人 +- 创建时间 +- 发布时间 + +**筛选条件**： +- 分类筛选 +- 状态筛选 +- 标题搜索 +- 创建时间范围 + +#### 3.2.2 创建问卷 + +**问卷属性**： +- 问卷标题（必填） +- 所属分类（必选） +- 问卷描述（可选） +- 时限（分钟，0表示不限时） +- 及格分数（可选） +- 是否允许重考（是/否） +- 状态（默认草稿） + +#### 3.2.3 编辑问卷 + +**功能描述**：修改问卷内容 + +**可编辑项**： +- 问卷属性 +- 题目内容 +- 题目顺序 +- 题目分值 + +**限制**： +- 已发布的问卷不能直接修改 +- 如需修改应先下架 + +#### 3.2.4 问卷预览 + +**功能描述**：预览问卷效果 + +**预览内容**： +- 问卷标题和描述 +- 题目列表（按顺序） +- 题目类型和选项 +- 分值显示 +- 预计完成时间 + +#### 3.2.5 发布/下架 + +**发布操作**： +- 状态从"草稿"变为"已发布" +- 记录发布时间 +- 问卷可用于测评 + +**下架操作**： +- 状态从"已发布"变为"已下架" +- 下架后不可用于新测评 +- 历史测评记录保留 + +#### 3.2.6 问卷复制 + +**功能描述**：创建问卷副本 + +**复制内容**： +- 问卷属性 +- 所有题目（含选项） + +**复制后**： +- 新问卷状态为"草稿" +- 标题自动添加"副本"标识 + +### 3.3 题目管理 + +#### 3.3.1 题目类型 + +| 类型 | 说明 | 评分方式 | +|-----|------|---------| +| 单选题 | 从多个选项中选择一个 | 固定分值 | +| 多选题 | 从多个选项中选择多个 | 按选项得分累加 | +| 判断题 | 判断对错 | 固定分值 | +| 填空题 | 输入文字答案 | 需人工评分 | +| 简述题 | 输入大段文字 | 需人工评分 | +| 评分题 | 选择分数等级 | 固定分值 | + +#### 3.3.2 题目编辑 + +**题目属性**： +- 题目内容（必填） +- 题目类型（必选） +- 题目分值（必填） +- 是否必答（是/否） +- 排序序号 + +**选项管理（单选/多选/判断）**： +- 选项内容 +- 选项分值 +- 是否正确答案（用于自动评分） + +**示例 - 单选题**： +``` +题目：您最近一周的情绪状态如何？ +分值：5分 + +选项： +A. 心情愉快 (+5分) +B. 心情一般 (+2分) +C. 心情低落 (0分) +D. 情绪低落 (-2分) +``` + +#### 3.3.3 题目排序 + +**功能**：拖拽调整题目顺序 + +**说明**： +- 序号根据排序自动生成 +- 保存后生效 + +#### 3.3.4 题目分值设置 + +**功能**：配置每题分值 + +**规则**： +- 客观题（单选/多选/判断/评分）可直接设置选项得分 +- 主观题（填空/简述）需人工评分 + +### 3.4 问卷发布流程 + +``` +草稿 → 内容审核 → 发布 → 测评执行 → 下架 → 归档 +``` + +**审核节点（可选）**： +- 发布前增加审核环节 +- 审核人可退回或通过 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 问卷标题在同一分类下必须唯一 | +| BR-002 | 已发布的问卷不能直接修改内容 | +| BR-003 | 问卷下架后不能再发起新测评 | +| BR-004 | 客观题支持自动评分，主观题需人工评分 | +| BR-005 | 超过时限自动提交（限时的问卷） | +| BR-006 | 不允许重考的问卷，一个罪犯只能答一次 | +| BR-007 | 题目顺序影响试卷展示顺序 | + +## 五、验收标准 + +- [ ] 支持问卷分类管理 +- [ ] 支持问卷的增删改查 +- [ ] 支持问卷预览 +- [ ] 支持问卷发布和下架 +- [ ] 支持问卷复制 +- [ ] 支持单选题编辑 +- [ ] 支持多选题编辑 +- [ ] 支持判断题编辑 +- [ ] 支持填空题编辑 +- [ ] 支持简述题编辑 +- [ ] 支持评分题编辑 +- [ ] 支持题目排序 +- [ ] 支持题目分值设置 + +## 六、相关模块 + +- 依赖：测评执行模块（使用问卷） +- 依赖：测评结果模块（存储答卷） +- 被依赖：危险评估模块（可引用问卷） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-05-测评执行与评分.md b/requirements/需求-05-测评执行与评分.md new file mode 100644 index 0000000..e4a993c --- /dev/null +++ b/requirements/需求-05-测评执行与评分.md @@ -0,0 +1,248 @@ +# 需求-05-测评执行与评分 + +> 模块名称：测评执行与评分 +> 优先级：P0 +> 预估工时：24h + +--- + +## 一、业务背景 + +测评执行是罪犯在线完成测评问卷的过程，系统需要提供良好的答题体验并确保测评数据的完整性和准确性。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 心理辅导员 | 作为心理辅导员，我希望罪犯在线完成测评问卷，这样方便快捷 | P0 | +| 心理辅导员 | 作为心理辅导员，我希望自动计算客观题得分，这样提高工作效率 | P0 | +| 心理辅导员 | 作为心理辅导员，我希望查看测评结果，这样分析罪犯心理状态 | P0 | +| 教育科长 | 作为教育科长，我希望统计分析测评数据，这样了解整体情况 | P1 | +| 罪犯 | 作为罪犯，我希望能够完成测评，这样接受心理评估 | P0 | + +## 三、功能需求 + +### 3.1 在线测评 + +#### 3.1.1 发起测评 + +**功能描述**：为罪犯发起测评任务 + +**发起方式**： +- 单个发起：选择罪犯 + 选择问卷 +- 批量发起：选择多个罪犯 + 选择问卷 +- 按监区发起：选择监区 + 选择问卷 + +**表单字段**： +- 罪犯选择（支持搜索、筛选） +- 问卷选择（根据测评类型筛选） +- 测评说明（可选） +- 截止日期（可选） + +**校验规则**： +- 罪犯状态必须为"在押" +- 问卷状态必须为"已发布" +- 不可重复测评的问卷需要检查是否已测评 + +#### 3.1.2 答题界面 + +**页面布局**： +- 顶部：问卷标题、剩余时间（限时问卷） +- 左侧：题目导航（序号标识） +- 主体：当前题目内容 +- 底部：上一题、下一题、提交按钮 + +**题目展示**： +- 显示题目序号和内容 +- 显示题目分值 +- 显示是否必答 +- 显示选项或输入框 +- 显示已选/已答状态 + +**交互功能**： +- 选项点击选择/取消 +- 填空输入 +- 简述输入 +- 上一题/下一题切换 +- 题目导航快速跳转 +- 剩余时间倒计时 + +**时限处理**： +- 限时问卷显示倒计时 +- 时间到自动提交 +- 超时未提交的题目按0分计 + +#### 3.1.3 提交答卷 + +**提交方式**： +- 手动提交：点击提交按钮 +- 自动提交：时间到自动提交 + +**提交确认**： +- 提交前提示未答题数量 +- 支持返回修改或确认提交 + +**提交后**： +- 客观题自动计算得分 +- 生成测评记录 +- 跳转到完成页面 + +### 3.2 答题记录 + +#### 3.2.1 记录查询 + +**查询条件**： +- 罪犯姓名/编号 +- 问卷名称 +- 测评时间范围 +- 状态（待评估/已完成） + +**列表字段**： +- 测评记录ID +- 罪犯编号、姓名 +- 问卷标题 +- 测评时间 +- 得分 +- 评估结果 +- 状态 +- 操作 + +#### 3.2.2 记录详情 + +**展示内容**： +- 罪犯信息 +- 问卷信息 +- 测评时间 +- 得分详情（每题得分） +- 总分 +- 评估结果 + +**答卷内容**： +- 显示所有题目和答案 +- 客观题显示标准答案 +- 主观题显示作答内容 + +### 3.3 自动评分 + +#### 3.3.1 评分规则 + +**客观题评分**： +- 单选题：选择正确答案得满分，否则得0分 +- 多选题：每个正确选项得相应分值，错误选项扣分 +- 判断题：正确得满分，错误得0分 +- 评分题：按选择分值计算 + +**主观题评分**： +- 填空题：需人工评分 +- 简述题：需人工评分 + +#### 3.3.2 结果生成 + +**总分计算**： +``` +总分 = 客观题得分 + 主观题得分 +``` + +**评估结果**： +- 及格/不及格（根据及格分数线判断） +- 风险等级（根据测评类型和分数判断） +- 测评建议（根据测评类型生成） + +### 3.4 人工评分 + +#### 3.4.1 待评分列表 + +**功能描述**：显示需要人工评分的答卷 + +**筛选条件**： +- 测评时间范围 +- 问卷类型 +- 监区 + +**列表字段**： +- 记录ID +- 罪犯信息 +- 问卷名称 +- 客观题得分 +- 主观题数量 +- 待评分数 + +#### 3.4.2 主观题评分 + +**评分界面**： +- 显示题目和作答内容 +- 输入分数 +- 填写评语（可选） + +**提交后**： +- 更新总分 +- 生成评估结果 + +### 3.5 测评统计分析 + +#### 3.5.1 完成率统计 + +**统计维度**： +- 按问卷统计：各问卷的完成率 +- 按监区统计：各监区的完成率 +- 按时间统计：日/周/月完成数量 + +#### 3.5.2 分数分布统计 + +**统计维度**： +- 按分数段统计人数（0-20, 21-40, 41-60, 61-80, 81-100） +- 及格率统计 +- 平均分统计 + +#### 3.5.3 风险分布统计 + +**统计维度**： +- 高风险人数和占比 +- 中风险人数和占比 +- 低风险人数和占比 + +#### 3.5.4 统计图表 + +**图表类型**： +- 柱状图：完成数量趋势 +- 饼图：分数分布 +- 饼图：风险等级分布 +- 折线图：平均分趋势 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 限时问卷时间到自动提交 | +| BR-002 | 不允许重考的问卷只能测评一次 | +| BR-003 | 客观题自动评分，主观题需人工评分 | +| BR-004 | 测评记录一旦生成不能删除 | +| BR-005 | 测评过程中刷新页面保留已答题状态 | +| BR-006 | 未登录状态下不能发起测评 | + +## 五、验收标准 + +- [ ] 支持单个发起测评 +- [ ] 支持批量发起测评 +- [ ] 支持按监区发起测评 +- [ ] 答题界面展示正确 +- [ ] 答题交互正常（上一题/下一题/导航） +- [ ] 限时功能正常，时间到自动提交 +- [ ] 提交功能正常 +- [ ] 客观题自动评分正确 +- [ ] 支持人工评分主观题 +- [ ] 测评记录查询正常 +- [ ] 测评详情展示正确 +- [ ] 支持测评统计分析 + +## 六、相关模块 + +- 依赖：测评问卷管理模块（获取问卷） +- 依赖：狱政信息管理模块（获取罪犯列表） +- 被依赖：危险评估模块（测评结果引用） +- 被依赖：评估报告模块（测评数据引用） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-06-狱情平台.md b/requirements/需求-06-狱情平台.md new file mode 100644 index 0000000..1018327 --- /dev/null +++ b/requirements/需求-06-狱情平台.md @@ -0,0 +1,199 @@ +# 需求-06-狱情平台 + +> 模块名称：狱情平台 +> 优先级：P1 +> 预估工时：22h + +--- + +## 一、业务背景 + +狱情平台用于记录和管理狱内发生的各类事件，支持狱情动态跟踪、预警信息管理和事件处理流程。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 狱政科长 | 作为狱政科长，我希望记录狱内发生的重要事件，这样留存管理痕迹 | P1 | +| 分监区长 | 作为分监区长，我希望登记突发事件，这样及时上报 | P1 | +| 监狱长 | 作为监狱长，我希望查看预警信息，这样及时掌握风险 | P1 | +| 狱政干事 | 作为狱政干事，我希望跟踪事件处理进度，这样确保事件闭环 | P1 | +| 管理员 | 作为管理员，我希望管理应急预案，这样突发事件有据可依 | P2 | + +## 三、功能需求 + +### 3.1 狱情动态记录 + +#### 3.1.1 事件登记 + +**事件类型**： +- 监管事件（脱逃、行凶、违规等） +- 安全事件（事故、隐患等） +- 医疗事件（疾病、伤亡等） +- 教育事件（冲突、思想动态等） +- 其他事件 + +**表单字段**： +- 事件标题 +- 事件类型（必选） +- 发生时间（必填） +- 发生地点（监区/分监区） +- 涉及罪犯（可多选） +- 事件描述（详细经过） +- 事件等级（一般/较大/重大/特大） +- 现场处置情况 +- 附件上传（照片、文件等） + +#### 3.1.2 事件列表 + +**列表字段**： +- 事件编号 +- 事件标题 +- 事件类型 +- 发生时间 +- 发生地点 +- 事件等级 +- 处理状态 +- 登记人 +- 登记时间 + +**筛选条件**： +- 事件类型 +- 发生时间范围 +- 事件等级 +- 处理状态 +- 发生地点 + +#### 3.1.3 事件详情 + +**展示内容**： +- 事件基本信息 +- 涉及罪犯列表 +- 事件经过 +- 处置情况 +- 附件列表 +- 处理记录时间线 + +### 3.2 预警信息管理 + +#### 3.2.1 预警规则配置 + +**预警类型**： +- 罪犯行为异常预警 +- 考核连续下滑预警 +- 消费异常预警 +- 风险评估预警 +- 余刑到期预警 + +**规则配置**： +- 预警名称 +- 预警类型 +- 触发条件 +- 预警级别（一般/紧急/严重） +- 通知对象 +- 通知方式 + +**示例规则**： +``` +规则名称：消费异常预警 +触发条件：单日消费超过500元 +预警级别：一般 +通知对象：分监区长、狱政科长 +``` + +#### 3.2.2 预警触发 + +**触发机制**： +- 定时检查（每日凌晨） +- 实时触发（数据变更时） + +**预警生成**： +- 生成预警记录 +- 发送通知 + +#### 3.2.3 预警处理 + +**处理流程**： +1. 接收预警通知 +2. 查看预警详情 +3. 填写处置措施 +4. 标记处理状态 + +**预警处理表单**： +- 预警详情 +- 处置措施 +- 处置人 +- 处置时间 + +### 3.3 事件处理跟踪 + +#### 3.3.1 处理流程 + +**流程节点**： +- 登记 → 审核 → 处置 → 结案 + +**状态流转**： +``` +登记(待审核) → 审核(处理中) → 处置(已完成) → 结案 + ↓ + 退回修改 +``` + +#### 3.3.2 跟踪记录 + +**时间线展示**： +- 登记时间 +- 审核时间 +- 处置时间 +- 结案时间 +- 各节点操作人 + +### 3.4 应急预案管理（P2） + +#### 3.4.1 预案库 + +**预案分类**： +- 突发事件预案 +- 安全事故预案 +- 医疗急救预案 +- 舆情应对预案 + +#### 3.4.2 预案管理 + +**功能**： +- 预案新增/编辑/删除 +- 预案分类管理 +- 预案启用/停用 +- 预案演练记录 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 重大事件需要多人审核 | +| BR-002 | 预警处理有时限要求 | +| BR-003 | 事件处理记录不可删除 | +| BR-004 | 涉及罪犯需要权限验证 | +| BR-005 | 附件上传有大小限制 | + +## 五、验收标准 + +- [ ] 支持事件登记 +- [ ] 支持事件列表查询 +- [ ] 支持事件详情查看 +- [ ] 支持预警规则配置 +- [ ] 支持预警触发 +- [ ] 支持预警处理 +- [ ] 支持事件处理流程跟踪 +- [ ] 支持事件状态流转 + +## 六、相关模块 + +- 依赖：狱政信息管理模块（罪犯数据） +- 依赖：消费管理模块（消费预警） +- 依赖：计分考核模块（考核预警） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-07-危险评估.md b/requirements/需求-07-危险评估.md new file mode 100644 index 0000000..4e40af9 --- /dev/null +++ b/requirements/需求-07-危险评估.md @@ -0,0 +1,207 @@ +# 需求-07-危险评估 + +> 模块名称：危险评估 +> 优先级：P1 +> 预估工时：22h + +--- + +## 一、业务背景 + +危险评估是对罪犯进行风险评估的系统，通过专业评估确定罪犯的风险等级，为管理决策提供依据。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 心理辅导员 | 作为心理辅导员，我希望配置评估问卷，这样评估维度全面 | P1 | +| 心理辅导员 | 作为心理辅导员，我希望为罪犯做危险评估，这样确定风险等级 | P1 | +| 心理辅导员 | 作为心理辅导员，我希望系统自动计算风险值，这样提高效率 | P1 | +| 狱政科长 | 作为狱政科长，我希望看到风险等级划分结果，这样合理配置警力 | P1 | +| 心理辅导员 | 作为心理辅导员，我希望有定期复评提醒，这样及时更新评估 | P1 | + +## 三、功能需求 + +### 3.1 评估问卷配置 + +#### 3.1.1 评估维度 + +**标准评估维度**： +- 犯罪史评估 +- 家庭背景评估 +- 社会支持评估 +- 心理状态评估 +- 行为表现评估 +- 改造态度评估 + +#### 3.1.2 评估问卷 + +**评估类型**： +- 入监评估（新入监罪犯） +- 定期评估（在押罪犯定期评估） +- 出监评估（释放前评估） +- 专项评估（针对特定情况） + +**问卷结构**： +- 评估基本信息 +- 各维度题目 +- 风险因素清单 +- 管控措施建议 + +### 3.2 危险评估录入 + +#### 3.2.1 创建评估 + +**评估类型选择**： +- 入监评估 +- 定期评估（月度/季度/年度） +- 出监评估 +- 专项评估 + +**罪犯选择**： +- 支持搜索罪犯 +- 显示基本信息 + +#### 3.2.2 填写评估 + +**评估内容**： +- 各维度题目作答 +- 风险因素勾选 +- 管控措施填写 +- 评估人意见 + +**风险因素选项**（示例）： +- 有脱逃倾向 +- 有暴力倾向 +- 有自杀倾向 +- 近期情绪异常 +- 家庭变故 +- 与他犯有矛盾 +- 其他 + +**管控措施选项**（示例）： +- 列为重点关注 +- 调整监管等级 +- 增加巡查频次 +- 安排心理疏导 +- 调整监区 +- 其他 + +### 3.3 风险计算引擎 + +#### 3.3.1 计算规则 + +**风险分值计算**： +- 各维度题目得分累加 +- 风险因素加权 +- 最终得出风险总分 + +**风险分值范围**：0-100分 + +#### 3.3.2 风险等级划分 + +**等级划分标准**（可配置）： + +| 风险等级 | 分值范围 | 说明 | +|---------|---------|-----| +| 高风险 | ≥70分 | 需要重点关注和管控 | +| 中风险 | 40-69分 | 需要一般关注 | +| 低风险 | <40分 | 正常管理 | + +**等级颜色标识**： +- 高风险：红色 +- 中风险：橙色 +- 低风险：绿色 + +### 3.4 评估结果管理 + +#### 3.4.1 评估记录 + +**列表字段**： +- 评估编号 +- 罪犯姓名/编号 +- 评估类型 +- 评估日期 +- 风险等级 +- 风险分值 +- 评估人 +- 状态（有效/过期） + +#### 3.4.2 评估详情 + +**展示内容**： +- 评估基本信息 +- 各维度得分详情 +- 风险因素 +- 管控措施 +- 历史评估对比 + +### 3.5 定期复评提醒 + +#### 3.5.1 复评周期配置 + +**默认周期**： +- 高风险：每月复评 +- 中风险：每季度复评 +- 低风险：每半年复评 + +**可按罪犯调整**： + +#### 3.5.2 提醒机制 + +**触发时机**： +- 临近复评日期提前提醒（可配置天数） +- 超过复评日期未复评提醒 + +**通知方式**： +- 系统消息提醒 +- 站内通知 + +### 3.6 历史评估对比 + +#### 3.6.1 对比展示 + +**对比维度**： +- 风险分值趋势 +- 风险等级变化 +- 各维度得分对比 + +#### 3.6.2 趋势分析 + +**图表展示**： +- 折线图：风险分值趋势 +- 柱状图：各维度得分对比 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 入监评估必须在入监后7天内完成 | +| BR-002 | 高风险罪犯必须每月复评 | +| BR-003 | 风险等级变更需要审批 | +| BR-004 | 评估记录不可删除 | +| BR-005 | 评估有效期根据风险等级自动计算 | + +## 五、验收标准 + +- [ ] 支持评估问卷配置 +- [ ] 支持评估维度管理 +- [ ] 支持创建评估任务 +- [ ] 支持评估内容填写 +- [ ] 支持风险分值自动计算 +- [ ] 支持风险等级自动划分 +- [ ] 支持评估记录查询 +- [ ] 支持评估详情查看 +- [ ] 支持定期复评提醒 +- [ ] 支持历史评估对比 + +## 六、相关模块 + +- 依赖：测评问卷管理模块（问卷基础） +- 依赖：狱政信息管理模块（罪犯数据） +- 被依赖：狱政信息管理模块（风险等级引用） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-08-消费系统.md b/requirements/需求-08-消费系统.md new file mode 100644 index 0000000..643faf9 --- /dev/null +++ b/requirements/需求-08-消费系统.md @@ -0,0 +1,205 @@ +# 需求-08-消费系统 + +> 模块名称：消费系统 +> 优先级：P1 +> 预估工时：18h + +--- + +## 一、业务背景 + +消费系统管理罪犯的账户余额、消费记录和存款，是保障罪犯日常生活和规范消费行为的重要模块。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 生活卫生科长 | 作为生活卫生科长，我希望管理罪犯账户余额，这样掌握消费情况 | P1 | +| 家属 | 作为罪犯家属，我希望给罪犯存款，这样罪犯有钱花 | P1 | +| 罪犯 | 作为罪犯，我希望查询自己的消费记录，这样我知道钱花哪了 | P1 | +| 狱政科长 | 作为狱政科长，我希望设置消费限额，这样控制过度消费 | P1 | +| 管理员 | 作为管理员，我希望分析消费数据，这样发现异常消费 | P1 | + +## 三、功能需求 + +### 3.1 账户管理 + +#### 3.1.1 账户查询 + +**查询条件**： +- 罪犯姓名/编号 +- 监区/分监区 +- 账户状态（正常/冻结） + +**列表字段**： +- 罪犯编号、姓名 +- 监区/分监区 +- 账户余额 +- 累计存款 +- 累计消费 +- 账户状态 +- 开户时间 + +#### 3.1.2 账户详情 + +**展示内容**： +- 罪犯基本信息 +- 账户信息（余额、状态） +- 存款记录（最近10笔） +- 消费记录（最近10笔） +- 月度消费统计 + +### 3.2 家属存款 + +#### 3.2.1 存款登记 + +**表单字段**： +- 罪犯选择（支持搜索） +- 存款金额（必填） +- 存款人姓名 +- 存款人关系 +- 联系方式 +- 备注 + +**存款方式**： +- 现场存款（家属到窗口） +- 银行转账（系统对接银行） +- 线上支付（微信/支付宝） + +**到账确认**： +- 线下存款需工作人员确认 +- 系统存款自动到账 + +#### 3.2.2 存款记录 + +**列表字段**： +- 记录编号 +- 罪犯姓名/编号 +- 存款金额 +- 存款人 +- 存款方式 +- 存款时间 +- 状态（待确认/已到账/已取消） + +### 3.3 消费记录 + +#### 3.3.1 消费类型 + +**消费类型**： +- 购物消费（超市购物） +- 餐饮消费（食堂） +- 医疗消费（看病） +- 通讯消费（电话费） +- 其他消费 + +#### 3.3.2 消费查询 + +**查询条件**： +- 罪犯姓名/编号 +- 消费类型 +- 消费时间范围 +- 监区 + +**列表字段**： +- 订单编号 +- 罪犯姓名/编号 +- 消费类型 +- 消费金额 +- 商品名称 +- 消费时间 +- 账户余额（消费后） + +#### 3.3.3 消费详情 + +**展示内容**： +- 订单信息 +- 商品列表 +- 金额明细 +- 消费时间 +- 操作人 + +### 3.4 消费限额 + +#### 3.4.1 全局限额配置 + +**配置项**： +- 日消费限额 +- 月消费限额 +- 单笔消费限额 +- 特殊商品限制 + +**默认限额**： +- 日限额：50元 +- 月限额：500元 +- 单笔限额：100元 + +#### 3.4.2 个体限额配置 + +**按罪犯设置**： +- 单独设置限额 +- 按监管等级设置 +- 按风险等级设置 + +**限额类型**： +- 宽管级：标准限额的120% +- 普管级：标准限额 +- 严管级：标准限额的60% +- 考察级：最低保障 + +### 3.5 消费统计分析 + +#### 3.5.1 统计维度 + +**统计报表**： +- 日消费统计 +- 月消费统计 +- 人均消费统计 +- 监区消费排名 +- 商品销售排行 + +#### 3.5.2 异常检测 + +**异常规则**： +- 单日消费超过日限额 +- 单月消费超过月限额 +- 消费频率异常（短时间内多次消费） + +**异常处理**： +- 超出限额时拦截 +- 生成异常预警 +- 通知管理人员 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 罪犯账户余额不能为负数 | +| BR-002 | 消费金额不能超过账户余额 | +| BR-003 | 消费金额不能超过单笔限额 | +| BR-004 | 累计消费不能超过日/月限额 | +| BR-005 | 存款需校验金额格式 | +| BR-006 | 严管级罪犯消费限额更低 | +| BR-007 | 消费记录不可删除 | + +## 五、验收标准 + +- [ ] 支持账户查询 +- [ ] 支持账户详情查看 +- [ ] 支持存款登记 +- [ ] 支持存款记录查询 +- [ ] 支持消费记录查询 +- [ ] 支持消费限额配置 +- [ ] 支持个体限额设置 +- [ ] 支持消费统计分析 +- [ ] 支持异常消费预警 + +## 六、相关模块 + +- 依赖：狱政信息管理模块（罪犯数据） +- 依赖：监区管理模块（监区数据） +- 被依赖：数据分析模块（消费数据引用） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-09-数据汇总.md b/requirements/需求-09-数据汇总.md new file mode 100644 index 0000000..26895ad --- /dev/null +++ b/requirements/需求-09-数据汇总.md @@ -0,0 +1,228 @@ +# 需求-09-数据汇总 + +> 模块名称：数据汇总 +> 优先级：P1 +> 预估工时：20h + +--- + +## 一、业务背景 + +数据汇总模块提供各类统计报表和分析图表，帮助管理层全面了解监狱运行状况。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 监狱长 | 作为监狱长，我希望看到在册罪犯统计，这样了解整体规模 | P1 | +| 教导员 | 作为教导员，我希望看到押犯构成分析，这样了解罪犯特点 | P1 | +| 考核干事 | 作为考核干事，我希望看到考核统计报表，这样了解整体改造情况 | P1 | +| 生活科长 | 作为生活科长，我希望看到消费统计，这样了解消费水平 | P1 | +| 教育科长 | 作为教育科长，我希望看到评估统计，这样了解测评情况 | P1 | + +## 三、功能需求 + +### 3.1 人口统计分析 + +#### 3.1.1 在册统计 + +**统计指标**： +- 当前在册总数 +- 本月新收数量 +- 本月释放数量 +- 本月移交数量 +- 本月死亡数量 + +**时间维度**： +- 日统计 +- 月统计 +- 年统计 + +#### 3.1.2 动态统计 + +**统计图表**： +- 折线图：在册人数趋势 +- 柱状图：月度收押/释放对比 + +### 3.2 押犯构成分析 + +#### 3.2.1 年龄分布 + +**年龄段**： +- 未成年（≤17） +- 青年（18-30） +- 中年（31-50） +- 老年（51-60） +- 老龄（60+） + +**展示形式**： +- 饼图：年龄占比 +- 柱状图：各年龄段人数 + +#### 3.2.2 刑期分布 + +**刑期段**： +- 短刑（≤3年） +- 中刑（3-10年） +- 长刑（10年以上） +- 无期 +- 死缓 + +**展示形式**：饼图 + +#### 3.2.3 罪名分布 + +**分类**： +- 暴力型（故意杀人、故意伤害、抢劫等） +- 财产型（盗窃、诈骗、抢夺等） +- 淫欲型（强奸、猥亵等） +- 涉毒型（贩毒、吸毒等） +- 涉黑涉恶型 +- 其他 + +**展示形式**：柱状图 + +#### 3.2.4 其他维度 + +**文化程度分布**：饼图 +**民族分布**：饼图 +**籍贯分布**：地图热力图 + +### 3.3 考核统计报表 + +#### 3.3.1 分数分布 + +**统计维度**： +- 各分数段人数 +- 平均分 +- 最高分/最低分 + +**展示形式**： +- 柱状图：分数分布 +- 表格：统计数据 + +#### 3.3.2 等级分布 + +**考核等级**： +- 优秀人数/占比 +- 良好人数/占比 +- 合格人数/占比 +- 不合格人数/占比 + +**展示形式**：饼图 + +#### 3.3.3 月度趋势 + +**趋势分析**： +- 月度平均分趋势 +- 各等级占比趋势 + +**展示形式**：折线图 + +### 3.4 消费统计报表 + +#### 3.4.1 消费金额统计 + +**统计指标**： +- 总消费金额 +- 人均消费金额 +- 日均消费金额 +- 消费总额趋势 + +#### 3.4.2 消费类型分布 + +**类型占比**： +- 超市购物 +- 餐饮消费 +- 医疗消费 +- 通讯消费 +- 其他 + +**展示形式**：饼图 + +#### 3.4.3 监区消费排名 + +**排名维度**： +- 人均消费排名 +- 消费总额排名 +- 月环比增长排名 + +**展示形式**：排行榜表格 + +### 3.5 评估统计报表 + +#### 3.5.1 测评完成率 + +**统计指标**： +- 应测评人数 +- 已完成人数 +- 完成率 +- 待测评人数 + +#### 3.5.2 风险分布 + +**风险等级**： +- 高风险人数/占比 +- 中风险人数/占比 +- 低风险人数/占比 + +**展示形式**：饼图 + +#### 3.5.3 评估趋势 + +**趋势分析**： +- 高风险占比趋势 +- 测评覆盖率趋势 + +### 3.6 综合报表 + +#### 3.6.1 监狱运行月报 + +**报告内容**： +- 在押犯情况 +- 收押释放情况 +- 考核情况 +- 消费情况 +- 测评情况 +- 重点关注事项 + +#### 3.6.2 自定义报表 + +**功能**： +- 选择统计指标 +- 选择时间范围 +- 选择统计维度 +- 生成报表 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 统计数据实时更新 | +| BR-002 | 支持按时间范围筛选 | +| BR-003 | 支持按监区筛选 | +| BR-004 | 报表支持导出（Excel/PDF） | +| BR-005 | 敏感数据脱敏展示 | + +## 五、验收标准 + +- [ ] 支持人口统计分析 +- [ ] 支持押犯构成分析（年龄/刑期/罪名） +- [ ] 支持考核统计报表 +- [ ] 支持消费统计报表 +- [ ] 支持评估统计报表 +- [ ] 支持综合报表生成 +- [ ] 支持数据导出 +- [ ] 支持图表交互（筛选、导出） + +## 六、相关模块 + +- 依赖：狱政信息管理模块（人口数据） +- 依赖：计分考核模块（考核数据） +- 依赖：消费管理模块（消费数据） +- 依赖：测评管理模块（评估数据） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-10-评估报告.md b/requirements/需求-10-评估报告.md new file mode 100644 index 0000000..83f3fa4 --- /dev/null +++ b/requirements/需求-10-评估报告.md @@ -0,0 +1,1349 @@ +# 需求-10-评估报告 + +> 模块名称：评估报告 +> 优先级：P1 +> 预估工时：27天 +> 版本：v1.3（根据业务流程确认结果修订） + +--- + +## 一、业务背景 + +评估报告模块用于生成罪犯的综合评估报告，为减刑假释、处遇调整等决策提供依据。 + +**核心创新**：使用AI大语言模型自动填写风险评估报告，支持人机协作模式（AI生成初稿 + 人工审核修改），大幅提高评估工作效率。 + +**业务流程修订说明（v1.3）**： +- 增加报告生成前数据完整性检查步骤 +- 完善批量生成异步队列设计 +- 增加撤回功能流程 +- 完善自动归档规则 +- 补充家庭帮教评估维度 +- 支持PDF/Word/Excel三种导出格式 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 心理辅导员 | 作为心理辅导员，我希望有报告模板，这样统一报告格式 | P1 | +| 心理辅导员 | 作为心理辅导员，我希望AI自动生成报告初稿，这样提高效率 | P1 | +| 管教民警 | 作为管教民警，我希望AI根据罪犯数据自动生成评估内容，这样减少文书工作量 | P1 | +| 监狱长 | 作为监狱长，我希望预览报告内容，这样审核报告 | P1 | +| 刑罚执行科 | 作为刑罚执行科，我希望下载报告用于呈报，这样准备减刑材料 | P1 | +| 教育科长 | 作为教育科长，我希望审核报告，这样确保报告准确 | P1 | +| 管教民警 | 作为管教民警，我希望修改AI生成的初稿，这样确保报告准确性 | P1 | + +## 三、功能需求 + +### 3.1 评估报告模板管理 + +#### 3.1.1 模板分类 + +**模板类型**： +- 入监综合评估报告 +- 定期考核报告 +- 出监评估报告 +- 减刑假释建议报告（新增） +- 专项评估报告 + +#### 3.1.2 模板配置 + +**模板内容**： +- 模板名称 +- 模板类型 +- 报告标题格式 +- 章节结构（评估维度） +- 数据字段映射 +- AI提示词配置 +- 样式配置 + +**评估维度配置**： +| 字段 | 类型 | 说明 | +|------|------|------| +| 维度名称 | 文本 | 如：犯罪情况分析、服刑表现评估等 | +| AI提示词 | 多行文本 | AI生成的指令模板 | +| 数据源绑定 | 多选 | 选择需要聚合的数据源 | +| 输出格式 | 下拉 | 文本/段落/列表 | +| 是否AI生成 | 开关 | 该维度是否需要AI生成 | +| 编辑器类型 | 下拉 | 文本框/富文本/下拉选择 | +| 排序 | 数字 | 维度排序 | + +**章节结构示例**： +``` +一、基本信息 + - 罪犯姓名、编号、入狱日期等 + +二、犯罪及刑罚情况 + - 罪名、刑期、判决情况等 + +三、改造表现 + - 考核得分、等级 + - 表扬/处分记录 + +四、心理评估 + - 测评结果 + - 风险等级 + +五、服刑表现综合分析（AI生成） + - 消费行为分析 + - 劳动表现分析 + - 狱内关系分析 + +六、管教意见 + - 改造评价 + - 建议意见 + +七、附件 + - 相关证明材料 +``` + +#### 3.1.3 模板操作 + +**功能**： +- 新增模板 +- 编辑模板 +- 复制模板 +- 启用/停用模板 +- 设为默认 +- 版本管理 + +#### 3.1.4 评估维度管理 + +评估维度是模板的核心组成部分，定义了报告的章节结构和内容生成规则。 + +##### 3.1.4.1 维度管理操作 + +| 功能 | 说明 | 触发条件 | +|-----|------|---------| +| 新增维度 | 为模板添加新的评估维度 | 模板详情页点击"新增维度" | +| 编辑维度 | 修改维度名称、提示词、数据源等配置 | 点击维度卡片的"编辑"按钮 | +| 删除维度 | 删除模板下的维度 | 未被报告引用时可删除 | +| 复制维度 | 基于现有维度快速创建新维度 | 点击"复制"按钮 | +| 拖拽排序 | 调整维度在模板中的显示顺序 | 拖拽维度卡片上下移动 | +| 启用/停用 | 控制维度是否在报告中显示 | 切换状态开关 | + +##### 3.1.4.2 维度配置字段 + +| 字段 | 类型 | 必填 | 说明 | +|-----|------|-----|------| +| 维度名称 | 文本 | 是 | 如：犯罪情况分析、服刑表现评估 | +| 维度编码 | 文本 | 是 | 唯一标识，如：crime_analysis | +| 维度类型 | 下拉 | 是 | 1-基本信息 2-犯罪情况 3-服刑表现 4-心理评估 5-风险评估 6-消费行为 7-劳动表现 8-家庭帮教 9-综合分析 10-管教意见 | +| 数据源绑定 | 多选 | 否 | 选择需要聚合的数据源（见3.2数据源配置） | +| 生成方式 | 下拉 | 是 | 1-自动填充（从数据源） 2-AI生成 3-人工填写 | +| AI提示词 | 多行文本 | 条件必填 | 生成方式为AI生成时必填 | +| 输出格式 | 下拉 | 是 | 1-文本 2-段落 3-列表 | +| 编辑器类型 | 下拉 | 是 | 1-文本框 2-富文本 3-下拉选择 | +| 是否必填 | 开关 | 是 | 该维度内容是否必须填写 | +| 字数限制 | 数字 | 否 | 最小字数-最大字数 | +| 排序 | 数字 | 是 | 维度在报告中的显示顺序 | +| 状态 | 开关 | 是 | 启用/停用 | + +##### 3.1.4.3 AI提示词变量 + +在AI提示词中可以使用以下变量，系统会自动替换为实际数据： + +| 变量 | 说明 | 示例 | +|-----|------|------| +| `{罪犯姓名}` | 罪犯姓名 | 张三 | +| `{罪犯编号}` | 罪犯档案编号 | 2024001 | +| `{罪犯档案}` | 完整罪犯档案信息JSON | {"name":"张三","crime":"盗窃罪"...} | +| `{计分考核}` | 计分考核数据JSON | {"monthlyScore":98,"level":"良好"...} | +| `{消费记录}` | 消费记录数据JSON | {"totalAmount":1200,"avgMonthly":100...} | +| `{心理测评}` | 心理测评结果JSON | {"score":85,"level":"正常"...} | +| `{风险评估}` | 风险评估结果JSON | {"riskLevel":"低风险","score":25...} | +| `{违规记录}` | 违规记录数据JSON | {"count":0,"types":[]...} | +| `{奖励记录}` | 奖励记录数据JSON | {"praiseCount":2,"types":["表扬"]...} | +| `{会见记录}` | 会见记录数据JSON | {"visitCount":5,"lastVisit":"2026-01-10"...} | +| `{家庭帮教}` | 家庭帮教情况JSON | {"supportLevel":"积极","contact":"良好"...} | +| `{维度名称}` | 当前维度名称 | 服刑表现评估 | + +**AI提示词示例**： +``` +你是一位有20年工作经验的监狱管教民警，请根据以下{罪犯姓名}的服刑数据， +生成一份专业的{维度名称}分析报告。 + +【基本信息】 +{罪犯档案} + +【服刑表现数据】 +{计分考核} + +【消费行为数据】 +{消费记录} + +要求： +1. 语言专业、客观，符合监狱管理规范 +2. 结合具体数据进行分析，有理有据 +3. 字数控制在200-500字 +4. 不要使用模板化语言，针对个案具体分析 +``` + +##### 3.1.4.4 维度管理页面 + +``` +┌─────────────────────────────────────────────────────────────────────┐ +│ 模板详情 - 入监风险评估模板 │ +├─────────────────────────────────────────────────────────────────────┤ +│ [基本信息] [维度配置] │ +├─────────────────────────────────────────────────────────────────────┤ +│ │ +│ 维度配置 [+ 新增维度] │ +│ ┌───────────────────────────────────────────────────────────────┐ │ +│ │ ≡ 1. 基本信息 [自动填充] [必填] │ │ +│ │ 数据源：罪犯档案 │ │ +│ │ [编辑] [复制] [删除] [↑] [↓] │ │ +│ └───────────────────────────────────────────────────────────────┘ │ +│ ┌───────────────────────────────────────────────────────────────┐ │ +│ │ ≡ 2. 犯罪情况分析 [AI生成] [必填] │ │ +│ │ 数据源：罪犯档案 │ │ +│ │ 提示词：你是一位有20年... │ │ +│ │ [编辑] [复制] [删除] [↑] [↓] │ │ +│ └───────────────────────────────────────────────────────────────┘ │ +│ ┌───────────────────────────────────────────────────────────────┐ │ +│ │ ≡ 3. 服刑表现评估 [AI生成] [必填] │ │ +│ │ 数据源：计分考核、违规记录、奖励记录 │ │ +│ │ 提示词：请根据该犯的考核数据... │ │ +│ │ [编辑] [复制] [删除] [↑] [↓] │ │ +│ └───────────────────────────────────────────────────────────────┘ │ +│ ┌───────────────────────────────────────────────────────────────┐ │ +│ │ ≡ 4. 综合结论与建议 [人工填写] [必填] │ │ +│ │ 编辑器：富文本 │ │ +│ │ [编辑] [复制] [删除] [↑] [↓] │ │ +│ └───────────────────────────────────────────────────────────────┘ │ +│ │ +│ 提示：拖拽 ≡ 图标可调整维度顺序 │ +└─────────────────────────────────────────────────────────────────────┘ +``` + +##### 3.1.4.5 维度编辑弹窗 + +``` +┌─────────────────────────────────────────────────────────────────────┐ +│ 编辑维度 - 服刑表现评估 [×] │ +├─────────────────────────────────────────────────────────────────────┤ +│ │ +│ 维度名称 *：[服刑表现评估 ] │ +│ 维度编码 *：[behavior_evaluation ] │ +│ 维度类型 *：[服刑表现 ▼] │ +│ │ +│ 生成方式 *：[AI生成 ▼] │ +│ │ +│ 数据源绑定： │ +│ [✓] 计分考核 [✓] 违规记录 [✓] 奖励记录 [ ] 劳动数据 │ +│ [ ] 消费记录 [ ] 心理测评 [ ] 会见记录 [ ] 家庭帮教 │ +│ │ +│ AI提示词 *： │ +│ ┌───────────────────────────────────────────────────────────────┐ │ +│ │ 你是一位有20年工作经验的监狱管教民警，请根据{罪犯姓名}的 │ │ +│ │ 服刑表现数据，生成一份专业的{维度名称}分析报告... │ │ +│ └───────────────────────────────────────────────────────────────┘ │ +│ [插入变量▼] 可用变量：罪犯姓名、罪犯档案、计分考核... │ +│ │ +│ 输出格式 *：[段落 ▼] │ +│ 编辑器类型 *：[富文本 ▼] │ +│ 字数限制：最小 [200] 字 最大 [500] 字 │ +│ 是否必填：[✓] 状态：[✓] 启用 │ +│ │ +│ [取消] [测试AI生成] [保存] │ +└─────────────────────────────────────────────────────────────────────┘ +``` + +### 3.2 数据源配置 + +#### 3.2.1 可用数据源 + +| 数据源类型 | 标识 | 说明 | +|-----------|------|------| +| 罪犯档案 | prisoner | 基本信息、犯罪情况、刑期等 | +| 消费记录 | consumption | 消费金额、消费类型分布 | +| 计分考核 | score | 月度得分、年度汇总、等级分布 | +| 问卷答题 | questionnaire_record | 心理测评结果、问卷得分 | +| 风险评估 | risk_assessment | 危险评估得分、风险等级 | +| 违规记录 | violation | 违规次数、违规类型 | +| 奖励记录 | reward | 表扬次数、立功情况 | +| 会见记录 | visit | 会见频次、会见人关系 | +| 劳动数据 | labor | 劳动效率、产量质量 | +| 家庭帮教 | family | 家属会见情况、家庭支持情况 | +| 心理测评 | psychology | 心理测评得分、心理状态 | + +### 3.2.2 【新增】家庭帮教维度设计 + +**维度说明**： +家庭帮教情况是减刑假释评估的重要参考因素，建议作为独立维度纳入评估模板。 + +**维度子项**： +| 子项名称 | 字段类型 | 说明 | 数据来源 | +|---------|---------|------|---------| +| 家属会见频次 | 自动填充 | 近6个月会见次数、月均会见次数 | 会见记录表 | +| 帮教通信情况 | 自动填充 | 家属来信次数、通信内容摘要 | 通信记录表 | +| 家属态度评价 | 人工选择 | 积极/一般/消极 | 管教评价 | +| 家庭支持力度 | 人工选择 | 强/中/弱（经济支持、情感支持） | 综合评估 | +| 假释后安置意向 | 人工填写 | 有无固定住所、就业意向 | 档案信息/人工填写 | + +**AI提示词建议**： +``` +请根据以下家庭帮教情况数据，分析该犯的家属帮教支持情况： +- 家属会见频次：{会见次数}次/月 +- 帮教通信：{通信次数}次/月 +- 家属态度：{家属态度} +- 家庭支持：{支持力度} +- 安置条件：{安置意向} + +请生成客观描述，重点分析： +1. 家属帮教对罪犯改造效果的积极/消极影响 +2. 家庭支持对罪犯心理状态的影响 +3. 假释后的家庭监管条件评估 +4. 建议加强的帮教措施 + +要求： +- 语言专业、客观 +- 基于具体数据分析 +- 字数控制在200-400字 +``` + +**维度配置建议**： +- 生成方式：AI生成（根据自动填充数据） +- 是否必填：建议必填（减刑假释评估时尤为重要） +- 适用模板：入监评估、定期考核、出监评估、减刑假释建议报告 + +### 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 创建报告（修订版） + +**创建方式**： +- 手动创建：选择罪犯 + 数据检查 + 选择模板 + 生成报告 +- 批量创建：选择多个罪犯 + 选择模板 + 批量生成 + +**生成流程**： +``` +步骤1：选择罪犯 + │ + ▼ +步骤2：【新增】数据完整性检查 ⚠️ + ├── 检查项： + │ ├── 罪犯档案完整性（基本信息、犯罪情况、刑期等） + │ ├── 计分考核记录（最近12个月） + │ ├── 消费记录（最近12个月） + │ ├── 心理测评记录（最近1年） + │ └── 危险评估记录（最近1年） + ├── 显示结果： + │ ├── 完整：显示绿色勾选 ✓ + │ ├── 缺失：显示黄色警告 ⚠ + 缺失项列表 + └── 操作： + ├── [继续生成]（数据完整或允许缺失生成） + └── [补录数据]（跳转补录页面，缺失关键数据时强提醒） + │ + ▼ +步骤3：选择报告模板 + ├── 显示模板列表（支持搜索和筛选） + └── 显示模板预览（包含维度结构） + │ + ▼ +步骤4：确认生成 + ├── 显示：预计生成时间、数据完整性状态 + └── [确认生成] + │ + ▼ +步骤5：AI生成报告初稿 + ├── 生成时间：30-60秒/份 + ├── 并发限制：最多3个并行任务（单个生成） + └── 批量生成：进入异步队列处理 + │ + ▼ +步骤6：人工审核修改 + ├── 步骤：查看报告 → 逐维度审核 → 修改 → 确认 + └── 标识：AI生成内容显示"🤖 AI生成"标识 + │ + ▼ +步骤7：提交审核 + +#### 3.5.3 【新增】批量生成流程 + +**功能说明**： +支持选择多个罪犯+模板，批量生成评估报告。批量生成使用异步队列处理，避免接口超时。 + +**批量生成流程**： +``` +批量生成入口：批量选择罪犯 → 选择模板 → 批量生成 + │ + ▼ +前置检查 + ├── 数据完整性扫描（批量） + │ ├── 统计完整数据罪犯数 + │ ├── 统计缺失数据罪犯数 + │ └── 生成数据完整性报告 + └── 显示：[继续生成] [补录数据] [取消] + │ + ▼ +任务队列 + ├── 异步处理：进入后台队列 + │ ├── 队列优先级：普通 + │ ├── 并发控制：最多10个并行任务 + │ └── 超时设置：单任务超时5分钟 + ├── 预估时间：根据数量计算 + │ └── 显示：预计完成时间 + └── 用户操作：可离开去做其他工作 + │ + ▼ +进度通知 + ├── 进度条：实时显示进度 + │ ├── 已完成：X/Y 份 + │ ├── 进行中：Z 份 + │ └── 失败：W 份（显示失败原因） + ├── 完成通知：系统消息通知 + │ └── 通知内容：批量生成完成，成功X份，失败Y份 + └── 失败处理：标记失败项，支持重试 +``` + +**批量生成限制**： +| 项目 | 限制值 | 说明 | +|-----|-------|------| +| 单次批量数量 | 最多50个 | 超过需分批处理 | +| 每日批量次数 | 无限制 | 根据实际需求 | +| 队列优先级 | 普通 | 低优先级任务可延迟处理 | + +**批量生成状态管理**： +| 状态 | 说明 | 操作 | +|-----|------|------| +| 等待中 | 任务已加入队列，等待处理 | 可取消 | +| 处理中 | 正在生成中 | 显示进度 | +| 已完成 | 全部生成成功 | 查看报告 | +| 部分失败 | 部分成功，部分失败 | 查看失败列表，可重试 | +| 全部失败 | 全部生成失败 | 查看原因，可重试 | + +**自动填充内容**： +- 罪犯基本信息（从狱政模块获取） +- 考核数据（从计分考核模块获取） +- 测评数据（从测评模块获取） +- 风险评估数据（从危险评估模块获取） +- 消费数据（从消费模块获取） +- AI生成的分析内容（根据模板配置的维度） + +**AI生成内容**： +- 消费行为分析 +- 劳动表现分析 +- 改造趋势分析 +- 风险因素分析 +- 综合评估结论 + +**手动补充内容**： +- 管教意见 +- 建议结论 +- 附件上传 + +#### 3.4.3 人机协作模式 + +- AI生成各维度初稿，显示"AI生成"标识 +- 管教民警可逐维度编辑修改 +- 修改后显示"人工修改"标识和修改时间 +- 支持单个维度重新AI生成 +- 记录修改历史（版本管理） + +### 3.5 报告预览 + +#### 3.5.1 在线预览 + +**展示内容**： +- 报告标题 +- 报告生成时间 +- 完整报告内容（分章节展示） +- AI生成内容标识（"AI生成"或"人工修改"） +- 附件列表 + +**交互功能**： +- 章节导航 +- 缩放控制 +- 打印预览 + +#### 3.5.2 报告编辑页面（左右分栏布局） + +``` +┌─────────────────────────────────────────────────────────────────────────┐ +│ 评估报告编辑 │ +├────────────────────────────┬────────────────────────────────────────────┤ +│ 【服刑人员列表】 │ 【报告编辑区】 │ +│ ┌────────────────────┐ │ ┌────────────────────────────────────────┐ │ +│ │ [搜索框] 姓名/编号 │ │ │ [操作按钮] │ │ +│ │ [搜索按钮] │ │ │ [AI生成全部] [保存草稿] [提交审核] [导出]│ │ +│ ├────────────────────┤ │ ├────────────────────────────────────────┤ │ +│ │ [卡片列表] │ │ │ │ │ +│ │ ┌────────────────┐│ │ │ [基本信息] │ │ +│ │ │ 三分监区 ││ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ 张三 2024001 ││ │ │ │ 服刑人员：张三 (2024001) │ │ │ +│ │ │ [高风险] ││ │ │ │ 监区：三分监区 评估日期：2026-01-16│ │ │ +│ │ └────────────────┘│ │ │ │ 模板：入监风险评估 v 类型：入监评估 v │ │ │ +│ │ │ │ │ └────────────────────────────────────┘ │ │ +│ │ ┌────────────────┐│ │ │ │ │ +│ │ │ 二分监区 ││ │ │ [维度分析] │ │ +│ │ │ 李四 2024002 ││ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ [中风险] ││ │ │ │ ▼ 犯罪情况分析 [重新生成] │ │ │ +│ │ └────────────────┘│ │ │ │ 该犯因盗窃罪... │ │ │ +│ │ │ │ │ │ [AI生成] [已修改] │ │ │ +│ │ ┌────────────────┐│ │ │ └────────────────────────────────────┘ │ │ +│ │ │ 一分监区 ││ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ 王五 2024003 ││ │ │ │ ▼ 服刑表现评估 [重新生成] │ │ │ +│ │ │ [低风险] ││ │ │ │ 入监以来表现良好... │ │ │ +│ │ └────────────────┘│ │ │ │ [AI生成] │ │ │ +│ │ │ │ │ └────────────────────────────────────┘ │ │ +│ │ ... │ │ │ │ │ +│ ├────────────────────┤ │ ├────────────────────────────────────────┤ │ +│ │ [分页组件] 1/5 │ │ │ [综合结论与建议] │ │ +│ └────────────────────┘ │ │ ┌────────────────────────────────────┐ │ │ +│ │ │ │ 风险等级：高风险 v │ │ │ +│ │ │ │ 综合结论： │ │ │ +│ │ │ │ [多行输入框] │ │ │ +│ │ │ │ │ │ │ +│ │ │ │ 改造建议： │ │ │ +│ │ │ │ [多行输入框] │ │ │ +│ │ │ └────────────────────────────────────┘ │ │ +│ │ │ │ │ +│ │ │ │ │ +│ │ └──────────────────────────────────────────┘ │ +│ │ │ +└────────────────────────────┴────────────────────────────────────────────┘ +``` + +**布局说明**： +- **左侧罪犯列表区域**：宽度280px，高度占满左侧，支持滚动 +- **右侧报告编辑区域**：自适应宽度，高度占满右侧，支持滚动 +- **顶部固定操作栏**：操作按钮固定在报告编辑区顶部，方便操作 +- **内容区域**：基本信息、维度分析、综合结论从左到下排列 +- **罪犯卡片**：显示监区、姓名、编号、风险等级，点击选中高亮 + +**页面特性**： +- 操作按钮固定在顶部，不随滚动消失 +- 罪犯列表分页加载（每页20条） +- 搜索框支持姓名和编号模糊查询 +- 选中罪犯后右侧显示对应的报告编辑区 +- 维度分析可折叠展开，支持逐维度重新AI生成 + +**可编辑内容**： +- AI生成的各维度内容（可重新生成或手动修改） +- 管教意见 +- 建议结论 +- 附件管理 + +**不可编辑内容**： +- 系统自动填充的基础数据 + +### 3.5.3 页面设计易用性改进建议 + +#### 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.6.2 审核操作 + +**通过**： +- 状态变为"已通过" +- 记录审核人和时间 + +**退回**： +- 状态变为"已退回" +- 选择退回原因（分类选择） +- 可选填写详细说明 +- 返回起草人修改 + +**退回原因分类**： +| 分类 | 说明 | +|-----|------| +| 内容不完整 | 必填维度未填写完整 | +| 数据错误 | 数据与实际情况不符 | +| 表述不当 | 文字表述需要改进 | +| 逻辑不清 | 分析逻辑需要调整 | +| 其他 | 其他原因（可选填说明） | + +### 3.6 报告安全与防篡改 + +#### 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.9.2 下载操作 + +**功能**： +- 单个下载 +- 批量下载 +- 批量打包下载 + +### 3.10 报告归档（修订版） + +#### 3.10.1 归档管理 + +**归档规则**： +- **自动归档**：审核通过后24小时自动归档（可配置） +- **手动归档**：管理员可手动标记归档 +- **归档条件**： + - 报告状态为"已通过" + - 已超过归档冷静期（默认24小时，可配置） + - 归档前无需再次确认 + +**归档效果**： +- 报告状态变为"已归档" +- 归档后报告不可修改 +- 归档后报告不可删除 +- 归档后仍可查看和导出 + +**自动归档流程**： +``` +定时任务（每小时执行一次） + │ + ▼ +查询已通过状态超过冷静期的报告 + │ + ▼ +批量更新状态为"已归档" + │ + ▼ +记录归档日志 + │ + ▼ +发送归档完成通知（可选） +``` + +#### 3.10.2 归档查询 + +**查询条件**： +- 归档时间范围 +- 报告类型 +- 罪犯信息 +- 创建人 + +### 3.11 报告列表管理页面 + +#### 3.11.1 页面布局 + +``` +┌─────────────────────────────────────────────────────────────────────────┐ +│ 评估报告管理 [+ 新建报告] │ +├─────────────────────────────────────────────────────────────────────────┤ +│ 筛选条件 │ +│ ┌─────────────────────────────────────────────────────────────────┐ │ +│ │ 状态：[全部▼] 类型：[全部▼] 监区：[全部▼] 风险等级：[全部▼] │ │ +│ │ 创建日期：[2026-01-01] 至 [2026-01-18] │ │ +│ │ 罪犯：[姓名/编号搜索... ] [搜索] [重置] │ │ +│ └─────────────────────────────────────────────────────────────────┘ │ +├─────────────────────────────────────────────────────────────────────────┤ +│ 批量操作：[批量生成] [批量导出] [批量删除] 已选 0 项 │ +├─────────────────────────────────────────────────────────────────────────┤ +│ □ 报告编号 罪犯 监区 类型 风险 状态 创建人 创建时间 操作 │ +│ ───────────────────────────────────────────────────────────────────── │ +│ □ RPT-JQ01-202601-0001 张三(2024001) 一监区 入监评估 🔴高 已通过 陈警官 2026-01-15 [查看][编辑][导出]│ +│ □ RPT-JQ02-202601-0002 李四(2024002) 二监区 定期考核 🟡中 待审核 王警官 2026-01-16 [查看][编辑][审核]│ +│ □ RPT-JQ01-202601-0003 王五(2024003) 一监区 入监评估 🟢低 草稿 陈警官 2026-01-17 [查看][编辑][删除]│ +│ □ RPT-JQ03-202601-0004 赵六(2024004) 三监区 出监评估 🟢低 已退回 李警官 2026-01-18 [查看][编辑][删除]│ +│ ... │ +├─────────────────────────────────────────────────────────────────────────┤ +│ 共 125 条 [< 1 2 3 4 5 ... 13 >] 每页 [10▼] 条 │ +└─────────────────────────────────────────────────────────────────────────┘ +``` + +#### 3.11.2 筛选条件 + +| 筛选项 | 类型 | 可选值 | 说明 | +|-------|------|-------|------| +| 状态 | 下拉单选 | 全部/草稿/待审核/已通过/已退回/已归档 | 报告当前状态 | +| 类型 | 下拉单选 | 全部/入监评估/定期考核/出监评估/减刑假释/专项评估 | 报告模板类型 | +| 监区 | 下拉单选 | 全部/各监区列表 | 罪犯所属监区 | +| 风险等级 | 下拉单选 | 全部/高风险/中风险/低风险 | 评估风险等级 | +| 创建日期 | 日期范围 | 开始日期-结束日期 | 报告创建时间范围 | +| 罪犯 | 文本输入 | 姓名或编号 | 支持模糊搜索 | + +#### 3.11.3 列表字段 + +| 字段 | 说明 | 排序 | +|-----|------|------| +| 报告编号 | 系统自动生成的唯一编号 | 支持 | +| 罪犯 | 显示姓名和编号 | 支持 | +| 监区 | 罪犯所属监区 | 支持 | +| 类型 | 报告模板类型 | 支持 | +| 风险等级 | 显示风险等级图标+文字 | 支持 | +| 状态 | 显示状态标签（不同颜色） | 支持 | +| 创建人 | 报告创建人 | 支持 | +| 创建时间 | 报告创建时间 | 支持（默认倒序） | +| 操作 | 根据状态显示可用操作 | - | + +#### 3.11.4 操作按钮 + +| 状态 | 可用操作 | +|-----|---------| +| 草稿 | 查看、编辑、AI生成、删除 | +| 待审核 | 查看、审核（审核人）、撤回（创建人） | +| 已通过 | 查看、导出、归档 | +| 已退回 | 查看、编辑、重新提交、删除 | +| 已归档 | 查看、导出 | + +#### 3.11.5 批量操作 + +| 操作 | 说明 | 限制条件 | +|-----|------|---------| +| 批量生成 | 选择多个罪犯+模板，批量生成报告 | 最多50个 | +| 批量导出 | 将选中的报告导出为PDF/Word | 仅已通过状态 | +| 批量删除 | 删除选中的报告 | 仅草稿/已退回状态 | + +### 3.12 报告编号规则 + +#### 3.12.1 编号格式 + +``` +格式：RPT-{监区编码}-{年月}-{4位序号} +示例：RPT-JQ01-202601-0001 +``` + +| 组成部分 | 说明 | 示例 | +|---------|------|------| +| RPT | 固定前缀，表示Report | RPT | +| 监区编码 | 罪犯所属监区编码 | JQ01（一监区） | +| 年月 | 报告创建年月，6位 | 202601 | +| 序号 | 当月监区内的流水号，4位 | 0001 | + +#### 3.12.2 编号生成规则 + +1. **唯一性**：报告编号全局唯一，不可重复 +2. **自动生成**：创建报告时系统自动生成，不可手动修改 +3. **序号递增**：同一监区同一月份内，序号从0001开始递增 +4. **跨月重置**：新的月份序号从0001重新开始 +5. **不可复用**：删除的报告编号不会被重新使用 + +#### 3.12.3 监区编码对照 + +| 监区名称 | 编码 | +|---------|------| +| 一监区 | JQ01 | +| 二监区 | JQ02 | +| 三监区 | JQ03 | +| ... | ... | +| 入监队 | RJD | +| 出监队 | CJD | + +### 3.13 状态流转定义 + +#### 3.13.1 状态说明 + +| 状态 | 状态值 | 说明 | 颜色 | +|-----|-------|------|------| +| 草稿 | 1 | 报告已创建，可编辑 | 灰色 | +| 待审核 | 2 | 已提交，等待审核人审核 | 蓝色 | +| 已通过 | 3 | 审核通过，可导出 | 绿色 | +| 已退回 | 4 | 审核退回，需修改后重新提交 | 红色 | +| 已归档 | 5 | 已归档，不可修改 | 紫色 | + +#### 3.13.2 状态流转图 + +``` + ┌──────────────────────────────────────┐ + │ │ + ▼ │ +┌────────┐ 提交审核 ┌────────┐ 审核通过 ┌────────┐ 归档 ┌────────┐ +│ 草稿 │ ────────→ │ 待审核 │ ────────→ │ 已通过 │ ────→ │ 已归档 │ +└────────┘ └────────┘ └────────┘ └────────┘ + │ │ + │ │ 审核退回 + │ ▼ + │ ┌────────┐ + │ │ 已退回 │ + │ └────────┘ + │ │ + │ │ 重新提交 + └────────────────────┘ +``` + +#### 3.13.3 状态流转规则（修订版） + +| 当前状态 | 操作 | 目标状态 | 操作人 | 前置条件 | +|---------|------|---------|-------|---------| +| 草稿 | 提交审核 | 待审核 | 创建人 | 所有必填维度已填写 | +| 草稿 | 删除 | - | 创建人 | - | +| 待审核 | 审核通过 | 已通过 | 审核人 | - | +| 待审核 | 审核退回 | 已退回 | 审核人 | 必须选择退回原因（分类选择） | +| 待审核 | 【新增】撤回 | 草稿 | 创建人 | -（提交后24小时内可撤回） | +| 已退回 | 重新提交 | 待审核 | 创建人 | 所有必填维度已填写 | +| 已退回 | 删除 | - | 创建人 | - | +| 已通过 | 【修订】自动归档 | 已归档 | 系统 | 审核通过后24小时自动归档 | +| 已通过 | 导出 | 已通过 | 所有人 | - | +| 已归档 | 导出 | 已归档 | 所有人 | - | + +**撤回功能说明**： +- 撤回条件：报告处于"待审核"状态 +- 撤回时限：提交后24小时内可撤回（可配置） +- 撤回操作：点击"撤回"按钮，状态变回"草稿" +- 撤回记录：记录撤回人、撤回时间、撤回原因（非必填） + +#### 3.13.4 状态变更记录 + +每次状态变更需记录以下信息： + +| 字段 | 说明 | +|-----|------| +| 变更时间 | 状态变更的时间戳 | +| 操作人 | 执行状态变更的用户 | +| 原状态 | 变更前的状态 | +| 新状态 | 变更后的状态 | +| 操作类型 | 提交审核/审核通过/审核退回/撤回/归档 | +| 备注 | 退回原因或其他说明 | + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 报告编号全局唯一 | +| BR-002 | 已发布的报告不能修改 | +| BR-003 | 报告数据取自源系统，保证一致性 | +| BR-004 | AI生成内容必须经过人工审核确认后才能正式使用 | +| BR-005 | 报告需要审核后才能下载 | +| BR-006 | 归档报告不可删除 | +| BR-007 | 敏感信息在报告中脱敏 | +| BR-008 | AI生成日志需要记录，可追溯 | +| BR-009 | 已审核报告添加数字签名，保证法律效力 | +| BR-010 | 支持快捷评语快速插入 | +| BR-011 | 支持报告历史版本查看和对比 | + +## 五、验收标准（v1.3修订版） + +- [ ] 支持报告模板管理（含AI提示词配置） +- [ ] 支持评估维度配置（拖拽排序） +- [ ] 【新增】支持数据完整性检查（生成前检查数据完整性） +- [ ] 支持创建报告 +- [ ] 支持数据自动填充（客观题） +- [ ] 支持AI生成报告初稿（主观题） +- [ ] 支持人工修改AI生成内容 +- [ ] 支持报告预览 +- [ ] 支持报告编辑 +- [ ] 支持报告审核流程（含退回原因选择） +- [ ] 【新增】支持撤回功能（提交后24小时内可撤回） +- [ ] 支持报告下载（PDF/Word/Excel） +- [ ] 【修订】支持报告自动归档（审核通过后24小时自动归档） +- [ ] 支持批量生成报告（异步队列处理） +- [ ] 【新增】支持批量生成进度查询和通知 +- [ ] 支持数据源绑定配置 +- [ ] 支持快捷评语功能 +- [ ] 支持历史版本查看与对比 +- [ ] 支持版本回滚功能 +- [ ] 支持报告防篡改机制（数字签名） +- [ ] 支持数据缓存和异步生成 +- [ ] 支持减刑假释专用模板 +- [ ] 【新增】支持家庭帮教评估维度 + +## 六、相关模块 + +- 依赖：狱政信息管理模块（罪犯数据） +- 依赖：计分考核模块（考核数据） +- 依赖：测评管理模块（测评数据） +- 依赖：危险评估模块（风险数据） +- 依赖：消费管理模块（消费数据） +- 依赖：外部系统（数据同步） +- 依赖：AI模型服务（私有部署/第三方API） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.3（根据业务流程确认结果修订） +**更新日期**：2026-01-18 +**修订说明**： +- 增加报告生成前数据完整性检查步骤 +- 完善批量生成异步队列设计 +- 增加撤回功能流程 +- 完善自动归档规则（审核通过后24小时自动归档） +- 补充家庭帮教评估维度设计 +- 完善退回原因选择器（分类选择） +- 更新验收标准 + +--- + +### 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完成二稿评审。 diff --git a/requirements/需求-11-智能预警.md b/requirements/需求-11-智能预警.md new file mode 100644 index 0000000..cc7797e --- /dev/null +++ b/requirements/需求-11-智能预警.md @@ -0,0 +1,157 @@ +# 需求-11-智能预警 + +> 模块名称：智能预警 +> 优先级：P2 +> 预估工时：32h + +--- + +## 一、业务背景 + +智能预警系统通过分析罪犯的行为数据，自动发现异常模式和潜在风险，提前预警。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 心理辅导员 | 作为心理辅导员，我希望系统发现异常行为模式，这样及时干预 | P2 | +| 狱政科长 | 作为狱政科长，我希望消费异常有预警，这样防止过度消费 | P2 | +| 分监区长 | 作为分监区长，我希望考核下滑有预警，这样关注重点人员 | P2 | +| 管理员 | 作为管理员，我希望有风险预测模型，这样提前识别高风险罪犯 | P2 | + +## 三、功能需求 + +### 3.1 行为异常检测 + +#### 3.1.1 行为模式分析 + +**分析维度**： +- 考核得分趋势 +- 消费行为模式 +- 人际交往情况 +- 情绪表达特征 + +**检测规则**： +- 考核连续下滑（连续3个月下降） +- 消费突然增加（较历史均值增加50%） +- 社交圈变化（突然接触新群体） +- 情绪表达异常（测评分数突变） + +#### 3.1.2 异常标记 + +**标记内容**： +- 异常类型 +- 异常程度 +- 触发规则 +- 建议关注点 + +### 3.2 消费异常预警 + +#### 3.2.1 阈值预警 + +**预警规则**： +- 单日消费超过设定阈值 +- 单月消费超过设定阈值 +- 消费频率异常（单日多次消费） + +**预警触发**： +- 超出阈值时生成预警 +- 通知相关管理人员 + +#### 3.2.2 模式预警 + +**分析规则**： +- 与历史消费模式偏离 +- 与同监区平均消费偏离 +- 消费时间异常（非正常时段） + +### 3.3 考核下滑预警 + +#### 3.3.1 趋势分析 + +**分析维度**： +- 连续下降月数 +- 下降幅度 +- 下降原因推断 + +**预警规则**： +- 连续2月下降超过10% +- 连续3月下降 +- 考核等级降级 + +### 3.4 风险预测模型 + +#### 3.4.1 特征提取 + +**输入特征**： +- 历史考核得分 +- 历史测评结果 +- 风险评估等级 +- 消费行为特征 +- 违规记录 + +#### 3.4.2 风险评分 + +**输出**： +- 风险评分（0-100） +- 风险等级（高/中/低） +- 风险因素（哪些因素导致高分） + +**模型说明**： +- 基于历史数据训练的预测模型 +- 定期更新模型参数 + +### 3.5 预警通知 + +#### 3.5.1 通知方式 + +**通知渠道**： +- 系统站内消息 +- 短信通知（预留接口） +- 邮件通知（预留接口） + +#### 3.5.2 通知配置 + +**配置项**： +- 通知接收人 +- 通知方式 +- 通知时机（即时/汇总） +- 通知频率 + +#### 3.5.3 预警汇总 + +**汇总报告**： +- 每日预警汇总 +- 每周预警趋势 +- 高风险预警列表 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 预警产生后需要人工确认 | +| BR-002 | 高风险预警必须24小时内处理 | +| BR-003 | 预警记录不可删除 | +| BR-004 | 预测模型定期更新 | +| BR-005 | 误报率需要控制在合理范围 | + +## 五、验收标准 + +- [ ] 支持行为异常检测 +- [ ] 支持消费异常预警 +- [ ] 支持考核下滑预警 +- [ ] 支持风险预测评分 +- [ ] 支持预警通知配置 +- [ ] 支持预警汇总报告 +- [ ] 预警准确率达到要求 + +## 六、相关模块 + +- 依赖：消费管理模块（消费数据） +- 依赖：计分考核模块（考核数据） +- 依赖：危险评估模块（风险数据） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求-12-智能分析.md b/requirements/需求-12-智能分析.md new file mode 100644 index 0000000..cbf7293 --- /dev/null +++ b/requirements/需求-12-智能分析.md @@ -0,0 +1,182 @@ +# 需求-12-智能分析 + +> 模块名称：智能分析 +> 优先级：P2 +> 预估工时：22h + +--- + +## 一、业务背景 + +智能分析模块提供深度数据分析和预测功能，帮助管理层发现规律、制定决策。 + +## 二、用户故事 + +| 角色 | 故事描述 | 优先级 | +|-----|---------|-------| +| 监狱长 | 作为监狱长，我希望系统自动生成分析报告，这样减少人工汇总 | P2 | +| 教育科长 | 作为教育科长，我希望有趋势预测，这样制定教育计划 | P2 | +| 心理辅导员 | 作为心理辅导员，我希望发现数据关联，这样针对性干预 | P2 | +| 管理员 | 作为管理员，我希望有智能分析结果，这样辅助决策 | P2 | + +## 三、功能需求 + +### 3.1 自动报表生成 + +#### 3.1.1 报告类型 + +**周期报告**： +- 日报：每日运行情况 +- 周报：每周运行情况 +- 月报：每月运行情况 +- 年报：每年运行情况 + +**专题报告**： +- 人口构成分析 +- 考核情况分析 +- 消费行为分析 +- 风险评估分析 + +#### 3.1.2 报告内容 + +**报告结构**： +- 关键指标概览 +- 数据图表展示 +- 异常情况说明 +- 趋势分析 +- 建议措施 + +#### 3.1.3 自动生成 + +**生成机制**： +- 定时生成（日/周/月/年） +- 手动触发生成 +- 按模板生成 + +### 3.2 趋势预测 + +#### 3.2.1 人口预测 + +**预测维度**： +- 在册人数趋势 +- 收押趋势 +- 释放趋势 +- 刑满释放预测 + +**预测周期**： +- 短期预测（未来1个月） +- 中期预测（未来3个月） +- 长期预测（未来1年） + +#### 3.2.2 考核趋势 + +**预测内容**： +- 整体考核得分趋势 +- 优秀率趋势 +- 不合格率趋势 + +#### 3.2.3 风险趋势 + +**预测内容**： +- 高风险占比趋势 +- 风险变化预测 + +### 3.3 关联分析 + +#### 3.3.1 因素关联 + +**分析维度**： +- 刑期与考核表现关联 +- 年龄与风险等级关联 +- 消费与考核关联 +- 测评与违规关联 + +**分析方法**： +- 相关性分析 +- 回归分析 +- 聚类分析 + +#### 3.3.2 异常发现 + +**发现规则**： +- 偏离正常模式的数据点 +- 突然变化的数据趋势 +- 异常的数据分布 + +**展示方式**： +- 异常标记 +- 异常说明 +- 可能原因分析 + +### 3.4 分析可视化 + +#### 3.4.1 图表类型 + +**基础图表**： +- 折线图（趋势） +- 柱状图（对比） +- 饼图（占比） +- 散点图（分布） +- 雷达图（多维度） + +**高级图表**： +- 桑基图（流转分析） +- 热力图（密度分布） +- 关系图（关联分析） + +#### 3.4.2 交互功能 + +**交互操作**： +- 数据筛选 +- 时间范围选择 +- 维度切换 +- 图表联动 +- 数据钻取 + +### 3.5 分析报告导出 + +#### 3.5.1 导出格式 + +**支持格式**： +- PDF（完整报告） +- Word（文档报告） +- Excel（数据表格） +- PPT（演示文稿） + +#### 3.5.2 导出内容 + +**可导出内容**： +- 分析报告全文 +- 图表图片 +- 原始数据 +- 分析结论 + +## 四、业务规则汇总 + +| 规则编号 | 规则描述 | +|---------|---------| +| BR-001 | 预测数据仅供参考 | +| BR-002 | 分析结果需人工确认 | +| BR-003 | 历史数据完整才能做趋势分析 | +| BR-004 | 敏感分析结果需要权限控制 | +| BR-005 | 预测模型定期校验 | + +## 五、验收标准 + +- [ ] 支持自动报表生成 +- [ ] 支持多种报告类型 +- [ ] 支持趋势预测 +- [ ] 支持关联分析 +- [ ] 支持可视化展示 +- [ ] 支持报告导出 +- [ ] 预测准确率达到要求 + +## 六、相关模块 + +- 依赖：所有业务模块（数据来源） +- 被依赖：监管看板模块（可视化展示） + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/requirements/需求索引.md b/requirements/需求索引.md new file mode 100644 index 0000000..1e8704f --- /dev/null +++ b/requirements/需求索引.md @@ -0,0 +1,228 @@ +# XL监狱综合管理平台 - 需求索引 + +> 文档版本：v1.0 +> 创建日期：2026-01-14 + +--- + +## 一、需求总览 + +本项目共拆分为 **12个独立需求文档**，每个文档对应一个功能模块，可独立迭代。 + +``` +XL监狱综合管理平台 +│ +├── P0 - 核心功能 +│ ├── 需求-01-监管看板 (18h) ← 首页仪表盘 +│ ├── 需求-02-狱政信息管理 (24h) ← 罪犯全生命周期管理 +│ ├── 需求-03-计分考核 (24h) ← 考核规则与评分 +│ ├── 需求-04-测评问卷管理 (40h) ← 问卷模板CRUD +│ └── 需求-05-测评执行与评分 (24h) ← 在线测评与评分 +│ +├── P1 - 重要功能 +│ ├── 需求-06-狱情平台 (22h) ← 事件记录与预警 +│ ├── 需求-07-危险评估 (22h) ← 风险评估 +│ ├── 需求-08-消费系统 (18h) ← 存款与消费 +│ ├── 需求-09-数据汇总 (20h) ← 统计分析报表 +│ └── 需求-10-评估报告 (20h) ← 报告生成与导出 +│ +└── P2 - 增值功能 + ├── 需求-11-智能预警 (32h) ← 异常检测与预警 + └── 需求-12-智能分析 (22h) ← 趋势预测与关联分析 +``` + +--- + +## 二、优先级矩阵 + +### P0 - 核心功能（必须完成） + +| 序号 | 需求 | 名称 | 预估工时 | 依赖关系 | +|-----|------|-----|---------|---------| +| 1 | 需求-02 | 狱政信息管理 | 24h | 无（基础） | +| 2 | 需求-03 | 计分考核 | 24h | 依赖需求-02 | +| 3 | 需求-01 | 监管看板 | 18h | 依赖需求-02 | +| 4 | 需求-04 | 测评问卷管理 | 40h | 无 | +| 5 | 需求-05 | 测评执行与评分 | 24h | 依赖需求-04 | + +**P0小计**：130h + +### P1 - 重要功能（计划完成） + +| 序号 | 需求 | 名称 | 预估工时 | 依赖关系 | +|-----|------|-----|---------|---------| +| 1 | 需求-06 | 狱情平台 | 22h | 依赖需求-02 | +| 2 | 需求-07 | 危险评估 | 22h | 依赖需求-04, 需求-05 | +| 3 | 需求-08 | 消费系统 | 18h | 依赖需求-02 | +| 4 | 需求-09 | 数据汇总 | 20h | 依赖需求-02,03,05,07,08 | +| 5 | 需求-10 | 评估报告 | 20h | 依赖需求-02,03,05,07,08 | + +**P1小计**：102h + +### P2 - 增值功能（选做） + +| 序号 | 需求 | 名称 | 预估工时 | 依赖关系 | +|-----|------|-----|---------|---------| +| 1 | 需求-11 | 智能预警 | 32h | 依赖需求-02,03,07,08 | +| 2 | 需求-12 | 智能分析 | 22h | 依赖所有模块 | + +**P2小计**：54h + +### 总工时 + +| 阶段 | 工时 | +|-----|------| +| P0 核心功能 | 130h | +| P1 重要功能 | 102h | +| P2 增值功能 | 54h | +| **合计** | **286h** | + +--- + +## 三、模块依赖关系 + +### 3.1 依赖图 + +``` + ┌─────────────────┐ + │ 需求-02 狱政信息│ + │ (基础数据) │ + └────────┬────────┘ + │ + ┌─────────────────┼─────────────────┐ + │ │ │ + ▼ ▼ ▼ + ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ + │需求-01看板 │ │需求-03考核 │ │需求-08消费 │ + └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ + │ │ │ + │ │ │ + │ ▼ │ + │ ┌─────────────┐ │ + │ │需求-04问卷 │ │ + │ └──────┬──────┘ │ + │ │ │ + │ ▼ │ + │ ┌─────────────┐ │ + │ │需求-05执行 │ │ + │ └──────┬──────┘ │ + │ │ │ + │ ┌──────────┼──────────┐ │ + │ │ │ │ │ + ▼ ▼ ▼ ▼ ▼ + ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ + │需求-06 │ │需求-07 │ │需求-09 │ │需求-10 │ + │狱情平台 │ │危险评估 │ │数据汇总 │ │评估报告 │ + └─────────┘ └────┬────┘ └─────────┘ └─────────┘ + │ + ▼ + ┌────────────────┐ + │ 需求-11 智能预警│ + └───────┬────────┘ + │ + ▼ + ┌────────────────┐ + │ 需求-12 智能分析│ + └────────────────┘ +``` + +### 3.2 依赖说明 + +| 模块 | 被依赖 | 依赖 | +|-----|-------|------| +| 需求-02 狱政信息管理 | 所有模块 | 无 | +| 需求-01 监管看板 | 无 | 需求-02 | +| 需求-03 计分考核 | 需求-09,10,11 | 需求-02 | +| 需求-04 测评问卷管理 | 需求-05,07 | 无 | +| 需求-05 测评执行 | 需求-07,09,10 | 需求-04 | +| 需求-06 狱情平台 | 无 | 需求-02 | +| 需求-07 危险评估 | 需求-09,10,11 | 需求-04,05 | +| 需求-08 消费系统 | 需求-09,10,11 | 需求-02 | +| 需求-09 数据汇总 | 无 | 需求-02,03,05,07,08 | +| 需求-10 评估报告 | 无 | 需求-02,03,05,07,08 | +| 需求-11 智能预警 | 无 | 需求-02,03,07,08 | +| 需求-12 智能分析 | 无 | 所有模块 | + +--- + +## 四、迭代建议 + +### 迭代顺序 + +``` +第1迭代：基础平台 +├── 需求-02 狱政信息管理（P0） +└── 需求-03 计分考核（P0） + +第2迭代：监管看板 +└── 需求-01 监管看板（P0） + +第3迭代：测评模块 +├── 需求-04 测评问卷管理（P0） +└── 需求-05 测评执行与评分（P0） + +第4迭代：辅助功能 +├── 需求-06 狱情平台（P1） +├── 需求-07 危险评估（P1） +├── 需求-08 消费系统（P1） +└── 需求-09 数据汇总（P1） + +第5迭代：报告模块 +└── 需求-10 评估报告（P1） + +第6迭代：智能功能 +├── 需求-11 智能预警（P2） +└── 需求-12 智能分析（P2） +``` + +### 每个迭代的工作量 + +| 迭代 | 内容 | 预估工时 | +|-----|------|---------| +| 第1迭代 | 狱政管理 + 计分考核 | 48h | +| 第2迭代 | 监管看板 | 18h | +| 第3迭代 | 测评问卷 + 测评执行 | 64h | +| 第4迭代 | 狱情 + 危评 + 消费 + 汇总 | 82h | +| 第5迭代 | 评估报告 | 20h | +| 第6迭代 | 智能预警 + 智能分析 | 54h | + +--- + +## 五、通用验收标准 + +所有模块需满足以下通用验收标准： + +### 功能验收 + +- [ ] 列表查询功能正常 +- [ ] 新增功能正常 +- [ ] 修改功能正常 +- [ ] 删除功能正常（逻辑删除） +- [ ] 导出功能正常 +- [ ] 数据权限控制生效 + +### 性能验收 + +- [ ] 页面加载时间 < 3秒 +- [ ] 接口响应时间 < 500ms +- [ ] 支持100并发用户 + +### 安全验收 + +- [ ] 敏感数据脱敏显示 +- [ ] 操作日志完整记录 +- [ ] 权限控制生效 +- [ ] 无SQL注入/XSS漏洞 + +--- + +## 六、相关文档 + +- 需求拆解文档：`XL监狱综合管理平台-需求拆解文档.md` +- 改造设计文档：`XL监狱综合管理平台-监区犯人管理改造设计方案.md` +- 技术架构文档：待创建 + +--- + +**创建日期**：2026-01-14 +**版本**：v1.0 diff --git a/test_llm_api.py b/test_llm_api.py new file mode 100644 index 0000000..a5bd420 --- /dev/null +++ b/test_llm_api.py @@ -0,0 +1,166 @@ +#!/usr/bin/env python3 +""" +测试LLM API调用 +""" + +import requests +import json +import time + +# API配置 +BASE_URL = "https://oneapi.gongjulian.cn/v1" +API_KEY = "sk-lB2Fc9ssY5UuwmiV5dD441F997364d29Be547e008dF5Cf41" +MODEL = "deepseek-ai/deepseek-v3.2" + +def test_api(): + """测试API连接""" + url = f"{BASE_URL}/models" + headers = { + "Authorization": f"Bearer {API_KEY}", + "Content-Type": "application/json" + } + + print("=" * 60) + print("测试1: 获取模型列表") + print("=" * 60) + + try: + response = requests.get(url, headers=headers, timeout=30) + print(f"状态码: {response.status_code}") + print(f"响应: {response.text[:500]}") + return response.status_code == 200 + except requests.exceptions.Timeout: + print("超时: 请求超过30秒") + return False + except requests.exceptions.ConnectionError as e: + print(f"连接错误: {e}") + return False + except Exception as e: + print(f"错误: {e}") + return False + +def test_chat_completion(): + """测试聊天完成接口""" + url = f"{BASE_URL}/chat/completions" + headers = { + "Authorization": f"Bearer {API_KEY}", + "Content-Type": "application/json" + } + + payload = { + "model": MODEL, + "messages": [ + { + "role": "user", + "content": "请简单介绍一下你自己。" + } + ], + "max_tokens": 100, + "temperature": 0.7 + } + + print("\n" + "=" * 60) + print("测试2: 聊天完成接口") + print("=" * 60) + print(f"URL: {url}") + print(f"Model: {MODEL}") + + try: + start_time = time.time() + response = requests.post(url, headers=headers, json=payload, timeout=60) + elapsed = time.time() - start_time + + print(f"状态码: {response.status_code}") + print(f"耗时: {elapsed:.2f}秒") + + if response.status_code == 200: + result = response.json() + content = result.get("choices", [{}])[0].get("message", {}).get("content", "") + print(f"响应内容:\n{content}") + return True + else: + print(f"错误响应: {response.text[:500]}") + return False + + except requests.exceptions.Timeout: + print(f"超时: 请求超过60秒") + return False + except requests.exceptions.ConnectionError as e: + print(f"连接错误: {e}") + return False + except Exception as e: + print(f"错误: {e}") + return False + +def test_simple_prompt(): + """测试简单提示词""" + url = f"{BASE_URL}/chat/completions" + headers = { + "Authorization": f"Bearer {API_KEY}", + "Content-Type": "application/json" + } + + payload = { + "model": MODEL, + "messages": [ + { + "role": "user", + "content": "1+1等于几？" + } + ], + "max_tokens": 50, + "temperature": 0.1 + } + + print("\n" + "=" * 60) + print("测试3: 简单数学问题") + print("=" * 60) + + try: + start_time = time.time() + response = requests.post(url, headers=headers, json=payload, timeout=30) + elapsed = time.time() - start_time + + print(f"状态码: {response.status_code}") + print(f"耗时: {elapsed:.2f}秒") + + if response.status_code == 200: + result = response.json() + content = result.get("choices", [{}])[0].get("message", {}).get("content", "") + print(f"响应: {content}") + return True + else: + print(f"错误: {response.text[:300]}") + return False + + except requests.exceptions.Timeout: + print("超时") + return False + except Exception as e: + print(f"错误: {e}") + return False + +if __name__ == "__main__": + print("LLM API 连接测试") + print(f"API地址: {BASE_URL}") + print(f"模型: {MODEL}") + print() + + results = [] + results.append(("模型列表", test_api())) + results.append(("聊天完成", test_chat_completion())) + results.append(("简单问题", test_simple_prompt())) + + print("\n" + "=" * 60) + print("测试结果汇总") + print("=" * 60) + for name, success in results: + status = "通过" if success else "失败" + print(f"{name}: {status}") + + all_passed = all(r[1] for r in results) + print() + if all_passed: + print("所有测试通过！") + else: + print("部分测试失败，请检查API配置和网络连接") diff --git a/test_models.py b/test_models.py new file mode 100644 index 0000000..172a6b2 --- /dev/null +++ b/test_models.py @@ -0,0 +1,85 @@ +#!/usr/bin/env python3 +""" +测试不同模型，找出可用的模型 +""" + +import requests +import time + +BASE_URL = "https://oneapi.gongjulian.cn/v1" +API_KEY = "sk-lB2Fc9ssY5UuwmiV5dD441F997364d29Be547e008dF5Cf41" + +# 可选模型列表 +MODELS = [ + "deepseek-ai/deepseek-v3.2", + "deepseek-ai/deepseek-r1", + "minimaxai/minimax-m2.1", + "z-ai/glm4.7", +] + +def test_model(model_id): + """测试单个模型""" + url = f"{BASE_URL}/chat/completions" + headers = { + "Authorization": f"Bearer {API_KEY}", + "Content-Type": "application/json" + } + + payload = { + "model": model_id, + "messages": [ + { + "role": "user", + "content": "你好，请简单回复" + } + ], + "max_tokens": 20, + "temperature": 0.1 + } + + print(f"\n测试模型: {model_id}") + print("-" * 40) + + try: + start_time = time.time() + response = requests.post(url, headers=headers, json=payload, timeout=30) + elapsed = time.time() - start_time + + print(f" 状态码: {response.status_code}") + print(f" 耗时: {elapsed:.2f}秒") + + if response.status_code == 200: + result = response.json() + content = result.get("choices", [{}])[0].get("message", {}).get("content", "") + print(f" 响应: {content[:100]}") + return True + else: + print(f" 错误: {response.text[:200] if response.text else '无响应'}") + return False + + except requests.exceptions.Timeout: + print(f" 超时") + return False + except Exception as e: + print(f" 错误: {e}") + return False + +if __name__ == "__main__": + print("测试不同模型的可用性") + print(f"API: {BASE_URL}") + print("=" * 50) + + results = {} + for model in MODELS: + results[model] = test_model(model) + + print("\n" + "=" * 50) + print("测试结果") + print("=" * 50) + for model, success in results.items(): + status = "可用" if success else "不可用" + print(f"{model}: {status}") + + available = [m for m, s in results.items() if s] + if available: + print(f"\n建议使用的模型: {available[0]}") diff --git a/指导书.md b/指导书.md new file mode 100644 index 0000000..f7949c8 --- /dev/null +++ b/指导书.md @@ -0,0 +1,328 @@ +好的，这是一个非常专业且具有社会价值的需求。一份优秀的“罪犯出监个性化回归指导计划”应当是一个系统、动态且充满人文关怀的过程。它不仅仅是简单的出监教育，而是贯穿服刑末期、释放初期和长期跟踪的综合性支持体系。 +以下为您构建一个详细、可操作的框架和模板。 +一、 核心理念 +以“个体为中心，预防为重，发展为要”为核心理念，旨在通过精准的评估、个性化的干预和持续的支持，帮助服刑人员顺利实现从“监狱人”到“社会人”的平稳过渡，降低再犯罪风险，成为自食其力、遵纪守法的公民。 +二、 计划流程总览 +该计划是一个分阶段、多部门协作的连续性过程： +阶段一：评估与诊断期（出监前6-12个月） +阶段二：个性化干预与准备期（出监前3-6个月） +阶段三：释放与衔接期（出监当日及第一周） +阶段四：社区支持与跟踪期（出监后1-24个月） +三、 分阶段详细内容 +阶段一：评估与诊断期（出监前6-12个月） +目标： 全面了解服刑人员的风险、需求与优势，为制定个性化计划奠定基础。 +1. 成立回归评估小组： 成员包括监狱民警、心理咨询师、教育干事、社会工作者（可外聘或合作）。 +2. 综合评估内容： +· 再犯罪风险评估： 使用专业量表（如LSI-R等），评估其再犯罪的可能性。 +· 需求评估： +· 心理需求： 情绪管理、压力应对、成瘾性问题（烟、酒、毒、赌）、反社会思维模式等。 +· 技能需求： 文化水平、职业技能、社交能力、求职技巧、法律知识等。 +· 社会需求： 家庭关系、社会支持网络、住房、经济状况等。 +· 优势评估： +· 个人优势：有何特长、兴趣爱好、积极品质？ +· 社会优势：有哪些支持他的家人、朋友？有无愿意接收他的社区或企业？ +3. 形成《个性化评估报告》： 明确该犯人的核心问题、主要需求和个人优势。 +阶段二：个性化干预与准备期（出监前3-6个月） +目标： 根据评估报告，开展有针对性的干预和培训，提升其回归社会的能力。 +1. 制定《个性化回归规划书》： 与服刑人员共同商议制定，内容应包括： +· 近期目标（出监后3个月）： 如找到住所、联系家人、报名参加职业技能培训。 +· 中长期目标（出监后1-2年）： 如获得稳定工作、修复家庭关系、考取职业技能证书。 +· 具体行动计划： 如何达成上述目标。 +2. 模块化干预课程： +· 心理矫正模块： +· 针对性咨询： 对有成瘾、暴力倾向或心理创伤的犯人进行一对一咨询。 +· 团体辅导： 开展“情绪管理”、“压力应对”、“理性解决问题”等主题团体。 +· 职业技能培训模块： +· 技能培训： 结合社会用工需求和本人兴趣，提供如电工、焊工、烹饪、家政、电商运营等培训，并争取颁发认证证书。 +· 求职模拟： 制作简历、面试技巧培训、模拟招聘会。 +· 社会生活适应模块： +· 法律常识教育： 重点学习与其生活密切相关的民法、治安管理处罚法等。 +· 金融知识普及： 如何储蓄、理财、防范金融诈骗。 +· 数字化生活指导： 如何使用智能手机、健康码、移动支付、网上购票等。 +· 家庭与社会关系修复模块： +· 亲情电话与视频会见： 增加频率，为回归家庭做准备。 +· 家庭治疗（如需要）： 邀请家人参与，共同解决家庭矛盾。 +· 社会资源链接： 提前联系其户籍地的司法所、社区、社会工作服务机构。 +阶段三：释放与衔接期（出监当日及第一周） +目标： 确保从监狱到社区“无缝衔接”，解决迫在眉睫的生存问题。 +1. 释放前准备： +· 确保其领取《释放证明书》。 +· 发放为其准备的“回归礼包”（内含基本生活用品、本地社区资源联系卡、法律援助热线等）。 +· 再次确认其出监后的第一落脚点。 +2. “一站式”衔接： +· 专人护送： 对于重点人员，由监狱民警会同地方司法所工作人员共同接回，完成交接。 +· 首周关怀： 社区社工或司法所人员在其回归后24小时内进行首次家访，协助其： +· 办理户口登记、身份证。 +· 申请临时救助、低保（如符合条件）。 +· 熟悉周边环境，购买生活必需品。 +阶段四：社区支持与跟踪期（出监后1-24个月） +目标： 提供持续的社会支持，巩固改造成果，预防再犯罪。 +1. 建立支持网络： +· 监督人： 司法所社区矫正工作人员（对于假释或暂予监外执行人员）或指定社工。 +· 帮扶人： 家庭成员、志愿者、成功回归社会的“同伴辅导员”。 +· 联系人： 雇主、社区干部。 +2. 定期跟踪与反馈： +· 频率： 第1个月每周一次，第2-3个月每两周一次，之后每月一次（根据风险等级调整）。 +· 方式： 面谈、电话、微信联系。 +· 内容： 了解其生活、工作、思想动态，评估面临的困难，及时提供帮助。 +3. 动态调整计划： 根据跟踪情况，与服刑人员一起回顾并调整《个性化回归规划书》。 +4. 危机干预： 当出现失业、家庭矛盾激化、受社会歧视等重大挫折时，启动危机干预程序，提供紧急支持。 +四、 成功的关键要素 +· 跨部门协作： 监狱、司法、公安、人社、民政、社会组织必须信息互通、协同作战。 +· 专业化队伍： 需要拥有心理学、社会学、法律等专业背景的社工和志愿者参与。 +· 社会支持： 呼吁企业提供“包容性就业”岗位，社区营造接纳回归人员的氛围。 +· 技术赋能： 利用信息化平台建立电子档案，实现动态管理和数据共享。 +总结： +这份“个性化回归指导计划”的成功，在于它将惩罚与改造、监督与帮扶、监狱与社会紧密地结合起来。它认识到，每一个罪犯都是独特的，他们的回归之路也需要独一无二的地图和支持。这不仅是司法文明的体现，更是构建和谐社会、从根本上预防犯罪的有效投资。 + +五、计划书模板示例1：第一版 + +一、基础信息 + +1. 罪犯姓名：__________ 性别：__________ 出生日期：__________ + +2. 原判刑期：__________ 刑满释放日期：__________ 罪名：__________ + +3. 家庭住址：__________ 联系电话：__________ 紧急联系人：__________ + +4. 文化程度：__________ 健康状况：__________ 技能特长：__________ + +二、回归评估（基于出监综合情况调查结果） + +（一）思想认知评估 + +• 对犯罪行为的认知程度：□深刻悔改 □基本认识 □存在偏差 + +• 法治观念掌握情况：□良好 □一般 □薄弱 + +• 社会责任感树立情况：□较强 □一般 □欠缺 + +（二）生活适应评估 + +• 家庭支持情况：□有稳定支持 □部分支持 □无支持 + +• 社会关系现状：□有可依托亲友 □孤立无援 □存在不良交友圈 + +• 生活技能水平：□具备基本生活能力 □部分欠缺 □严重不足 + +（三）就业创业评估 + +• 就业意愿：□强烈 □一般 □无明确意愿 + +• 职业技能基础：□有专业技能 □具备基础技能 □无技能 + +• 就业限制因素：□无明显限制 □学历限制 □前科影响 □健康问题 + +（四）心理状态评估 + +• 心理健康状况：□良好 □存在轻微焦虑/抑郁 □有严重心理困扰 + +• 抗压能力：□较强 □一般 □薄弱 + +• 情绪管理能力：□良好 □一般 □较差 + +三、指导目标 + +1. 短期目标（释放后1-3个月）：顺利融入家庭生活，掌握基本生活技能，建立法治思维，初步缓解心理压力。 + +2. 中期目标（释放后3-12个月）：实现稳定就业或确定创业方向，修复社会关系，形成健康心理状态，杜绝再犯风险。 + +3. 长期目标（释放后1年以上）：成为守法公民，实现经济独立，承担家庭责任，积极参与社会建设。 + +四、个性化指导内容及实施措施 + +（一）思想法治引导 + +1. 法治教育：定期组织参与社区法治讲座（每月1次），发放法治宣传手册，重点学习《刑法》《治安管理处罚法》等与日常生活相关的法律法规。 + +2. 思想交流：每季度开展1次一对一思想访谈，引导其正视前科，树立正确的人生观、价值观，强化社会责任感。 + +3. 榜样学习：推荐观看守法公民先进事迹纪录片，鼓励参与社区志愿服务，增强社会认同感。 + +（二）家庭与社会关系修复 + +1. 家庭沟通指导：邀请专业社工开展家庭沟通技巧培训（释放后1个月内），协助修复亲子、夫妻等家庭关系，争取家庭支持。 + +2. 社会关系重构：协助对接社区邻里互助组织，推荐加入兴趣社群，远离原有不良交友圈，建立健康社交网络。 + +3. 社会接纳促进：协调社区居委会开展包容教育，消除邻里歧视，为其回归社会营造良好环境。 + +（三）就业创业支持 + +1. 职业规划：根据技能特长和就业意愿，制定个性化职业规划，明确就业方向或创业路径。 + +2. 技能提升：对接职业技能培训机构，免费提供电工、焊工、家政服务、电商运营等技能培训（根据需求选择1-2项），考取相关职业资格证书。 + +3. 就业帮扶：联系本地企业、公益岗位，提供就业信息对接服务，协助制作简历、开展面试指导，解决就业难题。 + +4. 创业扶持：若有创业意愿，协助对接创业孵化基地，提供政策咨询、创业计划书撰写指导，协助申请创业补贴。 + +（四）心理疏导干预 + +1. 心理测评：释放后1周内完成专业心理测评，建立心理档案。 + +2. 个性化疏导：根据测评结果，每月开展1-2次心理咨询服务，针对焦虑、自卑、易怒等问题进行专项疏导。 + +3. 压力管理培训：组织参与情绪管理、压力应对技巧培训（每2个月1次），教授冥想、正念等放松方法，提升抗压能力。 + +（五）生活适应帮扶 + +1. 基本生活指导：协助办理身份证、户口本等证件，指导社保、医保缴纳流程，熟悉社区医疗、购物、交通等生活配套资源。 + +2. 理财规划：开展理财知识培训（释放后2个月内），指导合理规划收入与支出，培养良好消费习惯，避免因经济问题再次犯罪。 + +3. 健康管理：根据健康状况，对接社区卫生服务中心，提供体检服务和健康指导，督促慢性病治疗，培养规律作息和健康饮食习惯。 + +五、实施周期与责任主体 +指导阶段 实施周期 责任主体 +前期准备 释放前1个月 监狱民警、社工 +短期适应 释放后1-3个月 社区居委会、社工、心理咨询师 +中期发展 释放后3-12个月 就业服务机构、社工、社区民警 +长期巩固 释放后1年以上 社区居委会、家庭、社会志愿者 + +六、跟踪评估与调整 + +1. 月度跟踪：每月通过电话或实地走访，了解指导计划执行情况，记录生活、就业、心理等方面的变化。 + +2. 季度评估：每季度开展1次综合评估，对照指导目标评估实施效果，分析存在的问题。 + +3. 动态调整：根据季度评估结果，结合罪犯实际情况，及时调整指导内容和实施措施，确保计划的针对性和有效性。 + +七、备注 + +1. 本计划书需结合罪犯出监综合情况调查表的具体数据制定，确保个性化适配。 + +2. 指导过程中需注重保护罪犯隐私，避免信息泄露造成二次伤害。 + +3. 若罪犯出现严重心理危机、再犯倾向等特殊情况，立即启动应急机制，联系公安、司法等部门协同处理。 + +制定人：__________ 制定日期：__________ 审核人：__________ 审核日期：__________ + +六、计划书模板示例2：简单模板 +犯人编号： XXXX +姓名：李某 +评估日期：2023年10月26日 +预定释放日期：2024年4月26日 +1. 评估摘要： +· 风险： 中度再犯罪风险。主要风险因素为无稳定职业技能、社交圈复杂、易冲动。 +· 需求： +· 迫切： 解决出监后住宿问题；学习一门谋生技能。 +· 重要： 改善与父亲的关系；学习情绪控制方法。 +· 优势： 身体健康，有劳动意愿；在狱中学习了基础电工知识；其叔叔愿意提供初步帮助。 +2. 个性化回归规划书： +· 目标1（出监后1个月内）： 稳定住所，与父亲建立初步联系。 + · 行动计划： + · 释放后暂住叔叔家。 + · 在社工陪同下，一周内拜访父亲一次。 + · 参加社区组织的“父子关系修复”小组。 +· 目标2（出监后3个月内）： 获得一份与电工相关的工作。 + · 行动计划： + · 联系司法局合作培训机构，参加为期一个月的“电工证”考前培训班。 + · 在社工帮助下制作简历，投递至合作企业。 +· 目标3（出监后6个月内）： 情绪稳定，与至少两名积极向上的朋友建立联系。 + · 行动计划： + · 每月接受一次心理咨询。 + · 参加社区篮球队，拓展健康社交圈。 +3. 责任分工： +· 监狱方： 提供考前培训资源，出具其在狱表现证明。 +· 司法所/社工： 负责出监衔接、家庭关系调解、职业介绍、定期跟踪。 +· 家庭成员（叔叔）： 提供临时住宿和情感支持。 +· 李某本人： 积极参与各项活动，主动执行计划。 +七、计划书模板示例3：强力实操版模板 +犯人编号： XXXX +姓名：李某 +评估日期：2023年10月26日 +预定释放日期：2024年4月26日 + +本方案的核心是：“一人一策，清单管理，无缝衔接”。 + +第一步：启动与诊断——“精准画像”（出监前6个月） + +目标： 不再泛泛而谈，而是完成三份可操作的评估清单。 + +1. 【工具1】《出监人员基本信息与需求快速评估清单》 + · （由责任民警与服刑人员共同填写，勾选即可） + · 核心问题： + · 释放后第一晚住哪里？ （选项：回自己家、回父母/子女家、去朋友家、无着落需紧急安置） + · 出监后第一周生活费从哪里来？ （选项：家庭支持、自有积蓄、无来源需申请临时救助） + · 最重要的社会关系是谁？联系方式？ （必须填写1-2个确切的姓名和电话） + · 你认为自己最需要哪方面的帮助？ （多选：找工作、解决家庭矛盾、心理疏导、学习技能、办理证件） + · 作用： 在30分钟内锁定最紧迫的生存需求。 +2. 【工具2】《风险与优势评估表》 + · （由心理咨询师/评估小组完成） + · 风险维度（简化版）： + · 高风险信号： 无家可归、无业可就、无亲可投、有严重成瘾行为、思想偏激。 + · 中风险信号： 家庭关系紧张、技能单一、情绪不稳定。 + · 优势维度（发现资源）： + · 个人优势： 有确切的职业技能（如会开车、会做饭）、身体健康、学习意愿强。 + · 外部资源： 有明确愿意接收的家人/朋友、有愿意提供试岗机会的原单位、家乡有有利政策（如扶贫车间）。 + · 作用： 快速分类，决定后续投入资源的力度。（例如：标记为“高风险”的个案，必须启动“重点衔接程序”）。 + +第二步：干预与准备——“靶向攻坚”（出监前3-6个月） + +目标： 根据第一步的清单，启动“个性化资源包”对接。 + +设立“回归资源柜”，内含： + +1. 【资源包A】就业资源包（针对“找工作”需求） + · 行动： + · 立即联系合作企业库，提供2-3个匹配的岗位信息（如物流分拣、保安、后厨帮工）。 + · 组织参加确切的、有证书的短期技能培训（如“电工证考前班”、“叉车驾驶培训”），而非泛泛的课程。 + · 必须完成一项实操： 在民警指导下，制作一份真实的简历，并完成一次模拟视频面试（录制下来，回放分析）。 +2. 【资源包B】家庭关系修复包（针对“家庭矛盾”需求） + · 行动： + · “一封家书”活动： 在民警指导下，撰写一封真诚的道歉信和未来规划信，寄给家人。 + · “一次视频”活动： 安排一次有心理咨询师在场的家庭视频会议，聚焦“出监后的具体安排”，而非纠结过去。 + · “一份协议”： 与家人共同商定一份《出监后共同生活试行约定》，明确双方的责任和义务，减少不确定性。 +3. 【资源包C】心理与社会适应包（针对所有人员） + · 行动： + · “出监第一课”工作坊： 不是讲课，而是场景模拟。模拟如何使用手机支付、如何坐地铁、如何到社区报到、如何应对邻居的异样眼光。 + · “情绪急救卡”： 为每人制作一张口袋卡片，正面写有当他感到愤怒、焦虑时可以立即使用的3个方法（如“深呼吸10次”、“打电话给社工”），背面印有司法所、社工和心理援助热线电话。 + +第三步：释放与衔接——“无缝交棒”（出监前后一周） + +这是最关键的实操环节，必须做到“责任到人，时间到点”。 + +1. 释放前7天：“三方通话”制度 + · 行动： 由监狱责任民警牵头，召集服刑人员、地方司法所社区矫正官（或社工），进行一次三方通话或视频会议。 + · 议程： + · 监狱方介绍服刑人员在监表现和准备情况。 + · 服刑人员确认出监安排。 + · 地方司法所/社工确认接洽时间和地点。 + · 产出： 形成一份《出监衔接确认单》，三方确认。 +2. 释放当日：“一档一包一护送” + · “一档”： 密封的《个性化回归档案》，内含所有评估清单、规划书、在监表现、技能证书复印件等。由本人携带，当面交给地方司法所工作人员。 + · “一包”： “回归起步包”，内含：少量现金（为其申请的劳动报酬）、洗漱用品、方便食品、一张本地手机卡（已预存话费）、一张交通卡。 + · “一护送”： 对于“高风险”或家在外地的人员，由民警护送至交接地点，确保“手递手”交接，杜绝“出了大门无人管”。 +3. 释放后24小时内：“首次家访” + · 行动： 地方司法所社工必须在24小时内进行首次上门或约定地点见面。 + · 任务清单： + · 协助其用《释放证明书》办理户口登记。 + · 带其熟悉周边超市、银行、公交站。 + · 协助其申请办理身份证。 + · 带其到社区完成报到。 + · 核心： 用最快的速度帮助他解决“第一步”的困难，建立信任感。 + +第四步：跟踪与支持——“扶上马，送一程”（出监后1-24个月） + +目标： 从“监狱管理”平稳过渡到“社区支持”，防止支持断档。 + +1. 【工具3】《动态跟踪与支持表》 + · （由地方司法所/社工使用，月度更新） + · 跟踪指标（量化、易查）： + · 居住状态： 稳定、临时、流落（立即干预） + · 就业状态： 稳定就业、打零工、失业（立即干预） + · 家庭关系： 和谐、紧张、破裂 + · 情绪状态： 平稳、一般、差（需关注） + · 支持记录： + · 本月提供了何种具体帮助？（如：介绍了一次零工、进行了一次心理疏导、协助申请了低保） + · 下月计划是什么？ +2. 建立“同伴辅导员”制度 + · 行动： 邀请成功回归社会3年以上、有公益心的前服刑人员，经过培训后，成为“同伴辅导员”。 + · 作用： 他们用亲身经历提供指导、倾听和榜样作用，这种“过来人”的支持往往比官方说教更有效。 +3. 危机响应“绿色通道” + · 规则： 一旦跟踪表出现“失业”或“流落”等红色警报，或本人主动求助，立即启动危机响应。 + · 响应流程： + · 24小时内面谈。 + · 根据需要，启动紧急临时安置、紧急生活救助、紧急心理干预。 + · 联系其支持网络（家人、同伴辅导员）共同介入。 \ No newline at end of file