# 全区月批 + 退养资格审批（V2026-08-13）

> 替代「一村一月一批次、镇经发审村批」。村合作社与镇经发中心 **不再看见批次**，只维护人员与退养资格。

## 角色入口

| 角色 | 页面 | 看见批次？ | 做什么 |
|------|------|------------|--------|
| 村合作社 | `/base` 人员新增录入 | 否 | 录入/导入人员，提交资格审批，看资格日志 |
| 镇经发中心 | `/approvals` 退养资格审批 | 否 | 通过（有土地/无土地有资格）或无资格/驳回补材料 |
| 社区事务 | `/insurance` `/monthly` `/special` `/disk` | 是（全区月批 + 本镇切片） | 居保结果、月度清单、特殊业务、回盘 |
| 分管领导 | `/approvals` | 是（本镇统计记录） | 审本镇月度清单 + 特殊业务 |
| 管理员 | `/admin-batches` | 是 | 可手动「生成/重跑本月全区批次」 |

## 人员业务状态

| 码 | 页面文案 | 含义 |
|----|----------|------|
| `DRAFT` | 待提交资格 | 村已录入，尚未提交资格审批 |
| `PENDING_TOWN_APPROVE` | 待资格审批 | 已提交，等镇经发 |
| `NEW` | 新增 | 资格已通过，等待下个 1 号纳入月发 |
| `NORMAL` | 正常发放 | 已在发 |
| `ABNORMAL` | 异常待处理 | 居保失败、无资格等 |
| 其余 | 暂停/停止/死亡丧葬/已退出/归档 | 同原规则，不进 1 号自动名单 |

## 每月 1 号（01:00）

1. 生成（或刷新）当月 **一条全区批次** `DB{yyyyMM}`，`batchLevel=DISTRICT`。
2. 为每个街镇 upsert **一条镇统计记录** `TB{yyyyMM}-{townId}`，`batchLevel=TOWN`，`c_parent_batch_id=全区批ID`。
3. 纳入发放明细（全部挂全区批 `c_batch_id`，`c_town_id` 用人身上的街镇）：
   - 居保 `SUCCESS/MANUAL_PASS` + 业务 `NORMAL` + 资格 `WITH_LAND/WITHOUT_LAND`
   - **或** 业务 `NEW`（须已有资格）
4. 自动触发居保匹配。
5. 1 号之后新录入的人 **不自动追加本月**；本月要发须特殊业务审批通过后加人。

配置：`sjnmtybt.schedule.district-month-batch=true`（默认 true）。管理员：`POST /api/batches/generate-district-month?payMonth=yyyyMM`。

## 居保匹配（全区批）

- 失败/丧失资格：告警 `INSURANCE_MATCH_FAIL`，人员 `ABNORMAL`。
- 死亡/丧葬：当月土地补贴按规则清零或保留，写入丧葬金额，状态 `FUNERAL`。
- 叠加待补发台账（`RETURN_ARREARS` 待处理）与待扣款（多发退款下月扣），重算 `totalAmount`。
- 全区主批匹配后停在 `PENDING_STATUS_MAINTAIN`（**不**因一镇提交领导而改全区状态）。
- 各镇统计记录表示该镇清单进度：`PENDING_STATUS_MAINTAIN` → 提交领导 `PENDING_LEADER_APPROVE` → 通过 `READY_EXPORT`。

## 特殊业务门禁

月度清单「提交本镇分管领导」前：该镇该发放月特殊业务不能有「待分管领导审批」。未齐则 400。

特殊业务通过后可对本月全区明细：加人、减人、改金额、改人员状态。

## 表与字段

- 批次 `sjnmtybt_pcb`：沿用；新增写入 `c_parent_batch_id`（无模型字段时备注 `PARENT_BATCH={id}`）。
- 发放明细 `sjnmtybt_ffmx`：`c_batch_id` 一律全区批；按 `c_town_id` 切本镇。
- 资格日志：流程表 `c_biz_type=RETIRE_QUALIFY`，动作 `QUALIFY_SUBMIT / QUALIFY_PASS / QUALIFY_REJECT`。

## 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/personnel/{id}/qualify/submit` | 村提交资格 |
| POST | `/api/personnel/{id}/qualify/review` | 镇经发审批 |
| POST | `/api/batches/generate-district-month` | 生成/重跑全区月批并居保 |
| POST | `/api/batches/{id}/submit-leader` | 提交 **镇统计记录** 给分管领导 |
| POST | `/api/batches/leader-approve` | 领导审 **镇统计记录** |