package com.haha.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.haha.entity.InventoryLog;
import com.haha.entity.dto.InventoryLogQueryDTO;

import java.util.List;
import java.util.Map;

/**
 * 库存变动日志服务接口
 */
public interface InventoryLogService extends IService<InventoryLog> {

    /**
     * 分页查询库存变动日志
     *
     * @param page     页码
     * @param pageSize 每页条数
     * @param queryDTO 查询参数
     * @return 分页结果
     */
    IPage<InventoryLog> getPage(int page, int pageSize, InventoryLogQueryDTO queryDTO);

    /**
     * 记录库存变动
     *
     * @param deviceId        设备ID
     * @param productId       商品ID
     * @param productCode     商品编码
     * @param productName     商品名称
     * @param changeType      变动类型
     * @param changeQuantity  变动数量
     * @param beforeStock     变动前库存
     * @param afterStock      变动后库存
     * @param orderId         关联订单号
     * @param activityId      关联活动号
     * @param operatorId      操作人ID
     * @param operatorName    操作人名称
     * @param remark          备注
     * @return 日志记录
     */
    InventoryLog logChange(String deviceId, Long productId, String productCode, String productName,
                           Integer changeType, Integer changeQuantity,
                           Integer beforeStock, Integer afterStock,
                           String orderId, String activityId,
                           Long operatorId, String operatorName, String remark);

    /**
     * 查询设备的变动统计
     *
     * @param deviceId  设备ID
     * @param startTime 开始时间
     * @param endTime   结束时间
     * @return 统计结果
     */
    List<Map<String, Object>> getChangeStatistics(String deviceId, String startTime, String endTime);

    /**
     * 查询商品的变动记录
     *
     * @param productCode 商品编码
     * @param limit       限制条数
     * @return 变动记录列表
     */
    List<Map<String, Object>> getByProductCode(String productCode, int limit);

    /**
     * 统计指定订单号和变动类型的日志数量（用于幂等性检查）
     *
     * @param orderId    订单号
     * @param changeType 变动类型
     * @return 日志数量
     */
    long countByOrderIdAndType(String orderId, Integer changeType);
}
