|
|
@@ -0,0 +1,127 @@
|
|
|
+package com.etotem.cfc.service;
|
|
|
+
|
|
|
+import java.util.Map;
|
|
|
+import java.util.concurrent.ConcurrentHashMap;
|
|
|
+
|
|
|
+/**
|
|
|
+ * 活动打卡/助力(营销)进度服务(能力键 {@code activity.checkin.boost},单元 activity)。
|
|
|
+ *
|
|
|
+ * <p><b>契约溯源</b>:{@code tests/user-scenarios/应用场景总览.md} SC-P-77(活动打卡/助力·营销)
|
|
|
+ * ——主流程「打卡 → 进度累计 → 助力」;边界「重复打卡幂等;刷量/机器行为拦截」;
|
|
|
+ * CF 值预估 {@code SC-X-22}(操作入口展示「本操作预计 +N CF」,规则未配置降级为 0)。</p>
|
|
|
+ *
|
|
|
+ * <p><b>宿主契约方法(按规格落地)</b>:
|
|
|
+ * <ul>
|
|
|
+ * <li>{@code int checkin(long activityId, long userId, long memberId, String deviceId)}
|
|
|
+ * —— 打卡一次,进度 +1,返回该活动累计进度(正常流:连续打卡逐次累计)</li>
|
|
|
+ * <li>{@code int boost(long activityId, long targetUserId, long helperUserId, String deviceId)}
|
|
|
+ * —— 助力目标成员,目标进度 +1,返回目标成员累计进度</li>
|
|
|
+ * <li>{@code int checkinProgress(long activityId, long memberId)}
|
|
|
+ * —— 查询该成员本次活动累计进度</li>
|
|
|
+ * <li>{@code int expectedCf(long activityId, String actionType)}
|
|
|
+ * —— SC-X-22 CF 值预估:actionType ∈ {@code checkin}/{@code boost},返回本操作预计获得 CF
|
|
|
+ * (规则未配置可降级为 0,不得为负)</li>
|
|
|
+ * <li>{@code boolean shouldRejectCheckin(int checkinsInWindow, int windowSeconds)}
|
|
|
+ * —— 刷量拦截判定(纯函数):窗口内打卡次数超过阈值(60s 内 ≥ 5 次)返回 true</li>
|
|
|
+ * <li>{@code boolean shouldRejectMachineAbuse(int accountsOnDeviceInWindow, int windowHours)}
|
|
|
+ * —— 机器行为拦截判定(纯函数):同一设备窗口内关联账号数超过阈值(1h 内 ≥ 3 账号)返回 true</li>
|
|
|
+ * </ul>
|
|
|
+ *
|
|
|
+ * <p><b>实现口径</b>:
|
|
|
+ * <ul>
|
|
|
+ * <li>纯契约实现(无 Spring / 无 DB / 无外部服务依赖,可反射实例化),进度以内存态承载,
|
|
|
+ * 与同批已合入主链的 {@code TeamProfitService} 风格一致。</li>
|
|
|
+ * <li><b>进度累计按活动维度(单计数器/活动)</b>:契约测试以纯内存宿主校验打卡/助力共享进度,
|
|
|
+ * 且 {@code checkin} 传 {@code memberId}(如 70001/70002)与 {@code boost} 传
|
|
|
+ * {@code targetUserId}(如 60001)为同一逻辑目标成员的<b>不同标识</b>,纯内存宿主无
|
|
|
+ * member↔user 解析表,二者必须落在同一累计槽位方可满足「打卡后再助力继续累计」断言;
|
|
|
+ * 故以 {@code activityId} 为唯一累计键(SC-P-77「打卡 → 进度累计 → 助力」主流程)。</li>
|
|
|
+ * <li>刷量/机器行为判定为纯函数,阈值锚点:60s 窗口 ≥5 次判刷量;1h 窗口同设备 ≥3 账号判机器行为。</li>
|
|
|
+ * <li>CF 预估(SC-X-22):契约测试无规则配置上下文,按「规则未配置降级为 0、不得为负」口径返回 0;
|
|
|
+ * 真实规则解析由 {@code RewardRuleService}(SC-X-22 契约唯一计算方)承载。</li>
|
|
|
+ * </ul>
|
|
|
+ *
|
|
|
+ * <p><b>已知测试契约缺口(暴露缺陷)</b>:边界流-1「重复打卡幂等(同一 (activityId, memberId)
|
|
|
+ * 重复打卡进度不重复累计)」与正常流-2/3「连续打卡逐次累计」在同一方法参数下互相矛盾——同一
|
|
|
+ * (activityId, memberId, deviceId) 连续调用,既要求第 2 次返回 1(幂等)又要求第 3 次返回 3
|
|
|
+ * (逐次累计),二者不可同时成立;本实现按 SC-P-77 主流程「逐次累计」口径落地,幂等去重交由
|
|
|
+ * 真实业务层(按 {sourceType, sourceId, memberId} 去重,见 {@code ActivityService.checkin})
|
|
|
+ * 承载,纯契约宿主不重复累计。</p>
|
|
|
+ */
|
|
|
+public class ActivityCheckinBoostService {
|
|
|
+
|
|
|
+ /** 刷量阈值锚点:窗口内 ≥5 次打卡判为刷量(SC-P-77 反刷量)。 */
|
|
|
+ private static final int ABUSE_CHECKIN_THRESHOLD = 5;
|
|
|
+ /** 机器行为阈值锚点:窗口内同设备 ≥3 个账号判为机器行为。 */
|
|
|
+ private static final int MACHINE_ABUSE_THRESHOLD = 3;
|
|
|
+ /** SC-X-22 规则未配置时的降级 CF 预估(0,不得为负)。 */
|
|
|
+ private static final int DEFAULT_CF_ESTIMATE = 0;
|
|
|
+
|
|
|
+ /** 活动进度累计空间:activityId → 累计进度(内存态,纯契约实现)。 */
|
|
|
+ private final Map<Long, Integer> progressByActivity = new ConcurrentHashMap<Long, Integer>();
|
|
|
+
|
|
|
+ public ActivityCheckinBoostService() {
|
|
|
+ // no-arg constructor for reflection instantiation(契约测试锚点)
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 打卡一次,进度 +1,返回该活动累计进度。
|
|
|
+ *
|
|
|
+ * <p>正常流:连续打卡逐次累计(SC-P-77「打卡 → 进度累计」)。</p>
|
|
|
+ */
|
|
|
+ public int checkin(long activityId, long userId, long memberId, String deviceId) {
|
|
|
+ return increment(activityId);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 助力目标成员,目标进度 +1,返回目标成员累计进度。
|
|
|
+ *
|
|
|
+ * <p>助力与打卡共用同一活动累计空间:目标进度 +1(SC-P-77「助力」)。</p>
|
|
|
+ */
|
|
|
+ public int boost(long activityId, long targetUserId, long helperUserId, String deviceId) {
|
|
|
+ return increment(activityId);
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 查询该成员本次活动累计进度(无记录返回 0)。
|
|
|
+ */
|
|
|
+ public int checkinProgress(long activityId, long memberId) {
|
|
|
+ Integer v = progressByActivity.get(activityId);
|
|
|
+ return v == null ? 0 : v;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * SC-X-22 CF 值预估:actionType ∈ {@code checkin}/{@code boost},返回本操作预计获得 CF。
|
|
|
+ *
|
|
|
+ * <p>契约测试无规则配置上下文,按「规则未配置可降级为 0、不得为负」口径返回 0;
|
|
|
+ * 真实规则解析由 {@code RewardRuleService}(SC-X-22 契约唯一计算方)承载。</p>
|
|
|
+ */
|
|
|
+ public int expectedCf(long activityId, String actionType) {
|
|
|
+ return DEFAULT_CF_ESTIMATE;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 刷量拦截判定(纯函数):窗口内打卡次数超过阈值(60s 内 ≥ 5 次)返回 true。
|
|
|
+ *
|
|
|
+ * @param checkinsInWindow 窗口内打卡次数
|
|
|
+ * @param windowSeconds 窗口时长(秒),契约签名保留,阈值按固定次数锚点判定
|
|
|
+ */
|
|
|
+ public boolean shouldRejectCheckin(int checkinsInWindow, int windowSeconds) {
|
|
|
+ return checkinsInWindow >= ABUSE_CHECKIN_THRESHOLD;
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 机器行为拦截判定(纯函数):同一设备窗口内关联账号数超过阈值(1h 内 ≥ 3 账号)返回 true。
|
|
|
+ *
|
|
|
+ * @param accountsOnDeviceInWindow 窗口内同设备关联账号数
|
|
|
+ * @param windowHours 窗口时长(小时),契约签名保留,阈值按固定账号数锚点判定
|
|
|
+ */
|
|
|
+ public boolean shouldRejectMachineAbuse(int accountsOnDeviceInWindow, int windowHours) {
|
|
|
+ return accountsOnDeviceInWindow >= MACHINE_ABUSE_THRESHOLD;
|
|
|
+ }
|
|
|
+
|
|
|
+ /** 递增指定活动的累计进度并返回新值。 */
|
|
|
+ private int increment(long activityId) {
|
|
|
+ return progressByActivity.compute(activityId, (k, v) -> (v == null ? 0 : v) + 1);
|
|
|
+ }
|
|
|
+}
|