金币设置要求

金币比例与注意事项（当前比例：100 金币 = 1 元）

• 当前统一比例：100 金币 = 1 元（示例：6 元 ≈ 600 金币；9.9 元 ≈ 990 金币）
• 金币为整数，不支持小数；所有换算与奖励请确保最终为整数
• 比例变更将影响：商品金币标价、活动奖励金币、会员充值返还金币、金币充值商品面额，需整体联动校准，并且定好了之后就不允许进行大比例调整

金币获取渠道（“获得金币”的地方）

• 任务/活动（H5 我的金币页）
  • 签到（type=11）：奖励金币（额度按活动规则配置）
  • 看广告得金币（type=12）：观看广告后发放金币
  • 邀请好友（type=13）：成功邀请（即新用户绑定了老用户的邀请码）后奖励金币（按规则被邀请的用户也会奖励金币）
  • 阅读时长分档奖励（type=14）：达成分钟节点奖励对应金币
  • 其他活动：以活动配置为准（目前h5还没有实现，后期可上线其它特殊的金币活动）
• 金币充值商品（type=2）：现金购买金币（RMB→金币按比例发放）
• 会员充值返还金币（ReturnCoins）：购买会员时按商品配置返还固定金币（注意与商品售价的比例一致性，比如30元返50%金币即1500）

金币使用场景（“使用金币”的地方）

• 购买会员商品（当该会员商品允许金币支付且 coins>0 时）
• 兑换虚拟商品（type=3）：仅支持金币支付
• 其他金币消耗项：以业务后续扩展为准（统一走 CoinTransaction 记录）

配置与联动建议

• 商品金币定价
  • 会员商品：如开启金币支付（coins>0），建议 coins ≈ 现金价(元) × 100
  • 虚拟商品：仅金币兑换，coins 为唯一支付价，需结合实际成本与库存
  • 金币充值商品（type=2）：面额与比例应严格对应（示例：6元→600金币；1元/100金币为最小单元）
• 活动金币奖励
  • 看广告/阅读时长/签到/邀请等规则里的 coins 建议以“金额×100”思维配置，避免与充值比例脱节
  • 设定每日/总奖励上限，防刷与成本控制
• 会员充值返还金币（ReturnCoins）
  • 返还金币建议与会员售价形成可解释的比例（如返还约价×5%×100）
  • 避免返还过高引发套利（用返还金币兑换其他虚拟商品）
• 库存与额度
  • 虚拟商品库存使用商品表 stock，发券时乐观锁扣减，避免并发超卖
  • 活动奖励建议有频控/日上限；奖励失败与补发策略需可追溯
• 精度与四舍五入
  • 货币→金币：现金(元)×100，保证结果为整数；涉及折扣时先在金额侧算净额再×100，统一向下取整或四舍五入需定标准
• 审计与风控
  • 所有增减金币都会记录金币记录日志 CoinTransaction（类型：充值/消耗/兑换/返还等），含余额前后与备注

常见问题与排查

• 金币不一致：检查比例换算、折扣顺序（先折扣后换算）、四舍五入规则是否一致
• 可兑换但无卡券：检查商品 stock 与实际可用卡券池是否同步；发券失败日志；乐观锁冲突重试
• 套利风险：返还金币过高或活动奖励叠加，建议叠加总上限与黑名单策略
• 数据校验：定期核对金币总账（交易流水聚合=余额变动），商品库存与未使用卡券一致性

变更比例时的操作清单

• 校准以下配置与代码中的金币数值：
  • 商品 coins（会员/虚拟/金币充值）与价格映射
  • 活动奖励金币（签到、广告、阅读、邀请等）
  • 会员充值返还金币（ReturnCoins）
• 回归测试
  • 订单创建/支付（现金与金币）
  • 兑换发券与库存扣减（并发）
  • 活动奖励发放与上限
  • 金币流水审计
• 风险提示
  • 比例调整前先评估历史商品与活动配置的影响范围，避免“金币通胀/通缩”体验突变
  • 如需“过渡期”，可临时保留旧值兼容，逐步切换新比例