update order and order_item

backend/app/Model/Order.php

@@ -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');
+    }
 }
+

backend/app/Model/OrderItem.php

@@ -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');
+    }
+}

backend/app/Platform/Tmall/EntityParse/Order.php

@@ -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);
+    }
 }

backend/migrations/2025_12_12_130906_add_foreign_key_to_order_items_table.php

@@ -0,0 +1,31 @@
+<?php
+
+use Hyperf\Database\Schema\Schema;
+use Hyperf\Database\Schema\Blueprint;
+use Hyperf\Database\Migrations\Migration;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('order_items', function (Blueprint $table) {
+            $table->foreign('order_id')
+                ->references('id')
+                ->on('orders')
+                ->onDelete('cascade');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('order_items', function (Blueprint $table) {
+            $table->dropForeign(['order_id']);
+        });
+    }
+};