xlcp/XL监狱综合管理平台-需求拆解文档.md

# 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技术）