update order and order_item

2025-12-12 13:15:02 +08:00
parent e96e767b92
commit 651de05bb5
4 changed files with 139 additions and 13 deletions
@@ -9,10 +9,8 @@ use Hyperf\DbConnection\Model\Model;
 /**
 * @property int $id 主键
 * @property int $company_id 公司 ID 与 Tools 保持一致
- * @property int $company_id 公司 ID 与 Tools 保持一致
 * @property int $platform_id 平台 ID 与 Tools 保持一致
 * @property int $store_id 店铺 ID 与 Tools 保持一致
- * @property int $store_id 店铺 ID 与 Tools 保持一致
 * @property int $order_status_id 订单状态 ID
 * @property string $platform_order_id 平台 订单 ID
 * @property string $buyer_user_id 平台买家 id
@@ -30,7 +28,6 @@ use Hyperf\DbConnection\Model\Model;
 * @property string $voucher_amount 代金券 - 兑换券金额
 * @property int $order_type_id 订单类型 ID, 默认为一般订单，部分平台可能有补差价，代金券订单等
 * @property string $created_date 订单的创建时间
- * @property string $created_date 订单的创建时间
 * @property string $updated_date 订单的更新时间
 * @property string $paid_date 订单的付款时间
 * @property string $shipping_date 订单的发货时间
@@ -54,10 +51,20 @@ class Order extends Model
    /**
     * The attributes that are mass assignable.
     */
-    protected array $fillable = ['id', 'company_id', 'company_id', 'platform_id', 'store_id', 'store_id', 'order_status_id', 'platform_order_id', 'buyer_user_id', 'payment_method_id', 'presale', 'total_amount', 'total_paid', 'total_discount', 'total_received', 'freight_fee', 'tax_fee', 'discount_fee', 'commission_fee', 'coupon_amount', 'voucher_amount', 'order_type_id', 'created_date', 'created_date', 'updated_date', 'paid_date', 'shipping_date', 'zipcode', 'city', 'province', 'country', 'raw', 'ext', 'created_at', 'updated_at'];
+    protected array $fillable = ['id', 'company_id', 'platform_id', 'store_id', 'order_status_id', 'platform_order_id', 'buyer_user_id', 'payment_method_id', 'presale', 'total_amount', 'total_paid', 'total_discount', 'total_received', 'freight_fee', 'tax_fee', 'discount_fee', 'commission_fee', 'coupon_amount', 'voucher_amount', 'order_type_id', 'created_date', 'updated_date', 'paid_date', 'shipping_date', 'zipcode', 'city', 'province', 'country', 'raw', 'ext', 'created_at', 'updated_at'];

    /**
     * The attributes that should be cast to native types.
     */
-    protected array $casts = ['id' => 'integer', 'company_id' => 'integer', 'company_id' => 'integer', 'platform_id' => 'integer', 'store_id' => 'integer', 'store_id' => 'integer', 'order_status_id' => 'integer', 'payment_method_id' => 'integer', 'presale' => 'boolean', 'order_type_id' => 'integer', 'created_at' => 'datetime', 'updated_at' => 'datetime'];
+    protected array $casts = ['id' => 'integer', 'company_id' => 'integer', 'platform_id' => 'integer', 'store_id' => 'integer', 'order_status_id' => 'integer', 'payment_method_id' => 'integer', 'presale' => 'boolean', 'order_type_id' => 'integer', 'created_at' => 'datetime', 'updated_at' => 'datetime'];
+
+
+    /**
+     * Get the order items for the order.
+     */
+    public function items()
+    {
+        return $this->hasMany(OrderItem::class, 'order_id', 'id');
+    }
 }
