zsElectric-boot/src/main/java/com/zsElectric/boot/business/service/CouponService.java

package com.zsElectric.boot.business.service;

import com.zsElectric.boot.business.model.entity.Coupon;
import com.zsElectric.boot.business.model.form.CouponForm;
import com.zsElectric.boot.business.model.query.CouponQuery;
import com.zsElectric.boot.business.model.vo.CouponVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 优惠劵服务类
 *
 * @author zsElectric
 * @since 2025-12-15 09:38
 */
public interface CouponService extends IService<Coupon> {

    /**
     *优惠劵分页列表
     *
     * @return {@link IPage<CouponVO>} 优惠劵分页列表
     */
    IPage<CouponVO> getCouponPage(CouponQuery queryParams);

    /**
     * 获取优惠劵表单数据
     *
     * @param id 优惠劵ID
     * @return 优惠劵表单数据
     */
     CouponForm getCouponFormData(Long id);

    /**
     * 新增优惠劵
     *
     * @param formData 优惠劵表单对象
     * @return 是否新增成功
     */
    boolean saveCoupon(CouponForm formData);

    /**
     * 修改优惠劵
     *
     * @param id   优惠劵ID
     * @param formData 优惠劵表单对象
     * @return 是否修改成功
     */
    boolean updateCoupon(Long id, CouponForm formData);

    /**
     * 删除优惠劵
     *
     * @param ids 优惠劵ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteCoupons(String ids);

}