Add seasons generator

Author: Vitaly

docs/001_product_review.md

@@ -0,0 +1,17 @@
+Codebattle: Competitive Programming Game
+
+Codebattle (codebattle.hexlet.io) is a real‑time coding duel platform. Two players solve the same task in parallel; whoever solves it first wins the match.
+
+The platform hosts Swiss‑system tournaments across several grades with a seasonal ranking model inspired by tennis.
+
+Key Concepts
+
+Match (Duel): 1v1, same task, first correct solution wins; otherwise ends by timeout.
+
+Tournament (Swiss): Multiple rounds; in each round, players are paired vs players with similar cumulative score; no repeat pairings (unless unavoidable on round 1 bootstrap or via bot fill‑ins).
+
+Tournament grades: open, rookie, challenger, pro, elite, masters, grand_slam — determine prestige, task pools, points, schedules, and limits.
+
+Seasons: Four per year aligned to equinoxes/solstices. Season points reset each season; lifetime Elo never resets.
+
+Languages: 16 supported — clojure, cpp, csharp, dart, elixir, golang, haskell, java, js, kotlin, php, python, ruby, rust, swift, ts.

docs/002_tournament_gameplay_and_matches.md

@@ -0,0 +1,25 @@
+Tournament Gameplay & Matches
+
+Joining
+
+Players may late‑join any Swiss tournament while it is active. They enter with 0 tournament points and are scheduled into the next round.
+
+Minimum participants to start: 2 for any grade.
+
+Time Controls
+
+Tournament uses a single round timeout: round_timeout_seconds (applied to all matches in the round). Organizers may set different values per tournament and (optionally) per task difficulty in future.
+
+Outcomes
+
+Win: First accepted solution (100% tests) within timeout.
+
+Timeout: No accepted solution when time expires. Treated as non‑draw for scoring: both receive a partial score (see 75‑percentile scoring), but Elo is not updated for timeout games.
+
+Cheating reports: If cheating is confirmed against your opponent, your match score is recalculated according to anti‑cheat policy (see docs/08-anti-cheat.md).
+
+Languages & Environment
+
+Supported languages: clojure, cpp, csharp, dart, elixir, golang, haskell, java, js, kotlin, php, python, ruby, rust, swift, ts.
+
+Same task for both players in the match.

docs/003_swiss_tournament.md

@@ -0,0 +1,36 @@
+Swiss Tournaments
+
+Pairing
+
+Round 1: random mixed seeding (shuffled), pair by adjacent order.
+
+Subsequent rounds: sort by current tournament score (desc); pair within bands; no repeat pairings (tracked set). If odd participants, a bot fills the last unmatched player.
+
+
+These are platform defaults and can be configured if needed.
+
+One Task per Round
+
+Every round features one task shared by all matches.
+
+In‑Tournament Scoring (Score Strategy)
+
+Default strategy: 75_percentile (a.k.a. "percentile‑based"):
+
+For each task (round), compute base_score = 25th percentile of winners' duration_sec (faster → smaller time).
+
+Winner scaling: winners get between 2× and 1× base_score linearly, mapping min winner time → 2×, max winner time → 1×.
+
+Losers/partials: scale by result_percent/100 and by the same linear time factor. For pure timeout games, grant 0.5 × base_score × (result_percent/100).
+
+The tournament table sums per‑round scores.
+
+Tournament Table & Tie‑Breakers
+
+Sorted by Total Score (desc).
+
+Tie‑break: Total Duration (asc).
+
+Finals & Places
+
+Final places are taken from the sorted table after the last round.

docs/004-seasons-and-points.md

