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.BikeUsageStatVO;
|
import com.doumee.dao.business.vo.DashboardVO;
|
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.vo.PackageSourceStatVO;
|
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);
|
|
/**
|
* 近30天收益统计(固定30天,无需入参):按日柱状图 + 累计 + 环比/同比。
|
* <p>口径同 {@link #incomeStat},内部以 dateType=3(近30天)调用。
|
*
|
* @return 近30天收益统计结果
|
*/
|
IncomeStatVO incomeStat30();
|
|
/**
|
* 车辆使用情况:自行车/电动车各自的使用中(status=1)与空闲(status=0)数量。
|
* <p>禁用车辆(status=3)不计入。
|
*
|
* @return 车辆使用情况
|
*/
|
BikeUsageStatVO bikeUsageStat();
|
|
/**
|
* 套餐销售来源统计:本月/本年维度下,抖音兑换(payWay=2)与小程序购买(payWay=0)的套餐数。
|
* <p>口径:goodsorder type=1 套餐卡购买、payStatus=1 已支付。
|
*
|
* @return 套餐销售来源统计
|
*/
|
PackageSourceStatVO packageSourceStat();
|
|
/**
|
* 综合看板:本月/昨日/今日收益与订单数、车辆总数/使用中/空闲,客户数相关暂搁置。
|
*
|
* @return 综合看板数据
|
*/
|
DashboardVO dashboard();
|
}
|
