package com.example.cattletends.service;

import com.example.cattletends.dto.ProvinceDataDTO;
import com.example.cattletends.entity.CattleProvince;

import java.util.List;
import java.util.Map;

/**
 * 省份数据服务接口
 */
public interface CattleProvinceService {

    /**
     * 导入省份数据
     * 更新或创建各省份的存栏出栏量和省份均价，并计算全国总量
     *
     * @param provinceDataList 省份数据列表
     * @return 导入结果（包含更新的数据数量和全国总量）
     */
    Map<String, Object> importProvinceData(List<ProvinceDataDTO> provinceDataList);

    /**
     * 获取所有省份数据（按省份均价降序排序）
     *
     * @param province 可选的省份名称，如果提供则只返回该省份数据
     * @return 省份数据列表
     */
    List<CattleProvince> getAllProvinceData(String province);

    /**
     * 根据省份名称获取数据
     *
     * @param province 省份名称
     * @return 省份数据
     */
    CattleProvince getProvinceDataByName(String province);
}

