|
|
@@ -254,4 +254,102 @@ public class GrowthPlanService {
|
|
|
plan.setUpdatedAt(new Date());
|
|
|
return growthPlanMapper.updateById(plan) > 0;
|
|
|
}
|
|
|
+
|
|
|
+ /** 草稿默认有效期 7 天(SC-P-81 边界:草稿有效期) */
|
|
|
+ private static final long DRAFT_VALIDITY_MS = 7L * 24L * 3600_000L;
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 存草稿(SC-P-81 正常流:计划创建前暂存未完,能力键 plan.draft.save)。
|
|
|
+ *
|
|
|
+ * <p>持久化 {@code status="draft"};设置 {@code draftExpiresAt = now + 7 天}(有效期边界);
|
|
|
+ * 并发存两版草稿:{@code draftVersion} 递增,后存覆盖前存(TC-P-81-E 冲突检测依据)。
|
|
|
+ * 已有 id 为更新(版本号+1,后存覆盖),无 id 为新建。</p>
|
|
|
+ */
|
|
|
+ public GrowthPlan saveDraft(GrowthPlan plan) {
|
|
|
+ if (plan.getStatus() == null || !"draft".equals(plan.getStatus())) {
|
|
|
+ plan.setStatus("draft");
|
|
|
+ }
|
|
|
+ plan.setDraftExpiresAt(new Date(System.currentTimeMillis() + DRAFT_VALIDITY_MS));
|
|
|
+ if (plan.getId() != null) {
|
|
|
+ GrowthPlan existing = growthPlanMapper.selectById(plan.getId());
|
|
|
+ if (existing != null) {
|
|
|
+ plan.setDraftVersion((existing.getDraftVersion() != null ? existing.getDraftVersion() : 0) + 1);
|
|
|
+ } else {
|
|
|
+ plan.setDraftVersion(1);
|
|
|
+ }
|
|
|
+ plan.setCreatedAt(existing != null ? existing.getCreatedAt() : new Date());
|
|
|
+ plan.setUpdatedAt(new Date());
|
|
|
+ growthPlanMapper.updateById(plan);
|
|
|
+ } else {
|
|
|
+ plan.setDraftVersion(1);
|
|
|
+ plan.setCreatedAt(new Date());
|
|
|
+ plan.setUpdatedAt(new Date());
|
|
|
+ growthPlanMapper.insert(plan);
|
|
|
+ }
|
|
|
+ return plan;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 恢复草稿继续编辑(SC-P-81 正常流,能力键 plan.draft.save)。
|
|
|
+ *
|
|
|
+ * <p>草稿不存在返回 null;已超有效期抛 {@link IllegalStateException}『草稿已失效』
|
|
|
+ * (TC-P-81-E 异常流提示);有效期内返回可继续编辑的草稿(status 保持 draft)。</p>
|
|
|
+ */
|
|
|
+ public GrowthPlan restoreDraft(Long draftId) {
|
|
|
+ GrowthPlan plan = growthPlanMapper.selectById(draftId);
|
|
|
+ if (plan == null) {
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+ if (isDraftExpired(plan)) {
|
|
|
+ throw new IllegalStateException("草稿已失效");
|
|
|
+ }
|
|
|
+ return plan;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 权限恢复(SC-P-81-P 越权拒绝,不泄露他人草稿,能力键 plan.draft.save)。
|
|
|
+ *
|
|
|
+ * <p>归属判定:{@code userId} 须等于草稿创建人 {@code teacherId}(方案由
|
|
|
+ * 规划师/家长创建,创建人即归属方)。非归属 → 抛 {@link IllegalStateException}
|
|
|
+ *『无权限』(403 拒绝,不返回他人草稿);归属 → 恢复,过期则抛『草稿已失效』。</p>
|
|
|
+ */
|
|
|
+ public GrowthPlan restoreDraft(Long draftId, Long userId) {
|
|
|
+ GrowthPlan plan = growthPlanMapper.selectById(draftId);
|
|
|
+ if (plan == null) {
|
|
|
+ // 方案不存在:统一 403 口径拒绝,不泄露任何草稿信息
|
|
|
+ throw new IllegalStateException("无权限:草稿不存在");
|
|
|
+ }
|
|
|
+ if (userId == null || !userId.equals(plan.getTeacherId())) {
|
|
|
+ throw new IllegalStateException("无权限");
|
|
|
+ }
|
|
|
+ if (isDraftExpired(plan)) {
|
|
|
+ throw new IllegalStateException("草稿已失效");
|
|
|
+ }
|
|
|
+ return plan;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 草稿是否已超有效期({@code draftExpiresAt < now},TC-P-81-E『草稿已失效』判定)。
|
|
|
+ * 无有效期记录的存量草稿视为未过期(安全默认,不阻断历史数据恢复)。
|
|
|
+ */
|
|
|
+ public boolean isDraftExpired(GrowthPlan draft) {
|
|
|
+ if (draft == null || draft.getDraftExpiresAt() == null) {
|
|
|
+ return false;
|
|
|
+ }
|
|
|
+ return draft.getDraftExpiresAt().getTime() < System.currentTimeMillis();
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 并发检测(TC-P-81-E:后存覆盖前存且提示冲突)。
|
|
|
+ *
|
|
|
+ * <p>服务端已存版本 > 本地版本 → 冲突(true,提示用户重新拉取);
|
|
|
+ * 本地版本 ≥ 服务端版本 → 无冲突(false)。草稿不存在时返回 false(无版本可比对)。</p>
|
|
|
+ */
|
|
|
+ public boolean isDraftVersionConflict(Long draftId, long localVersion) {
|
|
|
+ GrowthPlan plan = growthPlanMapper.selectById(draftId);
|
|
|
+ if (plan == null || plan.getDraftVersion() == null) {
|
|
|
+ return false;
|
|
|
+ }
|
|
|
+ return plan.getDraftVersion() > localVersion;
|
|
|
+ }
|
|
|
}
|