API Changelog Bot 5b604b372a fix(agency): 删除 admin 公司基础信息「分公司名称」字段 (PR #1728 )

前端 mmg @ admin 公司详情/编辑/列表 + mp/agency/primary 不再返回
companyBranchName, 前端必须移除该字段展示和表单输入. 12301 上报
后端不再传 agency.companyBranchName(PR #1573 之前同行为, 12301 spec
该字段可选, 平台接收正常). 测试服已部署 + round-trip 3/3 ✓.
Closes wx/HL #1727.

2026-05-06 18:48:45 +08:00

4.0 KiB

原始文件 Blame 文件历史

fix(agency): 删除 admin 公司基础信息「分公司名称」字段

日期: 2026-05-06 18:50 通知对象: @mmg (前端) — 必须移除「分公司名称」字段的展示和表单输入 关联 PR: wx/HL #1728 (squash 4bddc5b2 已合 dev) / Closes #1727 关联工单: #1727

⚠️ 一句话摘要

admin 公司详情/编辑/列表接口的响应/请求体不再包含 companyBranchName 字段, 小程序 /mp/agency/primary 接口同步移除。前端必须删除「分公司名称」展示和表单输入项, 保留会浪费一个无意义字段。

一、为什么删

时间	行为
PR #1573 之前	agency 不传 companyBranchName, 12301 平台接收正常
2026-04 PR #1573 hotfix	12301 上报新增 agency.companyBranchName(可选字段)
2026-05-06 PR #1710	旅行社公司管理新模块, DB travel_agency 表落 company_branch_name 列
2026-05-06 用户反馈	admin 详情页「分公司名称: 海拉尔区营业部」字段不需要在前端单独维护, 业务上由 agency 名称/地址推导
2026-05-06 PR #1728 (本次)	彻底删除字段: DB DROP COLUMN + Entity/VO/DTO/12301 上报全部移除

12301 spec 中 companyBranchName 属可选字段, PR #1573 之前一直未传, 平台接受。

二、影响接口对照表 (前端必改)

1. admin 端 - 字段被删

Method	路径	旧字段	新行为
GET	`/admin/travel-agency/{agencyId}`	`companyBranchName`	不再返回此字段
GET	`/admin/travel-agency/page`	`records[*].companyBranchName`	不再返回此字段
POST	`/admin/travel-agency`	`companyBranchName` (body)	后端忽略, 不入库 (字段已删)
PUT	`/admin/travel-agency/{agencyId}`	`companyBranchName` (body)	后端忽略, 不入库 (字段已删)

Round-trip 验证: GET /admin/travel-agency/2051922156798779394 响应 40 字段, 无 companyBranchName ✓

2. 小程序端 - 字段被删

Method	路径	旧字段	新行为
GET	`/mp/agency/primary`	`companyBranchName`	不再返回此字段

Round-trip 验证: GET /mp/agency/primary 响应 6 字段 (code/agencyName/licenseNumber/businessLicenseNumber/complaintPhone/agencyAddress), 无 companyBranchName ✓

3. 12301 合同上报

后端不再上报 agency.companyBranchName 节点, 12301 平台接收正常 (与 PR #1573 之前一致)。前端无感知。

三、前端改动清单 (mmg)

模块	改动
`hl-ui` 公司详情页基础信息 tab	移除「分公司名称」整行
`hl-ui` 公司编辑/新建表单	移除「分公司名称」输入框 + 校验
`hl-ui` 公司列表(若有展示)	移除该列
`hl-ui` 小程序首页/我的页/客服联系页/分享卡片/协议页落款	若有用 `companyBranchName` 显示, 移除
API 类型定义 (`*.d.ts` 或 axios response 类型)	移除该字段定义

关键: 前端 companyBranchName 字段可以一次性 grep 全删, 无业务逻辑分支依赖该字段。

四、DB 变更

-- V20260506_009__drop_company_branch_name.sql
ALTER TABLE travel_agency DROP COLUMN company_branch_name;

测试服: 已通过 Flyway 自动执行 (deploy-panel task fb0dd936 18:46 完成滚动部署 8094/8194)
正式服: 下一波 release main 走 Flyway 自动执行

五、Round-trip 验证记录

测试	路径	结果
1	`GET /admin/travel-agency/2051922156798779394`	✅ 200, 40 字段, 无 `companyBranchName`
2	`GET /mp/agency/primary`	✅ 200, 6 字段, 无 `companyBranchName`
3	`GET /admin/travel-agency/page?pageNum=1&pageSize=3`	✅ 200, 3 records, 第一条 40 字段, 无 `companyBranchName`

测试服: https://api.test.1814.love:9443 admin token: 真实登录 (admin / Admin@123456) DB: DESC travel_agency 已无 company_branch_name 列 (Flyway 自动 apply)

有疑问 @ wx, 改动完成请在工单 #1727 留言确认。

4.0 KiB 原始文件 Blame 文件历史