import { http } from '../../utils/request';

// ==================== 行政区域服务 ====================

/**
 * 获取所有省份 (带缓存)
 * @returns {Promise<Array<{
 *   id: number,
 *   code: string,
 *   name: string,
 *   parentCode: string
 * }>>}
 */
export const regionProvincesGet = () => {
    return http.get('/region/provinces');
};

/**
 * 根据省份代码获取城市列表 (带缓存)
 * @param {Object} params - 查询参数
 * @param {string} params.provincecode - 省份代码
 * @returns {Promise<Array<{
 *   id: number,
 *   code: string,
 *   name: string,
 *   parentCode: string
 * }>>}
 */
export const regionCitiesbyprovinceGet = (params) => {
    return http.get('/region/citiesbyprovince', { params });
};

/**
 * 根据城市代码获取区县列表 (带缓存)
 * @param {Object} params - 查询参数
 * @param {string} params.citycode - 城市代码
 * @returns {Promise<Array<{
 *   id: number,
 *   code: string,
 *   name: string,
 *   parentCode: string
 * }>>}
 */
export const regionDistrictsbycityGet = (params) => {
    return http.get('/region/districtsbycity', { params });
};

/**
 * 分页查询省份信息
 * @param {Object} data - 查询参数
 * @param {number} [data.pageNo] - 当前页码
 * @param {number} [data.pageSize] - 每页条数
 * @param {string} [data.name] - 省份名称 (模糊查询)
 * @param {string} [data.code] - 省份代码
 * @returns {Promise<{
 *   pageNo: number,
 *   pageSize: number,
 *   pages: number,
 *   total: number,
 *   rows: Array<{
 *     id: number,
 *     code: string,
 *     name: string,
 *     parentCode: string
 *   }>
 * }>}
 */
export const regionPageProvincesPost = (data) => {
    return http.post('/region/page/provinces', data);
};

/**
 * 添加省份
 * @param {Object} data - 省份信息
 * @param {number} [data.id] - 省份ID (编辑时传)
 * @param {string} data.code - 省份代码
 * @param {string} data.name - 省份名称
 * @param {string} [data.parentCode] - 父级代码 (省份的父级代码通常为空)
 */
export const regionProvincePost = (data) => {
    return http.post('/region/province', data);
};

/**
 * 更新省份
 * @param {Object} data - 省份信息
 * @param {number} data.id - 省份ID
 * @param {string} data.code - 省份代码
 * @param {string} data.name - 省份名称
 * @param {string} [data.parentCode] - 父级代码
 */
export const regionProvincePut = (data) => {
    return http.put('/region/province', data);
};

/**
 * 删除省份
 * @param {Object} params - 删除参数
 * @param {number} params.id - 省份ID
 */
export const regionProvinceDelete = (params) => {
    return http.delete('/region/province', { params });
};