datahub/backend/app/Platform/ProductContract.php

<?php

declare(strict_types=1);

namespace App\Platform;

/**
 * 产品解析器契约接口
 *
 * 定义所有电商平台产品解析器必须实现的方法
 * 适用于：Shopee、Tmall、JD 等所有电商平台
 */
interface ProductContract
{
    /**
     * 获取产品状态 ID
     *
     * 将平台产品状态映射到本地 ProductStatus 枚举
     *
     * @param string $platform_status 平台状态字符串
     * @return int 本地产品状态 ID
     */
    public function getProductStatusId(string $platform_status): int;
}