@@ -0,0 +1,99 @@
+<?php
+
+namespace app\common\model;
+
+use support\Model;
+use app\common\traits\HasMoneyJournal;
+
+class StockOrderItems extends Model
+{
+    /**
+     * The connection name for the model.
+     *
+     * @var string|null
+     */
+    protected $connection = 'mysql';
+    
+    /**
+     * The table associated with the model.
+     *
+     * @var string
+     */
+    protected $table = 'stock_order_items';
+
+    /**
+     * The primary key associated with the table.
+     *
+     * @var string
+     */
+    protected $primaryKey = 'id';
+
+    /**
+     * Indicates if the model should be timestamped.
+     *
+     * @var bool
+     */
+    public $timestamps = true;
+    
+    
+    protected $dateFormat = 'U';
+
+    /**
+     * 允许自动填充模型字段
+     */
+    protected $fillable = [
+        'id', 'order_id', 'product_code', 'sku_id', 'sku_snapshot', 
+        'model_snapshot', 'quantity', 'color_interior_code', 'color_interior_snapshot', 
+        'color_exterior_code', 'color_exterior_snapshot', 'remark', 'vin', 'created_at', 'updated_at',
+        'mileage', 'unique_id'
+    ];
+
+    /**
+     * 不允许自动填充模型字段
+     */
+    protected $guarded = [];
+
+    /* ========= 关系 ========= */
+
+    use HasMoneyJournal;
+    // 实现抽象方法
+    protected static function moneyObjectScene(): string
+    {
+        return 'stock_order_items';
+    }
+
+    // 便捷访问器（最新一条的原币金额）
+    public function getUnitPriceAmountAttribute()       { return $this->moneyLatest('unit_price')?->amount; }
+    public function getHandlingFeeAmountAttribute()     { return $this->moneyLatest('handling_fee')?->amount; }
+    public function getFobTransportFeeAmountAttribute() { return $this->moneyLatest('fob_transport_fee')?->amount; }
+    public function getPortMiscFeeAmountAttribute()     { return $this->moneyLatest('port_misc_fee')?->amount; }
+    public function getRetrofitFeeAmountAttribute()     { return $this->moneyLatest('retrofit_fee')?->amount; }
+    public function getTotalPriceAmountAttribute()      { return $this->moneyLatest('total_price')?->amount; }
+
+
+    /**
+     * 关联主订单
+     */
+    public function order()
+    {
+        return $this->belongsTo(StockOrders::class, 'order_id', 'id');
+    }
+
+    /**
+     * 关联订单项选项
+     */
+    public function options()
+    {
+        return $this->hasMany(StockOrderItemOptions::class, 'order_item_id', 'id');
+    }
+
+
+    /**
+     * 关联货币价值信息（一个订单项可以有多个货币价值记录）
+     */
+    public function moneyValues()
+    {
+        return $this->hasMany(VehMoneyValue::class, 'object_id', 'id')
+            ->where('object_scene', 'stock_order_items'); // 场景标识区分不同对象类型
+    }
+}