fix(promo): HQ 渠道负责人与关联合伙人展示为公司-人名

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-09-17 09:19:53 +08:00
parent b9921b1a75
commit 674b6ac31b
4 changed files with 34 additions and 32 deletions
+5 -3
View File
@@ -1,7 +1,8 @@
# 杜康好客 · v4.0.20 开发文档
> **2026-09-16 / 09-17** · promo / city-scope / store / admin-web / h5-partner / shared-types
> **主题**:推广码渠道负责人(多选主合伙人)+ 关联合伙人(扫码 first-lock
> **主题**:推广码渠道负责人(多选主合伙人)+ 关联合伙人(扫码 first-lock
> **2026-09-17 修订**HQ 渠道负责人 / 关联合伙人下拉与表格展示为「公司(如有)-人名」
---
@@ -41,6 +42,7 @@ flowchart TD
- **关联合伙人**:可空、单选 ACTIVE 主合伙人。登录 touch 后 `tryBindIfUnbound`:无关联则写 `assoc_partner_account_id` + `assoc_bound_at`(不写 `assoc_sub_account_id`、不改 `sourceType`、不增加关联码 `assoc_scan_count`);已是同一人 noop;已是他人不抛错。只绑以后扫进来的用户。
- 两字段独立:只配渠道负责人 ≠ 绑用户;只配关联合伙人也会把用户写入该合伙人「关联用户」,并允许看三项汇总。
- HQ 原 `ownerUserId` 列保留、创建/编辑不再暴露。
- **展示**:渠道负责人、关联合伙人(筛选/创建/编辑下拉、列表列、详情)统一为「公司-人名」;无公司则只显示人名。多人用顿号拼接。
---
@@ -79,7 +81,7 @@ flowchart TD
| API promo | `promo-code.service.ts``dto/promo-code.dto.ts``partner-promo-code.controller.ts``PromoModule` import `CityScopeModule` |
| API city-scope | `PartnerCityService.tryBindIfUnbound` |
| API store | `PartnerAssocService.tryBindIfUnbound` 转调 city-scope |
| admin-web | `PromoCodesPage.tsx``promo/PromoCodeDetailPage.tsx`:渠道负责人多选 / 关联合伙人单选;去掉关联用户 ID |
| admin-web | `PromoCodesPage.tsx``promo/PromoCodeDetailPage.tsx`:渠道负责人多选 / 关联合伙人单选;去掉关联用户 ID;展示「公司-人名」(`lib/promo-partner-label.ts` |
| h5-partner | `CenterPage.tsx` 运营管理「推广码数据」;`/center/promo-codes``PromoCodesPage.tsx` |
| 本地代理 | admin/partner/shop Vite 默认 `VITE_API_TARGET``http://127.0.0.1:3010`Windows 上 `localhost` 可能打到占用 `::3010` 的其他进程) |
@@ -87,7 +89,7 @@ flowchart TD
## 5. 验收
- [ ] HQ 创建/编辑推广码可多选渠道负责人、可清空单选关联合伙人;列表/详情展示公司;可按两字段筛选
- [ ] HQ 创建/编辑推广码可多选渠道负责人、可清空单选关联合伙人;下拉与列表/详情展示公司-人名」(无公司则人名);可按两字段筛选
- [ ] 只配渠道负责人:扫码不写用户关联;该主账号 H5「推广码数据」能看到三项数字,点不开用户/订单/核销
- [ ] 只配关联合伙人:未关联的登录用户扫码后出现在该合伙人「关联用户」;该主账号也能看三项汇总
- [ ] 用户已关联他人:扫带关联合伙人的码不换绑、流程不中断、不报「无法更换」