# 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