Commit 54d36134 by 王雷

更新prd

parent e4479b4a
Showing with 18 additions and 1 deletions
# partner-mp 接口说明文档 # partner-mp 接口说明文档
...@@ -7,6 +7,7 @@ ...@@ -7,6 +7,7 @@
> 更新日期:2026-07-07(02 原型 P8/P9 字段级复核,新增合伙人线索列表/提交接口,`customer_collect_list`/`get_deal_settlement` 新增字段与分页需求,详见下方【本次更新汇总】) > 更新日期:2026-07-07(02 原型 P8/P9 字段级复核,新增合伙人线索列表/提交接口,`customer_collect_list`/`get_deal_settlement` 新增字段与分页需求,详见下方【本次更新汇总】)
> 更新日期:2026-07-07(对接后端 `api-doc-第四点新增接口.md` 「四、20260706补充接口」,`get_partner_users`/`opportunity_create.user_type` 已接入前端,详见下方【本次更新汇总】) > 更新日期:2026-07-07(对接后端 `api-doc-第四点新增接口.md` 「四、20260706补充接口」,`get_partner_users`/`opportunity_create.user_type` 已接入前端,详见下方【本次更新汇总】)
> 更新日期:2026-07-07(对接后端 `api-doc-第四点新增接口.md` 「五、20260707补充接口」,`partner_opportunity_list`/`partner_lead_create` 按后端最终字段调整前端实现,详见下方【本次更新汇总】) > 更新日期:2026-07-07(对接后端 `api-doc-第四点新增接口.md` 「五、20260707补充接口」,`partner_opportunity_list`/`partner_lead_create` 按后端最终字段调整前端实现,详见下方【本次更新汇总】)
> 更新日期:2026-07-08(🔴新提需求:`partner_opportunity_list` 需新增全部状态汇总计数,用于 tab 上展示各状态数量,详见 §3.4)
--- ---
...@@ -176,6 +177,22 @@ sdk.domainServicePost("接口名", { data, params }, isAnonymous, subProjectName ...@@ -176,6 +177,22 @@ sdk.domainServicePost("接口名", { data, params }, isAnonymous, subProjectName
- 页面:[lead-list.vue](../src/pages/subpackages/other/lead-list.vue)(列表,tabs:全部/进行中/已成单/已作废)、[lead-create.vue](../src/pages/subpackages/other/lead-create.vue)(提交表单:客户类型/企业名称/联系人/联系电话/可能的产品多选)。首页统计三宫格"推荐记录"入口、首页"推荐线索"banner 均已改为跳转 `lead-list.vue` - 页面:[lead-list.vue](../src/pages/subpackages/other/lead-list.vue)(列表,tabs:全部/进行中/已成单/已作废)、[lead-create.vue](../src/pages/subpackages/other/lead-create.vue)(提交表单:客户类型/企业名称/联系人/联系电话/可能的产品多选)。首页统计三宫格"推荐记录"入口、首页"推荐线索"banner 均已改为跳转 `lead-list.vue`
- `partner_opportunity_list`[lead-request.ts](../src/pages/subpackages/other/lead-request.ts)):请求字段 `status`(字符串,`""`/`"all"`全部、`in_progress`进行中=待审核+待分配+跟进中+暂时挂起合并、`"5"`已成单、`"6"`已作废)、`search_key`(客户名称模糊搜索)、`page``page_size`;响应字段 `opportunity_id, code, customer_name, customer_attr, product_name, partner_name, contactor_name, channel_admin_name, source, source_code, create_time, update_time, status, status_code`,与对接人视角 `opportunity_list` 同一张商机表,按"我提交的"(`partner_id`=当前登录用户)过滤。**🔴待补充**:02·P8 原型卡片有"联系人:姓名+手机号"展示,当前反参未提供 `contact_name`/`contact_mobile` 字段,前端已在 `LeadListItem` 加了可选字段兜底(无值不显示该行),需后端补充。 - `partner_opportunity_list`[lead-request.ts](../src/pages/subpackages/other/lead-request.ts)):请求字段 `status`(字符串,`""`/`"all"`全部、`in_progress`进行中=待审核+待分配+跟进中+暂时挂起合并、`"5"`已成单、`"6"`已作废)、`search_key`(客户名称模糊搜索)、`page``page_size`;响应字段 `opportunity_id, code, customer_name, customer_attr, product_name, partner_name, contactor_name, channel_admin_name, source, source_code, create_time, update_time, status, status_code`,与对接人视角 `opportunity_list` 同一张商机表,按"我提交的"(`partner_id`=当前登录用户)过滤。**🔴待补充**:02·P8 原型卡片有"联系人:姓名+手机号"展示,当前反参未提供 `contact_name`/`contact_mobile` 字段,前端已在 `LeadListItem` 加了可选字段兜底(无值不显示该行),需后端补充。
- **🔴新提需求(2026-07-08):`partner_opportunity_list` 需新增全部状态汇总计数**。当前每次请求只返回当前 `status` 过滤条件下的 `total`,无法在页面 tab 上同时展示"全部/进行中/已成单/已作废"四个数量(如截图 `全部12 进行中5 已成单4 已作废4`)。要求响应体顶层新增 `status_count` 对象,与 `status` 请求参数取值一一对应,口径与列表过滤条件保持一致(按当前登录合伙人 `partner_id` 过滤,不受本次请求的 `status` 参数影响,即无论传什么 `status`,返回的 `status_count` 都是该合伙人名下的全量分布):
```json
{
"total": 12,
"page": 1,
"data_list": [...],
"status_count": {
"all": 12,
"in_progress": 5,
"5": 4,
"6": 4
}
}
```
- `partner_lead_create`([lead-request.ts](../src/pages/subpackages/other/lead-request.ts)):请求字段 `customer_type`(1企业/2个人,[lead-create.vue](../src/pages/subpackages/other/lead-create.vue) 已做文案→数字映射)、`customer_name, contact_name?, contact_mobile, product_ids[], description?`;替代旧的 `create_lead_suggestion`;去重口径为"客户名称+联系人手机号+产品+进行中"三维匹配;**仅审核通过的合伙人可提交**,前端不做前置拦截,交由后端报错提示。 - `partner_lead_create`([lead-request.ts](../src/pages/subpackages/other/lead-request.ts)):请求字段 `customer_type`(1企业/2个人,[lead-create.vue](../src/pages/subpackages/other/lead-create.vue) 已做文案→数字映射)、`customer_name, contact_name?, contact_mobile, product_ids[], description?`;替代旧的 `create_lead_suggestion`;去重口径为"客户名称+联系人手机号+产品+进行中"三维匹配;**仅审核通过的合伙人可提交**,前端不做前置拦截,交由后端报错提示。
- 旧的 `referral-clue.vue` 页面和 `create_lead_suggestion` 接口**保留代码但不再被任何入口引用**。 - 旧的 `referral-clue.vue` 页面和 `create_lead_suggestion` 接口**保留代码但不再被任何入口引用**。
......
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