优化

2026-08-27 13:50:33 +08:00
parent daf0ee2acd
commit 3b38fdd33d
7 changed files with 117 additions and 12 deletions
@@ -427,10 +427,11 @@ components:
        itemVersion: {type: integer, format: int32, minimum: 0, description: 明细乐观锁版本；更新仓库备注时作为 expectedItemVersion}
    OperationHistory:
      type: object
-      required: [historyId, actionType, operatorId, occurredAt]
+      required: [historyId, operationId, actionType, operatorId, occurredAt]
      properties:
        historyId: {$ref: '#/components/schemas/LongId'}
        itemId: {$ref: '#/components/schemas/NullableLongId'}
+        operationId: {type: string, minLength: 1, maxLength: 128, description: 稳定业务动作或幂等事件标识；客户端据此识别重放，不按展示文案去重}
        actionType: {type: string, description: 操作类型}
        fromStatus: {type: string, nullable: true, description: 操作前状态}
        toStatus: {type: string, nullable: true, description: 操作后状态}