feat: 初始提交需求拆解文档

- XL监狱综合管理平台需求拆解
- Phase 1-6 详细开发任务
- 里程碑计划与工时估算

注意: backend和frontend为子模块,单独推送
This commit is contained in:
tangweijie 2026-01-12 20:17:45 +08:00
commit fa3e3bc37b
18 changed files with 1580 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 618 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 689 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 954 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 681 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 489 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 522 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 627 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 521 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 525 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 687 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 621 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 497 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 383 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 260 KiB

View File

@ -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 目录下截图分析*

View File

@ -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
**待评审专家:** 王建国监狱业务、李明远系统设计、张AIAI技术

View File

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