文件
hl-api-changelog/changelogs-v2/2026-08/29_6620_供应商编辑页主体证件号未绑定tax_no-前端缺陷-管理后台.md
T
Mimingguang b54c4cc8d7
changelog-filename-gate / validate (push) Successful in 2s
chore(changelog): 回写 #6544/#6620/#6643 前端消费状态 verified
修改原因:三条 changelog 前端已交付并推送 hl-admin v2.1,回写 frontmatter 消费证据。
- #6544 供应商合同独立登记 → frontend_ref 55a3a056
- #6620 主体证件号 taxNo 回显(DRAFT 可改非 DRAFT 锁定) → frontend_ref 9d5dcbab
- #6643 营业执照 licenseImageUrl 顶层权威回显 → frontend_ref bab3673b
2026-08-29 15:07:39 +08:00

2.7 KiB
原始文件 Blame 文件历史

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
schema ticket title consumer author change_type backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base
hl-changelog/v2 6620 供应商编辑页主体证件号未绑定 tax_no admin lc(GIT) 前端缺陷 not_required not_required verified mmg 9d5dcbab v2.1 2026-08-29 hl-admin 端实际绑定 formData.taxNo(非 socialCreditCode,该定位对端不符);经用户拍板采用「tax_no 回显、DRAFT 可改、非 DRAFT 锁定」折中,非 DRAFT 恒不携带防 395033,未按字面「保持可编辑」。契约库记 002 tax_no 脱敏与本条称完整值不一致,回填已加脱敏守卫兼容。 2026-08-29 dev-v3

供应商编辑页主体证件号未绑定 tax_no

后端契约没有变化。打开已有供应商时,详情响应已经返回完整 tax_no,管理端需在表单适配层消费该字段。

接口与字段

  • 接口:GET /admin/supplier/items/{supplierId}/basic-info/view
  • 响应字段:data.tax_no,类型为 string,值为完整主体证件号。
  • 创建、更新请求字段仍为 taxNo。响应与请求字段命名不同,前端不得改读 data.taxNo 或用 socialCreditCode 代替响应字段。

前端处理要求

  1. 详情加载后,将非空 data.tax_no 映射为“主体证件号”输入框的实际值,并保持可编辑。
  2. 详情值必须覆盖表单初始空值;初始化或重置逻辑不得在映射后再次清空。
  3. 只有接口实际返回空值时才显示空输入框;占位提示不能代替已有证件号。
  4. 保存时继续按既有写契约提交 taxNo,不要新增或要求后端返回重复字段。

后端核验结论

  • 响应 VO 将 Java 属性 taxNo 固定序列化为 JSON 字段 tax_no。
  • 查询服务直接取供应商主体的 taxNo 写入响应,持久化读取兼容密文和历史明文。
  • 供应商回显、查询、Controller 契约与聚合写入相关测试共 60 项通过,失败、错误和跳过均为 0。
  • #6499 / PR #6505 已在 TEST 验证详情返回的 tax_no 与数据库原值一致;当前 dev-v3 已包含该实现。本条目不引入后端代码、接口、数据库、配置、Redis 或 MQ 变更。

只读前端定位

现有管理端表单显示字段绑定为 socialCreditCode,详情适配逻辑没有把后端 tax_no 映射到该输入框,因此页面会保留初始空值。该定位仅用于联调交接,本工单未修改前端源码。

撤回

如需撤回本联调通知,只需回退本 Changelog 文件;既有后端 tax_no 契约和运行数据不受影响。

关联 / 联系人

  • Issue:#6620
  • 后端联系人:@lc