package com.moral.api.service;

import com.moral.api.entity.RadarHourlySummary;
import com.baomidou.mybatisplus.extension.service.IService;
import com.moral.api.vo.ComparisonResponse;
import com.moral.api.vo.HourlyResponse;

/**
 * <p>
 * 雷达小时汇总表 服务类
 * </p>
 *
 * @author moral
 * @since 2026-09-08
 */
public interface RadarHourlySummaryService extends IService<RadarHourlySummary> {

    /**
     * 处理指定小时的数据
     * @return 处理结果摘要
     */
    void processHour(String hourStart);

    /**
     * 处理上一完整小时（自动计算）
     */
    void processLastHour();

    /**
     * 获取当前值与近30天对比数据
     *
     * @param location 位置，如"苏州"
     * @param time     请求时间，如"2026-09-09 09:00:00"，取前一整点（8:00）作为 current
     */
    ComparisonResponse getComparison(String location, String time);

    /**
     * 获取指定时间范围内每小时的雷达数据
     *
     * @param location  位置
     * @param startTime 起始时间（包含）
     * @param endTime   结束时间（不包含）
     */
    HourlyResponse getHourly5Days(String location, String startTime, String endTime);
}