fix: 统一学习会话结算并修正结束幂等

This commit is contained in:
2026-10-09 10:48:12 +08:00
parent 04d1f40c6c
commit d8c8b76c32
6 changed files with 409 additions and 25 deletions
@@ -0,0 +1,36 @@
package com.guo.learningprogresstracker.common;
/**
* 学习会话的时间口径常量。
*
* <p>番茄钟长度、遗忘判定阈值与有效时间下限集中在此处定义,避免阈值散落在实体与服务的各个角落。
* 修改口径时只改这里,不要就地写死数字。</p>
*/
public final class StudyTimePolicy {
/**
* 番茄钟长度(分钟)。
*/
public static final int WORK_DURATION_MINUTES = 25;
/**
* 番茄钟长度(毫秒)。
*/
public static final long WORK_DURATION_MILLIS = WORK_DURATION_MINUTES * 60_000L;
/**
* 遗忘判定阈值(分钟):2 × 番茄钟。
*
* <p>最后一段学习在超过该时长后仍没有任何操作,判定为「忘了点暂停/结束」,
* 该段只按一个番茄钟结算(见 {@code StudySessionsEntity#resolveSettlementTime})。</p>
*/
public static final int FORGET_THRESHOLD_MINUTES = WORK_DURATION_MINUTES * 2;
/**
* 有效学习时间下限(秒):低于该值的一次学习不计入总学习时间。
*/
public static final long MIN_EFFECTIVE_TIME_SECONDS = 10 * 60L;
private StudyTimePolicy() {
}
}