Skip to content
Toggle navigation
P
Projects
G
Groups
S
Snippets
Help
何博文
/
hro_prd_dock
This project
Loading...
Sign in
Toggle navigation
Go to a project
Project
Repository
Issues
0
Merge Requests
0
Pipelines
Wiki
Snippets
Settings
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Commit
0c149a49
authored
Jul 08, 2026
by
王雷
Browse files
Options
_('Browse Files')
Download
Email Patches
Plain Diff
更新api-doc
parent
c9e45ca8
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
8 additions
and
6 deletions
亲亲创客二期/文档/前端/api-doc.md
亲亲创客二期/文档/前端/api-doc.md
View file @
0c149a49
# par
tner-mp 接口说明文档
# par
tner-mp 接口说明文档
...
@@ -9,6 +9,7 @@
...
@@ -9,6 +9,7 @@
> 更新日期: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)
> 更新日期: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(`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
...
@@ -333,12 +334,13 @@ contactor_poster_template, partner_land_page, customer_land_page
-
详情额外字段:
`order_time`
,以及分佣干系人列表(对接人本人显示实际金额,其他三方只显示分佣规则文案,不显示金额)
-
详情额外字段:
`order_time`
,以及分佣干系人列表(对接人本人显示实际金额,其他三方只显示分佣规则文案,不显示金额)
-
**是否可复用**
:与「三、3.5」的
`get_deal_settlement`
明细字段高度相似(
`Amount, Commission, RuleSnapshot`
等),建议复用同一张订单/结算表,只是对接人视角不需要"提现"操作,是"次月随工资发放"
-
**是否可复用**
:与「三、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
)
-
页面:
[
my-product-list.vue
](
../src/pages/subpackages/product/my-product-list.vue
)
、
[
my-product-detail.vue
](
../src/pages/subpackages/product/my-product-detail.vue
)
-
列表建议字段:
`name, category, price_desc, rate_desc, hot, following_count, done_count, month_commission`
-
接口:
`my_product_list`
、
`my_product_detail`
(
[
opportunity/request.ts:172
](
../src/pages/subpackages/opportunity/request.ts#L172
)
),已接入真实数据,非 mock
-
详情额外字段:
`desc, rate, rate_base, total_commission`
,以及跟进中商机预览列表
-
`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[]`
-
**是否可复用**
:产品基础信息复用「三、3.6」的
`partner_product`
模型(已有
`manager_name`
/
`manager_mobile`
负责人字段),只是这里需要额外按"主责人=当前对接人"过滤,并联查商机/订单表算出统计数字,不是一张新的产品表,是产品表 + 商机表的聚合查询
-
**🔴待补充(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 原型新增)
### 4.3 合伙人审核流程(对应 01 · P5-P8,2026-07-06 原型新增)
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment