package com.doumee.service.business;

import com.doumee.core.model.PageData;
import com.doumee.core.model.PageWrap;
import com.doumee.dao.business.vo.BikeIncomeStatVO;
import com.doumee.dao.business.vo.IncomeStatVO;
import com.doumee.dao.business.vo.OperationCenterVO;
import com.doumee.dao.business.vo.OperationOrderVO;
import com.doumee.dao.business.vo.OrderRidesDetailVO;
import com.doumee.dao.business.vo.OverviewStatVO;
import com.doumee.dao.business.web.request.BikeIncomeQueryDTO;
import com.doumee.dao.business.web.request.OperationOrderQueryDTO;

import java.util.List;

/**
 * 数据报表 Service(web 端:概览统计 + 收入车型分析)。
 *
 * @author rk
 * @date 2026/06/26
 */
public interface ReportService {

    /**
     * 概览统计:总注册用户、今日新增用户、自行车数量、电动车数量。
     *
     * @return 概览统计
     */
    OverviewStatVO overview();

    /**
     * 收入车型分析:按时段(近7/15/30天或自定义)按车型型号汇总已结算订单收入。
     *
     * @param query 时段查询入参(dateType 与自定义起止)
     * @return 车型收入列表(按收入降序)
     */
    List<BikeIncomeStatVO> bikeIncome(BikeIncomeQueryDTO query);

    /**
     * 收入统计:按时段(近7/15/30天或自定义)按日统计已结算订单收入(柱状图),
     * 并给出区间累计收入及环比、同比对比数据。
     *
     * @param query 时段查询入参(dateType 与自定义起止)
     * @return 收入统计结果(每日明细 + 累计收入 + 环比/同比)
     */
    IncomeStatVO incomeStat(BikeIncomeQueryDTO query);

    /**
     * 运营中心数据:今日订单总数、进行中订单数、今日套餐收入、今日总收入,
     * 以及今日日期与星期几(登录人姓名由 Controller 从登录态注入)。
     *
     * @return 运营中心数据
     */
    OperationCenterVO operationCenter();

    /**
     * 运营中心订单查询:按订单类型(骑行记录类型)/手机号/订单状态分页查询押金订单。
     *
     * @param pageWrap 分页与查询条件(bikeType/phone/status)
     * @return 订单分页数据
     */
    PageData<OperationOrderVO> operationOrderPage(PageWrap<OperationOrderQueryDTO> pageWrap);

    /**
     * 订单骑行记录 + 轨迹:查询指定订单下全部骑行记录,电车挂轨迹点,自行车提示无轨迹。
     *
     * @param orderId 支付订单主键 goodsorder.id(member_rides.ordre_id)
     * @return 骑行记录与轨迹详情(含车辆类型、是否有轨迹、骑行列表及每条下挂的轨迹点)
     */
    OrderRidesDetailVO orderRidesDetail(String orderId);
}