Commit 0c149a49 by 王雷

更新api-doc

parent c9e45ca8
Showing with 8 additions and 6 deletions
# partner-mp 接口说明文档
# partner-mp 接口说明文档
......@@ -9,6 +9,7 @@
> 更新日期:2026-07-07(对接后端 `api-doc-第四点新增接口.md` 「五、20260707补充接口」,`partner_opportunity_list`/`partner_lead_create` 按后端最终字段调整前端实现,详见下方【本次更新汇总】)
> 更新日期:2026-07-08(🔴新提需求:`partner_opportunity_list` 需新增全部状态汇总计数,用于 tab 上展示各状态数量,详见 §3.4)
> 更新日期:2026-07-08(`lead-create.vue` 按 02·P9 视觉稿改版,新增"补充说明"字段并接入已支持的 `description` 参数;视觉稿另有"所在城市/职务/微信号"三个字段,`partner_lead_create` 当前不支持,前端暂未接入,详见 §3.4)
> 更新日期:2026-07-08(`my-product-detail.vue` 按 02·P8 视觉稿对齐 `product-detail.vue` 的 fee 分区结构,需要 `my_product_detail` 新增 `fee_type`/`fee_per`/`fee_amount` 字段,详见下方「四、我负责的产品列表/详情」)
---
......@@ -333,12 +334,13 @@ contactor_poster_template, partner_land_page, customer_land_page
- 详情额外字段:`order_time`,以及分佣干系人列表(对接人本人显示实际金额,其他三方只显示分佣规则文案,不显示金额)
- **是否可复用**:与「三、3.5」的 `get_deal_settlement` 明细字段高度相似(`Amount, Commission, RuleSnapshot` 等),建议复用同一张订单/结算表,只是对接人视角不需要"提现"操作,是"次月随工资发放"
#### 【建议新增】我负责的产品列表 / 详情
#### ✅ 已实现:我负责的产品列表 / 详情
- 参考 mock:[my-product-list.vue:74](../src/pages/subpackages/product/my-product-list.vue#L74)[my-product-detail.vue:107](../src/pages/subpackages/product/my-product-detail.vue#L107)
- 列表建议字段:`name, category, price_desc, rate_desc, hot, following_count, done_count, month_commission`
- 详情额外字段:`desc, rate, rate_base, total_commission`,以及跟进中商机预览列表
- **是否可复用**:产品基础信息复用「三、3.6」的 `partner_product` 模型(已有 `manager_name`/`manager_mobile` 负责人字段),只是这里需要额外按"主责人=当前对接人"过滤,并联查商机/订单表算出统计数字,不是一张新的产品表,是产品表 + 商机表的聚合查询
- 页面:[my-product-list.vue](../src/pages/subpackages/product/my-product-list.vue)[my-product-detail.vue](../src/pages/subpackages/product/my-product-detail.vue)
- 接口:`my_product_list``my_product_detail`[opportunity/request.ts:172](../src/pages/subpackages/opportunity/request.ts#L172)),已接入真实数据,非 mock
- `my_product_detail` 请求字段:`product_id`;响应字段:`product_id, name, category, price_desc, intro, rate_desc, stat{following_count, done_count, month_commission, total_commission}, following_opportunities[]`
- **🔴待补充(2026-07-08,02·P8 详情视觉稿改版)**`my-product-detail.vue` 头部 fee 分区已对齐 `product-detail.vue` 的"服务费/业绩规则 + 返佣规则"双栏结构,需要 `fee_type`(1按服务费百分比/2固定返佣金额)、`fee_per`(服务费百分比)、`fee_amount`(固定返佣金额) 三个字段,当前接口未提供,前端 `MyProductDetail` 类型已加为可选字段兜底(无值按 0 显示)
- **🔴待确认**:视觉稿头部有"我是主负责人"角标,接口无对应字段(如 `is_main_manager`),前端暂时固定展示,待后端补充字段后改为条件渲染
### 4.3 合伙人审核流程(对应 01 · P5-P8,2026-07-06 原型新增)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment