import request from './request' /** * 统计相关 API * 注:统计接口定义在 TransactionStatisticsController 中 */ // ===== 新统一接口(推荐使用) ===== /** * 按日期范围获取每日统计(新统一接口) * @param {Object} params - 查询参数 * @param {string} params.startDate - 开始日期(包含)格式: YYYY-MM-DD * @param {string} params.endDate - 结束日期(不包含)格式: YYYY-MM-DD * @param {string} [params.savingClassify] - 储蓄分类(可选,不传则使用系统配置) * @returns {Promise<{success: boolean, data: Array}>} * @returns {Array} data - 每日统计列表 * @returns {number} data[].day - 日期(天) * @returns {number} data[].count - 交易笔数 * @returns {number} data[].expense - 支出金额 * @returns {number} data[].income - 收入金额 * @returns {number} data[].saving - 储蓄金额 */ export const getDailyStatisticsByRange = (params) => { return request({ url: '/TransactionStatistics/GetDailyStatisticsByRange', method: 'get', params }) } /** * 按日期范围获取汇总统计(新统一接口) * @param {Object} params - 查询参数 * @param {string} params.startDate - 开始日期(包含)格式: YYYY-MM-DD * @param {string} params.endDate - 结束日期(不包含)格式: YYYY-MM-DD * @returns {Promise<{success: boolean, data: Object}>} * @returns {Object} data.totalExpense - 总支出 * @returns {Object} data.totalIncome - 总收入 * @returns {Object} data.balance - 结余 * @returns {Object} data.expenseCount - 支出笔数 * @returns {Object} data.incomeCount - 收入笔数 * @returns {Object} data.totalCount - 总笔数 */ export const getSummaryByRange = (params) => { return request({ url: '/TransactionStatistics/GetSummaryByRange', method: 'get', params }) } /** * 按日期范围获取分类统计(新统一接口) * @param {Object} params - 查询参数 * @param {string} params.startDate - 开始日期(包含)格式: YYYY-MM-DD * @param {string} params.endDate - 结束日期(不包含)格式: YYYY-MM-DD * @param {number} params.type - 交易类型 (0:支出, 1:收入, 2:不计入收支) * @returns {Promise<{success: boolean, data: Array}>} * @returns {Array} data - 分类统计列表 * @returns {string} data[].classify - 分类名称 * @returns {number} data[].amount - 金额 * @returns {number} data[].percent - 百分比 * @returns {number} data[].count - 交易笔数 */ export const getCategoryStatisticsByRange = (params) => { return request({ url: '/TransactionStatistics/GetCategoryStatisticsByRange', method: 'get', params }) } /** * 获取趋势统计数据 * @param {Object} params - 查询参数 * @param {number} params.startYear - 开始年份 * @param {number} params.startMonth - 开始月份 * @param {number} [params.monthCount=6] - 月份数量,默认6个月 * @returns {Promise<{success: boolean, data: Array}>} * @returns {Array} data - 趋势统计列表 * @returns {number} data[].year - 年份 * @returns {number} data[].month - 月份 * @returns {number} data[].expense - 支出金额 * @returns {number} data[].income - 收入金额 */ export const getTrendStatistics = (params) => { return request({ url: '/TransactionStatistics/GetTrendStatistics', method: 'get', params }) } // ===== 旧接口(保留用于向后兼容,建议迁移到新接口) ===== /** * 获取月度统计数据 * @deprecated 请使用 getSummaryByRange * @param {Object} params - 查询参数 * @param {number} params.year - 年份 * @param {number} params.month - 月份 * @returns {Promise<{success: boolean, data: Object}>} */ export const getMonthlyStatistics = (params) => { return request({ url: '/TransactionStatistics/GetMonthlyStatistics', method: 'get', params }) } /** * 获取分类统计数据 * @deprecated 请使用 getCategoryStatisticsByRange * @param {Object} params - 查询参数 * @param {number} params.year - 年份 * @param {number} params.month - 月份 * @param {number} params.type - 交易类型 (0:支出, 1:收入, 2:不计入收支) * @returns {Promise<{success: boolean, data: Array}>} */ export const getCategoryStatistics = (params) => { return request({ url: '/TransactionStatistics/GetCategoryStatistics', method: 'get', params }) } /** * 按日期范围获取分类统计数据 * @deprecated 请使用 getCategoryStatisticsByRange(DateTime 参数版本) * @param {Object} params - 查询参数 * @param {string} params.startDate - 开始日期 (格式: YYYY-MM-DD) * @param {string} params.endDate - 结束日期 (格式: YYYY-MM-DD) * @param {number} params.type - 交易类型 (0:支出, 1:收入, 2:不计入收支) * @returns {Promise<{success: boolean, data: Array}>} */ export const getCategoryStatisticsByDateRange = (params) => { return request({ url: '/TransactionStatistics/GetCategoryStatisticsByDateRange', method: 'get', params }) } /** * 获取指定月份每天的消费统计 * @deprecated 请使用 getDailyStatisticsByRange * @param {Object} params - 查询参数 * @param {number} params.year - 年份 * @param {number} params.month - 月份 * @returns {Promise<{success: boolean, data: Array}>} */ export const getDailyStatistics = (params) => { return request({ url: '/TransactionStatistics/GetDailyStatistics', method: 'get', params }) } /** * 获取累积余额统计数据(用于余额卡片) * @deprecated 请使用 getDailyStatisticsByRange 并在前端计算累积余额 * @param {Object} params - 查询参数 * @param {number} params.year - 年份 * @param {number} params.month - 月份 * @returns {Promise<{success: boolean, data: Array}>} */ export const getBalanceStatistics = (params) => { return request({ url: '/TransactionStatistics/GetBalanceStatistics', method: 'get', params }) } /** * 获取指定周范围的每天的消费统计 * @deprecated 请使用 getDailyStatisticsByRange * @param {Object} params - 查询参数 * @param {string} params.startDate - 开始日期 (yyyy-MM-dd) * @param {string} params.endDate - 结束日期 (yyyy-MM-dd) * @returns {Promise<{success: boolean, data: Array}>} */ export const getWeeklyStatistics = (params) => { return request({ url: '/TransactionStatistics/GetWeeklyStatistics', method: 'get', params }) } /** * 获取指定日期范围的统计汇总数据 * @deprecated 请使用 getSummaryByRange * @param {Object} params - 查询参数 * @param {string} params.startDate - 开始日期 (yyyy-MM-dd) * @param {string} params.endDate - 结束日期 (yyyy-MM-dd) * @returns {Promise<{success: boolean, data: Object}>} */ export const getRangeStatistics = (params) => { return request({ url: '/TransactionStatistics/GetRangeStatistics', method: 'get', params }) }