/**
 * 定义包名，表明该类属于系统用户模块下的数据传输对象包
 */
package com.yf.exam.modules.sys.user.dto;

// 导入 Swagger 注解，用于为 API 文档提供类的描述信息
import io.swagger.annotations.ApiModel;
// 导入 Swagger 注解，用于为 API 文档提供类属性的描述信息
import io.swagger.annotations.ApiModelProperty;
// 导入 Lombok 的 Data 注解，自动生成 getter、setter、equals、hashCode 和 toString 方法
import lombok.Data;

// 导入 Serializable 接口，使该类的对象可以被序列化
import java.io.Serializable;
// 导入 Date 类，用于表示日期和时间
import java.util.Date;

/**
 * <p>
 * 管理用户请求类，用于在不同层之间传输管理用户的相关信息，如从控制器传递到服务层，或从服务层传递到数据访问层。
 * </p>
 *
 * @author 聪明笨狗
 * @since 2020-04-13 16:57
 */
// 使用 Lombok 的 Data 注解，自动生成常用的 getter、setter 等方法
@Data
// 使用 Swagger 的 ApiModel 注解，为 API 文档描述该类的信息
@ApiModel(value="管理用户", description="管理用户")
public class SysUserDTO implements Serializable {

    /**
     * 序列化版本号，确保序列化和反序列化时类的版本一致性。
     * 当类的结构发生变化时，可能需要更新该版本号以避免反序列化错误。
     */
    private static final long serialVersionUID = 1L;

    /**
     * 管理用户的唯一标识 ID。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "ID", required=true)
    private String id;

    /**
     * 管理用户的用户名，用于系统登录和身份识别。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "用户名", required=true)
    private String userName;

    /**
     * 管理用户的真实姓名，用于更准确地识别用户身份和展示信息。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "真实姓名", required=true)
    private String realName;

    /**
     * 管理用户的登录密码，用于系统登录验证。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "密码", required=true)
    private String password;

    /**
     * 密码盐，用于增强密码的安全性，通常与密码一起进行哈希处理。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "密码盐", required=true)
    private String salt;

    /**
     * 管理用户所属的角色列表，以字符串形式存储角色 ID，多个 ID 之间可能用特定分隔符分隔。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "角色列表", required=true)
    private String roleIds;

    /**
     * 管理用户所属部门的 ID，用于关联部门信息。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "部门ID", required=true)
    private String departId;

    /**
     * 管理用户记录的创建时间，使用 Date 类型表示。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "创建时间", required=true)
    private Date createTime;

    /**
     * 管理用户记录的更新时间，使用 Date 类型表示。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "更新时间", required=true)
    private Date updateTime;

    /**
     * 管理用户的状态，使用整数类型表示不同的状态值，具体状态含义需根据业务逻辑定义。
     * 在 API 文档中标记为必需项，表明在使用该数据传输对象时，该字段必须提供。
     */
    @ApiModelProperty(value = "状态", required=true)
    private Integer state;
    
}