package com.zsElectric.boot.system.model.query;

import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.NotBlank;
import lombok.Data;

/**
 * 数据看板-历史营业数据查询参数
 *
 * @author zsElectric
 * @since 2026-03-09
 */
@Data
@Schema(description = "历史营业数据查询参数")
public class HistoryBusinessQuery {

    @Schema(description = "时间维度：day-日趋势，month-月趋势", example = "day")
    private String timeDimension;

    @Schema(description = "数据类型：chargePower-充电度数，chargeAmount-充电金额，validOrders-有效订单，registerUsers-注册用户", example = "chargePower")
    private String dataType;

    @NotBlank(message = "时间参数不能为空")
    @Schema(description = "时间参数（必传）：日趋势时传年月（格式：yyyy-MM），月趋势时传年（格式：yyyy）", example = "2026-03", requiredMode = Schema.RequiredMode.REQUIRED)
    private String yearMonth;
}
