== 单文件建单 ==
task.insert taskNo=APPEARANCE_PATENT-<snowflake> moduleType=APPEARANCE_PATENT status=PENDING taskMode=PYTHON_QUEUE collectChannel=null 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,collect_channel] requestJson.digest=8a10649faa72 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 collectChannel=null 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,collect_channel] requestJson.digest=2b44afc83905 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 collectChannel=null 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,collect_channel] requestJson.digest=8a10649faa72 resultJson={}
outcome=共享临时存储关闭 -> BusinessException: 外观专利parsed payload必须写入共享临时存储 RustFS，请检查 aiimage.transient-storage 配置
