xlcp/XL监狱综合管理平台-需求文档-完善版.md
tangweijie fa3e3bc37b feat: 初始提交需求拆解文档
- XL监狱综合管理平台需求拆解
- Phase 1-6 详细开发任务
- 里程碑计划与工时估算

注意: backend和frontend为子模块,单独推送
2026-01-12 20:18:13 +08:00

27 KiB
Raw Blame History

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 问卷编辑功能

题目结构
{
  "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 评审专家: 王建国监狱业务、李明远系统设计、张AIAI技术 状态: 已评审通过