第四点联调

亲亲创客二期/文档/联调记录.md

-```markdown
+```markdown
@@ -46,6 +46,14 @@ api文档：《api-doc-第三点改动.md》
 
 ## 王雷
 
+### 🔴改动6（需后端配合，待跟进）
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：一、⑤ opportunity_create — 新增商机 / 对接人代录入
+
+描述：新增商机表单 [opportunity-create.vue](../../../packages/partner-mp/src/pages/subpackages/opportunity/opportunity-create.vue) 已改为拉取真实产品列表得到 `product_ids` 并调用 `opportunity_create` 提交；但表单里的"关联合伙人"仍是占位文案，未接真实选择器——接口文档未提供"按姓名/手机号搜索合伙人"的查询接口，无法实现选择组件，暂不传 `partner_id`（等价于直销）。另外表单里的 `customer_type`（企业/个人客户）字段，接口入参未包含该字段，暂未随请求提交，待后端确认是否需要该字段。
+
 ### 改动1
 
 api文档：《api-doc-第三点改动.md》
@@ -86,4 +94,68 @@ api文档：《api-doc-第三点改动.md》
 
 描述：排查小程序代码未发现调用该接口（海报模板取自 `partner_poster_template`/`contactor_poster_template` 字段），无需改动
 
+### 改动7
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：一、① contactor_home_summary — 对接人首页三宫格
+
+描述：[opportunity-workbench.vue](../../../packages/partner-mp/src/pages/home/components/opportunity-workbench.vue) 原用 `userInfo2.opportunity_summery_info` 兜底 mock，已改为接入 `contactor_home_summary` 接口；同时去掉了文档未提供字段 `pending_follow_count`（待跟进红点）的展示
+
+### 改动8
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：一、② opportunity_list — 商机列表
+
+描述：[opportunity-list.vue](../../../packages/partner-mp/src/pages/subpackages/opportunity/opportunity-list.vue) 由纯 mock 改为接入接口；tab 由前端字符串枚举改为映射后端数字 `status_code`（3/4/5/6）；接入搜索框 `partner_key`；新增跟进中 tab 的 `following_untracked_count` 红点。同步改造 [opportunity-filter.vue](../../../packages/partner-mp/src/pages/subpackages/opportunity/opportunity-filter.vue)：产品清单改为拉取真实的 `my_product_list`，来源筛选项改用数字码（1/2/3），[state.ts](../../../packages/partner-mp/src/pages/subpackages/opportunity/state.ts) 的 `filterState.source` 类型同步由字符串改为数字
+
+### 改动9
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：一、③④ opportunity_detail / opportunity_transfer — 商机详情 / 商机流转
+
+描述：[opportunity-detail.vue](../../../packages/partner-mp/src/pages/subpackages/opportunity/opportunity-detail.vue) 由纯 mock 改为接入 `opportunity_detail`；挂起/作废/标记成单三个操作接入 `opportunity_transfer`（`target_status` 分别传 4/6/5），操作成功后重新拉取详情；接入后删除了原联调用的 `DevStateSwitch` 状态切换器
+
+### 改动10
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：一、⑥⑦ order_list / order_detail — 订单列表 / 订单详情
+
+描述：[order-list.vue](../../../packages/partner-mp/src/pages/subpackages/opportunity/order-list.vue) 由纯 mock 改为接入 `order_list`，月份 tab 的 value 由 `month`/`last_month` 改为文档要求的 `this`/`last`；[order-detail.vue](../../../packages/partner-mp/src/pages/subpackages/opportunity/order-detail.vue) 由纯 mock 改为接入 `order_detail`，按接口口径只有本人（对接人）显示实际佣金金额，其余三方只显示 `fee_rule_desc` 规则文案；接入后删除了原联调用的 `DevStateSwitch` 状态切换器
+
+### 改动11
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：一、⑧⑨ contactor_commission_summary / contactor_commission_list — 对接人佣金三宫格 / 明细
+
+描述：原 [my-commission.vue](../../../packages/partner-mp/src/pages/subpackages/commission/my-commission.vue) 走的是合伙人可提现余额模型（`get_deal_settlement`），与对接人"次月随工资发放、无提现"模型不同（`api-doc-第三点改动.md` 已提过此疑点）。经与王雷确认：新建独立页面 [contactor-commission.vue](../../../packages/partner-mp/src/pages/subpackages/commission/contactor-commission.vue)（样式仿 my-commission.vue 改造，去掉提现相关 UI），接入新接口 `contactor_commission_summary`/`contactor_commission_list`，并在 `pages.json` 注册路由；[opportunity-workbench.vue](../../../packages/partner-mp/src/pages/home/components/opportunity-workbench.vue) 首页"本月佣金"入口跳转目标同步改为新页面
+
+### 改动12
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：一、⑩⑪ my_product_list / my_product_detail — 我负责的产品列表 / 详情
+
+描述：[my-product-list.vue](../../../packages/partner-mp/src/pages/subpackages/product/my-product-list.vue)、[my-product-detail.vue](../../../packages/partner-mp/src/pages/subpackages/product/my-product-detail.vue) 由纯 mock 改为接入接口；详情页接入后删除了原联调用的主责/非主责 `DevStateSwitch` 状态切换器及对应的"编辑产品"入口（接口未提供主责身份字段）
+
+### 改动13
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：二、⑭⑮⑯ introducer_home_summary / introducer_partner_list / introducer_partner_detail — 介绍人模块
+
+描述：[introducer-view.vue](../../../packages/partner-mp/src/pages/home/components/introducer-view.vue) 首页三宫格接入 `introducer_home_summary`，"领取"角标判断依据由 `pending_amount` 改为文档提供的 `pending_count`；[my-partners.vue](../../../packages/partner-mp/src/pages/subpackages/customer/my-partners.vue) 接入 `introducer_partner_list`，列表项跳转参数由 `id` 改为 `partner_id`；[partner-detail.vue](../../../packages/partner-mp/src/pages/subpackages/customer/partner-detail.vue) 接入 `introducer_partner_detail`，原打平的 `reward_amount`/`reward_status` 等字段改为读取嵌套的 `reward{}` 对象，并新增 `reward.has_reward === false` 时的"无奖励"展示分支；"推荐企业"卡片点击跳转目标由客户详情页改为商机详情页（`opportunity_id`，与文档字段对齐）
+
+### 改动14
+
+api文档：《api-doc-第四点新增接口.md》
+
+接口：三、⑰ user_info 新增字段 is_introducer
+
+描述：[services/type.ts](../../../packages/partner-mp/src/services/type.ts) 中 `isIntroducer` 已读取 `userInfo2.is_introducer` 作为真实字段（此前分配02已接入），无需改动，等待后端在 `user_info` 响应里补上该字段即可生效
+
 # 后端