@@ -0,0 +1,92 @@
+Seasons, Grades, Points
+
+Seasons
+
+Season 0: Sep 21 – Dec 21
+Season 1: Dec 21 – Mar 21
+Season 2: Mar 21 – Jun 21
+Season 3: Jun 21 – Sep 21
+
+On each season end date (the 21st), we run a Grand Slam at 16:00 UTC.
+
+Season Points reset each season.
+
+Elo never resets (lifetime).
+
+Grades
+
+open — casual/unranked (no points; free task setups by users).
+
+rookie — once per 4 hours (except 16:00 UTC);
+should be 3 7 11 15 19 23  UTC
+easy tasks;
+grind‑friendly.
+
+challenger — daily 16:00 UTC; backbone of the calendar.
+
+pro — weekly Tuesday 16:00 UTC (preempted by higher grades in its week).
+
+elite — bi‑weekly Wednesday 16:00 UTC (no pro that week).
+
+masters — monthly Thursday 16:00 UTC (no pro/elite that week). Exactly one per day.
+
+grand_slam — season finale on the 21st at 16:00 UTC (no pro/elite/masters that week).
+
+Player Limits(players_limit)
+
+rookie: 8
+challenger: 16
+pro: 32
+elite: 64
+masters: 128
+grand_slam: 256
+
+Rounds per Grade (rounds_limit)
+
+rookie: 4 rounds
+challenger: 6 rounds
+pro: 8 rounds
+elite: 10 rounds
+masters: 12 rounds
+grand_slam: 14 rounds
+
+
+Task Provisioning
+
+For masters & grand_slam: use task packs (task_provider: task_pack).
+
+Naming: masters_s{season}_{year}_{N} (e.g., masters_s0_2025_1), grand_slam_s{season}_{year}.
+
+For others: use existing tasks via task_provider: level, task_strategy: random.
+
+Swiss always uses one task per round.
+
+Season Points Distribution
+
+For each finished tournament (grade ≠ open), we award Season Points by final place using these grade tables; all remaining participants (outside prize slots) receive 2 points each.
+
+rookie: [8, 4, 2] (top‑3)
+
+challenger: [64, 32, 16, 8, 4, 2] (top‑6)
+
+pro: [128, 64, 32, 16, 8, 4, 2] (top‑7)
+
+elite: [256, 128, 64, 32, 16, 8, 4, 2] (top‑8)
+
+masters: [1024, 512, 256, 128, 64, 32, 16, 8, 4, 2] (top‑10)
+
+grand_slam: [2048, 1024, 512, 256, 128, 64, 32, 16, 8, 4, 2] (top‑11)
+
+Prize points are not added on top of the participation points.
+
+Season Leaderboard Tie‑Breakers
+
+Total Season Points (desc)
+
+Tournament wins in season (desc)
+
+Tournament participations in season (desc)
+
+Hall of Fame
+
+Maintain a HoF for Season Champions and Grand Slam Champions (participants page optional later).

docs/005_elo_rating.md

@@ -0,0 +1,21 @@
+Elo Rating (Lifetime)
+
+Initial rating: 1200 for new players.
+
+Updates only for: tournament matches in graded events (rookie..grand_slam) vs human opponents.
+
+No Elo change on: 
+  - Matches involving a bot. 
+  - Timeout games.
+  - Any open (casual) tournaments.
+
+K‑Factors by Grade
+
+rookie: 2
+challenger: 2
+pro: 4
+elite: 4
+masters: 8
+grand_slam: 16
+
+Expected score is computed in the standard Elo way; winners and losers updated with their grade’s task level K.

docs/006-scheduling-and-automation.md

