feat: add editable order collaboration remarks

order/src/main/resources/openapi/order-v1.yaml

@@ -267,10 +267,10 @@ paths:
             application/json:
               schema: {$ref: '#/components/schemas/UnifiedOrderDetailEnvelope'}
         '403': {description: 需要平台身份和 platform:order:list 权限}
-  /api/platform/v1/orders/{orderId}/internal-notes:
-    post:
-      summary: 添加订单内部备注
-      description: 添加仅平台内部可见的订单备注，需要 platform:order:note 权限。
+  /api/platform/v1/orders/{orderId}/remarks:
+    put:
+      summary: 更新订单协作备注
+      description: 客户备注只读；需要 platform:order:note 权限，可更新或清空内部备注、仓库备注和客服备注。
       parameters:
         - $ref: '#/components/parameters/UnifiedOrderId'
         - $ref: '#/components/parameters/UnifiedTenantId'
@@ -280,9 +280,12 @@ paths:
           application/json:
             schema:
               type: object
-              required: [content]
+              required: [expectedVersion]
               properties:
-                content: {type: string, minLength: 1, maxLength: 2000}
+                expectedVersion: {type: integer, minimum: 0}
+                internalRemark: {type: string, nullable: true, maxLength: 1000}
+                warehouseRemark: {type: string, nullable: true, maxLength: 1000}
+                customerServiceRemark: {type: string, nullable: true, maxLength: 1000}
       responses:
         '200': {description: 备注添加成功或业务失败，按响应体 code 判断}
         '403': {description: 需要 platform:order:note 权限}
@@ -949,6 +952,8 @@ components:
         coLoadGroup: {$ref: '#/components/schemas/UnifiedCoLoadGroupSummary'}
         customerRemark: {type: string, nullable: true}
         latestInternalNote: {type: string, nullable: true, description: 客户详情不返回平台内部备注}
+        warehouseRemark: {type: string, nullable: true}
+        customerServiceRemark: {type: string, nullable: true}
         createdAt: {type: string, format: date-time, nullable: true}
         updatedAt: {type: string, format: date-time, nullable: true}
     UnifiedOrderRelation: