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
308c3631
authored
Jul 06, 2026
by
chunhong.mu
Browse files
Options
_('Browse Files')
Download
Email Patches
Plain Diff
fix: 更新接口文档
parent
09deae88
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
29 additions
and
2 deletions
亲亲创客二期/文档/api-doc(王雷整理需要提供的接口).md
亲亲创客二期/文档/api-doc(王雷整理需要提供的接口).md
View file @
308c3631
# par
tner-mp 接口说明文档
# par
tner-mp 接口说明文档
...
@@ -3,6 +3,7 @@
...
@@ -3,6 +3,7 @@
> 面向:接手本项目的后端同事
> 面向:接手本项目的后端同事
> 依据:`design-export/01-登录及申请.dc.html`、`02-合伙人.dc.html`、`03-介绍人视图.dc.html`、`04-对接人视图.dc.html` 四份交互原型 + 现有前端代码(`packages/partner-mp/src`)
> 依据:`design-export/01-登录及申请.dc.html`、`02-合伙人.dc.html`、`03-介绍人视图.dc.html`、`04-对接人视图.dc.html` 四份交互原型 + 现有前端代码(`packages/partner-mp/src`)
> 说明:四份原型是**交互原型**,不是视觉设计稿;本文档只关心页面需要什么数据、什么接口,不涉及颜色/间距等视觉内容。
> 说明:四份原型是**交互原型**,不是视觉设计稿;本文档只关心页面需要什么数据、什么接口,不涉及颜色/间距等视觉内容。
> 更新日期:2026-07-06(追加 P5-P8 审核流程接口、合伙人搜索接口)
---
---
...
@@ -93,7 +94,9 @@ sdk.domainServicePost("接口名", { data, params }, isAnonymous, subProjectName
...
@@ -93,7 +94,9 @@ sdk.domainServicePost("接口名", { data, params }, isAnonymous, subProjectName
|
`partner_users`
/
`join_partner`
(提交) | uniplat model action |
[
more/join.vue:203
](
../src/pages/subpackages/more/join.vue#L203
)
|
`{name, id_card, mobile, contactor_uniplat_uid, role_kind, city, create_type:"2"}`
| 提交合伙人申请 |
|
`partner_users`
/
`join_partner`
(提交) | uniplat model action |
[
more/join.vue:203
](
../src/pages/subpackages/more/join.vue#L203
)
|
`{name, id_card, mobile, contactor_uniplat_uid, role_kind, city, create_type:"2"}`
| 提交合伙人申请 |
|
`city_list`
| domain service |
[
more/components/index.ts:41
](
../src/pages/subpackages/more/components/index.ts#L41
)
| — | 表单里的城市选择器数据源 |
|
`city_list`
| domain service |
[
more/components/index.ts:41
](
../src/pages/subpackages/more/components/index.ts#L41
)
| — | 表单里的城市选择器数据源 |
**⚠️ 本次新需求是否需要改动**
:01 原型 P4 逻辑注释提到"介绍人"字段(选填,提交后由渠道管理员匹配绑定,或来自邀请链接自动带入并锁定)——当前
`join_partner`
提交参数里没有看到介绍人相关字段,需要确认是否要新增
`introducer_uid`
之类的参数。身份证号是否强制必填也有矛盾(见待确认疑点第 3 条)。
**⚠️ 本次新需求是否需要改动**
:
1.
01 原型 P4 逻辑注释提到"介绍人"字段(选填,提交后由渠道管理员匹配绑定,或来自邀请链接自动带入并锁定)——当前
`join_partner`
提交参数里没有看到介绍人相关字段,需要确认是否要新增
`introducer_uid`
之类的参数。身份证号是否强制必填也有矛盾(见待确认疑点第 3 条)。
2.
**2026-07-06 原型新增 P5-P8 审核流程**
:
`partner_users`
表需补充审核状态相关字段(
`audit_status`
/
`audit_time`
/
`reject_reason`
),详见「四、4.3 合伙人审核流程」。前端需新增"合伙人审核状态查询"接口。
### 3.3 我的客户(对应 02 · P2/P3)
### 3.3 我的客户(对应 02 · P2/P3)
...
@@ -255,6 +258,30 @@ contactor_poster_template, partner_land_page, customer_land_page
...
@@ -255,6 +258,30 @@ contactor_poster_template, partner_land_page, customer_land_page
-
详情额外字段:
`desc, rate, rate_base, total_commission`
,以及跟进中商机预览列表
-
详情额外字段:
`desc, rate, rate_base, total_commission`
,以及跟进中商机预览列表
-
**是否可复用**
:产品基础信息复用「三、3.6」的
`partner_product`
模型(已有
`manager_name`
/
`manager_mobile`
负责人字段),只是这里需要额外按"主责人=当前对接人"过滤,并联查商机/订单表算出统计数字,不是一张新的产品表,是产品表 + 商机表的聚合查询
-
**是否可复用**
:产品基础信息复用「三、3.6」的
`partner_product`
模型(已有
`manager_name`
/
`manager_mobile`
负责人字段),只是这里需要额外按"主责人=当前对接人"过滤,并联查商机/订单表算出统计数字,不是一张新的产品表,是产品表 + 商机表的聚合查询
### 4.3 合伙人审核流程(对应 01 · P5-P8,2026-07-06 原型新增)
#### 【建议新增】合伙人审核状态查询
-
用途:P7 审核中页面、P8 审核未通过页面的数据源
-
建议请求字段:无(取当前登录用户)
-
建议响应字段:
-
`status`
:审核状态字符串,枚举
`"待审核"`
/
`"审核通过"`
/
`"审核不通过"`
-
`submit_time`
:提交时间
`yyyy-MM-dd HH:mm:ss`
-
`audit_time`
:审核时间(仅审核通过/不通过时有值)
-
`name`
:申请人姓名
-
`mobile`
:申请人手机号
-
`id_card`
:身份证号
-
`role_kind`
:身份类别(逗号分隔,如
`"HR,财务"`
)
-
`reject_reason`
:驳回原因(仅审核不通过时有值,字符串或数组)
-
**是否可复用**
:与「三、3.2」
`join_partner`
提交接口关联,建议在
`partner_users`
表上增加
`audit_status`
/
`audit_time`
/
`reject_reason`
字段,查询时直接读取
#### 【建议新增】搜索合伙人列表
-
用途:P6b 新增商机页面,关联合伙人搜索抽屉
-
建议请求字段:
`search_key`
(姓名/手机号模糊搜索)、
`page`
、
`page_size`
-
建议响应字段:
`partner_id, name, mobile, create_type`
-
**是否可复用**
:
`partner_users`
表查询,过滤
`is_partner=true`
且
`create_type IN (1,2,3)`
的用户
---
---
## 五、待确认疑点清单
## 五、待确认疑点清单
...
...
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