# 需求-01-监管看板

> 模块名称：监管看板
> 优先级：P0
> 预估工时：18h

---

## 一、业务背景

监管看板是系统的首页，为监狱管理者提供全局视角的数据概览，帮助快速掌握监狱运行状态。

## 二、用户故事

| 角色 | 故事描述 | 优先级 |
|-----|---------|-------|
| 监狱长 | 作为监狱管理者，我希望在首页看到在册罪犯总数，这样我能快速了解监狱规模 | P0 |
| 教导员 | 作为教导员，我希望看到不同年龄段罪犯的分布情况，这样我好制定针对性教育方案 | P0 |
| 狱政科长 | 作为狱政科长，我希望看到不同刑期罪犯的占比，这样我能合理安排警力配置 | P0 |
| 分管领导 | 作为分管领导，我希望看到各省籍贯分布热力图，这样我能了解罪犯构成特点 | P0 |
| 管理员 | 作为系统管理员，我希望敏感信息自动脱敏显示，这样保护罪犯隐私 | P0 |

## 三、功能需求

### 3.1 首页框架

**功能描述**：搭建监管看板的整体布局结构

**功能列表**：
- 顶部导航菜单配置
- 左侧侧边栏菜单
- 主体内容区域布局
- 响应式适配

### 3.2 核心指标卡片

**功能描述**：展示监狱关键数据的汇总卡片

**指标项**：

| 指标名称 | 数据来源 | 计算逻辑 | 展示形式 |
|---------|---------|---------|---------|
| 在册罪犯总数 | 罪犯表 | status=在押 count | 数字卡片 |
| 本月已释放 | 释放记录 | 本月释放 count | 数字卡片 |
| 本月已移交 | 移交记录 | 本月移交 count | 数字卡片 |
| 当前就医人数 | 罪犯位置 | 在医院监区 count | 数字卡片 |
| 当前禁闭人数 | 罪犯位置 | 在禁闭室 count | 数字卡片 |

### 3.3 年龄分布图表

**功能描述**：展示罪犯年龄结构分布

**展示要求**：
- 使用 ECharts 饼图
- 年龄分段：未成年(≤17)、青年(18-30)、中年(31-50)、老年(51-60)、老龄(60+)
- 鼠标悬停显示具体人数和占比
- 支持图例点击筛选

### 3.4 刑期分布图表

**功能描述**：展示罪犯刑期结构分布

**展示要求**：
- 使用 ECharts 饼图
- 刑期分段：短刑(≤3年)、中刑(3-10年)、长刑(10年以上)、无期、死缓
- 颜色区分不同刑期类型

### 3.5 文化程度图表

**功能描述**：展示罪犯文化程度分布

**展示要求**：
- 使用 ECharts 饼图
- 学历分类：文盲、小学、初中、高中、中专、大专、本科、研究生及以上

### 3.6 省份分布地图

**功能描述**：使用热力图展示罪犯籍贯分布

**展示要求**：
- 使用 ECharts 中国地图
- 按省份着色，深度代表人数多少
- 点击省份显示该省罪犯数量和占比

### 3.7 数据脱敏组件

**功能描述**：对敏感信息进行脱敏展示

**脱敏规则**：

| 字段 | 脱敏规则 | 示例 |
|-----|---------|-----|
| 身份证号 | 保留前3后4位，中间用*替代 | 110***********1234 |
| 手机号 | 保留前3后4位，中间用*替代 | 138****5678 |
| 家庭住址 | 详细地址只显示到区县 | 北京市朝阳区*** |
| 姓名 | 只显示第一个字 | 张** |

## 四、非功能需求

### 4.1 性能需求
- 页面加载时间 < 3秒
- 图表渲染时间 < 1秒

### 4.2 安全需求
- 敏感数据脱敏展示
- 数据权限控制（按监区/分监区）

## 五、验收标准

- [ ] 核心指标卡片数据准确
- [ ] 年龄分布饼图展示正常，交互正常
- [ ] 刑期分布饼图展示正常
- [ ] 文化程度饼图展示正常
- [ ] 中国地图热力图正常显示
- [ ] 敏感信息自动脱敏
- [ ] 页面响应式适配正常

## 六、相关模块

- 依赖：狱政信息管理模块（罪犯数据）
- 依赖：系统管理模块（用户权限）

---

**创建日期**：2026-01-14
**版本**：v1.0