test(phase-3): 3A 迁移前补建单段 golden——吃真服务入口,不再抄一遍管线

AppearancePatentCreateTaskSnapshotTest(8 例)+ appearancepatent/golden/create-task-snapshot.txt。
渲染的是建单的落库事件流水:task.insert → payload.store → task.update → result.insert → scope.insert。

为什么已有 parse-snapshot.txt 还要再补一支:那支锁的是解析本身,而且是在测试里
重跑管线(自建 ExcelParser + 自己抄一份 baseId/hydratePromptFields),一行库没碰、
真入口一次没进。3A 要换掉的恰恰是 parseAndCreateTask 里那几行落库,那份 golden
对这件事零保护——蓝图 §5 的规矩写得很直白:「照抄那种对迁移零保护(旧代码消灭了测试还绿)」。

钉住的三段本支特有形状:
- 建单全程无事务:载荷存储失败时任务头行已经 insert(最后一节只剩 task.insert 一行),
  这是副作用边界,不是 bug 登记——底座不提供任何事务语义,迁移时必须原样保住。
- 结果行 success 留 NULL(不是 0 也不是 ShopDataCrawl 的 -1)、rowCount 写的是接受行数,
  所以底座 newScopeRow 的这两列只能由本支显式交进去。
- resultJson 是索引不是数据(六个顶层键+一枚载荷指针),真载荷只留 ptr://。

顺手钉出一条反直觉读数:maxParseRows 是「截断」口径不是「拒绝」口径——单文件读到上限
行数时 aggregate 那格的上限判定根本不触发,整单照建(golden 末行 events=5 就是这条)。
不顺手改,只登记。

时钟与雪花 id 不进快照;长内容取 sha256 前 12 位当摘要。两次独立 JVM 复跑逐字节相同
(generator 那格在未设环境变量时如实 skip)。AppearancePatent*Test 264 例全绿。
This commit is contained in:
2026-10-19 09:24:59 +08:00
parent 3471a4429f
commit 7b7d22cbb4
2 changed files with 534 additions and 0 deletions
@@ -0,0 +1,29 @@
== 单文件建单 ==
task.insert taskNo=APPEARANCE_PATENT-<snowflake> moduleType=APPEARANCE_PATENT status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=1 successFileCount=0 failedFileCount=0 userId=7 createdBy=user:7 deviceId=device-1 requestJson.keys=[files,fileKey,originalFilename,relativePath,user_id,ai_prompt,api_key] requestJson.digest=e9c718bc06a1 resultJson={}
payload.storeParsed module=APPEARANCE_PATENT taskId=1001 scopeHash=5aef06a0d982 entry=latest encodeAsJson=false content.len=1131 content.digest=3f9589e6833c
task.update id=1001 resultJson.keys=[aiPrompt,apiKey,sourceFileKeys,parsedPayloadRef,ownerInstanceId] resultJson={"aiPrompt":"请排查侵权风险","apiKey":"sk-test-0001","sourceFileKeys":["uploads/main.xlsx"],"parsedPayloadRef":"ptr://task-parsed/5aef06a0d982/latest","ownerInstanceId":"instance-A"}
result.insert taskId=1001 moduleType=APPEARANCE_PATENT sourceFilename=17.xlsx sourceFileUrl=uploads/main.xlsx rowCount=2 success=null userId=7
scope.insert taskId=1001 moduleType=APPEARANCE_PATENT scopeKey=uploads/main.xlsx scopeHash=5aef06a0d982 parsedPayloadJson="ptr://task-parsed/5aef06a0d982/latest" stateJson={"phase":"PARSED"} chunkTotal=0 receivedChunkCount=0 completed=0
vo: taskId=1001 sourceFilename=17.xlsx sourceFileCount=1 totalRows=3 acceptedRows=2 droppedRows=1 groupCount=1 aiPrompt=请排查侵权风险 items=0 groups=0
== 双文件聚合 ==
task.insert taskNo=APPEARANCE_PATENT-<snowflake> moduleType=APPEARANCE_PATENT status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=2 successFileCount=0 failedFileCount=0 userId=7 createdBy=user:7 deviceId=null requestJson.keys=[files,fileKey,originalFilename,relativePath,fileKey,originalFilename,relativePath,user_id,ai_prompt,api_key] requestJson.digest=2f72932983ea resultJson={}
payload.storeParsed module=APPEARANCE_PATENT taskId=1001 scopeHash=c822dc131109 entry=latest encodeAsJson=false content.len=1610 content.digest=e2bb1a0e4ab4
task.update id=1001 resultJson.keys=[aiPrompt,apiKey,sourceFileKeys,parsedPayloadRef,ownerInstanceId] resultJson={"aiPrompt":"请排查侵权风险","apiKey":"sk-test-0001","sourceFileKeys":["uploads/a.xlsx","uploads/b.xlsx"],"parsedPayloadRef":"ptr://task-parsed/c822dc131109/latest","ownerInstanceId":"instance-A"}
result.insert taskId=1001 moduleType=APPEARANCE_PATENT sourceFilename=a.xlsx 等 2 个文件 sourceFileUrl=aggregate:7b002a4b8031c0f8ee99822337979dfbe4720f1c3bf262701d04767a09b9dd36 rowCount=3 success=null userId=7
scope.insert taskId=1001 moduleType=APPEARANCE_PATENT scopeKey=aggregate:7b002a4b8031c0f8ee99822337979dfbe4720f1c3bf262701d04767a09b9dd36 scopeHash=c822dc131109 parsedPayloadJson="ptr://task-parsed/c822dc131109/latest" stateJson={"phase":"PARSED"} chunkTotal=0 receivedChunkCount=0 completed=0
vo: sourceFilename=a.xlsx 等 2 个文件 sourceFileCount=2 totalRows=4 acceptedRows=3 groupCount=2
== 建单被拒的六格:一次库都不碰 ==
userId=null -> BusinessException: user_id 不合法
files=空 -> BusinessException: 请先上传 Excel 文件
files=全 null 元素 -> BusinessException: 请先上传 Excel 文件
fileKey=空白 -> BusinessException: fileKey 不能为空
源文件不存在 -> BusinessException: 源文件不存在
未解析到有效行 -> BusinessException: 没有解析到可检测的外观专利行,请检查表格内容
超过 maxParseRows -> 未抛异常
events=5(四格有夹具的场景也必须零落库)
== 载荷存储失败时的副作用边界(本支建单无事务) ==
task.insert taskNo=APPEARANCE_PATENT-<snowflake> moduleType=APPEARANCE_PATENT status=PENDING taskMode=PYTHON_QUEUE sourceFileCount=1 successFileCount=0 failedFileCount=0 userId=7 createdBy=user:7 deviceId=d requestJson.keys=[files,fileKey,originalFilename,relativePath,user_id,ai_prompt,api_key] requestJson.digest=e9c718bc06a1 resultJson={}
outcome=共享临时存储关闭 -> BusinessException: 外观专利parsed payload必须写入共享临时存储 RustFS,请检查 aiimage.transient-storage 配置