package com.guo.learningprogresstracker.service.review;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.guo.learningprogresstracker.dto.ReviewSummary;
import com.guo.learningprogresstracker.dto.ReviewTaskStats;
import com.guo.learningprogresstracker.dto.TaskContentCount;
import com.guo.learningprogresstracker.dto.TaskSessionStats;
import com.guo.learningprogresstracker.dto.recall.TaskRecallDuration;
import com.guo.learningprogresstracker.entity.TaskEntity;
import com.guo.learningprogresstracker.mapper.ReviewRecallMapper;
import com.guo.learningprogresstracker.mapper.StudyReportFragmentsMapper;
import com.guo.learningprogresstracker.mapper.StudyReportsMapper;
import com.guo.learningprogresstracker.mapper.StudySessionsMapper;
import com.guo.learningprogresstracker.mapper.TasksMapper;
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.stream.Collectors;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Component;
import org.springframework.util.StringUtils;
/**
* 复习统计数据(总览与任务维度)。
*
*
口径与 feed 列表一致:报告按「报告 → 会话 → 任务」归属,碎片按内容归属(归属-01)。
* 聚合一律下推到 SQL(数据-02),返回行数与任务数同阶。
*/
@Component
@RequiredArgsConstructor
public class ReviewStatsService {
private final StudyReportsMapper studyReportsMapper;
private final StudyReportFragmentsMapper studyReportFragmentsMapper;
private final StudySessionsMapper studySessionsMapper;
private final TasksMapper tasksMapper;
private final ReviewRecallMapper newRecallMapper;
public ReviewSummary summary() {
// 口径必须与 /review/tasks 的列表一致(列表逐页相加 == 这里的汇总):
// 报告按「报告 → 会话 → 任务」归属,碎片按内容归属(owner_task_num)统计。
// 不能用裸表的 selectCount:那样「学习残片」会把待归类碎片也算进来,
// 与列表逐页相加的结果对不上(待归类在总览里有独立区块展示)。
return new ReviewSummary(
tasksMapper.selectCount(null),
studyReportsMapper.countOwnedReports(),
studyReportFragmentsMapper.countOwnedFragments());
}
public Page getReviewTaskStats(int pageNum, int pageSize, String markerName) {
// 点标签即筛选:过滤下推到 SQL(EXISTS 子查询),由数据库一次算出命中任务并分页;
// 不再「先查全部命中对象号、再拼 IN 回查」——命中量大时 IN 会膨胀。
IPage taskPage;
if (StringUtils.hasText(markerName)) {
taskPage = tasksMapper.selectPageByMarker(new Page<>(pageNum, pageSize), markerName.trim());
} else {
taskPage = tasksMapper.selectPage(
new Page<>(pageNum, pageSize),
Wrappers.lambdaQuery()
.orderByDesc(TaskEntity::getCalculatedPriority)
// 优先级相同的任务之间要有稳定次序,否则翻页会重复或漏掉
.orderByDesc(TaskEntity::getId));
}
List stats =
taskPage.getRecords().stream().map(this::newTaskStats).collect(Collectors.toList());
// 聚合只算这一页的任务,不再对全部任务做 IN 聚合
fillReviewTaskStats(stats);
Page result = new Page<>(taskPage.getCurrent(), taskPage.getSize(), taskPage.getTotal());
result.setRecords(stats);
return result;
}
/** 一批任务一次取齐:逐任务调用会把 4 条聚合乘以任务数。 */
public List getReviewTaskStats(Collection taskNums) {
if (taskNums == null || taskNums.isEmpty()) {
return List.of();
}
Map names = new LinkedHashMap<>();
for (TaskEntity task : tasksMapper.selectList(
Wrappers.lambdaQuery().in(TaskEntity::getTaskNum, taskNums))) {
names.put(task.getTaskNum(), task.getTaskName());
}
List stats = new ArrayList<>();
for (String taskNum : new LinkedHashSet<>(taskNums)) {
stats.add(newTaskStats(taskNum, names.get(taskNum)));
}
fillReviewTaskStats(stats);
return stats;
}
public ReviewTaskStats getReviewTaskStats(String taskNum) {
TaskEntity task = tasksMapper
.selectList(Wrappers.lambdaQuery()
.eq(TaskEntity::getTaskNum, taskNum)
.last("LIMIT 1"))
.stream()
.findFirst()
.orElse(null);
ReviewTaskStats stats = newTaskStats(taskNum, task == null ? null : task.getTaskName());
fillReviewTaskStats(Collections.singletonList(stats));
return stats;
}
/**
* 填充任务维度统计(数据-02):三类聚合(会话统计、报告数、碎片数)全部下推到 SQL,
* 每次查询只返回「任务数」量级的行,不随历史会话/内容条数线性增长。
*/
private void fillReviewTaskStats(List statsList) {
Map statsByTaskNum = statsList.stream()
.filter(item -> StringUtils.hasText(item.getTaskNum()))
.collect(Collectors.toMap(ReviewTaskStats::getTaskNum, item -> item, (a, b) -> a, LinkedHashMap::new));
if (statsByTaskNum.isEmpty()) {
return;
}
Set taskNums = statsByTaskNum.keySet();
LocalDateTime todayStart = LocalDate.now().atStartOfDay();
LocalDateTime weekStart = LocalDate.now().with(DayOfWeek.MONDAY).atStartOfDay();
for (TaskSessionStats row : studySessionsMapper.sumStudyStatsByTask(taskNums, todayStart, weekStart)) {
ReviewTaskStats stats = statsByTaskNum.get(row.getTaskNum());
if (stats == null) {
continue;
}
long sessionCount = row.getSessionCount() == null ? 0L : row.getSessionCount();
stats.setSessionCount(sessionCount);
stats.setEffectiveTime(nullToZero(row.getEffectiveTime()));
stats.setTodayEffectiveTime(nullToZero(row.getTodayEffectiveTime()));
stats.setWeekEffectiveTime(nullToZero(row.getWeekEffectiveTime()));
if (sessionCount > 0) {
stats.setAvgEffectiveTime(stats.getEffectiveTime() / sessionCount);
stats.setAvgEffectivenessRatio(nullToZero(row.getEffectivenessRatioSum()) / sessionCount);
}
}
fillContentCounts(statsByTaskNum, taskNums);
fillReviewDuration(statsByTaskNum);
}
/** 报告数与碎片数:同样在 SQL 侧按内容归属分组计数 */
private void fillContentCounts(Map statsByTaskNum, Set taskNums) {
for (TaskContentCount row : studyReportsMapper.countReportsByTask(taskNums)) {
ReviewTaskStats stats = statsByTaskNum.get(row.getTaskNum());
if (stats != null) {
stats.setReportCount(row.getContentCount() == null ? 0L : row.getContentCount());
}
}
for (TaskContentCount row : studyReportFragmentsMapper.countFragmentsByTask(taskNums)) {
ReviewTaskStats stats = statsByTaskNum.get(row.getTaskNum());
if (stats != null) {
stats.setFragmentCount(row.getContentCount() == null ? 0L : row.getContentCount());
}
}
}
private static double nullToZero(Double value) {
return value == null ? 0D : value;
}
/** Current free recall duration is aggregated from the single-current-draft table. */
private void fillReviewDuration(Map statsByTaskNum) {
if (statsByTaskNum.isEmpty()) {
return;
}
for (TaskRecallDuration row : newRecallMapper.sumTaskDuration(statsByTaskNum.keySet())) {
ReviewTaskStats stats = statsByTaskNum.get(row.getTaskNum());
if (stats != null && row.getActiveDurationMs() != null) {
stats.setReviewDurationSeconds(stats.getReviewDurationSeconds() + row.getActiveDurationMs() / 1000);
}
}
}
private ReviewTaskStats newTaskStats(TaskEntity task) {
return newTaskStats(task.getTaskNum(), task.getTaskName());
}
private ReviewTaskStats newTaskStats(String taskNum, String taskName) {
ReviewTaskStats stats = new ReviewTaskStats();
stats.setTaskNum(taskNum);
stats.setTaskName(taskName);
return stats;
}
}