changelog-filename-gate / validate (push) Successful in 2s
修改原因:三条 changelog 前端已交付并推送 hl-admin v2.1,回写 frontmatter 消费证据。 - #6544 供应商合同独立登记 → frontend_ref 55a3a056 - #6620 主体证件号 taxNo 回显(DRAFT 可改非 DRAFT 锁定) → frontend_ref 9d5dcbab - #6643 营业执照 licenseImageUrl 顶层权威回显 → frontend_ref bab3673b
2.7 KiB
2.7 KiB
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代替响应字段。
前端处理要求
- 详情加载后,将非空
data.tax_no映射为“主体证件号”输入框的实际值,并保持可编辑。 - 详情值必须覆盖表单初始空值;初始化或重置逻辑不得在映射后再次清空。
- 只有接口实际返回空值时才显示空输入框;占位提示不能代替已有证件号。
- 保存时继续按既有写契约提交
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