package com.moka.gdtauto.common;

import lombok.Data;
import java.io.Serializable;

/**
 * 统一响应结果封装类
 *
 * @author moka
 * @since 2026-02-06
 */
@Data
public class Result<T> implements Serializable {

    private static final long serialVersionUID = 1L;

    /**
     * 是否成功
     */
    private Boolean success;

    /**
     * 响应消息
     */
    private String message;

    /**
     * 响应数据
     */
    private T data;

    /**
     * 总记录数（分页查询时使用）
     */
    private Long total;

    /**
     * 当前页码（分页查询时使用）
     */
    private Long page;

    /**
     * 每页数量（分页查询时使用）
     */
    private Long pageSize;

    /**
     * 总页数（分页查询时使用）
     */
    private Long totalPages;

    /**
     * 数量（统计时使用）
     */
    private Integer count;

    /**
     * 备注信息（额外提示）
     */
    private String note;

    /**
     * 使用说明（额外指引）
     */
    private String usage;

    /**
     * 私有构造方法
     */
    private Result() {
    }

    /**
     * 成功响应（无数据）
     *
     * @param message 成功消息
     * @return Result实例
     */
    public static <T> Result<T> success(String message) {
        Result<T> result = new Result<>();
        result.setSuccess(true);
        result.setMessage(message);
        return result;
    }

    /**
     * 成功响应（带数据）
     *
     * @param data 响应数据
     * @param message 成功消息
     * @return Result实例
     */
    public static <T> Result<T> success(T data, String message) {
        Result<T> result = new Result<>();
        result.setSuccess(true);
        result.setData(data);
        result.setMessage(message);
        return result;
    }

    /**
     * 成功响应（仅数据，默认消息"操作成功"）
     *
     * @param data 响应数据
     * @return Result实例
     */
    public static <T> Result<T> success(T data) {
        return success(data, "操作成功");
    }

    public static <T> Result<T> success() {
        return success(null, "操作成功");
    }

    /**
     * 失败响应
     *
     * @param message 失败消息
     * @return Result实例
     */
    public static <T> Result<T> fail(String message) {
        Result<T> result = new Result<>();
        result.setSuccess(false);
        result.setMessage(message);
        return result;
    }

    /**
     * 失败响应（带数据）
     *
     * @param data 响应数据
     * @param message 失败消息
     * @return Result实例
     */
    public static <T> Result<T> fail(T data, String message) {
        Result<T> result = new Result<>();
        result.setSuccess(false);
        result.setData(data);
        result.setMessage(message);
        return result;
    }

    /**
     * 错误响应（别名方法，与fail功能相同）
     *
     * @param message 错误消息
     * @return Result实例
     */
    public static <T> Result<T> error(String message) {
        return fail(message);
    }

    /**
     * 错误响应（带数据，别名方法）
     *
     * @param data 响应数据
     * @param message 错误消息
     * @return Result实例
     */
    public static <T> Result<T> error(T data, String message) {
        return fail(data, message);
    }

    /**
     * 设置数量
     *
     * @param count 数量
     * @return Result实例
     */
    public Result<T> withCount(Integer count) {
        this.count = count;
        return this;
    }

    /**
     * 设置备注
     *
     * @param note 备注信息
     * @return Result实例
     */
    public Result<T> withNote(String note) {
        this.note = note;
        return this;
    }

    /**
     * 设置使用说明
     *
     * @param usage 使用说明
     * @return Result实例
     */
    public Result<T> withUsage(String usage) {
        this.usage = usage;
        return this;
    }

    /**
     * 设置分页信息
     *
     * @param page 当前页码
     * @param pageSize 每页数量
     * @param total 总记录数
     * @return Result实例
     */
    public Result<T> withPage(Long page, Long pageSize, Long total) {
        this.page = page;
        this.pageSize = pageSize;
        this.total = total;
        this.totalPages = (total + pageSize - 1) / pageSize;
        return this;
    }

    /**
     * 设置总记录数（用于统计）
     *
     * @param total 总记录数
     * @return Result实例
     */
    public Result<T> withTotal(Long total) {
        this.total = total;
        return this;
    }
}
