package cn.iocoder.yudao.module.finance.controller.admin.ledger.vo;
|
|
import io.swagger.v3.oas.annotations.media.Schema;
|
import jakarta.validation.constraints.NotEmpty;
|
import jakarta.validation.constraints.NotNull;
|
import lombok.Data;
|
import org.springframework.format.annotation.DateTimeFormat;
|
|
import java.time.YearMonth;
|
|
@Schema(description = "管理后台 - 总账/明细账查询 Request VO")
|
@Data
|
public class FinLedgerReqVO {
|
|
@Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
|
@NotEmpty(message = "查询总账/明细账必须指定会计科目")
|
private String subjectCode;
|
|
// 注意：这里必须是 YearMonth，不能是 LocalDate。
|
// 前端月份选择器传的是 "2026-01"，LocalDate 无法从「年+月」还原出「日」，
|
// 会在参数绑定阶段就抛 "Failed to convert ... to java.time.LocalDate"（400），
|
// 即使写了 @DateTimeFormat(pattern = "yyyy-MM") 也救不了 —— 是字段类型错了，不是格式错了。
|
@Schema(description = "开始月份，格式 yyyy-MM，取该月 1 号为账期起点", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-01")
|
@NotNull(message = "开始月份不能为空")
|
@DateTimeFormat(pattern = "yyyy-MM")
|
private YearMonth startMonth;
|
|
@Schema(description = "结束月份，格式 yyyy-MM，取该月最后一天为账期终点", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-12")
|
@NotNull(message = "结束月份不能为空")
|
@DateTimeFormat(pattern = "yyyy-MM")
|
private YearMonth endMonth;
|
|
@Schema(description = "是否包含下级科目", example = "true")
|
private Boolean includeChildren;
|
|
}
|
