sj_nmtybt_server/docs/district-month-batch.md

全区月批 + 退养资格审批（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	领导审 镇统计记录