package com.iotechn.unimall.admin.api.coupon;
|
|
import com.dobbinsoft.fw.core.annotation.HttpMethod;
|
import com.dobbinsoft.fw.core.annotation.HttpOpenApi;
|
import com.dobbinsoft.fw.core.annotation.HttpParam;
|
import com.dobbinsoft.fw.core.annotation.HttpParamType;
|
import com.dobbinsoft.fw.core.annotation.param.NotNull;
|
import com.dobbinsoft.fw.core.exception.ServiceException;
|
import com.dobbinsoft.fw.support.model.Page;
|
import com.iotechn.unimall.data.domain.CouponDO;
|
import com.iotechn.unimall.data.dto.CouponAdminDTO;
|
|
import java.util.Date;
|
|
/**
|
* Created with IntelliJ IDEA.
|
* Description:
|
* User: kbq
|
* Date: 2019-07-12
|
* Time: 下午10:47
|
*/
|
|
@HttpOpenApi(group = "admin.coupon", description = "优惠卷")
|
public interface AdminCouponService {
|
|
@HttpMethod(description = "创建", permission = "promotion:coupon:create", permissionParentName = "推广管理", permissionName = "优惠管理")
|
public CouponDO create(
|
@NotNull @HttpParam(name = "title", type = HttpParamType.COMMON, description = "优惠卷标题") String title,
|
@NotNull @HttpParam(name = "type", type = HttpParamType.COMMON, description = "优惠卷类别，如满减") Integer type,
|
@NotNull @HttpParam(name = "isVip", type = HttpParamType.COMMON, description = "是否vip专享") Integer isVip,
|
@HttpParam(name = "description", type = HttpParamType.COMMON, description = "优惠卷描述") String description,
|
@NotNull @HttpParam(name = "total", type = HttpParamType.COMMON, description = "优惠卷总数") Integer total,
|
@NotNull @HttpParam(name = "limit", type = HttpParamType.COMMON, description = "用户限制领取") Integer limit,
|
@NotNull @HttpParam(name = "discount", type = HttpParamType.COMMON, description = "优惠价格") Integer discount,
|
@NotNull @HttpParam(name = "min", type = HttpParamType.COMMON, description = "满足优惠的最低价格") Integer min,
|
@NotNull @HttpParam(name = "status", type = HttpParamType.COMMON, description = "优惠卷状态") Integer status,
|
@HttpParam(name = "categoryId", type = HttpParamType.COMMON, description = "优惠类别") Long categoryId,
|
@HttpParam(name = "days", type = HttpParamType.COMMON, description = "优惠时长") Integer days,
|
@HttpParam(name = "gmtStart", type = HttpParamType.COMMON, description = "优惠开始时间") Long gmtStart,
|
@HttpParam(name = "gmtEnd", type = HttpParamType.COMMON, description = "优惠结束时间") Long gmtEnd,
|
@NotNull @HttpParam(name = "adminId", type = HttpParamType.ADMIN_ID, description = "管理员ID") Long adminId) throws ServiceException;
|
|
@HttpMethod(description = "删除", permission = "promotion:coupon:delete", permissionParentName = "推广管理", permissionName = "优惠管理")
|
public Boolean delete(
|
@NotNull @HttpParam(name = "id", type = HttpParamType.COMMON, description = "优惠卷ID") Long id,
|
@NotNull @HttpParam(name = "adminId", type = HttpParamType.ADMIN_ID, description = "管理员ID") Long adminId) throws ServiceException;
|
|
@HttpMethod(description = "修改", permission = "promotion:coupon:edit", permissionParentName = "推广管理", permissionName = "优惠管理")
|
public Boolean edit(
|
@NotNull @HttpParam(name = "id", type = HttpParamType.COMMON, description = "优惠卷ID") Long id,
|
@NotNull @HttpParam(name = "title", type = HttpParamType.COMMON, description = "优惠卷标题") String title,
|
@NotNull @HttpParam(name = "type", type = HttpParamType.COMMON, description = "优惠卷类别，如满减") Integer type,
|
@NotNull @HttpParam(name = "isVip", type = HttpParamType.COMMON, description = "是否vip专享") Integer isVip,
|
@HttpParam(name = "description", type = HttpParamType.COMMON, description = "优惠卷描述") String description,
|
@NotNull @HttpParam(name = "total", type = HttpParamType.COMMON, description = "优惠卷总数") Integer total,
|
@NotNull @HttpParam(name = "surplus", type = HttpParamType.COMMON, description = "优惠卷剩余") Integer surplus,
|
@NotNull @HttpParam(name = "limit", type = HttpParamType.COMMON, description = "用户限制领取") Integer limit,
|
@NotNull @HttpParam(name = "discount", type = HttpParamType.COMMON, description = "优惠价格") Integer discount,
|
@NotNull @HttpParam(name = "min", type = HttpParamType.COMMON, description = "满足优惠的最低价格") Integer min,
|
@NotNull @HttpParam(name = "status", type = HttpParamType.COMMON, description = "优惠卷状态") Integer status,
|
@HttpParam(name = "categoryId", type = HttpParamType.COMMON, description = "优惠类别") Long categoryId,
|
@HttpParam(name = "days", type = HttpParamType.COMMON, description = "优惠时长") Integer days,
|
@HttpParam(name = "gmtStart", type = HttpParamType.COMMON, description = "优惠开始时间") Date gmtStart,
|
@HttpParam(name = "gmtEnd", type = HttpParamType.COMMON, description = "优惠结束时间") Date gmtEnd,
|
@NotNull @HttpParam(name = "adminId", type = HttpParamType.ADMIN_ID, description = "管理员ID") Long adminId) throws ServiceException;
|
|
@HttpMethod(description = "修改", permission = "promotion:coupon:edit", permissionParentName = "推广管理", permissionName = "优惠管理")
|
public Boolean updateCouponStatus(
|
@NotNull @HttpParam(name = "id", type = HttpParamType.COMMON, description = "优惠卷ID") Long id,
|
@NotNull @HttpParam(name = "status", type = HttpParamType.COMMON, description = "优惠卷状态") Integer status,
|
@NotNull @HttpParam(name = "adminId", type = HttpParamType.ADMIN_ID, description = "管理员ID") Long adminId) throws ServiceException;
|
|
|
@HttpMethod(description = "查询", permission = "promotion:coupon:list", permissionParentName = "推广管理", permissionName = "优惠管理")
|
public Page<CouponAdminDTO> list(
|
@HttpParam(name = "title", type = HttpParamType.COMMON, description = "优惠卷标题") String title,
|
@HttpParam(name = "type", type = HttpParamType.COMMON, description = "优惠卷类型") Integer type,
|
@HttpParam(name = "status", type = HttpParamType.COMMON, description = "优惠卷状态") Integer status,
|
@HttpParam(name = "pageNo", type = HttpParamType.COMMON, description = "页码", valueDef = "1") Integer pageNo,
|
@HttpParam(name = "limit", type = HttpParamType.COMMON, description = "页码长度", valueDef = "10") Integer limit,
|
@NotNull @HttpParam(name = "adminId", type = HttpParamType.ADMIN_ID, description = "管理员ID") Long adminId) throws ServiceException;
|
|
}
|
