PromotionRules.php 13 KB

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