feat(巡店删除): 建单删除条件补形状校验——挡"服务端收下、执行器读出零条件"的静默不删

只校形状不校取值:取值枚举化要跨三张脸且受存量装机版本分布约束,已另挂 docs/audit/BACKLOG.md B2 的四步顺序锁。
六键取文与客户端 _normalize_delete_condition_texts 逐字对齐(后端少认一键就是静默不删的成因),
按 ,,;;、\r\n 拆分去重、单条 ≤500 对齐 V41 的 condition_text 列、条数 ≤100;addCondition 一字未动。
反向对照钉在用例里:删除商品信息草稿/库存状态/草稿 这些真在用的自由措辞必须放行。

表结构零改动(条件不落库;结果走 biz_file_task.result_json 与 biz_task_result_item.payload_json)。
测试:新类 12/12(surefire tests=12 failures=0);后端整量 4381 passed/0 failed/7 skipped rc=0
——注意整量是在含另路未提交件的工作树上跑的,本笔只含 patroldelete 两支且不依赖那些件。
This commit is contained in:
2026-10-17 18:09:30 +08:00
parent 53f302ea6d
commit 531278f861
2 changed files with 191 additions and 0 deletions
@@ -67,6 +67,18 @@ public class PatrolDeleteTaskService {
private static final int RESULT_SUCCESS = 1;
private static final String INTERRUPTED_MESSAGE = "Python 在该店铺结果提交完成前中断";
/**
* 删除条件的取文键,与客户端 patrol_delete.py 的 _normalize_delete_condition_texts 逐字对齐:
* 后端少认一个键就会出现"服务端收下、执行器读出零条件、任务停在执行中"的静默不删。
*/
private static final List<String> DELETE_CONDITION_TEXT_KEYS = List.of(
"conditionText", "condition_text", "status", "text", "label", "name");
/** 一条载荷里可以塞多条条件,拆分符与客户端的 re.split(r"[,,;;、\r\n]+") 同形。 */
private static final String DELETE_CONDITION_SPLIT_REGEX = "[,,;;、\\r\\n]+";
/** 单条上限取 V41__patrol_delete_condition.sql 里 condition_text VARCHAR(500) 的同档值。 */
private static final int DELETE_CONDITION_MAX_TEXT_LENGTH = 500;
private static final int DELETE_CONDITION_MAX_ENTRIES = 100;
private final FileTaskMapper fileTaskMapper;
private final FileResultMapper fileResultMapper;
private final PatrolDeleteResolveService patrolDeleteResolveService;
@@ -246,6 +258,9 @@ public class PatrolDeleteTaskService {
if (request.getDeleteConditions() == null || request.getDeleteConditions().isEmpty()) {
throw new BusinessException("删除条件不能为空,请先选择删除条件");
}
// 空判只挡住"一条都没发",挡不住"发了但执行器读不出文本"(如只带 id 的对象)——
// 那种载荷服务端照收、任务建到 RUNNING 后 Python 无事可做,与上面注释要避免的是同一事故。
normalizeDeleteConditionTexts(request.getDeleteConditions());
List<PatrolDeleteTaskItemDto> uniqueItems = dedupeItems(request.getItems());
if (uniqueItems.isEmpty()) {
@@ -1196,6 +1211,59 @@ public class PatrolDeleteTaskService {
return blank(value) ? null : value.trim();
}
/**
* 只校形状、不校取值。删除条件仍是用户自由输入、由执行器按双向包含匹配,在这里枚举化会把
* 已经在用的措辞(例如"删除商品信息草稿")当场打挂;取值收口需先让执行器认得新代码并出包
* 覆盖存量装机,见 docs/audit/BACKLOG.md 的 B2 顺序锁。
*
* <p>形状判据挡的是另一类事故:结构不对时服务端返回成功、执行器却读出零条件,任务停在执行中。</p>
*/
static List<String> normalizeDeleteConditionTexts(List<Object> deleteConditions) {
List<String> texts = new ArrayList<>();
if (deleteConditions == null || deleteConditions.isEmpty()) {
// "一条都没发"归建单侧那道空判管;这里只管"发了但执行器读不出文本"的那一类。
return texts;
}
for (Object condition : deleteConditions) {
String raw = extractDeleteConditionText(condition);
for (String part : raw.split(DELETE_CONDITION_SPLIT_REGEX)) {
String text = part.trim();
if (text.isEmpty()) {
continue;
}
if (text.length() > DELETE_CONDITION_MAX_TEXT_LENGTH) {
throw new BusinessException("删除条件过长(单条上限 " + DELETE_CONDITION_MAX_TEXT_LENGTH + " 字)");
}
if (!texts.contains(text)) {
texts.add(text);
}
}
}
if (texts.isEmpty()) {
throw new BusinessException("删除条件不能为空,请先选择删除条件");
}
if (texts.size() > DELETE_CONDITION_MAX_ENTRIES) {
throw new BusinessException("删除条件过多(上限 " + DELETE_CONDITION_MAX_ENTRIES + " 条)");
}
return texts;
}
/** 取这条条件里的文本;取不到就判错,不留成"合法的空条件"被服务端收下。 */
private static String extractDeleteConditionText(Object condition) {
if (condition instanceof String text) {
return text;
}
if (condition instanceof Map<?, ?> map) {
for (String key : DELETE_CONDITION_TEXT_KEYS) {
if (map.get(key) instanceof String text && !text.isBlank()) {
return text;
}
}
throw new BusinessException("删除条件缺少可识别的文本,请重新输入删除条件");
}
throw new BusinessException("删除条件格式不合法,请重新输入删除条件");
}
private void validateUserId(Long userId) {
if (userId == null || userId <= 0) {
throw new BusinessException("user_id 不合法");