ebike-share/ebike-operate/src/main/java/com/cdzy/ebikeoperate/service/EbikeSiteRegionService.java

package com.cdzy.ebikeoperate.service;

import com.cdzy.common.model.PageParam;
import com.cdzy.ebikeoperate.model.dto.request.ReqBatchRegionDto;
import com.cdzy.ebikeoperate.model.dto.request.ReqSiteRegionDto;
import com.cdzy.ebikeoperate.model.dto.response.ResEbikeSiteRegionInfoDto;
import com.cdzy.ebikeoperate.model.dto.response.ResEbikeSiteRegionPageDto;
import com.cdzy.ebikeoperate.model.pojo.EbikeSiteRegion;
import com.mybatisflex.core.paginate.Page;
import com.mybatisflex.core.service.IService;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 站点配置表 服务层。
 *
 * @author attiya
 * @since 2025-04-29
 */
public interface EbikeSiteRegionService extends IService<EbikeSiteRegion> {

    /**
     * 生成站点
     * @param regionDto 站点信息
     */
    void createSiteRegion(ReqSiteRegionDto regionDto,List<MultipartFile> files) throws Exception;

    /**
     * 修改站点
     * @param regionDto 站点信息
     */
    void updateSiteRegion(ReqSiteRegionDto regionDto,List<MultipartFile> files) throws Exception;

    /**
     * 批量删除站点
     * @param delRegionDto id集合
     */
    void delSite(ReqBatchRegionDto delRegionDto);

    /**
     * 获取当前用户授权的所有站点
     * @param regionId 运营区ID
     * @return 站点列表
     */
    List<ResEbikeSiteRegionPageDto> listByToken(Long regionId);

    /**
     * 获取站点详情
     * @param siteRegionId 站点ID
     * @return 详情
     */
    ResEbikeSiteRegionInfoDto siteInfo(Long siteRegionId);

    /**
     * 分页查询站点
     * @param pageParam 分页参数
     * @param operationRegionId 运营区id
     * @param zoneId 行政区id
     * @param siteName 站点名称
     * @return 分页列表
     */
    Page<ResEbikeSiteRegionPageDto> pageSite(PageParam pageParam, Long operationRegionId, String zoneId, String siteName);
}