Add version groups to share routes and boss battles across games

Routes and boss battles now belong to a version_group instead of
individual games, so paired versions (e.g. Red/Blue, Gold/Silver)
share the same route structure and boss battles. Route encounters
gain a game_id column to support game-specific encounter tables
within a shared route. Includes migration, updated seeds, API
changes, and frontend type updates.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

backend/src/app/models/__init__.py

@@ -8,6 +8,7 @@ from app.models.nuzlocke_run import NuzlockeRun
 from app.models.pokemon import Pokemon
 from app.models.route import Route
 from app.models.route_encounter import RouteEncounter
+from app.models.version_group import VersionGroup
 
 __all__ = [
     "BossBattle",
@@ -20,4 +21,5 @@ __all__ = [
     "Pokemon",
     "Route",
     "RouteEncounter",
+    "VersionGroup",
 ]

backend/src/app/models/boss_battle.py

@@ -8,7 +8,9 @@ class BossBattle(Base):
     __tablename__ = "boss_battles"
 
     id: Mapped[int] = mapped_column(primary_key=True)
-    game_id: Mapped[int] = mapped_column(ForeignKey("games.id"), index=True)
+    version_group_id: Mapped[int] = mapped_column(
+        ForeignKey("version_groups.id"), index=True
+    )
     name: Mapped[str] = mapped_column(String(100))
     boss_type: Mapped[str] = mapped_column(String(20))  # gym_leader, elite_four, champion, rival, evil_team, other
     badge_name: Mapped[str | None] = mapped_column(String(100))
@@ -21,7 +23,9 @@ class BossBattle(Base):
     location: Mapped[str] = mapped_column(String(200))
     sprite_url: Mapped[str | None] = mapped_column(String(500))
 
-    game: Mapped["Game"] = relationship(back_populates="boss_battles")
+    version_group: Mapped["VersionGroup"] = relationship(
+        back_populates="boss_battles"
+    )
     after_route: Mapped["Route | None"] = relationship()
     pokemon: Mapped[list["BossPokemon"]] = relationship(
         back_populates="boss_battle", cascade="all, delete-orphan"

backend/src/app/models/game.py

@@ -1,4 +1,4 @@
-from sqlalchemy import SmallInteger, String
+from sqlalchemy import ForeignKey, SmallInteger, String
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 
 from app.core.database import Base
@@ -15,10 +15,14 @@ class Game(Base):
     box_art_url: Mapped[str | None] = mapped_column(String(500))
     release_year: Mapped[int | None] = mapped_column(SmallInteger)
     color: Mapped[str | None] = mapped_column(String(7))  # Hex color e.g. #FF0000
+    version_group_id: Mapped[int | None] = mapped_column(
+        ForeignKey("version_groups.id"), index=True
+    )
 
-    routes: Mapped[list["Route"]] = relationship(back_populates="game")
+    version_group: Mapped["VersionGroup | None"] = relationship(
+        back_populates="games"
+    )
     runs: Mapped[list["NuzlockeRun"]] = relationship(back_populates="game")
-    boss_battles: Mapped[list["BossBattle"]] = relationship(back_populates="game")
 
     def __repr__(self) -> str:
         return f"<Game(id={self.id}, name='{self.name}')>"

backend/src/app/models/route.py

@@ -7,19 +7,21 @@ from app.core.database import Base
 class Route(Base):
     __tablename__ = "routes"
     __table_args__ = (
-        UniqueConstraint("game_id", "name", name="uq_routes_game_name"),
+        UniqueConstraint("version_group_id", "name", name="uq_routes_version_group_name"),
     )
 
     id: Mapped[int] = mapped_column(primary_key=True)
     name: Mapped[str] = mapped_column(String(100))
-    game_id: Mapped[int] = mapped_column(ForeignKey("games.id"), index=True)
+    version_group_id: Mapped[int] = mapped_column(
+        ForeignKey("version_groups.id"), index=True
+    )
     order: Mapped[int] = mapped_column(SmallInteger)
     parent_route_id: Mapped[int | None] = mapped_column(
         ForeignKey("routes.id", ondelete="CASCADE"), index=True, default=None
     )
     pinwheel_zone: Mapped[int | None] = mapped_column(SmallInteger, default=None)
 
-    game: Mapped["Game"] = relationship(back_populates="routes")
+    version_group: Mapped["VersionGroup"] = relationship(back_populates="routes")
     route_encounters: Mapped[list["RouteEncounter"]] = relationship(
         back_populates="route"
     )

backend/src/app/models/route_encounter.py

@@ -8,13 +8,15 @@ class RouteEncounter(Base):
     __tablename__ = "route_encounters"
     __table_args__ = (
         UniqueConstraint(
-            "route_id", "pokemon_id", "encounter_method", name="uq_route_pokemon_method"
+            "route_id", "pokemon_id", "encounter_method", "game_id",
+            name="uq_route_pokemon_method_game"
         ),
     )
 
     id: Mapped[int] = mapped_column(primary_key=True)
     route_id: Mapped[int] = mapped_column(ForeignKey("routes.id"), index=True)
     pokemon_id: Mapped[int] = mapped_column(ForeignKey("pokemon.id"), index=True)
+    game_id: Mapped[int] = mapped_column(ForeignKey("games.id"), index=True)
     encounter_method: Mapped[str] = mapped_column(String(30))
     encounter_rate: Mapped[int] = mapped_column(SmallInteger)
     min_level: Mapped[int] = mapped_column(SmallInteger)
@@ -22,6 +24,7 @@ class RouteEncounter(Base):
 
     route: Mapped["Route"] = relationship(back_populates="route_encounters")
     pokemon: Mapped["Pokemon"] = relationship(back_populates="route_encounters")
+    game: Mapped["Game"] = relationship()
 
     def __repr__(self) -> str:
         return f"<RouteEncounter(route_id={self.route_id}, pokemon_id={self.pokemon_id}, method='{self.encounter_method}')>"

backend/src/app/models/version_group.py

@@ -0,0 +1,21 @@
+from sqlalchemy import String
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from app.core.database import Base
+
+
+class VersionGroup(Base):
+    __tablename__ = "version_groups"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String(100))
+    slug: Mapped[str] = mapped_column(String(100), unique=True)
+
+    games: Mapped[list["Game"]] = relationship(back_populates="version_group")
+    routes: Mapped[list["Route"]] = relationship(back_populates="version_group")
+    boss_battles: Mapped[list["BossBattle"]] = relationship(
+        back_populates="version_group"
+    )
+
+    def __repr__(self) -> str:
+        return f"<VersionGroup(id={self.id}, name='{self.name}')>"