Commit 308c3631 by chunhong.mu

fix: 更新接口文档

parent 09deae88
# partner-mp 接口说明文档
# partner-mp 接口说明文档
......@@ -3,6 +3,7 @@
> 面向:接手本项目的后端同事
> 依据:`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
| `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) | — | 表单里的城市选择器数据源 |
**⚠️ 本次新需求是否需要改动**: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)
......@@ -255,6 +258,30 @@ contactor_poster_template, partner_land_page, customer_land_page
- 详情额外字段:`desc, rate, rate_base, total_commission`,以及跟进中商机预览列表
- **是否可复用**:产品基础信息复用「三、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)` 的用户
---
## 五、待确认疑点清单
......
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