PromotionRules.php 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170
  1. <?php
  2. namespace App\Support;
  3. use Illuminate\Support\Facades\Validator;
  4. use Illuminate\Validation\ValidationException;
  5. final class PromotionRules
  6. {
  7. public const LOSS = 7;
  8. public const FIRST_DEPOSIT = 8;
  9. public const WHEEL = 9;
  10. public const UPGRADE_INVITE = 10;
  11. /** Fixed campaigns have exactly one row: edited in place, never created. */
  12. public const FIXED = [self::LOSS, self::WHEEL, self::UPGRADE_INVITE];
  13. public const TASKS = ['online', 'login', 'invite', 'deposit', 'team_deposit', 'bet', 'team_bet'];
  14. public const DAILY = ['online', 'login'];
  15. public const PRIZES = ['0-666', '100', '50', '200', '350', '500', '150', '366'];
  16. public const ORDINARY_POOL_RULE = '未完成本轮全部任务时,普通抽奖最多累计至600。任务完成后,未命中666时按剩余差额和达成概率控制单次奖额。可用奖项等概率,固定奖项按面额发放。';
  17. public const REWARD_MODES = ['cash', 'coupon'];
  18. public const COUPON_CATEGORIES = ['self:sport', 'self:lottery'];
  19. private const COUPON_KEYS = ['reward_mode', 'coupon_valid_from', 'coupon_valid_until', 'coupon_categories', 'inviter_coupons', 'invitee_coupons'];
  20. public static function supports(int $type): bool { return in_array($type, [7, 8, 9, 10], true); }
  21. public static function types(): array { return [7 => '净亏邀请奖励', 8 => '首充奖励', 9 => '转盘活动', 10 => '邀请升级奖励']; }
  22. public static function defaults(int $type): array
  23. {
  24. // Upgrade invite pays straight to the available balance, so it has no turnover ratio.
  25. if ($type === self::UPGRADE_INVITE) return ['tiers' => []];
  26. $common = ['turnover_ratio' => '0.00'];
  27. return $common + match ($type) {
  28. 7 => ['loss_amount' => '500.00', 'invite_count' => 3, 'reward_amount' => '500.00', 'reward_mode' => 'cash',
  29. 'coupon_valid_from' => null, 'coupon_valid_until' => null, 'coupon_categories' => [], 'inviter_coupons' => [], 'invitee_coupons' => []],
  30. 8 => ['min_deposit' => '100.00', 'reward_amount' => '10.00'],
  31. 9 => ['completion_probability' => '20.00', 'online_seconds' => 3600,
  32. 'deposit_amount' => '3000.00', 'team_deposit_amount' => '500.00',
  33. 'bet_amount' => '5000.00', 'team_bet_amount' => '3000.00'],
  34. default => [],
  35. };
  36. }
  37. public static function normalize(int $type, array $input): array
  38. {
  39. $defaults = self::defaults($type);
  40. Validator::make(['params' => $input], ['params' => ['array:' . implode(',', array_keys($defaults))]])->validate();
  41. $data = array_replace($defaults, $input);
  42. if ($type === self::UPGRADE_INVITE) return ['tiers' => self::tiers($data['tiers'])];
  43. $coupon = array_intersect_key($data, array_flip(self::COUPON_KEYS));
  44. $data = array_diff_key($data, $coupon);
  45. $rules = [];
  46. foreach ($data as $key => $value) {
  47. $rules[$key] = match ($key) {
  48. 'invite_count' => ['required', 'integer', 'min:1', 'max:1000'],
  49. 'online_seconds' => ['required', 'integer', 'min:60', 'max:86400'],
  50. 'completion_probability' => ['required', 'numeric', 'between:0,100', 'regex:/^\d{1,3}(\.\d{1,2})?$/'],
  51. 'turnover_ratio' => ['required', 'numeric', 'between:0,10000', 'regex:/^\d{1,5}(\.\d{1,2})?$/'],
  52. default => ['required', 'numeric', 'gt:0', 'regex:/^\d{1,12}(\.\d{1,2})?$/'],
  53. };
  54. }
  55. Validator::make($data, $rules)->validate();
  56. foreach ($data as $key => $value) $data[$key] = in_array($key, ['invite_count', 'online_seconds'], true) ? (int)$value : bcadd((string)$value, '0', 2);
  57. return $coupon ? $data + self::coupons($coupon, $data['reward_amount']) : $data;
  58. }
  59. /** Coupon settings stay well-formed in cash mode so switching modes keeps them; completeness is enforced only in coupon mode. */
  60. private static function coupons(array $input, string $rewardAmount): array
  61. {
  62. $invalid = fn (string $message) => throw ValidationException::withMessages(['params' => $message]);
  63. $mode = $input['reward_mode'];
  64. if (!is_string($mode) || !in_array($mode, self::REWARD_MODES, true)) $invalid('reward_mode参数错误');
  65. $data = ['reward_mode' => $mode];
  66. foreach (['coupon_valid_from', 'coupon_valid_until'] as $key) {
  67. $value = $input[$key];
  68. if ($value === null || $value === '') { $data[$key] = null; continue; }
  69. $time = is_string($value) ? \DateTimeImmutable::createFromFormat('!Y-m-d H:i:s', $value) : false;
  70. if (!$time || $time->format('Y-m-d H:i:s') !== $value) $invalid($key . '参数错误');
  71. $data[$key] = $value;
  72. }
  73. $categories = $input['coupon_categories'];
  74. if (!is_array($categories) || array_diff($categories, self::COUPON_CATEGORIES) || count(array_unique($categories)) !== count($categories)) {
  75. $invalid('coupon_categories参数错误');
  76. }
  77. $data['coupon_categories'] = array_values(array_intersect(self::COUPON_CATEGORIES, $categories));
  78. foreach (['inviter_coupons', 'invitee_coupons'] as $key) {
  79. $tiers = $input[$key];
  80. if (!is_array($tiers) || array_values($tiers) !== $tiers || count($tiers) > 10) $invalid($key . '参数错误');
  81. $data[$key] = [];
  82. foreach ($tiers as $tier) {
  83. if (!is_array($tier) || array_diff(array_keys($tier), ['min_amount', 'discount', 'quantity']) || count($tier) !== 3) $invalid($key . '参数错误');
  84. foreach (['min_amount', 'discount'] as $field) {
  85. if (!is_numeric($tier[$field]) || !preg_match('/^\d{1,12}(\.\d{1,2})?$/', (string)$tier[$field])) $invalid($key . '参数错误');
  86. }
  87. $quantity = is_scalar($tier['quantity']) ? filter_var($tier['quantity'], FILTER_VALIDATE_INT) : false;
  88. $min = bcadd((string)$tier['min_amount'], '0', 2); $discount = bcadd((string)$tier['discount'], '0', 2);
  89. if (bccomp($discount, '0', 2) <= 0 || bccomp($min, $discount, 2) < 0 || $quantity === false || $quantity < 1 || $quantity > 100) {
  90. $invalid($key . '参数错误:抵扣金额须大于0且不高于使用门槛,份数为1至100');
  91. }
  92. $data[$key][] = ['min_amount' => $min, 'discount' => $discount, 'quantity' => $quantity];
  93. }
  94. }
  95. if ($data['coupon_valid_from'] !== null && $data['coupon_valid_until'] !== null && $data['coupon_valid_until'] <= $data['coupon_valid_from']) {
  96. $invalid('优惠券结束时间必须晚于开始时间');
  97. }
  98. if ($mode === 'coupon') {
  99. if (!$data['inviter_coupons']) $invalid('请至少配置一档邀请人优惠券');
  100. if (bccomp(self::faceValue($data['inviter_coupons']), $rewardAmount, 2) > 0) $invalid('优惠券抵扣总额不能超过奖励金额');
  101. if ($data['coupon_valid_from'] === null || $data['coupon_valid_until'] === null) $invalid('请填写优惠券可用时间');
  102. if (!$data['coupon_categories']) $invalid('请选择优惠券可用游戏类型');
  103. }
  104. return $data;
  105. }
  106. /** Upgrade tiers: one bonus per share level reached, distinct levels from 2 up, sorted by level. */
  107. public static function tiers($tiers): array
  108. {
  109. $invalid = fn (string $message) => throw ValidationException::withMessages(['params' => $message]);
  110. if (!is_array($tiers) || array_values($tiers) !== $tiers || count($tiers) > 50) $invalid('tiers参数错误:最多50档');
  111. $data = [];
  112. foreach ($tiers as $tier) {
  113. if (!is_array($tier) || array_diff(array_keys($tier), ['level', 'amount']) || count($tier) !== 2) $invalid('tiers参数错误:每档须包含level和amount');
  114. $level = is_scalar($tier['level']) ? filter_var($tier['level'], FILTER_VALIDATE_INT) : false;
  115. if ($level === false || $level < 2) $invalid('tiers参数错误:等级须为2及以上的整数');
  116. if (isset($data[$level])) $invalid('tiers参数错误:等级' . $level . '重复');
  117. if (!is_numeric($tier['amount']) || !preg_match('/^\d{1,12}(\.\d{1,2})?$/', (string)$tier['amount']) || bccomp((string)$tier['amount'], '0', 2) <= 0) {
  118. $invalid('tiers参数错误:奖励金额须大于0且最多两位小数');
  119. }
  120. $data[$level] = ['level' => $level, 'amount' => bcadd((string)$tier['amount'], '0', 2)];
  121. }
  122. ksort($data);
  123. return array_values($data);
  124. }
  125. /** Total discount of one coupon set: sum of discount × quantity. */
  126. public static function faceValue(array $tiers): string
  127. {
  128. $total = '0.00';
  129. foreach ($tiers as $tier) $total = bcadd($total, bcmul((string)$tier['discount'], (string)$tier['quantity'], 2), 2);
  130. return $total;
  131. }
  132. public static function draw(int $coins, bool $complete, string $probability, ?callable $random = null): array
  133. {
  134. $random ??= fn (int $min, int $max) => random_int($min, $max);
  135. $remaining = 66600 - $coins;
  136. if ($remaining <= 0) throw new \LogicException('请先领取本轮奖金');
  137. $probabilityBps = (int)bcmul($probability, '100', 0);
  138. $hit = $complete && $random(1, 10000) <= $probabilityBps;
  139. if ($hit) return ['prize_index' => 0, 'amount_cents' => $remaining, 'reached' => true];
  140. if ($complete) {
  141. // Use twice the expected draws, rounded up and capped at ten. Budget one unit per draw,
  142. // then spread the remaining cents across that many misses once inside the buffer.
  143. $pacedSpins = (int)min(10, ceil(20000 / max(1, $probabilityBps)));
  144. $maxAmount = min($remaining - 1, max($remaining - $pacedSpins * 100, intdiv($remaining - 1, $pacedSpins), 1));
  145. } else {
  146. // Leave 66 for the qualified stage and award at most a quarter of the available room, rounded up to a cent.
  147. $headroom = max(0, 60000 - $coins);
  148. $maxAmount = intdiv($headroom + 3, 4);
  149. }
  150. if ($maxAmount === 0) return ['prize_index' => 0, 'amount_cents' => 0, 'reached' => false];
  151. // Choose eligible sectors before drawing. A fixed face value is never truncated.
  152. $eligible = [0];
  153. foreach (self::PRIZES as $i => $amount) if ($i && (int)$amount * 100 <= $maxAmount) $eligible[] = $i;
  154. $index = $eligible[$random(0, count($eligible) - 1)];
  155. $amount = $index === 0 ? $random(1, $maxAmount) : (int)self::PRIZES[$index] * 100;
  156. return ['prize_index' => $index, 'amount_cents' => $amount, 'reached' => false];
  157. }
  158. }