package com.mzl.flower.service.district;

import com.baomidou.mybatisplus.extension.service.IService;
import com.mzl.flower.dto.request.district.CreateDistrictTengxunDTO;
import com.mzl.flower.dto.response.district.DistrictTengxunVO;
import com.mzl.flower.dto.response.system.AreaDTO;
import com.mzl.flower.entity.district.DistrictTengxunDO;

import java.util.List;

/**
 * <p>
 * 对接高德地图行政区划 服务类
 * </p>
 *
 * @author @TaoJie
 * @since 2024-12-19
 */
public interface DistrictTengxunService extends IService<DistrictTengxunDO> {

    void removeAllDistricts();

    void refreshDistrict();

    /**
     * 获取所有的行政区划列表
     * @return
     */
    List<DistrictTengxunDO> getAllDistrict();

    /**
     * 从数据库里面获取
     * @return
     */
    List<AreaDTO> getAreaDTOListByDB();

    /**
     * 从JSON文件里面获取
     * @return
     */
    List<AreaDTO> getAreaDTOListByJsonFile();


    /**
     * 将远程的数据保存入库
     * @param districtTengxunDOList
     */
    void saveRemoteDistricts(List<DistrictTengxunDO> districtTengxunDOList);

    List<DistrictTengxunVO> getDistrictTreeList();

    /**
     * 创建行政区
     * @param dto
     * @return
     */
    boolean createDistrict(CreateDistrictTengxunDTO dto);

    /**
     * 删除行政区划及所有下级
     * @param id
     * @return
     */
    boolean deleteDistrict(String id);

    boolean updateDistrict(CreateDistrictTengxunDTO dto);

    String getChineseArea();

    void clearChineseDataCache();

    String getChineseAreaForApp();

    String getChineseAreaForWeb();
}