更新api-doc

亲亲创客二期/文档/前端/api-doc.md

-# partner-mp 接口说明文档
+# partner-mp 接口说明文档
@@ -10,6 +10,7 @@
 > 更新日期：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` 字段，详见下方「四、我负责的产品列表/详情」）
+> 更新日期：2026-07-08（`my-product-list.vue` 按 02·P8 视觉稿改版 + 新增分页需求，详见下方【本次更新汇总】）
 
 ---
 
@@ -24,6 +25,9 @@
 | ✅ 已接入（前端侧完成） | `partner_lead_create`      | `lead-create.vue` 新增"补充说明"文本域（选填，限 100 字），提交时映射到接口已支持但此前未使用的 `description` 参数                                             | §3.4    |
 | 📝 待确认，前端暂不接入 | `partner_lead_create`      | 02·P9 视觉稿新增"所在城市/职务/微信号"三个字段，接口当前不支持，前端本次未展示这三项输入框                                                                    | §3.4    |
 | 🔴新提需求（阻塞展示）  | `my_product_detail`        | 02·P8 视觉稿 fee 分区需要`fee_type`(1按服务费百分比/2固定返佣金额)、`fee_per`、`fee_amount` 三个字段，当前接口未提供，前端已加为可选字段兜底（无值按 0 显示） | 四       |
+| 🔴新提需求              | `my_product_list`          | 前端新增分页（`page`/`page_size` 请求，`total`/`page` 响应）并接入滚动加载                                                                                     | 四       |
+| 🔴新提需求              | `my_product_list`          | 视觉稿卡片有"主推"角标，接口无对应字段，前端`MyProductItem` 已加 `is_recommend?: boolean` 可选字段兜底（无值不显示角标）                                       | 四       |
+| 🔴待确认                | `my_product_list`          | `rate_desc`（如"5%返佣"）疑似写死文案，而 `my_product_detail` 的返佣方式实际由 `fee_type`+`fee_per`/`fee_amount` 动态决定，两者口径可能矛盾，需后端确认        | 四       |
 |                         |                            |                                                                                                                                                                |          |
 
 ---
@@ -352,9 +356,12 @@ contactor_poster_template, partner_land_page, customer_land_page
 
 - 页面：[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_list` 请求字段：`page, page_size`（2026-07-08 新增分页）；响应字段：`summary{product_count, following_count, month_commission}, total, page, data_list[]`
 - `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`），前端暂时固定展示，待后端补充字段后改为条件渲染
+- **🔴待补充（2026-07-08，02·P8 列表视觉稿改版）**：`my-product-list.vue` 卡片有"主推"角标，`my_product_list` 响应字段无对应标记，前端 `MyProductItem` 已加 `is_recommend?: boolean` 可选字段兜底（无值不显示角标），待后端补充
+- **🔴待确认（2026-07-08）**：`rate_desc`（如"5%返佣"）疑似后端写死的固定文案，而 `my_product_detail` 的返佣方式实际由 `fee_type`(1按服务费百分比/2固定返佣金额) + `fee_per`/`fee_amount` 动态决定（详情页 fee 分区已按此逻辑渲染，未使用 `rate_desc`）。若某产品 `fee_type=2`（固定返佣金额），`rate_desc` 显示"5%返佣"这类百分比文案会与实际返佣方式矛盾。需要后端确认 `rate_desc` 是否应改为根据 `fee_type/fee_per/fee_amount` 动态生成，或者 `my_product_list` 也一并返回 `fee_type/fee_per/fee_amount` 三个字段由前端统一计算展示文案
 
 ### 4.3 合伙人审核流程（对应 01 · P5-P8，2026-07-06 原型新增）