PromotionRules.php 12 KB

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