add refund

backend/app/Model/Refund.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace App\Model;
 
+use OpenApi\Attributes as OA;
 
 /**
  * @property int $id 主键
@@ -33,6 +34,37 @@ namespace App\Model;
  * @property \Carbon\Carbon $updated_at
  * @mixin \App_Model_Refund
  */
+#[OA\Schema(
+    schema: 'Refund',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1),
+        new OA\Property(property: 'company_id', type: 'integer', example: 1),
+        new OA\Property(property: 'platform_id', type: 'integer', example: 2),
+        new OA\Property(property: 'store_id', type: 'integer', example: 100),
+        new OA\Property(property: 'order_id', type: 'integer', nullable: true, example: 500),
+        new OA\Property(property: 'platform_order_id', type: 'string', example: 'ORD-20260101-001'),
+        new OA\Property(property: 'platform_refund_id', type: 'string', example: 'RF-20260115-001'),
+        new OA\Property(property: 'refund_status_id', type: 'integer', example: 1),
+        new OA\Property(property: 'refund_type_id', type: 'integer', example: 2),
+        new OA\Property(property: 'reason', type: 'string', nullable: true, example: '商品质量问题'),
+        new OA\Property(property: 'buyer_user_id', type: 'string', nullable: true, example: 'buyer_123'),
+        new OA\Property(property: 'refund_amount', type: 'number', format: 'decimal', example: 99.99),
+        new OA\Property(property: 'freight_refund', type: 'number', format: 'decimal', example: 10.00),
+        new OA\Property(property: 'refund_total', type: 'number', format: 'decimal', example: 109.99),
+        new OA\Property(property: 'currency', type: 'string', example: 'CNY'),
+        new OA\Property(property: 'hash', type: 'string', example: 'a1b2c3d4e5f6...'),
+        new OA\Property(property: 'raw', type: 'object', nullable: true, description: '平台原始数据'),
+        new OA\Property(property: 'ext', type: 'object', nullable: true, description: '扩展字段'),
+        new OA\Property(property: 'order_created_date', type: 'string', format: 'date-time', nullable: true),
+        new OA\Property(property: 'order_paid_date', type: 'string', format: 'date-time', nullable: true),
+        new OA\Property(property: 'created_date', type: 'string', format: 'date-time'),
+        new OA\Property(property: 'updated_date', type: 'string', format: 'date-time', nullable: true),
+        new OA\Property(property: 'completed_date', type: 'string', format: 'date-time', nullable: true),
+        new OA\Property(property: 'created_at', type: 'string', format: 'date-time'),
+        new OA\Property(property: 'updated_at', type: 'string', format: 'date-time'),
+    ]
+)]
 class Refund extends Model
 {
     /**