@@ -0,0 +1,52 @@
+Tournament Scheduling & Preemption
+
+Daily/Hourly Rules (UTC)
+
+Rookie: every hour except 16:00.
+
+Challenger: daily at 16:00, unless preempted by a higher grade that day/week.
+
+Weekly Slots (16:00 UTC)
+
+Priority: grand_slam > masters > elite > pro.
+
+In any given week, exactly one of pro/elite/masters/grand_slam runs at 16:00.
+
+Canonical Weekly Pattern (per 12–13‑week season)
+
+Weeks without special events alternate pro and elite as backbone, with masters approximately once per month (Thu). Example outline:
+
+w1  Tue: pro
+w2  Wed: elite
+w3  Tue: pro
+w4  Thu: masters
+w5  Tue: pro
+w6  Wed: elite
+w7  Tue: pro
+w8  Thu: masters
+w9  Tue: pro
+w10 Wed: elite
+w11 Tue: pro
+w12 21st: grand_slam
+w13 Tue: pro (if present within season window)
+
+Exact weekdays for masters/grand_slam follow the 21st constraint and season calendar; if a masters week is selected, no pro/elite that week. On a grand_slam week, only grand_slam at 16:00.
+
+Deterministic Planner (Pseudo‑code)
+
+input: season_start, season_end
+for each day in [season_start, season_end]:
+  if hour==16:00:
+    if date == season_end (21st): schedule grand_slam
+    else if is_thursday and is_monthly_slot and not special_week: schedule masters
+    else if is_wednesday and is_biweekly_slot and not masters_week: schedule elite
+    else if is_tuesday and not elite_week and not masters_week: schedule pro
+    else: schedule challenger
+  else:
+    if hour != 16:00: schedule rookie hourly
+
+biweekly_slot can be tracked as every second Wednesday in the season window.
+
+monthly_slot for masters is the nearest Thursday not colliding with GS.
+
+Preemption means the higher‑priority grade replaces challenger that day and replaces lower grades in that week as per rules.

docs/007-hall-of-fame.md

@@ -0,0 +1,13 @@
+Hall of Fame
+
+Display Season Champions (by Season Points rank 1 for S0..S3).
+
+Display Grand Slam Champions (winners of the Grand Slam for each season).
+
+Optional future addition: Grand Slam participants board.
+
+Data sources:
+
+Season leaderboard snapshot at season end.
+
+tournament_places for the corresponding grand_slam event.

docs/008-anti-cheat.md

@@ -0,0 +1,13 @@
+Anti‑Cheat & Dispute Resolution (MVP)
+
+Players can report suspected cheating.
+
+Admins review evidence; if cheating is confirmed:
+
+Offending player’s match result may be voided/banned per policy.
+
+The victim’s tournament score for the game is recalculated to a fair value (e.g., set to the average winners' score for that task or a policy‑defined replacement).
+
+Admin actions may update tournament_results.was_cheated and trigger a recompute of tournament aggregates/places.
+
+Elo is not granted for bot games or timeouts; cheating cases follow the same Elo exclusions until a fair game result exists.

services/app/apps/codebattle/assets/js/widgets/components/icons/grades/RookieIcon.jsx

@@ -5,16 +5,33 @@ const COLOR = '#00FF00'; // Неоново-зелёный (Neon-green)
 const RookieIcon = ({ size = '48px' }) => (
   <div className="rank-icon-container">
     <svg
-      className="rank-svg-icon flicker-animation"
+      className="rank-svg-icon"
       width={size}
       height={size}
       viewBox="0 0 100 100"
       xmlns="http://www.w3.org/2000/svg"
       style={{ filter: `drop-shadow(0 0 3px ${COLOR})` }}
     >
       {/* Floppy Disk/Terminal Cursor Symbol */}
-      <rect x="25" y="25" width="50" height="50" rx="5" fill="none" stroke={COLOR} strokeWidth="4" />
-      <rect x="35" y="45" width="30" height="15" fill="#000" stroke={COLOR} strokeWidth="2" />
+      <rect
+        x="25"
+        y="25"
+        width="50"
+        height="50"
+        rx="5"
+        fill="none"
+        stroke={COLOR}
+        strokeWidth="4"
+      />
+      <rect
+        x="35"
+        y="45"
+        width="30"
+        height="15"
+        fill="#000"
+        stroke={COLOR}
+        strokeWidth="2"
+      />
       <rect x="40" y="30" width="20" height="10" fill={COLOR} />
     </svg>
   </div>