fix: complete order measurement downstream flow

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

@@ -59,6 +59,34 @@ paths:
             application/json:
               schema: {$ref: '#/components/schemas/CargoLabelBindingListEnvelope'}
         '403': {description: 内部服务令牌无效}
+    put:
+      security: []
+      summary: Firstleg 维护订单权威协作备注
+      description: >-
+        仅接受内部服务令牌。预装清单编辑备注时写回 Order 权威订单记录；
+        客户备注保持只读，内部、仓库和客服备注统一按订单版本乐观更新。
+      parameters:
+        - name: X-Internal-Service-Token
+          in: header
+          required: true
+          schema: {type: string}
+        - {name: tenantId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: orderId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [operatorId]
+              properties:
+                internalRemark: {type: string, nullable: true, maxLength: 1000}
+                warehouseRemark: {type: string, nullable: true, maxLength: 1000}
+                customerServiceRemark: {type: string, nullable: true, maxLength: 1000}
+                operatorId: {type: integer, format: int64, minimum: 1}
+      responses:
+        '200': {description: 返回订单最新版本和四类备注}
+        '403': {description: 内部服务令牌无效}
   /internal/order/v1/cargoes/{tenantId}/{orderId}/printable-inbound-snapshot:
     post:
       security: []