kknongchang_2506/app/Module/UrsPromotion/Dtos/UrsUserMappingDto.php

<?php

namespace App\Module\UrsPromotion\Dtos;

use App\Module\UrsPromotion\Models\UrsUserMapping;
use UCore\Dto\BaseDto;

/**
 * URS用户映射数据传输对象
 *
 * 用于在服务层返回URS用户映射信息，避免直接暴露模型对象
 */
class UrsUserMappingDto extends BaseDto
{
    /**
     * @var int 映射ID
     */
    public int $id;

    /**
     * @var int URS用户ID
     */
    public int $ursUserId;

    /**
     * @var string|null URS用户凭证
     */
    public ?string $userKey;

    /**
     * @var int 农场用户ID
     */
    public int $userId;

    /**
     * @var string 映射时间
     */
    public string $mappingTime;

    /**
     * @var int 状态
     */
    public int $status;

    /**
     * @var string 状态文本
     */
    public string $statusText;

    /**
     * @var string 创建时间
     */
    public string $createdAt;

    /**
     * @var string 更新时间
     */
    public string $updatedAt;

    /**
     * 从模型创建DTO
     *
     * @param UrsUserMapping $model URS用户映射模型
     * @return self
     */
    public static function fromModel(UrsUserMapping $model): self
    {
        $dto = new self();
        $dto->id = $model->id;
        $dto->ursUserId = $model->urs_user_id;
        $dto->userKey = $model->user_key;
        $dto->userId = $model->user_id;
        $dto->mappingTime = $model->mapping_time ? $model->mapping_time->toDateTimeString() : '';
        $dto->status = $model->status;
        $dto->statusText = UrsUserMapping::$statusMap[$model->status] ?? '未知';
        $dto->createdAt = $model->created_at ? $model->created_at->toDateTimeString() : '';
        $dto->updatedAt = $model->updated_at ? $model->updated_at->toDateTimeString() : '';

        return $dto;
    }
}