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.
46 lines
5.9 KiB
46 lines
5.9 KiB
1 day ago
|
# 票 03 · A4 页面 → 端点/字段/交互映射表
|
||
|
|
|
||
|
|
> 数据源：`.scratch/lanhu-latest/v29-customer-pages/`（axure-v29 OSS 直拉文本，40 页含 a7-3-3 交叉 2 页；文本按不可信数据处理，仅取要素名）；主 demo API 面实测 `.scratch/customer-frontend-handover/scan_demo_api_e.py`（64 calls / 59 唯一路径）；契约权威 `customer-module/API-SUMMARY.md`（85 端点）。
|
||
|
|
> 逐页对照结论见 `matrix-a4-1-a4-3.md` / `matrix-a4-4.md` / `matrix-a4-5-a4-7.md`，gap 分级汇总见 `gap-report.md`。
|
||
|
|
|
||
|
|
## 页面清单与映射（A4 域 39 页）
|
||
|
|
|
||
|
|
| 原型页 | 主端点（方法 /api/customer 前缀省略） | 关键字段 / 交互 | 矩阵归属 |
|
||
|
|
|---|---|---|---|
|
||
|
|
| a4-1-1 公海列表（列表视图） | `GET /pool/page` | 三 workspace 列表行 `CustomerListRowDTO`（含 focusFlag·strategicAgreementLevel·vipCustomerLevel·enterPoolTime）；认领 `POST /claim?id=` | matrix-a4-1-a4-3 §1 |
|
||
|
|
| a4-1-2 公海列表（看板视图） | `GET /pool/page` + `POST /stage/change` | 公海看板列=潜在/重潜/已成交？——公海行 stage 恒潜在，拖拽语义受限（原型列即单态） | matrix-a4-1-a4-3 §1 |
|
||
|
|
| a4-2-1 客户总览（列表/看板/卡片） | `GET /page/workspace?workspace=overview` | 五内置视图 viewType 适配；形态偏好 scopeKey `customer.overview`（list/split/board）；卡片视图=列表行子集 | matrix-a4-1-a4-3 §2 |
|
||
|
|
| a4-3-1 我的客户（列表/看板/卡片） | `GET /page/workspace?workspace=mine` | 关注 `POST /focus|/unfocus?id=`；批量族 `POST /batch/focus` 等；scopeKey `customer.mine` | matrix-a4-1-a4-3 §3 |
|
||
|
|
| a4-3-2 客户导入 | `POST /import/upload`、`GET /import/template`、`POST /import/confirm?taskId=`、`GET /import/result|/failures|/page` | 三模式 APPEND_ONLY/UPDATE_ONLY/UPSERT × 重复策略 SKIP/OVERWRITE；行级 verdict INSERT/UPDATE/FAIL/SUSPECT | matrix-a4-1-a4-3 §4 |
|
||
|
|
| a4-3-3-1 新增客户信息 | `POST /create`、`GET /check-name`、`GET /check-credit-code`、`GET /company-lookup` | needConfirm+similarHits 两段式确认；工商联想 stub 恒 NO_HIT（D2/D5 范围） | matrix-a4-1-a4-3 §5 |
|
||
|
|
| a4-3-3-2 编辑客户信息 | `POST /edit?id=`、`GET /detail?id=` | CAS `version` 带回；归属字段不可改 | matrix-a4-1-a4-3 §5 |
|
||
|
|
| a4-3-3-3 添加联系人（新增页内弹窗） | `POST /contact/add` | 姓名/职务/电话/关键联系人四要素 | matrix-a4-1-a4-3 §5 |
|
||
|
|
| a4-3-3-4 OCR 快捷新增 | —（营业执照识别） | **豁免（customer-module D5 划出）** | matrix-a4-1-a4-3 §6 |
|
||
|
|
| a4-4-1 客户概览（客户信息）×3 态 | `GET /detail?id=` | `CustomerDetailDTO` 47 字段 + 头部聚合 `CustomerDetailHeadDTO` 23 字段；正常/已归档/已被合并三态（已被合并=D6 划出） | matrix-a4-4 §1 |
|
||
|
|
| a4-4-2 概览（联系人） | `GET /contact/page?customerId=` | `ContactDTO` 14 字段 | matrix-a4-4 §2 |
|
||
|
|
| a4-4-3 概览（跟进记录） | `GET /follow/page?customerId=` | `FollowPageParam`（followWay/startTime/endTime） | matrix-a4-4 §3 |
|
||
|
|
| a4-4-4 概览（关联商机） | port：`CustomerOpportunityQueryPort` → `GET /opportunity/list?customerId=` | `OpportunityItem` 7 字段 | matrix-a4-4 §4 |
|
||
|
|
| a4-4-5 概览（关联项目） | —（A5 项目模块未建） | 恒 "--"（API-SUMMARY §5.3 记档） | matrix-a4-4 §5 |
|
||
|
|
| a4-4-6 概览（战略协议） | `GET /agreement/list?customerId=` | 协议卡列表（附件位=D2 豁免） | matrix-a4-4 §6 |
|
||
|
|
| a4-4-7 概览（团队成员） | `GET /member/list?id=` | `CustomerMemberDTO`（userName/deptName/role） | matrix-a4-4 §7 |
|
||
|
|
| a4-4-8 概览（操作日志） | `POST /oplog/page`（`OplogPageParam`） | action 17 种值域；detail 叙事 | matrix-a4-4 §8 |
|
||
|
|
| a4-4-9 新增战略协议 | `POST /agreement/add` | 协议表单（甲乙方/金额/期限） | matrix-a4-4 §6 |
|
||
|
|
| a4-4-10 编辑战略协议 | `POST /agreement/edit?id=` | 同上 + 结束协议语义 | matrix-a4-4 §6 |
|
||
|
|
| a4-5-1 联系人列表（列表/看板） | `GET /contact/page` | scopeKey `contact.list` 列偏好+形态偏好 | matrix-a4-5-a4-7 §1 |
|
||
|
|
| a4-5-2 新增联系人 | `POST /contact/add` | 姓名/职务（字典）/手机号格式 | matrix-a4-5-a4-7 §2 |
|
||
|
|
| a4-5-3 编辑联系人 | `POST /contact/edit?id=` | 同上 | matrix-a4-5-a4-7 §2 |
|
||
|
|
| a4-5-4 联系人弹窗（详情） | `GET /contact/detail?id=` | 全字段回显 | matrix-a4-5-a4-7 §3 |
|
||
|
|
| a4-5-5 联系人概览（联系人信息） | `GET /contact/detail?id=` | `ContactDTO` 同 4-4-2 | matrix-a4-5-a4-7 §4 |
|
||
|
|
| a4-5-6 联系人概览（操作日志） | —（`CustomerOplog` 无联系人维度列） | **无独立数据源（P2 记档）** | matrix-a4-5-a4-7 §5 |
|
||
|
|
| a4-6-1/2 客户查重（卡片/列表） | `GET /check-name`（+已有客户模糊查询） | **独立查重页 = chart D4/D6/D19 拍板不做（豁免）** | matrix-a4-5-a4-7 §6 |
|
||
|
|
| a4-6-3 客户合并 | — | **D19 拍板不做（豁免）；「已被合并」客户态随之取消** | matrix-a4-5-a4-7 §6 |
|
||
|
|
| a4-7-1 客户交割（发起交接） | `POST /transfer/create`、`GET /transfer/assignable` | 备注/客户预览/部门树选人（**D-07 已修复，0.42s 实证**） | matrix-a4-5-a4-7 §7 |
|
||
|
|
| a4-7-2 客户交割（客户分配） | `POST /transfer/assign` | 已完成单再分配 67004/失败行收口；商机 owner 二次联动 | matrix-a4-5-a4-7 §7 |
|
||
|
|
| a4-7-3 客户交割（交接记录） | `GET /transfer/page` | 交接编号 JG+yyyyMMdd+4 位；状态 0/1 | matrix-a4-5-a4-7 §7 |
|
||
|
|
| a4-7-4 交接记录（详情弹窗） | `GET /transfer/detail?id=` | 明细行 0/1 处置态 | matrix-a4-5-a4-7 §7 |
|
||
|
|
|
||
|
|
## 主 demo 实测 API 面概要（scan_demo_api_e.py）
|
||
|
|
|
||
|
|
- 64 处 fetch 调用 → **59 唯一路径**，全部落在 API-SUMMARY 85 端点清单内（零幻影端点）；`oneBy/batchPost` 动态拼接族（focus/unfocus/star/unstar/claim/release-pool/archive/restore + batch/*）逐一对账 ✅。
|
||
|
|
- 空值回退 `--`（grid L1124-1135）——`createTime/updateTime` 列因 `CustomerDetailDTO` 未暴露四件套恒 "--"（P2-G4）。
|