huimv-baqing/doc/产业政策/补贴发放记录/补贴发放记录功能需求.md

补贴发放记录 — 功能需求

1. 文档说明

项	说明
模块名称	补贴发放记录
目标	对补贴发放信息进行登记、查询、维护与查阅，支撑补贴发放台账管理与统计核对
关联系统	业务后台
修订依据	同目录 补贴发放记录功能需求-草稿.md

本文档仅描述功能需求与业务规则，不涉及库表结构、接口路径、请求体字段命名及技术栈选型。

---

2. 术语与枚举

2.1 补贴类型（单选）

• 农业生产
• 住房基建
• 民生保障

2.2 记录说明

本模块为台账类数据，单条记录表示一笔补贴发放事实；不设发布/下架等上架状态。新建成功后即可被查询、修改、删除（在权限允许前提下）。

---

3. 功能范围

• 补贴发放记录的新增、修改、删除、分页列表查询、详情查看
• 受补贴人身份信息、联系方式、账户及发放金额、发放日期的录入与校验
• 按姓名、补贴类型、发放日期范围的组合查询
• 面向使用方的业务错误与校验提示（见第 7 章）

---

4. 业务流程概览

flowchart LR
    A[新增记录] --> B[列表查询/筛选]
    B --> C[查看详情]
    B --> D[修改记录]
    B --> E[删除记录]
    D --> B
    E --> B

1. 登记：录入补贴项目、类型、受补贴人及发放信息 → 形成一条发放记录。
   
2. 查询：按姓名、类型、发放日期范围筛选，分页浏览台账。
   
3. 维护：对已有记录进行修改（全字段可改，校验规则与新增一致）。
   
4. 查阅：查看单条记录全部字段；列表支持进入详情。
   
5. 删除：删除整条记录（无附件联动；若后续扩展凭证附件须单独约定）。

---

5. 详细功能需求

5.1 新增补贴发放记录

字段	规则
补贴项目名称	必填；长度 1～20 个字符（字符计数规则与项目全局一致）
补贴类型	必填；单选，取值限定为第 2.1 节
受补贴人姓名	必填；长度 1～10 个字符
身份证号	必填；须通过居民身份证格式与校验位规则校验（18 位；末位可为数字或 X/x，校验规则与项目全局一致）
联系电话	必填；须通过中国大陆手机号格式校验（如 11 位、号段规则与项目全局一致）
银行账户	必填；长度与字符规则与项目全局一致（建议：仅数字，长度 16～19 位；若支持对公账号扩展须在评审时写明）
补贴金额	必填；须为大于 0 的数值；小数位数与项目金额规范一致（建议最多 2 位小数）；上限若业务需要单独约定
发放日期	必填；格式 YYYY-MM-DD；默认不得为未来日期（表示已发生或当日发放；若允许预登记未来发放日须单独评审）

必填字段汇总： 补贴项目名称、补贴类型、受补贴人姓名、身份证号、联系电话、银行账户、补贴金额、发放日期。

校验：

• 各字段校验失败时须给出可区分的错误提示（如身份证格式错误、手机号格式错误、金额非法等）。
• 若业务要求同一身份证号在同一补贴项目、同一发放日期下不可重复登记，应在评审时单独约定并写入本节。

---

5.2 查询补贴发放记录列表

• 受补贴人姓名： 对「受补贴人姓名」进行模糊匹配；姓名为空时不按姓名过滤。
  
• 补贴类型： 精确匹配筛选；未选择时不按类型过滤。
  
• 发放日期范围： 支持 开始日期（startDate）、结束日期（endDate） 区间筛选（闭区间，含起止日）；仅填开始或仅填结束时，按「≥ 开始」「≤ 结束」处理；均未填时不按日期过滤。
  
  • 区间合法性： 若同时填写开始与结束，开始日期不得晚于结束日期；否则提示错误且不执行查询。
    
• 分页： 支持分页；默认 每页 20 条，默认首页为第一页；单页条数上限与项目列表通用规范一致（若有）。
  
