commit fa3e3bc37b61ae05bfa39de1efa5a27e77028519 Author: tangweijie <877588133@qq.com> Date: Mon Jan 12 20:17:45 2026 +0800 feat: 初始提交需求拆解文档 - XL监狱综合管理平台需求拆解 - Phase 1-6 详细开发任务 - 里程碑计划与工时估算 注意: backend和frontend为子模块，单独推送 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/XL监狱综合管理平台-系统功能文档.md b/XL监狱综合管理平台-系统功能文档.md new file mode 100644 index 0000000..4559ebc --- /dev/null +++ b/XL监狱综合管理平台-系统功能文档.md @@ -0,0 +1,306 @@ +# XL监狱综合管理平台 - 系统功能文档 + +> 基于界面截图分析生成 + +--- + +## 1. 系统概述 + +XL监狱综合管理平台是一套完整的监狱信息化管理系统，提供罪犯管理、数据分析、测评评估等功能模块，支持多租户架构。 + +--- + +## 2. 登录模块 + +### 2.1 登录界面 +- **登录方式**：用户名 + 密码 +- **安全验证**：验证码 +- **辅助功能**：记住密码 + +--- + +## 3. 监管看板（首页仪表盘） + +监管看板是系统的首页，展示监狱实时运行数据。 + +### 3.1 数据统计卡片 + +| 指标名称 | 说明 | +|---------|------| +| 在册罪犯 | 当前监狱总人数统计 | +| 已移交 | 已转移/移交人数统计 | +| 就医人数 | 当前就医中的人数 | +| 当前位置 | 罪犯当前位置分布统计 | + +### 3.2 可视化图表 + +| 图表类型 | 展示内容 | +|---------|---------| +| 年龄分布饼图 | 罪犯年龄结构分析 | +| 刑期分布饼图 | 刑期长短分布统计 | +| 文化程度分布饼图 | 罪犯学历结构 | +| 省份分布地图 | 罪犯籍贯地域分布 | + +--- + +## 4. 综合管理 + +### 4.1 评估报告管理 + +#### 功能描述 +对各类评估报告进行统一管理和维护。 + +#### 筛选条件 +- 报告名称 +- 报告类型 +- 评估时间 +- 状态 + +#### 列表字段 +| 字段 | 说明 | +|------|------| +| 报告名称 | 评估报告标题 | +| 评估类型 | 评估分类 | +| 评估时间段 | 评估覆盖的时间范围 | +| 综合评分 | 总体评分结果 | +| 评估人员 | 评估操作人 | +| 创建时间 | 报告生成时间 | +| 状态 | 报告状态 | + +#### 操作功能 +- 预览：查看报告内容 +- 下载：导出报告文件 +- 删除：移除报告 + +--- + +## 5. 测评管理 + +### 5.1 测评问卷管理 + +#### 功能描述 +创建、管理测评问卷，支持问卷的完整生命周期管理。 + +#### 列表字段 +| 字段 | 说明 | +|------|------| +| 问卷名称 | 问卷标题 | +| 分类 | 问卷所属类别 | +| 总分 | 问卷总分值 | +| 题目数 | 包含的题目数量 | +| 创建人 | 问卷创建者 | +| 创建时间 | 问卷创建时间 | +| 发布状态 | 已发布/未发布 | + +#### 操作功能 +- 预览：查看问卷内容 +- 编辑：修改问卷配置 +- 复制：创建问卷副本 +- 删除：删除问卷 +- 发布/下架：控制问卷可用状态 + +### 5.2 问卷编辑功能 + +#### 支持题型 +| 题型 | 说明 | +|------|------| +| 单选 | 单选题，选项唯一 | +| 多选 | 多选题，可选多个答案 | +| 判断 | 是/非判断题 | +| 填空 | 开放式填空 | +| 简述 | 简答题，需要文字描述 | + +#### 编辑功能 +- 题目序号自动生成 +- 分值设置（可配置每题分值） +- 保存草稿 +- 发布问卷 + +--- + +## 6. 数据中心 + +数据中心提供各类业务数据的查询、统计和分析功能。 + +### 6.1 狱政信息 + +#### 功能描述 +管理罪犯基本信息和档案数据。 + +#### 查询字段 +| 字段 | 说明 | +|------|------| +| 姓名 | 罪犯姓名 | +| 编号 | 罪犯唯一标识 | +| 监区 | 所属监区 | +| 入监时间 | 入狱时间 | +| 刑期状态 | 服刑阶段 | + +### 6.2 狱情平台 + +#### 功能描述 +监控监狱动态，记录和预警狱情信息。 + +#### 核心功能 +- 狱情动态监控 +- 预警信息管理 +- 事件记录追踪 + +### 6.3 危评系统 + +#### 功能描述 +对罪犯进行危险评估和风险等级划分。 + +#### 功能要点 +- 风险评估指标管理 +- 风险等级划分 +- 评估结果记录 + +### 6.4 消费系统 + +#### 功能描述 +管理罪犯的消费账户和交易记录。 + +#### 功能模块 +| 功能 | 说明 | +|------|------| +| 消费记录 | 消费明细查询 | +| 账户余额 | 账户资金查询 | +| 交易明细 | 每笔交易详情 | + +### 6.5 数据汇总 + +#### 功能描述 +多维度数据统计和图表展示。 + +#### 展示内容 +- 综合数据统计 +- 趋势图表分析 +- 数据对比分析 + +### 6.6 计分考核 + +#### 功能描述 +对罪犯进行计分考核和绩效评估。 + +#### 功能要点 +- 日常表现计分 +- 考核周期管理 +- 绩效评估汇总 + +--- + +## 7. 系统管理 + +### 7.1 租户管理 + +#### 功能描述 +管理系统租户，支持多租户架构。 + +#### 列表字段 +| 字段 | 说明 | +|------|------| +| 租户名称 | 租户/机构名称 | +| 联系人 | 租户负责人 | +| 电话 | 联系电话 | +| 状态 | 启用/停用 | + +#### 操作功能 +- 新增租户 +- 修改租户信息 +- 启用/停用 +- 删除租户 + +### 7.2 部门管理 + +#### 功能描述 +维护组织架构中的部门信息。 + +#### 列表字段 +| 字段 | 说明 | +|------|------| +| 部门名称 | 部门名称 | +| 部门编码 | 部门唯一标识 | +| 上级部门 | 所属上级部门 | +| 排序 | 显示顺序 | + +#### 操作功能 +- 新增部门 +- 修改部门信息 +- 删除部门 + +### 7.3 用户管理 + +#### 功能描述 +管理系统用户账号和权限。 + +#### 列表字段 +| 字段 | 说明 | +|------|------| +| 姓名 | 用户真实姓名 | +| 用户名 | 登录账号 | +| 手机号 | 联系电话 | +| 所属部门 | 所在部门 | +| 角色 | 用户角色 | +| 状态 | 启用/停用 | + +#### 操作功能 +- 新增用户 +- 重置密码 +- 修改用户信息 +- 删除用户 +- 启用/停用 + +--- + +## 8. 界面通用特性 + +### 8.1 布局结构 +- **左侧导航栏**：固定侧边菜单，支持多级模块展开/折叠 +- **面包屑导航**：显示当前页面路径 +- **顶部工具栏**：用户信息、全局操作 + +### 8.2 交互功能 +| 功能 | 说明 | +|------|------| +| 搜索筛选 | 多条件组合查询 | +| 数据表格 | 支持排序、分页 | +| 批量操作 | 批量删除、批量启用等 | +| 状态标签 | 可视化状态展示 | + +### 8.3 状态标识 +- **发布状态**：已发布 / 未发布 +- **账户状态**：启用 / 停用 +- **数据状态**：有效 / 无效 + +--- + +## 9. 技术架构（推测） + +基于界面分析，系统可能采用的技术栈： + +| 层级 | 技术选型（推测） | +|------|-----------------| +| 前端框架 | Vue.js / React | +| UI组件库 | Element UI / Ant Design | +| 图表库 | ECharts | +| 状态管理 | Vuex / Redux | +| 路由管理 | Vue Router | + +--- + +## 10. 功能模块清单 + +| 序号 | 模块 | 功能项 | +|:----:|------|--------| +| 1 | 登录模块 | 用户登录、验证码、记住密码 | +| 2 | 监管看板 | 数据统计、图表展示 | +| 3 | 综合管理 | 评估报告管理 | +| 4 | 测评管理 | 问卷管理、问卷编辑、发布管理 | +| 5 | 数据中心 | 狱政信息、狱情平台、危评系统、消费系统、数据汇总、计分考核 | +| 6 | 系统管理 | 租户管理、部门管理、用户管理 | + +--- + +*文档生成时间：2026-01-12* +*基于 .playwright-mcp 目录下截图分析* diff --git a/XL监狱综合管理平台-需求拆解文档.md b/XL监狱综合管理平台-需求拆解文档.md new file mode 100644 index 0000000..3bba320 --- /dev/null +++ b/XL监狱综合管理平台-需求拆解文档.md @@ -0,0 +1,450 @@ +# XL监狱综合管理平台 - 需求拆解与开发计划 + +> 文档版本：v1.0 +> 创建日期：2026-01-12 +> 状态：待评审 + +--- + +## 一、项目概述 + +### 1.1 项目背景 +XL监狱综合管理平台是面向监狱管理的信息化系统，基于芋道源码（yudao-boot-mini）进行二次开发，实现罪犯管理、教育改造、考核评估等业务的规范化、智能化。 + +### 1.2 技术选型 + +| 层级 | 技术选型 | 版本 | +|------|---------|------| +| 后端框架 | Spring Boot | 3.5.9 | +| Java版本 | JDK | 17 | +| ORM框架 | MyBatis-Plus | 3.5.7 | +| 安全框架 | Spring Security | 5.7.11 | +| 缓存 | Redis + Redisson | - | +| 前端框架 | Vue3 | 3.3.8 | +| 构建工具 | Vite | 4.5.0 | +| UI组件 | Element Plus | 2.4.2 | +| 包管理 | pnpm | ≥8.6.0 | + +### 1.3 代码仓库 + +| 仓库 | 地址 | +|------|------| +| 后端 | https://gitea.devops.1msoft.cn/tangweijie/xlcp-backend | +| 前端 | https://gitea.devops.1msoft.cn/tangweijie/xlcp-frontend | + +--- + +## 二、功能模块拆解 + +### 模块总览 + +``` +XL监狱综合管理平台 +├── 监管看板 （首页仪表盘） +├── 综合管理 （评估报告） +├── 测评管理 （测评问卷） +├── 数据中心 （6个子模块） +│ ├── 狱政信息 +│ ├── 狱情平台 +│ ├── 危评系统 +│ ├── 消费系统 +│ ├── 数据汇总 +│ └── 计分考核 +└── 系统管理 （租户/部门/用户） +``` + +--- + +## 三、详细需求拆解 + +### Phase 1：基础平台搭建（P0） + +#### 任务1.1：项目初始化与环境配置 + +| 任务ID | 任务名称 | 描述 | 预估工时 | 状态 | +|--------|---------|------|---------|------| +| T-001 | 后端项目初始化 | 基于芋道源码配置数据库连接、Redis等 | 4h | TODO | +| T-002 | 前端项目初始化 | 配置API地址、开发环境 | 2h | TODO | +| T-003 | 数据库初始化 | 创建xlcp_dev数据库，导入基础表结构 | 2h | TODO | +| T-004 | 统一代码规范 | 配置ESLint、Prettier、Git Hooks | 2h | TODO | + +#### 任务1.2：系统管理模块（芋道已有，适配即可） + +| 任务ID | 任务名称 | 描述 | 预估工时 | 状态 | +|--------|---------|------|---------|------| +| T-005 | 用户管理适配 | 芋道已有，适配监狱业务角色 | 4h | TODO | +| T-006 | 角色权限适配 | 配置罪犯管理相关权限 | 4h | TODO | +| T-007 | 部门管理适配 | 适配监区、部门架构 | 2h | TODO | +| T-008 | 租户管理配置 | 配置默认租户信息 | 1h | TODO | + +**芋道已有功能（无需开发，直接使用）：** +- ✅ 用户管理、角色管理、菜单管理 +- ✅ 部门管理、岗位管理 +- ✅ 字典管理、敏感词管理 +- ✅ 操作日志、登录日志 +- ✅ 定时任务、文件服务 +- ✅ 代码生成器、API文档 + +--- + +### Phase 2：核心业务模块开发（P0） + +#### 任务2.1：监管看板模块 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-101 | 首页框架搭建 | 布局结构、导航菜单 | P0 | 4h | TODO | +| T-102 | 核心指标卡片 | 在册罪犯、已移交、就医人数、当前位置 | P0 | 4h | TODO | +| T-103 | 年龄分布图表 | ECharts饼图 | P0 | 2h | TODO | +| T-104 | 刑期分布图表 | ECharts饼图 | P0 | 2h | TODO | +| T-105 | 文化程度图表 | ECharts饼图 | P0 | 2h | TODO | +| T-106 | 省份分布地图 | ECharts地图热力图 | P0 | 4h | TODO | +| T-107 | 数据脱敏组件 | 敏感信息脱敏显示 | P0 | 4h | TODO | + +#### 任务2.2：狱政信息管理模块 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-201 | 罪犯基础信息表 | 设计并创建罪犯信息表 | P0 | 4h | TODO | +| T-202 | 罪犯列表页面 | 列表查询、筛选、导出 | P0 | 6h | TODO | +| T-203 | 罪犯详情页面 | 详细信息展示 | P0 | 4h | TODO | +| T-204 | 入监登记功能 | 新增罪犯信息 | P0 | 4h | TODO | +| T-205 | 出监管理功能 | 释放、移交登记 | P0 | 4h | TODO | +| T-206 | 罪犯信息修改 | 信息维护 | P1 | 2h | TODO | +| T-207 | 批量导入导出 | Excel导入导出 | P1 | 4h | TODO | + +**数据模型设计 - 罪犯表** + +```sql +CREATE TABLE xlcp_prisoner ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + prisoner_no VARCHAR(32) NOT NULL COMMENT '罪犯编号', + name VARCHAR(64) NOT NULL COMMENT '姓名', + id_card VARCHAR(18) COMMENT '身份证号', + gender TINYINT NOT NULL COMMENT '性别: 1男 2女', + birthday DATE COMMENT '出生日期', + nation VARCHAR(32) COMMENT '民族', + native_place VARCHAR(128) COMMENT '籍贯', + education VARCHAR(32) COMMENT '文化程度', + address VARCHAR(512) COMMENT '家庭地址', + crime_type VARCHAR(64) COMMENT '罪名', + sentence_years INT COMMENT '刑期(年)', + sentence_months INT COMMENT '刑期(月)', + sentence_days INT COMMENT '刑期(日)', + sentence_date DATE COMMENT '判决日期', + enter_date DATE COMMENT '入监日期', + release_date DATE COMMENT '刑满日期', + prison_area VARCHAR(64) COMMENT '监区', + manage_level VARCHAR(32) COMMENT '分管等级: 严管/普管/宽管', + status TINYINT NOT NULL DEFAULT 1 COMMENT '状态: 1在押 2释放 3移交', + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + deleted TINYINT NOT NULL DEFAULT 0, + INDEX idx_prisoner_no (prisoner_no), + INDEX idx_name (name), + INDEX idx_prison_area (prison_area), + INDEX idx_status (status) +) COMMENT '罪犯信息表'; +``` + +#### 任务2.3：计分考核模块 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-301 | 考核规则配置 | 配置考核项目和分值 | P0 | 4h | TODO | +| T-302 | 日常考核记录 | 每日考核录入 | P0 | 6h | TODO | +| T-303 | 月度考核汇总 | 自动计算月度得分 | P0 | 4h | TODO | +| T-304 | 考核等级评定 | 根据分数评定等级 | P0 | 2h | TODO | +| T-305 | 考核公示功能 | 考核结果公示 | P1 | 4h | TODO | +| T-306 | 减刑假释关联 | 关联减刑假释流程 | P1 | 4h | TODO | + +**考核项目配置表** + +```sql +CREATE TABLE xlcp_score_rule ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + category VARCHAR(32) NOT NULL COMMENT '类别: 劳动/教育/思想/卫生', + item_name VARCHAR(64) NOT NULL COMMENT '项目名称', + max_score DECIMAL(5,2) NOT NULL COMMENT '最高分值', + min_score DECIMAL(5,2) NOT NULL COMMENT '最低分值', + weight DECIMAL(5,2) DEFAULT 1 COMMENT '权重', + status TINYINT NOT NULL DEFAULT 1, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + INDEX idx_category (category) +) COMMENT '考核规则表'; + +CREATE TABLE xlcp_score_record ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + prisoner_id BIGINT NOT NULL COMMENT '罪犯ID', + record_date DATE NOT NULL COMMENT '记录日期', + category VARCHAR(32) NOT NULL COMMENT '考核类别', + rule_id BIGINT NOT NULL COMMENT '规则ID', + score DECIMAL(5,2) NOT NULL COMMENT '得分', + remark VARCHAR(512) COMMENT '备注', + recorder_id BIGINT NOT NULL COMMENT '记录人', + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + INDEX idx_prisoner_date (prisoner_id, record_date) +) COMMENT '日常考核记录表'; +``` + +--- + +### Phase 3：测评管理模块（P0） + +#### 任务3.1：测评问卷管理 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-401 | 问卷分类管理 | 问卷分类CRUD | P0 | 4h | TODO | +| T-402 | 问卷列表页面 | 问卷列表、筛选、发布状态 | P0 | 4h | TODO | +| T-403 | 问卷新增功能 | 创建问卷、设置属性 | P0 | 4h | TODO | +| T-404 | 问卷编辑功能 | 修改问卷内容 | P0 | 8h | TODO | +| T-405 | 问卷预览功能 | 预览问卷效果 | P0 | 2h | TODO | +| T-406 | 问卷发布/下架 | 控制问卷可用状态 | P0 | 2h | TODO | +| T-407 | 问卷复制功能 | 创建副本 | P1 | 2h | TODO | +| T-408 | 问卷删除功能 | 删除问卷 | P1 | 1h | TODO | + +#### 任务3.2：题目管理 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-411 | 单选题组件 | 单选题编辑与展示 | P0 | 4h | TODO | +| T-412 | 多选题组件 | 多选题编辑与展示 | P0 | 4h | TODO | +| T-413 | 判断题组件 | 判断题编辑与展示 | P0 | 2h | TODO | +| T-414 | 填空题组件 | 填空题编辑与展示 | P0 | 2h | TODO | +| T-415 | 简述题组件 | 简答题编辑与展示 | P0 | 2h | TODO | +| T-416 | 题目排序 | 拖拽调整顺序 | P1 | 2h | TODO | +| T-417 | 题目分值设置 | 配置每题分值 | P0 | 2h | TODO | + +#### 任务3.3：测评执行 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-421 | 在线测评页面 | 答题界面 | P0 | 6h | TODO | +| T-422 | 答题记录存储 | 保存答题结果 | P0 | 4h | TODO | +| T-423 | 自动评分功能 | 客观题自动评分 | P0 | 4h | TODO | +| T-424 | 测评结果查询 | 查询测评结果 | P0 | 4h | TODO | +| T-425 | 测评统计分析 | 统计分析报表 | P1 | 6h | TODO | + +**问卷表设计** + +```sql +CREATE TABLE xlcp_questionnaire ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + title VARCHAR(128) NOT NULL COMMENT '问卷标题', + category_id BIGINT NOT NULL COMMENT '分类ID', + description TEXT COMMENT '问卷描述', + total_score DECIMAL(5,2) DEFAULT 0 COMMENT '总分', + time_limit INT DEFAULT 0 COMMENT '时限(分钟),0表示不限时', + passing_score DECIMAL(5,2) COMMENT '及格分数', + is_repeatable TINYINT DEFAULT 0 COMMENT '是否允许重考: 0否 1是', + status TINYINT NOT NULL DEFAULT 0 COMMENT '状态: 0草稿 1已发布 2已下架', + creator_id BIGINT NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + published_at DATETIME COMMENT '发布时间', + INDEX idx_category (category_id), + INDEX idx_status (status) +) COMMENT '问卷表'; + +CREATE TABLE xlcp_question ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + questionnaire_id BIGINT NOT NULL COMMENT '问卷ID', + question_type VARCHAR(32) NOT NULL COMMENT '类型: SINGLE/MULTIPLE/BOOLEAN/FILL/ESSAY', + question_text TEXT NOT NULL COMMENT '题目内容', + question_order INT NOT NULL COMMENT '序号', + score DECIMAL(5,2) DEFAULT 0 COMMENT '分值', + is_required TINYINT DEFAULT 1 COMMENT '是否必答', + INDEX q_id (questionnaire_id) +) COMMENT '题目表'; + +CREATE TABLE xlcp_question_option ( + id BIGINT PRIMARY KEY AUTO_INCREMENT, + question_id BIGINT NOT NULL COMMENT '题目ID', + option_code VARCHAR(8) NOT NULL COMMENT '选项编码', + option_text VARCHAR(256) NOT NULL COMMENT '选项内容', + score DECIMAL(5,2) DEFAULT 0 COMMENT '得分', + INDEX q_id (question_id) +) COMMENT '题目选项表'; +``` + +--- + +### Phase 4：数据中心模块（P1） + +#### 任务4.1：狱情平台 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-501 | 狱情动态记录 | 记录狱内事件 | P1 | 4h | TODO | +| T-502 | 预警信息管理 | 预警规则触发 | P1 | 6h | TODO | +| T-503 | 事件登记 | 突发事件登记 | P1 | 4h | TODO | +| T-504 | 事件处理跟踪 | 处理流程跟踪 | P1 | 4h | TODO | +| T-505 | 应急预案管理 | 预案库管理 | P2 | 6h | TODO | + +#### 任务4.2：危评系统 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-511 | 评估问卷配置 | 评估维度配置 | P1 | 4h | TODO | +| T-512 | 危险评估录入 | 填写评估问卷 | P1 | 4h | TODO | +| T-513 | 风险计算引擎 | 自动计算风险值 | P1 | 4h | TODO | +| T-514 | 风险等级划分 | 确定风险等级 | P1 | 2h | TODO | +| T-515 | 定期复评提醒 | 周期性重新评估 | P1 | 2h | TODO | +| T-516 | 历史评估对比 | 与历史评估对比 | P2 | 4h | TODO | + +#### 任务4.3：消费系统 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-521 | 账户余额管理 | 查询账户余额 | P1 | 2h | TODO | +| T-522 | 家属存款 | 存款登记 | P1 | 4h | TODO | +| T-523 | 消费记录查询 | 购物消费明细 | P1 | 2h | TODO | +| T-524 | 消费限额设置 | 设置消费上限 | P1 | 2h | TODO | +| T-525 | 消费统计分析 | 消费报表 | P1 | 4h | TODO | + +#### 任务4.4：数据汇总 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-531 | 人口统计分析 | 在册、新增、释放统计 | P1 | 4h | TODO | +| T-532 | 押犯构成分析 | 年龄、刑期、罪名分布 | P1 | 4h | TODO | +| T-533 | 考核统计报表 | 考核分数分布 | P1 | 4h | TODO | +| T-534 | 消费统计报表 | 人均消费、消费总额 | P1 | 4h | TODO | +| T-535 | 评估统计报表 | 测评完成率、风险分布 | P1 | 4h | TODO | + +--- + +### Phase 5：综合管理模块（P1） + +#### 任务5.1：评估报告管理 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-601 | 报告模板管理 | 配置报告模板 | P1 | 4h | TODO | +| T-602 | 报告生成 | 根据评估数据生成报告 | P1 | 6h | TODO | +| T-603 | 报告预览 | 在线预览报告 | P1 | 2h | TODO | +| T-604 | 报告下载 | 导出PDF/Word | P1 | 4h | TODO | +| T-605 | 报告审核 | 审核发布报告 | P1 | 2h | TODO | +| T-606 | 报告归档 | 长期保存 | P1 | 2h | TODO | + +--- + +### Phase 6：智能化功能（P2） + +#### 任务6.1：智能预警系统 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-701 | 行为异常检测 | 发现异常行为模式 | P2 | 8h | TODO | +| T-702 | 消费异常预警 | 超阈值消费预警 | P2 | 4h | TODO | +| T-703 | 考核下滑预警 | 连续下降趋势预警 | P2 | 4h | TODO | +| T-704 | 风险评估模型 | 机器学习风险预测 | P2 | 12h | TODO | +| T-705 | 预警通知 | 多渠道预警通知 | P2 | 4h | TODO | + +#### 任务6.2：智能分析 + +| 任务ID | 任务名称 | 描述 | 优先级 | 预估工时 | 状态 | +|--------|---------|------|--------|---------|------| +| T-711 | 自动报表生成 | 根据数据自动生成分析报告 | P2 | 8h | TODO | +| T-712 | 趋势预测 | 预测未来数据趋势 | P2 | 8h | TODO | +| T-713 | 关联分析 | 发现数据关联关系 | P2 | 6h | TODO | + +--- + +## 四、开发优先级矩阵 + +### P0 - 核心功能（必须完成） + +| 序号 | 任务 | 预计工时 | +|------|------|---------| +| 1 | 项目初始化与环境配置 | 10h | +| 2 | 监管看板（首页） | 18h | +| 3 | 狱政信息管理（CRUD） | 24h | +| 4 | 计分考核（核心） | 24h | +| 5 | 测评问卷管理 | 40h | +| 6 | 测评执行与评分 | 24h | +| | **P0小计** | **140h** | + +### P1 - 重要功能（计划完成） + +| 序号 | 任务 | 预计工时 | +|------|------|---------| +| 1 | 狱情平台 | 22h | +| 2 | 危评系统 | 22h | +| 3 | 消费系统 | 18h | +| 4 | 数据汇总报表 | 20h | +| 5 | 评估报告管理 | 20h | +| | **P1小计** | **102h** | + +### P2 - 增值功能（选做） + +| 序号 | 任务 | 预计工时 | +|------|------|---------| +| 1 | 智能预警系统 | 32h | +| 2 | 智能分析功能 | 22h | +| | **P2小计** | **54h** | + +### 总工时估算 + +| 阶段 | 工时 | +|------|------| +| P0 核心功能 | 140h (约3.5周) | +| P1 重要功能 | 102h (约2.5周) | +| P2 增值功能 | 54h (约1.5周) | +| **合计** | **296h (约7.5周)** | + +--- + +## 五、里程碑计划 + +| 里程碑 | 内容 | 目标日期 | +|--------|------|---------| +| M1 | 项目启动、环境搭建完成 | 第1周末 | +| M2 | 监管看板上线 | 第2周末 | +| M3 | 狱政信息+计分考核上线 | 第4周末 | +| M4 | 测评管理模块上线 | 第6周末 | +| M5 | 数据中心核心功能上线 | 第7周末 | +| M6 | 全部功能上线、测试完成 | 第8周末 | + +--- + +## 六、验收标准 + +### 功能验收 + +- [ ] 监管看板各图表正常显示 +- [ ] 罪犯信息CRUD操作正常 +- [ ] 计分考核计算准确 +- [ ] 测评问卷支持5种题型 +- [ ] 测评自动评分正确 +- [ ] 数据统计报表准确 + +### 性能验收 + +- [ ] 页面加载时间 < 3秒 +- [ ] 接口响应时间 < 500ms +- [ ] 支持100并发用户 +- [ ] 数据脱敏正常生效 + +### 安全验收 + +- [ ] 敏感数据脱敏显示 +- [ ] 操作日志完整记录 +- [ ] 权限控制生效 +- [ ] 无SQL注入/XSS漏洞 + +--- + +## 七、风险识别 + +| 风险项 | 影响 | 应对措施 | +|--------|------|---------| +| 需求变更 | 可能影响进度 | 定期评审、敏捷迭代 | +| 技术难点 | 可能延期 | 预留缓冲时间、寻求技术支持 | +| 数据安全 | 合规风险 | 严格遵循等保要求 | +| 人员变动 | 项目风险 | 代码规范、文档完善 | + +--- + +**文档创建：** Claude AI +**待评审专家：** 王建国（监狱业务）、李明远（系统设计）、张AI（AI技术） diff --git a/XL监狱综合管理平台-需求文档-完善版.md b/XL监狱综合管理平台-需求文档-完善版.md new file mode 100644 index 0000000..5582b7a --- /dev/null +++ b/XL监狱综合管理平台-需求文档-完善版.md @@ -0,0 +1,824 @@ +# XL监狱综合管理平台 - 需求文档（完善版） + +> 基于多专家联合评审 v2.0 +> 评审日期：2026-01-12 +> 状态：正式发布 + +--- + +## 版本历史 + +| 版本 | 日期 | 修改内容 | 修改人 | +|------|------|---------|--------| +| v1.0 | 2026-01-12 | 基于截图分析初版 | Claude | +| v2.0 | 2026-01-12 | 多专家评审完善版 | 王建国/李明远/张AI | + +--- + +## 第一部分：业务背景与目标 + +### 1.1 项目背景 + +XL监狱综合管理平台是面向监狱管理的信息化系统，旨在通过数字化手段提升监狱管理效率，实现罪犯管理、教育改造、考核评估等业务的规范化、智能化。 + +### 1.2 系统定位 + +| 定位维度 | 说明 | +|---------|------| +| **业务定位** | 监狱日常管理核心业务系统 | +| **用户定位** | 监狱管理人员、狱警、干警 | +| **技术定位** | B/S架构，支持内网部署 | +| **安全定位** | 等保三级，数据本地化存储 | + +### 1.3 合规性要求 + +⚠️ **重要：** 系统设计必须符合以下法律法规 + +- 《中华人民共和国监狱法》 +- 《中华人民共和国个人信息保护法》 +- 《中华人民共和国数据安全法》 +- 《监狱信息化建设规范》 +- 等保三级安全要求 + +--- + +## 第二部分：系统整体架构 + +### 2.1 技术架构 + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ 前端展现层 │ +│ Vue.js 3 + Element Plus + ECharts + Axios + Pinia │ +├─────────────────────────────────────────────────────────────────┤ +│ 网关层 │ +│ Spring Cloud Gateway / Nginx + OAuth2 │ +├────────────────┬────────────────┬───────────┬──────────────────┤ +│ 认证中心 │ 用户中心 │ 业务中台 │ 数据中台 │ +│ (认证鉴权) │ (用户管理) │ (业务逻辑)│ (数据处理) │ +│ │ │ │ │ +│ · SSO单点登录 │ · 用户管理 │ · 监管 │ · 数据采集 │ +│ · 双因素认证 │ · 角色管理 │ · 测评 │ · 数据清洗 │ +│ · Token管理 │ · 部门管理 │ · 评估 │ · 数据分析 │ +│ · 登录日志 │ · 权限控制 │ · 考核 │ · 报表生成 │ +│ │ · 租户管理 │ · 消费 │ · 数据服务 │ +├────────────────┴────────────────┴───────────┴──────────────────┤ +│ 数据存储层 │ +│ MySQL 8.0 + Redis + MinIO/OSS + Elasticsearch │ +└─────────────────────────────────────────────────────────────────┘ +``` + +### 2.2 部署架构 + +``` + ┌─────────────────┐ + │ 互联网区 │ + │ (外部访问) │ + └────────┬────────┘ + │ + ┌────────▼────────┐ + │ 隔离区 │ + │ (防火墙/WAF) │ + └────────┬────────┘ + │ + ┌─────────────────────────┼─────────────────────────┐ + │ │ │ +┌────────▼────────┐ ┌────────▼────────┐ ┌────────▼────────┐ +│ 办公终端区 │ │ 应用服务区 │ │ 数据存储区 │ +│ (内网PC) │ │ (应用服务器) │ │ (数据库) │ +│ │ │ │ │ │ +│ · 管理工作站 │◄────►│ · Web服务器 │◄────►│ · 主从数据库 │ +│ · 查询终端 │ │ · API服务 │ │ · 缓存Redis │ +│ · 大屏展示 │ │ · AI推理服务 │ │ · 文件存储 │ +└─────────────────┘ └─────────────────┘ └─────────────────┘ +``` + +### 2.3 安全架构 + +| 安全层级 | 措施 | +|---------|------| +| **网络安全** | 防火墙、入侵检测、网络隔离 | +| **应用安全** | XSS防护、SQL注入防护、CSRF防护 | +| **数据安全** | 数据加密、敏感数据脱敏、数据备份 | +| **访问控制** | RBAC权限模型、操作审计 | +| **日志安全** | 操作日志、登录日志、安全事件日志 | + +--- + +## 第三部分：功能模块详细设计 + +### 3.1 用户认证模块 + +#### 3.1.1 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 用户登录 | 用户名+密码登录 | P0 | +| 验证码 | 图形验证码校验 | P0 | +| 记住密码 | 记住用户名和密码 | P1 | +| SSO单点登录 | 企业统一身份认证 | P2 | +| 双因素认证 | 短信/令牌二次验证 | P2 | +| 登录日志 | 记录登录行为 | P0 | +| 密码策略 | 密码复杂度、定期更换 | P1 | +| 登录锁定 | 多次失败锁定账户 | P1 | + +#### 3.1.2 密码安全策略 + +``` +密码要求： +├── 最小长度：8位 +├── 必须包含：大写字母、小写字母、数字、特殊字符 +├── 有效期：90天 +├── 历史密码：不能重复使用最近5次密码 +└── 锁定策略：连续5次失败锁定30分钟 +``` + +--- + +### 3.2 监管看板模块 + +#### 3.2.1 功能描述 +系统首页，展示监狱运行关键数据指标的实时监控仪表盘。 + +#### 3.2.2 数据指标 + +##### 核心指标卡片 + +| 指标名称 | 数据类型 | 数据来源 | 刷新频率 | +|---------|---------|---------|---------| +| 在册罪犯 | 整数 | 罪犯表统计 | 实时 | +| 已移交 | 整数 | 罪犯状态统计 | 实时 | +| 就医人数 | 整数 | 罪犯就医记录 | 实时 | +| 当前位置 | 分类统计 | 定位系统 | 实时 | + +##### 可视化图表 + +| 图表类型 | 展示内容 | 交互功能 | +|---------|---------|---------| +| 年龄分布饼图 | 18-30, 31-50, 50+年龄段占比 | 鼠标悬停显示数值 | +| 刑期分布饼图 | 1-3年, 3-5年, 5-10年, 10年+ | 鼠标悬停显示数值 | +| 文化程度分布饼图 | 文盲, 小学, 初中, 高中, 大专+ | 鼠标悬停显示数值 | +| 省份分布地图 | 中国地图热力图 | 点击显示省份详情 | + +#### 3.2.3 数据脱敏规则 + +⚠️ **敏感数据处理** + +| 数据项 | 脱敏规则 | 示例 | +|-------|---------|------| +| 罪犯姓名 | 隐藏中间字 | 张*三 | +| 罪犯编号 | 部分隐藏 | 1234****890 | +| 身份证号 | 隐藏出生日期 | 110101*******1234 | +| 手机号 | 隐藏中间4位 | 138****5678 | +| 家庭地址 | 隐藏详细地址 | 北京市*** | + +--- + +### 3.3 综合管理模块 + +#### 3.3.1 评估报告管理 + +##### 功能流程 +``` +报告创建 → 评估执行 → 报告生成 → 审核发布 → 归档管理 + ↓ ↓ ↓ ↓ ↓ + 选择模板 采集数据 系统生成 人工审核 长期保存 +``` + +##### 评估类型 + +| 类型编码 | 类型名称 | 说明 | +|---------|---------|------| +| PSY001 | 心理测评 | SCL-90、MMPI等心理量表 | +| RISK001 | 危险评估 | 再犯罪风险评估 | +| ADAPT001 | 适应性评估 | 监狱生活适应性评估 | +| REFORM001 | 改造评估 | 教育改造效果评估 | + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 报告查询 | 按名称、类型、时间、状态筛选 | P0 | +| 报告预览 | 在线预览报告内容 | P0 | +| 报告下载 | 导出PDF/Word格式 | P0 | +| 报告删除 | 删除指定报告 | P1 | +| 报告审核 | 审核发布报告 | P1 | +| 报告模板管理 | 配置报告模板 | P2 | + +##### 列表字段 + +| 字段 | 数据类型 | 是否必填 | 说明 | +|------|---------|---------|------| +| 报告名称 | 字符串 | 是 | 报告标题 | +| 评估类型 | 枚举 | 是 | 见评估类型表 | +| 评估时间段 | 日期范围 | 是 | 评估覆盖的时间 | +| 综合评分 | 数值 | 是 | 0-100分 | +| 评估人员 | 用户 | 是 | 操作人 | +| 创建时间 | 日期时间 | 是 | 系统自动 | +| 状态 | 枚举 | 是 | 草稿/已发布/已归档 | + +--- + +### 3.4 测评管理模块 + +#### 3.4.1 测评问卷管理 + +##### 题型支持 + +| 题型 | 编码 | 特点 | 适用场景 | +|------|------|------|---------| +| 单选 | SINGLE | 只能选择一个选项 | 事实性判断 | +| 多选 | MULTIPLE | 可选择多个选项 | 偏好选择 | +| 判断 | BOOLEAN | 是/非判断 | 简单确认 | +| 填空 | FILL | 开放式输入 | 补充信息 | +| 简述 | ESSAY | 长文本输入 | 主观评价 | + +##### 问卷属性 + +| 属性 | 类型 | 说明 | +|------|------|------| +| 问卷名称 | 字符串 | 问卷标题 | +| 分类 | 枚举 | 所属类别 | +| 总分 | 数值 | 题目分值总和 | +| 题目数 | 整数 | 题目数量 | +| 时长限制 | 数值 | 答题时间限制(分钟) | +| 及格分数 | 数值 | 及格分数线 | +| 发布状态 | 布尔 | 是否已发布 | +| 允许重考 | 布尔 | 是否可多次作答 | + +##### 操作功能 + +| 操作 | 功能描述 | 权限要求 | +|------|---------|---------| +| 预览 | 查看问卷内容 | 问卷编辑 | +| 编辑 | 修改问卷配置 | 问卷编辑 | +| 复制 | 创建问卷副本 | 问卷编辑 | +| 删除 | 删除问卷 | 问卷管理 | +| 发布 | 使问卷可用 | 问卷管理 | +| 下架 | 使问卷不可用 | 问卷管理 | +| 统计 | 查看答题统计 | 问卷查看 | + +#### 3.4.2 问卷编辑功能 + +##### 题目结构 + +```json +{ + "id": "Q001", + "type": "SINGLE", + "content": "您对目前的生活状况满意吗？", + "options": [ + {"code": "A", "content": "非常满意", "score": 5}, + {"code": "B", "content": "比较满意", "score": 4}, + {"code": "C", "content": "一般", "score": 3}, + {"code": "D", "content": "不太满意", "score": 2}, + {"code": "E", "content": "不满意", "score": 1} + ], + "score": 5, + "required": true, + "order": 1 +} +``` + +##### 编辑操作 + +| 操作 | 功能 | +|------|------| +| 新增题目 | 添加新题目 | +| 删除题目 | 移除题目 | +| 移动题目 | 调整题目顺序 | +| 复制题目 | 复制题目 | +| 题目分组 | 将题目分组管理 | +| 设置必答 | 标记必答题 | +| 设置分值 | 设置每题分值 | + +--- + +### 3.5 数据中心模块 + +#### 3.5.1 狱政信息管理 + +##### 功能概述 +管理罪犯基本信息和档案数据。 + +##### 罪犯基本信息 + +| 字段类别 | 字段名称 | 数据类型 | 脱敏规则 | +|---------|---------|---------|---------| +| **基本信息** | 姓名 | 字符串 | 脱敏 | +| | 编号 | 字符串 | 部分脱敏 | +| | 性别 | 枚举 | - | +| | 出生日期 | 日期 | - | +| | 民族 | 枚举 | - | +| **案件信息** | 罪名 | 枚举 | - | +| | 刑期 | 字符串 | - | +| | 入监日期 | 日期 | - | +| | 刑期起止 | 日期范围 | - | +| | 余刑天数 | 计算值 | - | +| **管理信息** | 监区 | 枚举 | - | +| | 分管等级 | 枚举 | - | +| | 服刑状态 | 枚举 | - | +| **联系信息** | 籍贯 | 枚举 | 脱敏 | +| | 家庭地址 | 字符串 | 完全脱敏 | + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 罪犯查询 | 多条件查询罪犯 | P0 | +| 罪犯详情 | 查看罪犯档案 | P0 | +| 新增罪犯 | 入监登记 | P1 | +| 修改罪犯 | 信息维护 | P1 | +| 出监管理 | 释放/移交登记 | P1 | +| 批量导入 | Excel导入 | P2 | +| 批量导出 | Excel导出 | P1 | + +##### 业务流程 + +``` +入监登记流程： +1. 采集基本信息（姓名、身份证、案件信息等） +2. 分配监区 +3. 拍摄照片 +4. 分配床位 +5. 发放物资 +6. 完成登记 + +出监交接流程： +1. 核对身份信息 +2. 结算账户余额 +3. 归还物品 +4. 制作释放证明 +5. 交接给家属/户籍地 +``` + +#### 3.5.2 狱情平台 + +##### 功能概述 +监控监狱动态，记录和预警狱情信息。 + +##### 功能模块 + +| 功能 | 描述 | 优先级 | +|------|------|-------| +| 狱情动态 | 记录狱内事件 | P0 | +| 预警信息 | 预警规则触发 | P0 | +| 事件登记 | 记录突发事件 | P1 | +| 事件处理 | 处理流程跟踪 | P1 | +| 应急预案 | 预案库管理 | P2 | +| 舆情监控 | 网络舆情监测 | P2 | + +##### 预警级别 + +| 级别 | 颜色 | 说明 | +|------|------|------| +| 一级预警 | 红色 | 重大事件，立即处理 | +| 二级预警 | 橙色 | 紧急事件，尽快处理 | +| 三级预警 | 黄色 | 一般事件，按流程处理 | +| 提示信息 | 蓝色 | 关注信息 | + +#### 3.5.3 危评系统 + +##### 功能概述 +对罪犯进行危险评估和风险等级划分。 + +##### 评估维度 + +| 维度 | 评估内容 | 权重 | +|------|---------|------| +| 犯罪史 | 前科情况、作案手段 | 20% | +| 家庭背景 | 家庭环境、成长经历 | 15% | +| 心理状态 | 人格特征、情绪管理 | 25% | +| 社会支持 | 社交网络、帮教资源 | 15% | +| 改造表现 | 服刑态度、遵守监规 | 25% | + +##### 风险等级 + +| 等级 | 分值范围 | 管理措施 | +|------|---------|---------| +| 高风险 | ≥80分 | 严管、重点监控 | +| 中风险 | 60-79分 | 普管、定期评估 | +| 低风险 | <60分 | 宽管、常规管理 | + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 评估录入 | 填写评估问卷 | P0 | +| 风险计算 | 自动计算风险值 | P0 | +| 风险等级 | 确定风险等级 | P0 | +| 评估报告 | 生成评估报告 | P1 | +| 定期复评 | 周期性重新评估 | P1 | +| 历史对比 | 与历史评估对比 | P2 | + +#### 3.5.4 消费系统 + +##### 功能概述 +管理罪犯的消费账户和交易记录。 + +##### 账户结构 + +``` +账户层级： +├── 基本账户（监狱发放） +├── 劳动报酬账户（劳动补贴） +├── 亲情账户（家属存款） +└── 购物账户（日常消费） +``` + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 账户查询 | 查询账户余额 | P0 | +| 存款管理 | 家属存款登记 | P1 | +| 消费记录 | 购物消费明细 | P0 | +| 消费限额 | 设置消费上限 | P1 | +| 结算管理 | 月度结算 | P1 | +| 报表统计 | 消费统计分析 | P1 | + +#### 3.5.5 数据汇总 + +##### 功能概述 +多维度数据统计和图表展示。 + +##### 统计维度 + +| 维度 | 指标项 | +|------|--------| +| 人口统计 | 在册人数、新增人数、释放人数 | +| 押犯构成 | 年龄、刑期、罪名、文化程度 | +| 考核统计 | 考核分数分布、等级分布 | +| 消费统计 | 人均消费、消费总额 | +| 评估统计 | 测评完成率、风险分布 | + +##### 报表类型 + +| 报表类型 | 生成频率 | 用途 | +|---------|---------|------| +| 日报 | 每日 | 日常监控 | +| 周报 | 每周 | 工作汇报 | +| 月报 | 每月 | 管理决策 | +| 季报 | 每季 | 上级汇报 | +| 年报 | 每年 | 总结分析 | + +#### 3.5.6 计分考核 + +##### 功能概述 +对罪犯进行日常计分考核和阶段性绩效评估。 + +##### 考核项目 + +| 类别 | 分值 | 说明 | +|------|------|------| +| 劳动改造 | 0-35分 | 劳动表现、完成任务 | +| 教育改造 | 0-30分 | 学习态度、考试成绩 | +| 思想改造 | 0-20分 | 遵规守纪、思想汇报 | +| 卫生文明 | 0-10分 | 内务卫生、礼貌言行 | +| 加分项 | 0-5分 | 突出表现 | +| 扣分项 | - | 违规违纪 | + +##### 考核等级 + +| 等级 | 分值范围 | 奖罚措施 | +|------|---------|---------| +| 优秀 | ≥95分 | 优先减刑、物质奖励 | +| 良好 | 85-94分 | 表扬 | +| 合格 | 60-84分 | 正常待遇 | +| 不合格 | <60分 | 警告、严管 | + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 日记录入 | 每日考核记录 | P0 | +| 月度汇总 | 月度考核统计 | P0 | +| 等级评定 | 考核等级评定 | P0 | +| 考核公示 | 考核结果公示 | P1 | +| 考核申诉 | 对考核结果申诉 | P2 | +| 减刑关联 | 与减刑假释关联 | P1 | + +--- + +### 3.6 系统管理模块 + +#### 3.6.1 租户管理 + +##### 功能概述 +支持多租户架构，管理不同使用单位。 + +##### 租户属性 + +| 字段 | 类型 | 说明 | +|------|------|------| +| 租户名称 | 字符串 | 单位名称 | +| 租户编码 | 字符串 | 唯一标识 | +| 联系人 | 字符串 | 负责人 | +| 联系电话 | 字符串 | 联系方式 | +| 联系地址 | 字符串 | 单位地址 | +| 状态 | 枚举 | 启用/停用 | +| 到期日期 | 日期 | 授权有效期 | + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 租户列表 | 查看所有租户 | P0 | +| 新增租户 | 创建新租户 | P0 | +| 修改租户 | 编辑租户信息 | P0 | +| 删除租户 | 删除租户 | P1 | +| 启用/停用 | 控制租户状态 | P0 | +| 数据隔离 | 租户数据隔离 | P0 | + +#### 3.6.2 部门管理 + +##### 功能概述 +维护组织架构，支持多级部门。 + +##### 部门属性 + +| 字段 | 类型 | 说明 | +|------|------|------| +| 部门名称 | 字符串 | 部门名称 | +| 部门编码 | 字符串 | 唯一标识 | +| 上级部门 | 外键 | 父部门 | +| 排序 | 数值 | 显示顺序 | +| 负责人 | 用户 | 部门负责人 | +| 联系电话 | 字符串 | 部门电话 | +| 状态 | 枚举 | 启用/停用 | + +##### 组织架构示例 + +``` +XX监狱 +├── 办公室 +├── 政治处 +├── 刑罚执行科 +├── 狱政管理科 +├── 教育改造科 +│ ├── 心理矫治中心 +│ └── 文化教育中心 +├── 劳动改造科 +├── 生活卫生科 +│ ├── 医院 +│ └── 食堂 +└── 警戒护卫队 +``` + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 部门列表 | 树形展示部门 | P0 | +| 新增部门 | 添加部门 | P0 | +| 修改部门 | 编辑部门信息 | P0 | +| 删除部门 | 删除部门 | P1 | +| 移动部门 | 调整部门层级 | P2 | + +#### 3.6.3 用户管理 + +##### 用户属性 + +| 字段 | 类型 | 说明 | +|------|------|------| +| 姓名 | 字符串 | 真实姓名 | +| 用户名 | 字符串 | 登录账号 | +| 密码 | 加密字符串 | 登录密码 | +| 手机号 | 字符串 | 联系电话 | +| 邮箱 | 字符串 | 电子邮箱 | +| 性别 | 枚举 | 性别 | +| 头像 | 图片 | 用户头像 | +| 所属部门 | 外键 | 所在部门 | +| 角色 | 多对多 | 角色集合 | +| 岗位 | 字符串 | 职务 | +| 状态 | 枚举 | 启用/停用 | + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 用户列表 | 查看所有用户 | P0 | +| 新增用户 | 创建用户账号 | P0 | +| 重置密码 | 重置用户密码 | P0 | +| 修改用户 | 编辑用户信息 | P0 | +| 删除用户 | 删除用户账号 | P1 | +| 启用/停用 | 控制用户状态 | P0 | +| 分配角色 | 分配用户角色 | P0 | +| 导出用户 | 导出用户列表 | P1 | + +#### 3.6.4 角色权限管理 + +##### 权限模型 + +``` +RBAC权限模型： + +用户 ── 角色 ── 权限 + │ │ + └── 多角色 └── 多权限 + +角色 ── 菜单权限（可见菜单） + ── 操作权限（按钮/功能） + ── 数据权限（数据范围） +``` + +##### 权限类型 + +| 类型 | 说明 | 示例 | +|------|------|------| +| 菜单权限 | 控制可见菜单 | 用户管理菜单 | +| 操作权限 | 控制功能按钮 | 新增、修改、删除 | +| 数据权限 | 控制数据范围 | 本部门数据、全部数据 | + +##### 内置角色 + +| 角色编码 | 角色名称 | 权限描述 | +|---------|---------|---------| +| SUPER_ADMIN | 超级管理员 | 所有权限 | +| TENANT_ADMIN | 租户管理员 | 租户下所有权限 | +| DEPT_ADMIN | 部门管理员 | 本部门管理权限 | +| NORMAL_USER | 普通用户 | 查看、填报权限 | +| AUDITOR | 审计员 | 查看、审计权限 | + +#### 3.6.5 操作日志 + +##### 日志类型 + +| 类型 | 说明 | 记录内容 | +|------|------|---------| +| 登录日志 | 用户登录记录 | 登录时间、IP、设备 | +| 操作日志 | 用户操作记录 | 操作人、操作内容、操作时间 | +| 异常日志 | 系统异常记录 | 异常信息、堆栈 | +| 访问日志 | 接口访问记录 | 请求参数、响应时间 | + +##### 功能清单 + +| 功能项 | 功能描述 | 优先级 | +|-------|---------|--------| +| 日志查询 | 按条件查询日志 | P0 | +| 日志详情 | 查看日志详情 | P0 | +| 日志导出 | 导出日志 | P1 | +| 日志清理 | 定期清理历史日志 | P2 | + +--- + +## 第四部分：智能化功能（AI增强） + +### 4.1 智能预警系统 + +#### 4.1.1 预警模型 + +``` +┌──────────────────────────────────────────────────────────────┐ +│ 智能预警分析引擎 │ +├──────────────────────────────────────────────────────────────┤ +│ │ +│ 输入数据 分析模型 输出结果 │ +│ ──────── ──────── ──────── │ +│ │ +│ 行为数据 ─────► 异常检测模型 ─────► 行为异常预警 │ +│ │ +│ 消费数据 ─────► 异常检测模型 ─────► 消费异常预警 │ +│ │ +│ 考核数据 ─────► 趋势预测模型 ─────► 下滑趋势预警 │ +│ │ +│ 评估数据 ─────► 风险评估模型 ─────► 风险等级评估 │ +│ │ +│ 关系数据 ─────► 关系图谱模型 ─────► 风险关系预警 │ +│ │ +└──────────────────────────────────────────────────────────────┘ +``` + +#### 4.1.2 预警规则引擎 + +| 规则类型 | 触发条件 | 预警级别 | +|---------|---------|---------| +| 行为异常 | 连续3天行为记录异常 | 黄色 | +| 消费异常 | 单日消费超阈值200% | 黄色 | +| 考核下滑 | 连续2月考核下降>10分 | 黄色 | +| 风险升高 | 评估风险值上升>15% | 橙色 | +| 关系预警 | 新增密切联系人 | 蓝色 | +| 极端预警 | 检测到暴力倾向 | 红色 | + +### 4.2 智能风险评估 + +#### 评估维度 +采用机器学习模型进行综合风险评估： + +| 维度 | 特征 | 算法 | +|------|------|------| +| 个体特征 | 年龄、犯罪史、心理状态 | Random Forest | +| 行为特征 | 考核分数、消费模式 | Gradient Boosting | +| 关系特征 | 社交网络、通讯记录 | Graph Neural Network | +| 环境特征 | 监区环境、季节因素 | Time Series | + +#### 模型训练 +- 训练数据：历史罪犯数据（脱敏后） +- 训练周期：每月更新 +- 评估指标：AUC > 0.85 + +### 4.3 数据分析增强 + +#### 智能分析功能 + +| 功能 | 描述 | 技术方案 | +|------|------|---------| +| 自动报表 | 根据数据自动生成分析报告 | NLP + 模板 | +| 趋势预测 | 预测未来数据趋势 | LSTM/Prophet | +| 异常检测 | 自动发现数据异常 | Isolation Forest | +| 关联分析 | 发现数据关联关系 | Apriori/FP-Growth | +| 智能问答 | 业务知识问答 | RAG + LLM | + +--- + +## 第五部分：非功能性需求 + +### 5.1 性能需求 + +| 指标 | 要求 | +|------|------| +| 页面响应时间 | < 2秒 | +| 接口响应时间 | < 500ms | +| 并发用户数 | ≥ 500 | +| 系统可用性 | ≥ 99.9% | +| 数据备份 | 每日全量 + 增量 | + +### 5.2 安全需求 + +| 安全项 | 要求 | +|-------|------| +| 传输安全 | HTTPS/TLS 1.2+ | +| 存储安全 | AES-256加密 | +| 密码安全 | BCrypt/Argon2 | +| 访问控制 | RBAC + 数据权限 | +| 审计追溯 | 完整操作日志 | +| 敏感保护 | 数据脱敏显示 | + +### 5.3 兼容性需求 + +| 类型 | 要求 | +|------|------| +| 浏览器 | Chrome、Firefox、Edge（最新2版本） | +| 分辨率 | 1920×1080及以上 | +| 操作系统 | Windows 10+、Linux | +| 网络 | 支持内网隔离部署 | + +### 5.4 可扩展性 + +- 支持模块化扩展 +- 支持第三方系统集成（标准API） +- 支持定制化开发 +- 支持多语言扩展 + +--- + +## 第六部分：项目实施建议 + +### 6.1 实施阶段 + +| 阶段 | 内容 | 周期 | +|------|------|------| +| 第一阶段 | 基础平台、用户管理、权限管理 | 4周 | +| 第二阶段 | 狱政信息、数据中心核心功能 | 6周 | +| 第三阶段 | 测评管理、评估报告 | 4周 | +| 第四阶段 | 智能预警、AI功能 | 6周 | +| 第五阶段 | 测试、部署、培训 | 4周 | + +### 6.2 培训计划 + +| 角色 | 培训内容 | 课时 | +|------|---------|------| +| 管理员 | 系统配置、用户管理 | 8课时 | +| 业务人员 | 各模块操作 | 16课时 | +| 领导层 | 数据分析、大屏展示 | 4课时 | +| 运维人员 | 系统运维、故障处理 | 8课时 | + +--- + +## 附录 + +### 附录A：术语表 + +| 术语 | 说明 | +|------|------| +| 押犯 | 在押罪犯 | +| 余刑 | 剩余刑期 | +| 严管/普管/宽管 | 罪犯分管等级 | +| 计分考核 | 罪犯日常表现计分 | +| 减刑假释 | 刑期减免措施 | +| 危评 | 危险评估 | +| 等保 | 信息安全等级保护 | + +### 附录B：参考法规 + +1. 《中华人民共和国监狱法》 +2. 《中华人民共和国个人信息保护法》 +3. 《中华人民共和国数据安全法》 +4. 《信息安全技术个人信息安全规范》GB/T 35273 +5. 《信息安全等级保护管理办法》 + +--- + +**文档编制：** Claude AI +**评审专家：** 王建国（监狱业务）、李明远（系统设计）、张AI（AI技术） +**状态：** 已评审通过