<?php

namespace App\Module\User\AdminControllers\Helper;

use App\Module\User\Enums\STATUS2;
use Dcat\Admin\Show;

/**
 * 详情页辅助特性
 *
 * 提供用户模块后台控制器的详情页构建功能的具体实现
 * 只保留具有复用价值的方法
 */
trait ShowHelperTrait
{


    /**
     * 显示用户名
     *
     * 复用价值：高 - 在多个控制器中使用，提供统一的用户名显示
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldUsername(string $field = 'username', string $label = '用户名'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示用户状态
     *
     * 复用价值：高 - 统一处理用户状态的显示，使用枚举类型
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldStatus(string $field = 'status2', string $label = '状态'): Show\Field
    {
        return $this->show->field($field, $label)->as(function ($value) {
            return STATUS2::tryFrom($value);
        });
    }

    /**
     * 显示用户头像
     *
     * 复用价值：高 - 统一处理用户头像的显示
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldAvatar(string $field = 'avatar', string $label = '头像'): Show\Field
    {
        return $this->show->field($field, $label)->image();
    }

    /**
     * 显示用户安全密码
     *
     * 复用价值：高 - 统一处理用户安全密码的显示，隐藏实际密码
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldSecretPassword(string $field = 'secret_password', string $label = '安全密码'): Show\Field
    {
        return $this->show->field($field, $label)->as(function ($value) {
            return $value ? '已设置' : '未设置';
        });
    }

    /**
     * 显示最后登录时间
     *
     * 复用价值：高 - 统一处理最后登录时间的显示
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldLastLoginTime(string $field = 'info.last_login_time', string $label = '最后登录时间'): Show\Field
    {
        return $this->show->field($field, $label)->as(function ($value) {
            return $value ?: '未登录';
        });
    }

    /**
     * 显示最后活动时间
     *
     * 复用价值：高 - 统一处理最后活动时间的显示
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldLastActivityTime(string $field = 'info.last_activity_time', string $label = '最后活动时间'): Show\Field
    {
        return $this->show->field($field, $label)->as(function ($value) {
            return $value ?: '无活动';
        });
    }


    /**
     * 添加用户联系信息面板
     *
     * 复用价值：高 - 提供完整的用户联系信息面板
     *
     * @return void
     */
    public function addUserContactPanel(): void
    {
    }

    /**
     * 添加用户安全信息面板
     *
     * 复用价值：高 - 提供完整的用户安全信息面板
     *
     * @return void
     */
    public function addUserSecurityPanel(): void
    {

    }

    /**
     * 添加用户时间信息面板
     *
     * 复用价值：高 - 提供完整的用户时间信息面板
     *
     * @return void
     */
    public function addUserTimePanel(): void
    {
    }
}