You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
40 lines
1.5 KiB
40 lines
1.5 KiB
5 days ago
|
# 05 接口文档同步（Bruno .bru）
|
||
|
|
|
||
|
|
Type: task
|
||
|
|
Status: resolved
|
||
|
|
|
||
|
|
## 目标
|
||
|
|
|
||
|
|
代码（01–03 票）改完后，同步接口文档仓的 `新建商机.bru`，与 `CreateOpportunityRequest` 保持一致。
|
||
|
|
|
||
|
|
## 文件
|
||
|
|
|
||
|
|
`D:\code\crm-api-docs\A3 商机管理\新建商机\新建商机.bru`
|
||
|
|
|
||
|
|
## 改动
|
||
|
|
|
||
|
|
### 1. 请求参数表新增 7 行
|
||
|
|
|
||
|
|
| 参数 | 类型 | 必填 | 默认 | 说明 |
|
||
|
|
| --- | --- | --- | --- | --- |
|
||
|
|
| projectAmount | string | 否 | - | 项目金额（BigDecimal，序列化为 string） |
|
||
|
|
| address | string | 否 | - | 项目详细地址 |
|
||
|
|
| customerRole | string | 否 | - | 客户类型 → 关联客户角色字典 code（customerId 非空时必填） |
|
||
|
|
| isPrimaryIntended | number | 否 | 1 | 是否主要客户：1是 0否（customerId 非空时必填；0=普通关联，不刷主客户冗余） |
|
||
|
|
| keyContactId | string | 否 | - | 商机关键联系人 ID（引用 A4 联系人，未建可空） |
|
||
|
|
| keyContactName | string | 否 | - | 商机关键联系人姓名快照 |
|
||
|
|
| keyContactCompany | string | 否 | - | 关键人所在公司快照 |
|
||
|
|
|
||
|
|
### 2. 既有行修正
|
||
|
|
|
||
|
|
- `cityCode` 说明补：「市/区国标 code（前端三级级联选到区/县时传区/县 code）」
|
||
|
|
- `remark` 说明从「备注」改为「项目概况（备注，线索转商机时映射）」
|
||
|
|
|
||
|
|
### 3. 请求示例补字段
|
||
|
|
|
||
|
|
`body:form-urlencoded` 与 `docs` 内的 curl 示例追加新字段（示例值自拟，标注非真实返回）。
|
||
|
|
|
||
|
|
## 完成标准
|
||
|
|
|
||
|
|
- [ ] .bru 参数表 / 示例 / body 与最终 DTO 一致
|