Commit 5319d412 by 王雷

更新api-doc

parent ff6c4be9
```markdown ```markdown
...@@ -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) 展示逻辑早已就绪;⑥ 介绍人身份判定收紧为"仅统计审核通过的合伙人",后端明确纯后端口径调整、前端无需改动。
# 后端 # 后端
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