package cn.iocoder.yudao.module.mes.service.wm.transaction.dto;

import jakarta.validation.constraints.NotNull;
import lombok.Data;
import lombok.experimental.Accessors;

import java.math.BigDecimal;
import java.time.LocalDateTime;

/**
 * MES 库存事务 创建 Request DTO
 */
@Data
@Accessors(chain = true)
public class MesWmTransactionSaveReqDTO {

    // ===== 事务核心 =====

    /**
     * 事务类型
     *
     * 枚举 {@link cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum}
     */
    @NotNull(message = "事务类型不能为空")
    private Integer type;

    // ===== 业务来源 =====

    /**
     * 业务类型
     *
     * 对应 {@link cn.iocoder.yudao.module.mes.enums.MesBizTypeConstants}
     */
    @NotNull(message = "业务类型不能为空")
    private Integer bizType;
    /**
     * 业务主单 ID
     */
    @NotNull(message = "业务主单 ID 不能为空")
    private Long bizId;
    /**
     * 业务单号
     */
    @NotNull(message = "业务单号不能为空")
    private String bizCode;
    /**
     * 业务行 ID
     */
    @NotNull(message = "业务行 ID 不能为空")
    private Long bizLineId;

    // ===== 物料维度 =====

    /**
     * 物料 ID
     */
    @NotNull(message = "物料 ID 不能为空")
    private Long itemId;
    /**
     * 变动数量（入库为正数，出库为负数）
     */
    @NotNull(message = "变动数量不能为空")
    private BigDecimal quantity;
    /**
     * 批次 ID
     */
    private Long batchId;
    /**
     * 批次号
     */
    private String batchCode;

    // ===== 库存位置 =====

    /**
     * 仓库 ID
     */
    @NotNull(message = "仓库 ID 不能为空")
    private Long warehouseId;
    /**
     * 库区 ID
     */
    @NotNull(message = "库区 ID 不能为空")
    private Long locationId;
    /**
     * 库位 ID
     */
    @NotNull(message = "库位 ID 不能为空")
    private Long areaId;

    // ===== 台账补充字段（入库时用于初始化 MesWmMaterialStockDO） =====

    /**
     * 供应商 ID（采购入库场景）
     */
    private Long vendorId;
    /**
     * 入库时间（为空默认当前时间）
     */
    private LocalDateTime receiptTime;

    // ===== 关联 =====

    /**
     * 指定库存记录 ID（出库场景优先使用，避免重新匹配库存记录）
     */
    private Long materialStockId;

    /**
     * 关联事务 ID
     */
    private Long relatedTransactionId;

    /**
     * 是否强制创建新库存记录（仅入库事务有效）
     *
     * 为 true 时，入库事务始终创建新的库存记录，不查找已有记录
     * 用于退料等场景，需要为每次退料创建独立的库存记录
     */
    private Boolean forceCreateNewStock;

    /**
     * 是否校验库存充足（仅出库事务有效）
     *
     * 为 true（默认）时，出库数量不能超过现有库存
     * 为 false 时，允许负库存（如虚拟线边库场景）
     */
    private Boolean checkFlag;

}