生成:2026-10-31 22:0x · 基于廖总 5 项拍板 基座:origin/cfclub =
865017a2d(最新)
| # | 决策点 | 拍板 |
|---|---|---|
| 1 | 等级金额通道形态 | ✅ params_json.levels[levelCode] 显式值(可审计) |
| 2 | 等级档位 | ✅ 动态读 membership_levels 表 |
| 3 | F11 里程碑(B1/B2) | ✅ 本次一并迁移到 DB |
| 4 | points 写死(P1–P3) | ✅ 修(P3 bug 顺手) |
| 5 | 数值矩阵 | ✅ FAMILY=非会员×2,PREMIUM=非会员×5(非原设计 0.5/1.0/1.5) |
| 规则 | 打卡内容 | 类型 | 当前 amount | params_json 现状 | 调用方 |
|---|---|---|---|---|---|
| F05 | 活动签到 | per_item | 活动配置 platform_points | {"source":"activities.platform_points"} |
ActivityService:450 |
| F07 | 文章答题 | formula | score+全对3 | {"bonus_all_correct":3} |
CfPathwayEarnService.earnArticleQuizCf |
| F08 | AI阅读答题 | fixed | 5 | {"require_all_correct":true} |
CfPathwayEarnService.earnAiReadingQuizCf |
| F14 | 喝水打卡 | fixed | 5 | {"daily_limit_by_tier":"cf_earn_daily_limit"} |
未接调用方 ❌ |
| F15 | 饮食打卡 | fixed | 5 | {"daily_limit_by_tier":"cf_earn_daily_limit"} |
未接调用方 ❌ |
| F16 | 每日健康打卡 | fixed | 10 | {"daily_limit_by_tier":"cf_earn_daily_limit"} |
DailyCheckinService:80 ✅ |
⚠️ F14/F15 规则已建(DatabaseInitializer 种子),但无调用方——打卡服务只发 points 积分,未接 CF。F05/F07/F08 已有调用。
cf_earn_daily_limit 表:FREE=1 / BASIC=3 / FAMILY=10 / LIFETIME=10 / PREMIUM=20(仅 F14/F15/F16/F22 命中)CfBalanceServiceImpl.computeAmount():不读等级——无论 FREE 还是 PREMIUM,单次金额相同InviteMilestoneService.MILESTONE_TIERS(L40-43)静态硬编码:INVITE_3={3,200,20} / INVITE_5={5,500,50} / INVITE_10={10,1000,100}AdminMilestoneController.MILESTONE_CONFIGS 同值静态副本config() 返回静态值,updateConfig() 只改 status=PENDING 行(DB 无种子则无效)int points=5(读 sys_config health_checkin_points 覆盖,默认 5 写死)int points=5(读 finance_checkin_points 覆盖,默认 5 写死)int points=5 + 误读 health_checkin_points 键(应为 micro 专用键)文件:cfc-backend/src/main/java/com/etotem/cfc/service/impl/CfBalanceServiceImpl.java
改动:
computeAmount() 末尾,在 base = base * resolveMultiplier(params) 之前,增加等级金额覆盖:
// 等级金额通道:params_json.levels[levelCode] 优先,缺省回落 rule.amount
double levelAmount = resolveLevelAmount(rule, levelCode, params);
if (levelAmount > 0) {
base = levelAmount;
}
base = base * resolveMultiplier(params);
新增私有方法:
private double resolveLevelAmount(CfEarnRule rule, String levelCode, Map<String, Object> params) {
if (params == null || levelCode == null) return 0;
Object levels = params.get("levels");
if (!(levels instanceof Map)) return 0;
Map<String, Object> levelsMap = (Map<String, Object>) levels;
Object val = levelsMap.get(levelCode);
if (val == null) val = levelsMap.get("NONE"); // fallback to NONE
if (val == null) return 0;
try { return Double.parseDouble(String.valueOf(val)); } catch (Exception e) { return 0; }
}
resolveLevelCode() 不变(已实现,读 membership_levels 动态档位)
验收:
CfBalanceServiceImplLevelAmountTest,断言:
文件:cfc-web/src/views/admin/CfRuleConfig.vue
改动:
ruleType === 'fixed' 时显示)paramsJson.levels(JSON.stringify)等级列表来源:
/api/admin/membership/levels(若存在)[{code:"NONE",label:"非会员"},{code:"FAMILY",label:"FAMILY"},{code:"PREMIUM",label:"PREMIUM"}]验收:
{"levels":{"NONE":2,"FAMILY":4,"PREMIUM":10}}文件:cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java
改动:迁移419(新增):
-- 为打卡类规则补 levels 默认值(幂等 UPDATE,仅改 params_json 列)
UPDATE cf_earn_rule SET params_json = JSON_MERGEREPLACE(
COALESCE(params_json, '{}'),
'{"levels":{"NONE":2,"FAMILY":4,"PREMIUM":10}}'
) WHERE code IN ('F14','F15','F16');
UPDATE cf_earn_rule SET params_json = JSON_MERGEREPLACE(
COALESCE(params_json, '{}'),
'{"levels":{"NONE":1,"FAMILY":2,"PREMIUM":5}}'
) WHERE code IN ('F05','F07','F08');
矩阵数值(廖总拍板 FAMILY=非会员×2 / PREMIUM=非会员×5):
- F14/F15(喝水/饮食):NONE=2, FAMILY=4, PREMIUM=10
- F16(每日健康):NONE=5, FAMILY=10, PREMIUM=25
- F05/F07/F08(活动/文章/AI答题):NONE=1, FAMILY=2, PREMIUM=5
验收:
现状:
invite_milestone 表结构:id, user_id, milestone(ENUM 'INVITE_3/5/10'), reward_points, reward_energy, status(PENDING/CLAIMED), achieved_at, claimed_at, created_atInviteMilestoneService.checkMilestones() 每达成时 INSERT 用户实例(正确)改动:
-- invite_milestone_template 表(模板,不是 invite_milestone 实例表)
CREATE TABLE IF NOT EXISTS invite_milestone_template (
id INT AUTO_INCREMENT PRIMARY KEY,
milestone VARCHAR(20) NOT NULL UNIQUE, -- INVITE_3/5/10
target_count INT NOT NULL,
reward_points INT NOT NULL,
reward_energy INT NOT NULL,
enabled TINYINT(1) NOT NULL DEFAULT 1,
sort_order INT NOT NULL DEFAULT 0,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
INDEX idx_milestone (milestone)
) COMMENT='邀请里程碑模板(管理端可配)';
-- 种子
INSERT IGNORE INTO invite_milestone_template (milestone, target_count, reward_points, reward_energy, sort_order) VALUES
('INVITE_3', 3, 200, 20, 1),
('INVITE_5', 5, 500, 50, 2),
('INVITE_10', 10, 1000, 100, 3);
MILESTONE_TIERS 静态字段checkMilestones() 改用 inviteMilestoneTemplateMapper.selectAll() 遍历模板config() 改查 invite_milestone_template 表updateConfig() 改 UPDATE invite_milestone_template(status 条件去掉,直接 by milestone)/api/admin/milestone/template GET 列表,/api/admin/milestone/template/save POST 保存/api/admin/milestone/template/save验收:
T5-A: HealthCheckinService:92
int points = 5 改 int points = 5(保留,但读 sys_config 后覆盖)T5-B: FinanceCheckinService:70
T5-C: MicroActionService:237 误读键修正
sysConfigService.getValue("health_checkin_points") 改为 sysConfigService.getValue("micro_checkin_points")insertSysConfigSeed("micro_checkin_points", "5", "微小行动打卡积分")验收:
现状:F14/F15 规则已建,但无调用方。
改动:
{"levels":{"NONE":1,"FAMILY":2,"PREMIUM":5}}{"levels":{"NONE":1,"FAMILY":2,"PREMIUM":5}}验收:
| 编号 | 验收项 | 方式 |
|---|---|---|
| AC-01 | computeAmount 按 levels[levelCode] 覆盖 base | 单测 |
| AC-02 | CfRuleConfig.vue 规则编辑含等级矩阵,保存合法 JSON | 手动 |
| AC-03 | 存量库迁移419 后 F14/F15/F16/F05/F07/F08 含 levels | SQL 查询 |
| AC-04 | invite_milestone_template 表种子 3 行 | SQL 查询 |
| AC-05 | 管理端修改 F11 里程碑 reward_points 落库 | 手动 |
| AC-06 | MicroAction 打卡积分读 micro_checkin_points | 日志/数据库 |
| AC-07 | HealthCheckin/FinanceCheckin 打卡成功后 CF 发放 | 测试库实测 |
| AC-08 | 等级差异化:同打卡,FAMILY 得 2×,PREMIUM 得 5× | 测试库实测 |
| AC-09 | 编译三端 PASS | mvn compile + npm build |
| AC-10 | 无 P0 回归(原有打卡/CF 功能正常) | 冒烟测试 |