progress.md 4.3 KB

SDD ledger — plan: 会员体系从硬编码迁移到数据库(feature/membership-benefits-db)

规格来源:用户对话中的【已确认方案】(单表 + 权益 JSON,非规范化三表)。 分支:feature/membership-benefits-db(基于 origin/cfclub,非主干)。 禁止:git add .;push 前 fetch + rebase;不新增 DB 迁移除非文档要求;不自行合并 cfclub。

待办

  • Task 1: 数据库迁移(schema.sql + DatabaseInitializer 迁移 432/433/434:旧表改名 bak、新表建一行一等级、回填标量+benefits JSON)
  • Task 2: 实体 MembershipBenefits.java 扩展全量字段
  • Task 3: Mapper MembershipBenefitsMapper 新增自定义方法(selectByLevelCode/upsert/updateStatus)
  • Task 4: DTO MembershipLevelDTO 新增 icon/bgColor/status/benefits/maxDailyAnalyze/autoUpgradeThreshold/durationDays/sortOrder/createdAt/updatedAt
  • Task 5: Service MembershipService 全面改读新表(getAllLevels/getCurrentLevel/hasPermission/resolveMembershipAmount/createOrder/createOrderWithPayType/buildWechatFallbackParams/grantMembershipByGift/getLevelOrder/getVisibleMemberLevelCodes/getBenefitsByLevel/getMembershipCompareData/checkAndAutoUpgrade;删除 131400L 硬编码 → resolveAutoUpgradeThreshold)
  • Task 6: 其他读 membership_levels 的服务迁移到新表(ProductGiftService/ProductGiftRuleService/ReportAnalyzeQuotaService/AdminController user-update 等级校验)
  • Task 7: Controller:MembershipController /benefits 返回类型改 List;新建 MembershipBenefitItemDTO;AdminController /membership/levels,/level/update 改读新表(update 支持新增=插行)+ 新增 /membership/level/update-status
  • Task 8: mvn -DskipTests compile 通过(exit 0);路由重复检查无新增冲突
  • Task 9: git commit + push -u origin feature/membership-benefits-db(fetch + rebase 前置)
  • 裁决记录(Ruling)

    • 回填跳过 PROVIDER(不插入新表,getLevelOrder('PROVIDER') 回退 1,与现状一致)。
    • benefits JSON 元素用 camelCase 键(benefitCode/benefitName/benefitDesc/icon/bgColor/included/value/sortOrder)以兼容前端。
    • level 级 icon/bg_color 用等级默认值;FAMILY auto_upgrade_threshold=131400,其余 NULL;duration_days:BASIC=30,FAMILY/PREMIUM=365,FREE/LIFETIME=NULL。
    • MembershipBenefits 实体移除旧字段 benefitCode/benefitName/benefitDesc(新表无此列),getBenefitsByLevel 改为解析 benefits JSON。
    • Task 7 调整(避免路由重复):不新建独立 AdminMembershipController(其 /level/list、/level/save 会与 AdminController 现有 /membership/levels、/membership/level/update 语义重复);改为:
      • AdminController /membership/levels 改读新表(返回 List)
      • AdminController /membership/level/update 改读新表(按 id/levelCode 定位;无 id 且新 levelCode = 新增插一行;非空字段部分覆盖)
      • AdminController 新增 /membership/level/update-status(levelCode+status 启停用,用 mapper.updateStatus)
      • 现有 cfc-web 调用 /api/membership/levels(MembershipController,返回 List)与 /api/admin/membership/level/update 保持不变(响应兼容)。
      • Task 9 前不跑 cfc-web npm run build:未改动任何 cfc-web/ cfc-frontend 源码;且 cfc-web prebuild 会跑 bump-version + generate-changelog(产生非本次变更)。响应契约向后兼容(benefits DTO 保留 benefitCode/benefitName/benefitDesc/icon/bgColor;compare rows 保留 name+小写列 key;levels DTO 为旧字段超集)。

      扩展兼容性记录

      • 前端 benefits.vue 读取 benefitCode/benefitName/benefitDesc/icon/bgColor;getBenefitsByLevel 返回的 JSON 元素映射为这些 camelCase 字段(MembershipBenefitItemDTO),并自行过滤 NO_BENEFIT/UPGRADE_HINT。
      • 前端 index.vue/upgrade.vue 读取 compare rows 的 name/free/basic/family/premium(小写列 key);动态聚合行保留该结构。
      • cfc-web MembershipCenter.vue 编辑表单字段与 MembershipBenefits 实体字段一致(id/levelCode/levelName/levelDesc/levelOrder/price/original/maxChildren/maxTasksPerDay/aiReviewEnabled/prioritySupport/teacherConsultation/features);update 非空覆盖,不会清空 icon/bgColor/status/benefits 等未提交字段。