feat(通知): task_failed 带 ref_json 定位锚点,明细可点直达任务详情

用户原话「都没体现哪个任务id/店铺/用户,咋排查」:通知表只有 title/content,
失败任务又按「用户×模块×自然日」聚合成一条,明细被 5 个 taskNo 预览 + 512 字截断吃掉。

- V162 给 biz_user_notification 加 ref_json(TEXT,可重跑迁移,存量不回填)
- 扫描器把桶内每个失败任务写成锚点(taskId/taskNo/moduleType/reason/updatedAt/
  deviceId),上限 20 条;品牌任务无 task_no 用 #<id> 兜底,保证至少一条可定位
- 详情接口回传 refs;同键刷新时锚点变化也更新,且不重新点亮已读
- 后台铃铛「展开明细」渲染成可点行,跳任务中心 ?taskNo= 自动开详情抽屉
- 新增判据 taskFailedAdminNotificationCarriesUidAndTaskNoAnchor:管理端正文必须含
  uid、每个桶的 ref_json 至少一条非空 taskNo
This commit is contained in:
2026-10-22 10:28:12 +08:00
parent 78be0f02e2
commit d268ecdf6b
15 changed files with 361 additions and 36 deletions
@@ -73,7 +73,7 @@ class NotificationDispatchServiceTest {
// 第 8 个参数是事件主体用户:管理员行必须带上它,聚合才有"按用户折"的键
org.mockito.Mockito.verify(notificationService).pushOrRefresh(eq(1L), eq(NotificationService.AUDIENCE_ADMIN),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
eq("标题"), eq("内容"), eq("task_failed_admin:20:PRICE_TRACK:20260913:1"), eq(20L));
eq("标题"), eq("内容"), eq("task_failed_admin:20:PRICE_TRACK:20260913:1"), eq(20L), isNull());
}
@Test
@@ -97,13 +97,13 @@ class NotificationDispatchServiceTest {
assertThat(pushed).isEqualTo(2);
verify(notificationService).pushOrRefresh(eq(1L), eq(NotificationService.AUDIENCE_ADMIN),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
eq("标题"), eq("内容"), eq("task_failed_admin:20:PRICE_TRACK:20260913:1"), eq(20L));
eq("标题"), eq("内容"), eq("task_failed_admin:20:PRICE_TRACK:20260913:1"), eq(20L), isNull());
verify(notificationService).pushOrRefresh(eq(2L), eq(NotificationService.AUDIENCE_ADMIN),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
eq("标题"), eq("内容"), eq("task_failed_admin:20:PRICE_TRACK:20260913:2"), eq(20L));
eq("标题"), eq("内容"), eq("task_failed_admin:20:PRICE_TRACK:20260913:2"), eq(20L), isNull());
// 非本组主管一条都不落
verify(notificationService, never()).pushOrRefresh(eq(3L), anyString(), anyString(),
anyString(), anyString(), anyString(), anyString(), any());
anyString(), anyString(), anyString(), anyString(), any(), anyString());
}
/**
@@ -179,7 +179,7 @@ class NotificationDispatchServiceTest {
contains("任务部分结果缺失"), contains("12 个品牌查询失败"), eq("task_partial:3301"));
verify(notificationService).pushOrRefresh(eq(1L), eq(NotificationService.AUDIENCE_ADMIN),
eq(NotificationService.SCENE_TASK_PARTIAL), eq(NotificationService.LEVEL_WARNING),
contains("用户"), anyString(), eq("task_partial_admin:3301:1"), eq(20L));
contains("用户"), anyString(), eq("task_partial_admin:3301:1"), eq(20L), isNull());
}
@Test
@@ -216,6 +216,8 @@ class NotificationDispatchServiceTest {
anyString(), anyString(), anyString())).thenReturn(true);
when(notificationService.pushOrRefresh(anyLong(), anyString(), anyString(), anyString(),
anyString(), anyString(), anyString(), any())).thenReturn(true);
when(notificationService.pushOrRefresh(anyLong(), anyString(), anyString(), anyString(),
anyString(), anyString(), anyString(), any(), any())).thenReturn(true);
}
private AdminUserEntity admin(Long id, String username) {
@@ -68,18 +68,19 @@ class NotificationScanSchedulerTest {
when(dispatch.prepareAdminAudience()).thenReturn(
new NotificationDispatchService.AdminAudience(List.of(), Set.of(), Map.of()));
when(dispatch.displayNameOf(anyLong())).thenReturn("张三");
when(notificationService.pushOrRefresh(anyLong(), anyString(), anyString(), anyString(), anyString(), anyString(), anyString()))
.thenReturn(true);
when(notificationService.pushOrRefresh(anyLong(), anyString(), anyString(), anyString(),
anyString(), anyString(), anyString(), any(), anyString())).thenReturn(true);
when(dispatch.pushToAdmins(any(NotificationDispatchService.AdminAudience.class), anyString(), anyString(),
anyString(), anyString(), anyString(), any())).thenReturn(1);
anyString(), anyString(), anyString(), any(), anyString())).thenReturn(1);
newScheduler().scanFailedTasks();
// 三个桶:用户7×跟价、用户7×品牌检测、用户8×货源查询
ArgumentCaptor<String> contentCaptor = ArgumentCaptor.forClass(String.class);
ArgumentCaptor<String> refCaptor = ArgumentCaptor.forClass(String.class);
verify(notificationService, times(3)).pushOrRefresh(anyLong(), eq(NotificationService.AUDIENCE_USER),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
anyString(), contentCaptor.capture(), anyString());
anyString(), contentCaptor.capture(), anyString(), any(), refCaptor.capture());
List<String> contents = contentCaptor.getAllValues();
assertThat(contents).anySatisfy(text -> {
assertThat(text).contains("2 个跟价任务失败");
@@ -88,9 +89,57 @@ class NotificationScanSchedulerTest {
});
assertThat(contents).anySatisfy(text -> assertThat(text).contains("1 个货源查询任务失败"));
assertThat(contents).anySatisfy(text -> assertThat(text).contains("1 个品牌检测任务失败"));
assertThat(refCaptor.getAllValues()).hasSize(3).allSatisfy(json ->
assertThat(readRefs(json)).isNotEmpty());
verify(dispatch, times(3)).pushToAdmins(any(NotificationDispatchService.AdminAudience.class),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
anyString(), anyString(), anyString(), anyLong());
anyString(), anyString(), anyString(), anyLong(), anyString());
}
/**
* 用户口径(2026-10-21):「通知里都没体现哪个任务 id / 店铺 / 用户,咋排查」。
* 管理端 task_failed 通知的可执行判据:正文必须带 uid,ref_json 必须至少有一条非空
* taskNo(品牌任务无 task_no 列,用 #&lt;id&gt; 兜底)。只断言标题字面量的测试对此完全无感。
*/
@Test
void taskFailedAdminNotificationCarriesUidAndTaskNoAnchor() {
when(fileTaskMapper.selectList(any())).thenReturn(List.of(
fileTask(101L, "DELETE_BRAND-101", "DELETE_BRAND", 1208L, "店铺打不开")));
BrandCrawlTaskEntity brandTask = new BrandCrawlTaskEntity();
brandTask.setId(201L);
brandTask.setUserId(1208L);
brandTask.setErrorMessage("品牌检测服务不可达");
when(brandCrawlTaskMapper.selectList(any())).thenReturn(List.of(brandTask));
stubAdminAudience();
newScheduler().scanFailedTasks();
ArgumentCaptor<String> contentCaptor = ArgumentCaptor.forClass(String.class);
ArgumentCaptor<String> refCaptor = ArgumentCaptor.forClass(String.class);
verify(dispatch, times(2)).pushToAdmins(any(NotificationDispatchService.AdminAudience.class),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
anyString(), contentCaptor.capture(), anyString(), eq(1208L), refCaptor.capture());
assertThat(contentCaptor.getAllValues()).allSatisfy(text -> assertThat(text).contains("uid=1208"));
assertThat(refCaptor.getAllValues()).allSatisfy(json -> {
List<Map<String, Object>> refs = readRefs(json);
assertThat(refs).as("task_failed 通知必须带定位锚点").isNotEmpty();
assertThat(refs.get(0).get("taskNo")).as("锚点必须能定位任务").isNotNull();
});
assertThat(refCaptor.getAllValues()).anySatisfy(json -> assertThat(readRefs(json))
.anySatisfy(ref -> assertThat(ref.get("taskNo")).isEqualTo("DELETE_BRAND-101")));
assertThat(refCaptor.getAllValues()).anySatisfy(json -> assertThat(readRefs(json))
.anySatisfy(ref -> assertThat(ref.get("taskNo")).isEqualTo("#201")));
}
private static List<Map<String, Object>> readRefs(String json) {
try {
return new com.fasterxml.jackson.databind.ObjectMapper()
.readValue(json, new com.fasterxml.jackson.core.type.TypeReference<>() {
});
} catch (Exception ex) {
throw new AssertionError("ref_json 不是合法 JSON: " + json, ex);
}
}
@Test
@@ -101,9 +150,9 @@ class NotificationScanSchedulerTest {
newScheduler().scanFailedTasks();
verify(notificationService, org.mockito.Mockito.never()).pushOrRefresh(anyLong(), anyString(), anyString(),
anyString(), anyString(), anyString(), anyString());
anyString(), anyString(), anyString(), anyString(), any(), anyString());
verify(dispatch, org.mockito.Mockito.never()).pushToAdmins(any(), anyString(), anyString(),
anyString(), anyString(), anyString(), any());
anyString(), anyString(), anyString(), any(), anyString());
}
@Test
@@ -115,7 +164,7 @@ class NotificationScanSchedulerTest {
newScheduler().scanFailedTasks();
verify(notificationService, org.mockito.Mockito.never()).pushOrRefresh(anyLong(), anyString(), anyString(),
anyString(), anyString(), anyString(), anyString());
anyString(), anyString(), anyString(), anyString(), any(), anyString());
}
/**
@@ -136,13 +185,14 @@ class NotificationScanSchedulerTest {
ArgumentCaptor<String> userKey = ArgumentCaptor.forClass(String.class);
verify(notificationService, times(1)).pushOrRefresh(eq(7L), eq(NotificationService.AUDIENCE_USER),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
anyString(), anyString(), userKey.capture());
anyString(), anyString(), userKey.capture(),
org.mockito.ArgumentMatchers.<Long>isNull(), anyString());
assertThat(userKey.getValue()).isEqualTo("task_failed:7:PRICE_TRACK:20261001");
ArgumentCaptor<String> adminKey = ArgumentCaptor.forClass(String.class);
verify(dispatch, times(1)).pushToAdmins(any(NotificationDispatchService.AdminAudience.class),
eq(NotificationService.SCENE_TASK_FAILED), eq(NotificationService.LEVEL_WARNING),
anyString(), anyString(), adminKey.capture(), eq(7L));
anyString(), anyString(), adminKey.capture(), eq(7L), anyString());
assertThat(adminKey.getValue()).isEqualTo("task_failed_admin:7:PRICE_TRACK:20261001");
}
@@ -159,7 +209,8 @@ class NotificationScanSchedulerTest {
ArgumentCaptor<String> userKey = ArgumentCaptor.forClass(String.class);
verify(notificationService, times(2)).pushOrRefresh(anyLong(), anyString(), anyString(), anyString(),
anyString(), anyString(), userKey.capture());
anyString(), anyString(), userKey.capture(),
org.mockito.ArgumentMatchers.<Long>isNull(), anyString());
assertThat(userKey.getAllValues()).containsExactlyInAnyOrder(
"task_failed:7:PRICE_TRACK:20261001", "task_failed:7:PRICE_TRACK:20261002");
}
@@ -473,10 +524,10 @@ class NotificationScanSchedulerTest {
when(dispatch.prepareAdminAudience()).thenReturn(
new NotificationDispatchService.AdminAudience(List.of(), Set.of(), Map.of()));
when(dispatch.displayNameOf(anyLong())).thenReturn("张三");
when(notificationService.pushOrRefresh(anyLong(), anyString(), anyString(), anyString(), anyString(), anyString(), anyString()))
.thenReturn(true);
when(notificationService.pushOrRefresh(anyLong(), anyString(), anyString(), anyString(), anyString(),
anyString(), anyString(), any(), anyString())).thenReturn(true);
when(dispatch.pushToAdmins(any(NotificationDispatchService.AdminAudience.class), anyString(), anyString(),
anyString(), anyString(), anyString(), any())).thenReturn(1);
anyString(), anyString(), anyString(), any(), anyString())).thenReturn(1);
}
private FileTaskEntity fileTask(Long id, String taskNo, String moduleType, Long userId, String errorMessage) {