Murmur Phase 2 开发完成：积分系统 + 邀请码机制

概述

Murmur 会员体系 Phase 2 核心功能已全部开发完成并通过测试。本次更新在 Phase 1 的 VIP 等级体系基础上，引入了积分经济和邀请码机制，形成"行为产生积分 → 积分消费邀请码 → 邀请新用户 → 双方获得奖励"的增长闭环。

新增功能

1. 全局设置系统 (SiteSettings)

• 新增 site_settings 表（KV 结构），支持 30+ 项管理员可配置参数
• 涵盖：注册设置、邀请码设置、积分规则、VIP 购买、实时动态间隔等
• 管理后台新增完整的站点设置页面，分 5 个区块展示
• 所有核心参数均可在后台实时调整，无需改代码

2. 邀请码机制 (InviteCode)

• 邀请码格式：murmur_inv_ + 16字符随机hex（128位熵，不可猜测）
• VIP 等级门控：V2+ 用户才能生成邀请码，V1 禁止
• 积分消耗：不同等级消耗不同积分（V5/admin 免费生成）
• 每人限 1 张 active 邀请码：被使用后方可再次生成
• 过期机制：管理员可配置有效期天数（0 = 永不过期）
• 注册集成：支持强制邀请码注册或可选填写
• 邀请奖励：邀请人和被邀请人均可获得积分奖励（可配置开关和数额）
• 管理后台：新增邀请码管理页，支持查看全部邀请码和撤销操作

3. 积分系统 (Points)

• 新增 points_log 表，完整审计每一笔积分变动
• 积分触发：
  • 发帖 +5 分
  • 回复 +2 分
  • 帖子获赞 +3 分（作者获得）
  • 回复获赞 +1 分（作者获得）
  • 创建辩论 +10 分
• 幂等保护：同一实体不会重复计分（投票使用 postId:voterId 复合键）
• 每日上限：默认 200 分/天，达到上限后行为正常但不再产生积分
• 积分购买 VIP：预留接口，管理员可开启积分购买 VIP 等级功能

4. Controller 集成

• 注册流程改造：邀请码预验证 → 事务包裹（注册 + 核销 + 奖励发放），失败全回滚
• 第一个用户（owner）自动跳过邀请码，确保首次部署可用
• API 积分触发：createPost、createReply、votePost、voteReply、createDebate 各端点均植入积分触发
• 管理后台：设置保存（白名单过滤 + checkbox 默认值处理）、邀请码撤销

5. UI 更新

• 注册页：新增邀请码输入框（根据设置控制必填/选填）
• 用户 Dashboard：积分余额 + 邀请码面板（生成按钮 + 列表）
• 管理后台：新增「站点设置」和「邀请码管理」两个完整页面
• 管理导航：增加设置和邀请码入口

数据库变更

新建表

表字段变更

新增路由

新增文件

测试覆盖

全部 93 条测试断言通过（0 失败）：

• test_membership_models.php：59 条断言

  • SiteSettings：CRUD、seedDefaults、类型转换
  • InviteCode：生成、VIP 门控、积分扣减、核销、过期、撤销、active 限制
  • Points：award、deduct、幂等、每日上限截断、余额不足、VIP 购买

• test_phase2_controller.php：34 条断言

  • 注册 + 邀请码验证 + 奖励发放
  • 积分触发（发帖/回复/投票/辩论）
  • 设置更新（白名单过滤 + checkbox 处理）
  • 邀请码撤销、过期预验证

待开发（Step 9-10）

• Step 9：扣分机制（管理员手动扣分接口）
• Step 10：积分购买 VIP 等级（Dashboard 购买入口 + 积分扣减）

设计亮点

1. 事务完整性：注册 + 邀请码核销 + 奖励发放在同一事务中，任何环节失败全部回滚
2. 幂等设计：投票积分使用 postId:voterId 复合键，确保多人投同一帖各自独立 + 同人重复不计分
3. 管理员零配置启动：所有设置都有默认值（seedDefaults），系统即装即用
4. 第一用户特殊处理：首位注册用户自动成为 owner，跳过邀请码要求
5. 全局可配：30+ 项策略参数全部通过后台 UI 动态调整，不碰代码

完整技术规格书见 MEMBERSHIP_SPEC.md v1.3。