+
@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Model;
+
+use Hyperf\DbConnection\Model\Model;
+
+/**
+ * @property int $id 主键
+ * @property int $company_id 公司 ID 与 Tools 保持一致
+ * @property int $platform_id 平台 ID 与 Tools 保持一致
+ * @property int $store_id 店铺 ID 与 Tools 保持一致
+ * @property int $order_id 父订单 ID
+ * @property string $platform_order_id 平台父订单 ID
+ * @property string $sub_order_id 平台子订单 ID，部分平台有，如 Tmall
+ * @property int $sub_order_type_id 平台子订单 类型 id，标记字段
+ * @property int $product_id 商品 ID， 与 Tools 保持一致
+ * @property string $platform_product_id 平台商品 ID， 与 Tools 保持一致
+ * @property string $product_sku 商品 SKU 编码， 客户提供的内部商品编码
+ * @property string $product_barcode 商品 条形码 GTIN 等
+ * @property string $unit_price 单件价格
+ * @property int $quantity 商品子项总数量
+ * @property string $discount 订单子项总的折扣金额
+ * @property string $total 总金额 = 单价X数量 - 折扣
+ * @property string $ext 扩展字段
+ * @property \Carbon\Carbon $created_at 
+ * @property \Carbon\Carbon $updated_at 
+ * @mixin \App_Model_OrderItem
+ */
+class OrderItem extends Model
+{
+    /**
+     * The table associated with the model.
+     */
+    protected ?string $table = 'order_items';
+
+    /**
+     * The attributes that are mass assignable.
+     */
+    protected array $fillable = ['id', 'company_id', 'platform_id', 'store_id', 'order_id', 'platform_order_id', 'sub_order_id', 'sub_order_type_id', 'product_id', 'platform_product_id', 'product_sku', 'product_barcode', 'unit_price', 'quantity', 'discount', 'total', 'ext', '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', 'sub_order_type_id' => 'integer', 'product_id' => 'integer', 'quantity' => 'integer', 'created_at' => 'datetime', 'updated_at' => 'datetime'];
+
+    /**
+     * Get the order that owns the order item.
+     */
+    public function order()
+    {
+        return $this->belongsTo(Order::class, 'order_id', 'id');
+    }
+}
@@ -2,7 +2,7 @@

 declare(strict_types=1);

-namespace App\Platform\Tmall;
+namespace App\Platform\Tmall\EntityParse;

 use App\Model\Company;
 use App\Model\Model as Entity;
@@ -16,7 +16,7 @@ use InvalidArgumentException;
 *
 * 展示如何继承 EntityParse 实现自定义解析逻辑
 */
-class TmallOrderParser extends EntityParse
+class Order extends EntityParse
 {
    /**
     * 公司作用域匹配
@@ -107,12 +107,45 @@ class TmallOrderParser extends EntityParse
    }

    /**
-     * 可选：覆盖唯一标识符提取逻辑
+     * 获取实体的唯一键字段（用于 upsert 的 uniqueBy 参数）
     *
-     * 如果使用默认的 unique_id 提取逻辑，则无需覆盖此方法
+     * 定义订单的唯一约束字段组合
+     *
+     * @return array 唯一键字段名数组
     */
-    // public function entityUniqueIdentifierExtract(array $metadata): string|int
-    // {
-    //     return $metadata['custom_id_field'] ?? throw new InvalidArgumentException('custom_id_field not found');
-    // }
+    public function getUniqueBy(): array
+    {
+        // 天猫订单的唯一性由店铺 + 平台订单号确定
+        return ['store_id', 'platform_order_id'];
+    }
+
+    /**
+     * 获取可更新的字段列表（用于 upsert 的 update 参数）
+     *
+     * 明确定义哪些字段在更新时可以被修改
+     * 排除：主键、唯一键、创建时间、关联 ID 等不应变更的字段
+     *
+     * @return array 可更新字段名数组
+     */
+    public function getUpdateFields(): array
+    {
+        // 方案1：手动指定可更新字段（推荐，最明确）
+        return [
+            'order_status_id',
+            'payment_method_id',
+            'buyer_user_id',
+            'total_amount',
+            'updated_date',
+            'raw',
+            // 根据实际业务需求添加其他可更新字段
+        ];
+
+        // 方案2：动态计算（如果字段较多且经常变动）
+        // $entity = $this->entityMatch($this->getData());
+        // $excludeFields = array_merge(
+        //     ['id', 'created_at', 'created_date', 'company_id', 'platform_id'],
+        //     $this->getUniqueBy()
+        // );
+        // return $this->getTableColumnsExcept($entity, $excludeFields);
+    }
 }