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
5319d412
authored
Jul 07, 2026
by
王雷
Browse files
Options
_('Browse Files')
Download
Email Patches
Plain Diff
更新api-doc
parent
ff6c4be9
Expand all
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
57 additions
and
1 deletions
亲亲创客二期/文档/前端/api-doc.md
亲亲创客二期/文档/联调记录.md
亲亲创客二期/文档/前端/api-doc.md
View file @
5319d412
This diff is collapsed.
Click to expand it.
亲亲创客二期/文档/联调记录.md
View file @
5319d412
```ma
rkdown
```ma
rkdown
...
@@ -182,4 +182,60 @@ api文档:《api-doc.md》
...
@@ -182,4 +182,60 @@ api文档:《api-doc.md》
描述:合伙人佣金明细已积累 200+ 条,
`get_deal_settlement`
当前一次性返回全量列表,前端已改造为按
`page`
/
`page_size`
分页加载、滚动到底部触发下一页(
[
commission/request.ts
](
../../../packages/partner-mp/src/pages/subpackages/commission/request.ts
)
、
[
my-commission.vue
](
../../../packages/partner-mp/src/pages/subpackages/commission/my-commission.vue
)
),
**缺后端确认接口支持这两个参数、并在响应里补充总数字段**
。
描述:合伙人佣金明细已积累 200+ 条,
`get_deal_settlement`
当前一次性返回全量列表,前端已改造为按
`page`
/
`page_size`
分页加载、滚动到底部触发下一页(
[
commission/request.ts
](
../../../packages/partner-mp/src/pages/subpackages/commission/request.ts
)
、
[
my-commission.vue
](
../../../packages/partner-mp/src/pages/subpackages/commission/my-commission.vue
)
),
**缺后端确认接口支持这两个参数、并在响应里补充总数字段**
。
### 改动18
api文档:《api-doc-第四点新增接口.md》
接口:四、① get_partner_users — 根据手机号/姓名搜索合伙人
描述:
[
partner-drawer.vue
](
../../../packages/partner-mp/src/components/common/partner-drawer.vue
)
(04·P6b 新增商机页面"关联合伙人"抽屉)原为
`// TODO: 调用合伙人搜索 API`
的 mock 数据,已接入真实接口,
`type`
固定传
`"all"`
、
`partner_key`
传搜索框内容;返参字段由 mock 的
`partner_id`
(number) 改为接口实际返回的
`id`
(string),模板与选中态逻辑同步更新。
### 改动19
api文档:《api-doc-第四点新增接口.md》
接口:四、② 修改接口:opportunity_create(入参增加 user_type)
描述:
[
opportunity-create.vue
](
../../../packages/partner-mp/src/pages/subpackages/opportunity/opportunity-create.vue
)
表单里原本就有的"客户类型"(企业客户/个人客户)字段此前只是本地 UI 状态、未随请求提交(见原代码注释"customer_type 字段接口文档未提供,暂保留 UI");现已映射为
`user_type`
(1企业/2个人) 随
`createOpportunity`
提交。顺带修复了"关联合伙人"选中后
`partner_id`
一直没有被提交的遗留问题(
[
opportunity/request.ts
](
../../../packages/partner-mp/src/pages/subpackages/opportunity/request.ts
)
补充
`user_type`
字段类型定义)。
### 改动20
api文档:《api-doc-第四点新增接口.md》
接口:四、③ 合伙人审核添加审核备注(partner_info 新增 review_remark)
描述:确认后不动代码——
`review_remark`
是给"合伙人审核状态查询"接口新增的字段,但该接口本身仍未接入(
[
audit-pending.vue
](
../../../packages/partner-mp/src/pages/subpackages/more/audit-pending.vue
)
、
[
audit-failed.vue
](
../../../packages/partner-mp/src/pages/subpackages/more/audit-failed.vue
)
目前仍是硬编码 mock,属于 api-doc.md「四、4.3」更早就存在的缺口)。已把
`review_remark`
记入 api-doc.md 对应待办小节,等该接口正式排期对接时一并处理。
### 改动21
api文档:《api-doc-第四点新增接口.md》
接口:五、① partner_opportunity_list — 合伙人线索(商机)列表【新增】
描述:改动15 新建
[
lead-list.vue
](
../../../packages/partner-mp/src/pages/subpackages/other/lead-list.vue
)
时
`status`
参数用的是前端占位的数字码(3跟进中/4暂时挂起/5已成单/6已作废,四个 tab);后端正式给出的字段是字符串(
`""`
/
`"all"`
全部、
`in_progress`
进行中=待审核+待分配+跟进中+暂时挂起合并、
`"5"`
已成单、
`"6"`
已作废),已按此改造:
[
lead-list.vue
](
../../../packages/partner-mp/src/pages/subpackages/other/lead-list.vue
)
tab 结构改为"全部/进行中/已成单/已作废",
[
lead-request.ts
](
../../../packages/partner-mp/src/pages/subpackages/other/lead-request.ts
)
的
`LeadListParams.status`
类型同步更新;响应新增
`partner_name`
字段,
`LeadListItem`
类型定义同步补充。
### 改动22
api文档:《api-doc-第四点新增接口.md》
接口:五、② partner_lead_create — 合伙人提交新线索【新增】
描述:改动15 新建
[
lead-create.vue
](
../../../packages/partner-mp/src/pages/subpackages/other/lead-create.vue
)
时
`customer_type`
是前端占位的字符串直传;后端正式给出的字段要求是
`int`
(1企业/2个人),已补充映射表(同
[
opportunity-create.vue
](
../../../packages/partner-mp/src/pages/subpackages/opportunity/opportunity-create.vue
)
的
`CUSTOMER_TYPE_CODE`
做法)后随请求提交。去重口径按后端明确改为"客户名称+联系人手机号+产品+进行中"三维(此前 api-doc.md 记录的是"客户+产品"二维,纯文档口径更新,逻辑在后端实现)。后端另说明"仅审核通过的合伙人可提交",前端不做前置拦截,未通过时交给后端报错提示。
### 改动23
api文档:《api-doc-第四点新增接口.md》
接口:五、④⑤ customer_order_list / get_deal_settlement 分页确认 + hasMore 判断优化
描述:改动16、17 里
`customer_order_list`
、
`get_deal_settlement`
的分页传参已提前做好;后端正式确认接口已支持
`page`
/
`page_size`
并返回总数字段(
`total`
/
`rc_count`
)。顺带把
[
customer-detail.vue
](
../../../packages/partner-mp/src/pages/subpackages/customer/customer-detail.vue
)
里
`hasMore`
的判断从"本页返回条数是否达到 pageSize"的近似判断,改为直接读取响应
`total`
/
`rc_count`
精确判断,避免多翻一页空请求;
`get_deal_settlement`
侧(
[
my-commission.vue
](
../../../packages/partner-mp/src/pages/subpackages/commission/my-commission.vue
)
)此前已经是用
`total`
判断,未改动。
### 改动24
api文档:《api-doc-第四点新增接口.md》
接口:五、③⑥ customer_collect_list.first_deal_status 取值口径 / 介绍人身份判定收紧
描述:均为确认无需改动——③ 后端补充了
`first_deal_status`
的取值口径说明(已成单/已注册/已创建/已留资),前端
[
customer-detail.vue
](
../../../packages/partner-mp/src/pages/subpackages/customer/customer-detail.vue
)
展示逻辑早已就绪;⑥ 介绍人身份判定收紧为"仅统计审核通过的合伙人",后端明确纯后端口径调整、前端无需改动。
# 后端
# 后端
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