# 可支配收入数据填报 — 功能需求

## 1. 文档说明

| 项 | 说明 |
| --- | --- |
| 模块名称 | 可支配收入数据填报 |
| 目标 | 按**所属年份**登记农村居民人均可支配收入、脱贫人口人均纯收入；增幅/增速可选填并落库 |
| 关联系统 | 业务后台 |
| 修订依据 | 交接表 `可支配收入数据填报.xlsx` |

---

## 2. 填报粒度

- 一条记录：某一自然年的县级收入快照（无乡镇/村维度）。
- 唯一键：所属年份。
- **增幅、增速可选填并落库**：
  - 增幅 = 人均可支配收入 − 去年人均可支配收入
  - 增速 = (增幅 / 去年人均可支配收入) × 100，保留 2 位小数（如 12.28）
  - **新增**或仅改其他字段且未填增幅/增速时：存在上年数据则按公式补齐；已手工填写则保留。
  - **修改年份或人均可支配收入时**：按新口径**强制重算**增幅、增速（与前端清空后提交一致）。
  - 无上年数据或无法计算增速（如上年可支配收入为 0）时，对应字段可为 `null`。
- **界面展示**：列表、详情中增幅/增速为库中 `null` 时，显示为 `0` / `0.00%`（不落库改写）。编辑表单中仍为空表示选填，避免误存为 0。
- 无导入 / 导出。

---

## 3. 功能范围

| 能力 | 说明 |
| --- | --- |
| 分页列表 | 筛选：所属年份；列：年份、农村居民人均可支配收入、增幅、增速、脱贫人口人均纯收入；增幅/增速 null 显示为 0 |
| 新增 / 修改 | 年份、人均可支配收入、增幅（选填）、增速（选填，百分数如 12.28）、人均纯收入、备注；新增默认本年；改年份/可支配收入时清空并重算增幅增速 |
| 详情 | 全部字段；增幅/增速 null 显示为 0 |
| 删除 | 物理删除 |

---

## 4. 权限

`dataModel:disposableIncome:list|query|add|edit|remove`

---

## 5. 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 首版：县级年度 CRUD |
| 1.1 | 增幅、增速改为可选填落库；未填按公式补齐 |
| 1.2 | 修改年份/可支配收入强制重算；列表详情 null 显示为 0 |
| 1.3 | 增速改为 (增幅/去年人均可支配收入)×100，保留 2 位小数落库 |
