From 97b123e010877ba34b626f9005b255ebe71d88f6 Mon Sep 17 00:00:00 2001
From: Nick Zeng <Nick.Zeng@wpic.co>
Date: Tue, 10 Feb 2026 13:04:24 +0800
Subject: [PATCH] add refund model

---
 backend/app/Model/Refund.php | 64 ++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 backend/app/Model/Refund.php

diff --git a/backend/app/Model/Refund.php b/backend/app/Model/Refund.php
new file mode 100644
index 0000000..36cff73
--- /dev/null
+++ b/backend/app/Model/Refund.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Model;
+
+use Hyperf\DbConnection\Model\Model;
+
+/**
+ * @property int $id 主键
+ * @property int $company_id 公司 ID
+ * @property int $platform_id 平台 ID
+ * @property int $store_id 店铺 ID
+ * @property int $order_id 关联本地 orders 表 ID
+ * @property string $platform_order_id 平台订单 ID
+ * @property string $platform_refund_id 平台退款单 ID
+ * @property int $refund_status_id 退款状态 ID
+ * @property int $refund_status_id 退款状态 ID
+ * @property int $refund_status_id 退款状态 ID
+ * @property int $refund_type_id 退款类型：1 仅退款 2 退货退款 3 补偿退款
+ * @property int $refund_type_id 退款类型：1 仅退款 2 退货退款 3 补偿退款
+ * @property int $refund_type_id 退款类型：1 仅退款 2 退货退款 3 补偿退款
+ * @property string $reason 退款原因
+ * @property string $refund_amount 退款金额
+ * @property string $freight_refund 退运费金额
+ * @property string $refund_total 退款合计金额，为退款金额+退运费金额，为主要参与聚合计算的字段
+ * @property string $refund_total 退款合计金额，为退款金额+退运费金额，为主要参与聚合计算的字段
+ * @property string $refund_total 退款合计金额，为退款金额+退运费金额，为主要参与聚合计算的字段
+ * @property string $currency 币种
+ * @property string $currency 币种
+ * @property string $currency 币种
+ * @property string $currency 币种
+ * @property string $buyer_user_id 平台买家 ID
+ * @property string $order_created_date 关联订单的创建时间
+ * @property string $order_paid_date 关联订单的付款时间
+ * @property string $created_date 退款单在平台的创建时间
+ * @property string $created_date 退款单在平台的创建时间
+ * @property string $updated_date 退款单在平台的更新时间
+ * @property string $completed_date 退款完成时间
+ * @property string $completed_date 退款完成时间
+ * @property string $raw 平台返回的原始数据
+ * @property string $ext 扩展字段
+ * @property string $hash raw 字段的 MD5 哈希值，用于检测数据变化
+ * @property \Carbon\Carbon $created_at 
+ * @property \Carbon\Carbon $updated_at 
+ * @mixin \App_Model_Refund
+ */
+class Refund extends Model
+{
+    /**
+     * The table associated with the model.
+     */
+    protected ?string $table = 'refunds';
+
+    /**
+     * The attributes that are mass assignable.
+     */
+    protected array $fillable = ['id', 'company_id', 'platform_id', 'store_id', 'order_id', 'platform_order_id', 'platform_refund_id', 'refund_status_id', 'refund_status_id', 'refund_status_id', 'refund_type_id', 'refund_type_id', 'refund_type_id', 'reason', 'refund_amount', 'freight_refund', 'refund_total', 'refund_total', 'refund_total', 'currency', 'currency', 'currency', 'currency', 'buyer_user_id', 'order_created_date', 'order_paid_date', 'created_date', 'created_date', 'updated_date', 'completed_date', 'completed_date', 'raw', 'ext', 'hash', 'created_at', 'updated_at'];
+
+    /**
+     * The attributes that should be cast to native types.
+     */
+    protected array $casts = ['id' => 'integer', 'company_id' => 'integer', 'platform_id' => 'integer', 'store_id' => 'integer', 'order_id' => 'integer', 'refund_status_id' => 'integer', 'refund_status_id' => 'integer', 'refund_status_id' => 'integer', 'refund_type_id' => 'integer', 'refund_type_id' => 'integer', 'refund_type_id' => 'integer', 'created_at' => 'datetime', 'updated_at' => 'datetime'];
+}