<?php

declare(strict_types=1);

namespace App\Model;

use Hyperf\DbConnection\Model\Model;

/**
 * @property int $id 主键 - 来自远程 和 tools 保持一致
 * @property int $company_id 店铺所属的公司 ID
 * @property int $platform_id 平台 ID
 * @property string $platform_store_id 平台店铺 ID
 * @property array $platform_meta 平台店铺扩展信息 如 店铺所属服务商 - 平台应用 id - 平台商家 id, 平台店铺名称-区域 等根据需要补充其他额外信息
 * @property int $timezone 平台店铺统计时使用的时区 默认为 +8 表示 北京时间， 如果是日本则是 +7， 填写基于 UTC 的偏移值
 * @property array $auth 电商平台开放接口的授权信息（可选）
 * @property int $warehouse_id 店铺使用的仓库 ID
 * @property int $currency_id 店铺的本币 ID
 * @property boolean $enabled 激活状态
 * @property string $name 店铺名 英文
 * @property string $label 店铺名 中文
 * @property array $ext 扩展字段
 * @property \Carbon\Carbon $created_at
 * @property \Carbon\Carbon $updated_at
 */
class Store extends Model
{
    /**
     * The table associated with the model.
     */
    protected ?string $table = 'stores';

    /**
     * Indicates if the IDs are auto-incrementing.
     * 由于 ID 来自远程系统，禁用自增
     */
    public bool $incrementing = false;

    /**
     * The attributes that are mass assignable.
     */
    protected array $fillable = [
        'id',
        'company_id',
        'platform_id',
        'platform_store_id',
        'platform_meta',
        'timezone',
        'auth',
        'warehouse_id',
        'currency_id',
        'enabled',
        'name',
        'label',
        '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',
        'platform_meta' => 'array',
        'timezone' => 'integer',
        'auth' => 'array',
        'warehouse_id' => 'integer',
        'currency_id' => 'integer',
        'enabled' => 'boolean',
        'ext' => 'array',
        'created_at' => 'datetime',
        'updated_at' => 'datetime',
    ];

    /**
     * 获取标准时区字符串
     * 将 UTC 偏移值（如 +8）转换为标准时区格式（如 '+08:00'）
     *
     * @return string 标准时区字符串，可用于 Carbon 和 DateTime
     */
    public function getTimezoneString(): string
    {
        $offset = $this->timezone ?? 0;
        $sign = $offset >= 0 ? '+' : '-';
        $absOffset = abs($offset);
        return sprintf('%s%02d:00', $sign, $absOffset);
    }
}