# 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 一致