diff --git a/changelogs/2026-05/06_fix_agency_remove_company_branch_name.md b/changelogs/2026-05/06_fix_agency_remove_company_branch_name.md new file mode 100644 index 0000000..1dcc3b2 --- /dev/null +++ b/changelogs/2026-05/06_fix_agency_remove_company_branch_name.md @@ -0,0 +1,97 @@ +# 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 变更 + +```sql +-- 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 留言确认。**