package com.xiaopeng.maintenance.service;

import com.xiaopeng.api.model.maintenance.XpChargingRecord;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiaopeng.maintenance.model.query.XpChargingRecordPageQuery;
import com.xiaopeng.common.core.web.page.PageInfo;
import com.xiaopeng.maintenance.dto.XpChargingRecordStartDTO;
import com.xiaopeng.maintenance.dto.XpChargingRecordStopDTO;
import com.xiaopeng.maintenance.model.vo.XpChargingRecordVO;
import com.xiaopeng.maintenance.vo.ChargingStatusVO;

import java.io.UnsupportedEncodingException;

/**
 * <p>
 * 车辆充电记录 服务类
 * </p>
 *
 * @author mitao
 * @since 2026-02-03
 */
public interface IXpChargingRecordService extends IService<XpChargingRecord> {

    /**
     * 车辆充电开始
     *
     * @param dto
     * @param id
     */
    void startCharging(XpChargingRecordStartDTO dto, Long id);

    /**
     * 充电结束
     *
     * @param dto
     * @param id
     */
    XpChargingRecord stopCharging(XpChargingRecordStopDTO dto, Long id);

    /**
     * 充电记录详情
     *
     * @param id
     * @return
     */
    XpChargingRecordVO chargingDetail(Long id) throws UnsupportedEncodingException;

    /**
     * 通过车辆ID查询充电记录分页列表(内部接口)
     *
     * @param query 查询参数
     * @return 充电记录分页列表
     */
    PageInfo<XpChargingRecordVO> queryChargingByVehicleId(XpChargingRecordPageQuery query);

    /**
     * 根据ID删除充电记录
     * @param id
     */
    void deleteRecordById(Long id);

    /**
     * 查询充电状态
     * @param vehicleId
     * @return
     */
    ChargingStatusVO queryChargingStatus(Long vehicleId);
}