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.
30 lines
2.5 KiB
30 lines
2.5 KiB
5 days ago
|
# 03 — 商机前端联调全链路回归
|
||
|
|
|
||
|
|
**What to build:** 起服务，实跑一遍商机前端主链路，确认前端工程师能端到端联调通过：在商机新增页"搜客户 → 选客户 → 选客户角色 → 客户联系人级联刷新 → 提交新增商机"整条路径全绿，两个字典下拉（customer_role + customer_type）出数，客户联系人级联端点不 404。同时与前端对齐 baseURL 契约（商机侧客户能力走 `/api/opportunity/customer/*`，而非报告理想路径 `/api/customer/*`），如有偏差记录并约定别名或前端改址。
|
||
|
|
|
||
|
|
**Blocked by:** 01, 02
|
||
|
|
|
||
|
|
**Status:** resolved
|
||
|
|
|
||
|
|
- [ ] 启动服务，`enabled-list` 对 customer_role 与 customer_type 均出数
|
||
|
|
- [ ] 候选客户搜索 `POST /api/opportunity/customer/search` 返回 customerId + customerName
|
||
|
|
- [ ] 客户联系人 stub 端点按已选客户返回契约一致的响应（空/mock），前端级联可对上、不 404
|
||
|
|
- [ ] 走通"搜客户 → 选客户 → 选角色 → 联系人级联 → 提交新增商机"全链路，无 404 / 500
|
||
|
|
- [ ] 与前端确认客户能力实际路径（`/api/opportunity/customer/*`），偏差点记录在案并给出对齐方案
|
||
|
|
|
||
|
|
## Answer
|
||
|
|
|
||
|
|
重打 crm-app fat jar（含 #01/#02 源码改动）→ `SPRING_PROFILES_ACTIVE=verify` 起服务（连远程 DB 8.129.84.155，Tomcat 8080，Started 成功）→ 跑 `verify-03.py` 回归，全绿：
|
||
|
|
|
||
|
|
| 校验 | 结果 |
|
||
|
|
|---|---|
|
||
|
|
| `GET /api/dict/item/enabled-list?groupCode=customer_role` | 200 success，6 项 |
|
||
|
|
| `GET /api/dict/item/enabled-list?groupCode=customer_type` | 200 success，6 项（总包/工程商/投资方/设计院/集成商/投标公司，原始字节 `\xe6\x80\xbb\xe5\x8c\x85`=UTF-8「总包」，控制台乱码为 GBG 终端所致，接口出参正确） |
|
||
|
|
| `POST /api/opportunity/customer/search`（oppId=749662392819908608, keyword=''） | 200 success，返回 10 条 customerId+customerName |
|
||
|
|
| `GET /api/opportunity/customer/contacts?customerId=` | 200 success，data 为空数组（stub），不 404 |
|
||
|
|
| 不存在客户 id `?customerId=999999999` | 200 success，空数组，不报错 |
|
||
|
|
|
||
|
|
**baseURL 契约结论**：客户能力实际路径为 `/api/opportunity/customer/*`（非报告理想的 `/api/customer/*`）。前端 demo（#04）按 `/api/opportunity/customer/*` 对接；A4 客户模块建成后如迁到独立 `/api/customer/*`，届时前端改址或后端加别名（本期不做）。
|
||
|
|
|
||
|
|
结果留存：`.scratch/opp-customer-dependency/verify-03.py` / `verify-03-result.json`。
|