rentease-app/api/bill.js

/**
 * 账单管理模块 API
 */

import { get, post, put, del } from '../utils/request.js'

export default {
  /**
   * 获取账单列表
   * @param {Object} params - 查询参数
   * @param {number} params.page - 页码
   * @param {number} params.pageSize - 每页数量
   * @param {string} params.type - 类型筛选 income/expense
   * @param {string} params.status - 状态筛选 unpaid/partial/paid/cancelled
   * @param {string} params.startDate - 开始日期
   * @param {string} params.endDate - 结束日期
   * @returns {Promise}
   */
  getList(params = {}) {
    return get('/bills/list', params)
  },

  /**
   * 获取所有账单（与Web端兼容的别名方法）
   * @param {Object} params - 查询参数
   * @returns {Promise}
   */
  getAll(params = {}) {
    return get('/bills', params)
  },

  /**
   * 获取账单详情
   * @param {number} id - 账单ID
   * @returns {Promise}
   */
  getDetail(id) {
    return get(`/bills/${id}`)
  },

  /**
   * 创建账单
   * @param {Object} data - 账单数据
   * @returns {Promise}
   */
  create(data) {
    return post('/bills', data)
  },

  /**
   * 更新账单
   * @param {number} id - 账单ID
   * @param {Object} data - 账单数据
   * @returns {Promise}
   */
  update(id, data) {
    return put(`/bills/${id}`, data)
  },

  /**
   * 删除账单
   * @param {number} id - 账单ID
   * @returns {Promise}
   */
  delete(id) {
    return del(`/bills/${id}`)
  },

  /**
   * 标记账单已支付
   * @param {number} id - 账单ID
   * @returns {Promise}
   */
  markPaid(id) {
    return post(`/bills/${id}/pay`)
  },

  /**
   * 获取账单统计
   * @param {Object} params - 查询参数
   * @returns {Promise}
   */
  getStatistics(params = {}) {
    return get('/bills/statistics', params)
  },

  /**
   * 账单收款
   * @param {number} billId - 账单ID
   * @param {Object} data - 支付数据
   * @returns {Promise}
   */
  receivePayment(billId, data) {
    return post(`/bill-payments/bill/${billId}`, data)
  },

  /**
   * 删除支付记录
   * @param {number} paymentId - 支付记录ID
   * @returns {Promise}
   */
  deletePayment(paymentId) {
    return del(`/bill-payments/${paymentId}`)
  },

  /**
   * 获取账单支付记录
   * @param {number} billId - 账单ID
   * @returns {Promise}
   */
  getPayments(billId) {
    return get(`/bill-payments/bill/${billId}`)
  }
}