Files
datahub/backend/app/Model/Product.php
T
2026-03-13 09:33:15 +08:00

128 lines
4.6 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Model;
use OpenApi\Attributes as OA;
/**
* @property int $id 主键
* @property int $company_id 公司 ID
* @property int $platform_id 平台 ID
* @property int $store_id 店铺 ID
* @property int $status_id 产品状态 ID
* @property int $type_id 产品类型 ID
* @property int|null $warehouse_id 仓库 ID
* @property int|null $sub_warehouse_id 子仓库 ID
* @property string $platform_item_id 平台商品 ID
* @property string|null $platform_model_id 平台规格 ID
* @property string|null $origin_sku_id 品牌方原始 SKU ID
* @property string|null $mapped_sku_id 映射后的 SKU ID
* @property string|null $barcode 条形码
* @property string|null $hscode 海关货物编码
* @property array|null $bundled 组合商品信息
* @property string $price 售价
* @property string $currency 货币代码
* @property int $num 可售卖数量
* @property string|null $url 平台 URL
* @property string|null $picture 图片链接
* @property string $hash raw 字段的 MD5 哈希值
* @property string|null $name 商品名称
* @property array $raw 平台返回的原始产品信息
* @property array|null $ext 扩展字段
* @property \Carbon\Carbon|null $created_date 商品在平台的创建时间
* @property \Carbon\Carbon|null $updated_date 商品在平台的更新时间
* @property \Carbon\Carbon $created_at
* @property \Carbon\Carbon $updated_at
*/
#[OA\Schema(
schema: 'Product',
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: 'status_id', type: 'integer', example: 1),
new OA\Property(property: 'type_id', type: 'integer', example: 1),
new OA\Property(property: 'platform_item_id', type: 'string', example: 'ITEM-001'),
new OA\Property(property: 'platform_model_id', type: 'string', nullable: true, example: 'MODEL-A'),
new OA\Property(property: 'name', type: 'string', nullable: true, example: 'iPhone 16 Pro'),
new OA\Property(property: 'price', type: 'number', format: 'decimal', example: 99.99),
new OA\Property(property: 'currency', type: 'string', example: 'CNY'),
new OA\Property(property: 'num', type: 'integer', example: 100),
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: 'created_date', type: 'string', format: 'date-time', nullable: true),
new OA\Property(property: 'updated_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 Product extends Model
{
/**
* The table associated with the model.
*/
protected ?string $table = 'products';
/**
* The attributes that are mass assignable.
*/
protected array $fillable = [
'id',
'company_id',
'platform_id',
'store_id',
'status_id',
'type_id',
'warehouse_id',
'sub_warehouse_id',
'platform_item_id',
'platform_model_id',
'origin_sku_id',
'mapped_sku_id',
'barcode',
'hscode',
'bundled',
'price',
'currency',
'num',
'url',
'picture',
'hash',
'name',
'raw',
'ext',
'created_date',
'updated_date',
'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',
'status_id' => 'integer',
'type_id' => 'integer',
'warehouse_id' => 'integer',
'sub_warehouse_id' => 'integer',
'price' => 'decimal:2',
'num' => 'integer',
'bundled' => 'json',
'raw' => 'json',
'ext' => 'json',
'created_date' => 'datetime',
'updated_date' => 'datetime',
'created_at' => 'datetime',
'updated_at' => 'datetime',
];
}