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.
50 lines
3.3 KiB
50 lines
3.3 KiB
3 weeks ago
|
# crm-lead 视图统计接口 /stats + statusIn 契约变更
|
||
|
|
|
||
|
|
Type: task
|
||
|
|
Status: resolved
|
||
|
|
Depends on: —
|
||
|
|
ADR: docs/adr/0023-lead-batch-operations-and-view-stats.md (D3/D4)
|
||
|
|
|
||
|
|
## Question（实现目标）
|
||
|
|
|
||
|
|
新增顶部统计卡片接口，口径=当前视图（非全库）；并把列表 status 筛选升级为多值以支持复合卡片下钻。
|
||
|
|
|
||
|
|
## 交付物
|
||
|
|
|
||
|
|
### 契约变更（crm-lead）
|
||
|
|
- `domain/param/LeadPageParam.java`：`Integer status` → `List<Integer> statusIn`（`/page` 与 `/stats` 共用）。
|
||
|
|
- Schema 说明：多值，支持复合卡片下钻（如「已被领取」传 `[3,4]`）。
|
||
|
|
|
||
|
|
### DTO（crm-lead）
|
||
|
|
- `domain/dto/LeadStatsDTO.java`：`int total / claimed / converted / todayNew / undistributed`（默认 0）。
|
||
|
|
|
||
|
|
### 读侧（crm-lead query 深模块，ADR-0022）
|
||
|
|
- `LeadViewQuery` 增 `LeadStatsDTO countStats(LeadPageParam param)`。
|
||
|
|
- `LeadViewQueryImpl`：
|
||
|
|
- 抽出 `private LambdaQueryWrapper<Lead> buildViewWrapper(param, currentUserId)`，被 `pageLeads` 与 `countStats` **共用**，确保统计口径 = 列表口径（同 viewType + 同筛选 + 同 `@DataScope`）。
|
||
|
|
- status 过滤由 `.eq(status)` 改为 `.in(CollUtil.isNotEmpty(statusIn), Lead::getStatus, statusIn)`。
|
||
|
|
- `pageLeads` = `buildViewWrapper(...).orderByDesc(createTime)` 后分页（行为不变）。
|
||
|
|
- `countStats` = `selectList(buildViewWrapper(...))` 后按 status 分组计数：claimed=status∈{3,4}、converted=5、undistributed=1、total=全部、todayNew=createTime 为今天。
|
||
|
|
|
||
|
|
### service + controller（crm-lead）
|
||
|
|
- `ILeadService` 增 `LeadStatsDTO countStats(LeadPageParam)` → 委派 `leadViewQuery.countStats`。
|
||
|
|
- `LeadController` 增 `@PostMapping("/stats")`，入参 `LeadPageParam`，返回 `Result<LeadStatsDTO>`。
|
||
|
|
|
||
|
|
## 验收
|
||
|
|
|
||
|
|
- 编译：`mvn -q -pl crm-lead -am compile`。无 BOM。
|
||
|
|
- 现有 `/page` 相关测试改 `status`→`statusIn` 后仍绿。
|
||
|
|
- 新测：四视图下 `countStats` 口径与 `pageLeads` 一致（同筛选集）；`statusIn=[3,4]` 下钻能正确回到 `/page`。
|
||
|
|
- 注意：`buildViewWrapper` 重构不得改变 `pageLeads` 既有行为（读写分离 query 模块为本会话前未提交改动，勿破坏）。
|
||
|
|
|
||
|
|
## Comments
|
||
|
|
|
||
|
|
## Answer
|
||
|
|
|
||
|
|
已交付（ADR-0023 D3/D4）：
|
||
|
|
- **statusIn 契约变更**：`LeadPageParam.status(Integer)` → `statusIn(List<Integer>)`（支撑复合卡片下钻）；wrapper 由 `.eq(status)` 改为 `.in(CollUtil.isNotEmpty, status, statusIn)`。全库仅 1 处引用（LeadViewQueryImpl），无测试引用 param.status。
|
||
|
|
- **统计口**：`LeadStatsDTO`（total/claimed/converted/todayNew/undistributed）；`LeadViewQuery.countStats` + `LeadServiceImpl.countStats` 委派；`LeadController` `POST /api/lead/stats`（同 /page 吃 `LeadPageParam`）。
|
||
|
|
- **口径共享**：抽取 `buildViewWrapper(param, userId)`（viewType 数据集 + 公共筛选，不含排序/分页），`pageLeads` 与 `countStats` 共用，保证「统计口径 = 列表口径」+ @DataScope 一致。claimed = status IN(已领取,跟进中)；todayNew 按 createTime.toLocalDate() == today。
|
||
|
|
|
||
|
|
验收：无 BOM；`mvn -pl crm-lead -am compile` BUILD SUCCESS；`LeadViewQueryImplTest` 6/6（+2 统计：status 分组、todayNew 今日），crm-lead 全套 64/64 绿无回归。（crm-auth 模块存在无关本票的 junit 发现失败，已隔离验证 crm-lead。）
|