• 排序： 默认按 发放日期倒序（最近发放在前）；发放日期相同时按 创建时间倒序（若有）；次要排序键与项目列表规范一致（若有）。

列表宜展示： 补贴项目名称、补贴类型、受补贴人姓名、补贴金额、发放日期、联系电话（可按脱敏规则展示，如中间四位 *）、创建时间，以及查看 / 编辑 / 删除等操作入口。

---

5.3 修改补贴发放记录

• 可修改项： 补贴项目名称、补贴类型、受补贴人姓名、身份证号、联系电话、银行账户、补贴金额、发放日期（全部字段均可修改）。
  
• 保存约束： 修改提交时须重新满足 5.1 中全部校验规则；必填字段不得为空。
  
• 说明： 本模块无「已锁定不可改」状态；若后续引入审批流或归档只读，须单独修订本文档。

---

5.4 删除补贴发放记录

• 允许删除： 具备删除权限的用户可对单条或多条记录执行删除（是否支持批量删除与项目列表惯例一致）。
  
• 删除后果： 删除后该条记录不再出现在列表与统计中；无关联文件清理要求（当前需求无附件字段）。
  
• 确认： 删除前宜弹出确认提示，避免误删。

---

5.5 查看补贴发放记录详情

• 展示内容： 补贴项目名称、补贴类型、受补贴人姓名、身份证号、联系电话、银行账户、补贴金额、发放日期；宜展示创建人、创建时间、最后修改人、最后修改时间（若系统有审计字段）。
  
• 敏感信息展示： 列表与详情中身份证号、手机号、银行账户是否脱敏展示，按项目安全规范与角色权限约定（如仅完整展示给特定角色）。
  
• 交互： 具备编辑权限的用户可从详情进入编辑流程（见 5.3）。

---

6. 操作权限矩阵（汇总）

本模块无发布状态约束；在已授权前提下：

操作	说明
查看	具备查询权限即可
新增	具备新增权限即可
修改	具备修改权限即可；无记录状态限制
删除	具备删除权限即可；删除前确认

菜单与按钮级权限（新增、修改、删除、导出等）按项目角色配置，具体标识在技术方案或权限配置文档中定义。

---

7. 错误与提示约定

• 业务与校验错误宜采用项目统一的 code、msg、data 结构呈现，便于前端统一处理（不涉及具体协议与路径设计）。
  
• 常见提示宜可区分，例如：
  
  • 必填项缺失、字段超长或格式不符；
    
  • 身份证号、手机号、银行账户、补贴金额、发放日期不合法；
    
  • 发放日期区间 startDate 晚于 endDate；
    
  • 删除确认取消与删除失败原因。

---

8. 非功能需求（建议）

类别	建议
权限	菜单与按钮级权限：查询、新增、修改、删除；敏感字段完整查看是否分角色
审计	新增、修改、删除记操作日志；关键字段变更可追溯
安全	身份证、手机号、银行账户在传输与展示层脱敏；导出 Excel 权限控制
性能	列表按发放日期、类型等条件查询满足后台通用体验；数据量大时考虑索引策略（实现阶段）
双语	后台字段标签与提示与项目 i18n 规范一致（汉语 + 藏文）

---

9. 修订说明（相对草稿）

草稿问题	优化处理
「修改/删除/查看补贴发放记录宣传」	更正为 补贴发放记录
补贴项目名称仅写「不超过 20 字」	明确为 1～20 字符；受补贴人姓名为 1～10 字符
补贴金额、银行账户规则未写清	补充金额须大于 0、小数位建议；银行账户长度建议
发放日期是否可为未来	默认不可为未来日期；预登记场景须评审
查询日期区间边界与合法性	补充闭区间、起止合法性校验
无流程与操作说明	增补 §4 流程图、§6 操作矩阵
第 6、7 条接口与技术栈	错误结构保留于 §7；技术栈移至技术方案文档
无列表排序、脱敏、删除确认	在 §5.2、§5.5、§5.4 补充建议