feat: add initial django scouting domain models baseline

app/scouting/models.py

@@ -0,0 +1,159 @@
+from django.db import models
+
+
+class Role(models.Model):
+    name = models.CharField(max_length=100, unique=True)
+    slug = models.SlugField(max_length=120, unique=True)
+    description = models.TextField(blank=True)
+
+    class Meta:
+        ordering = ["name"]
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class Specialty(models.Model):
+    name = models.CharField(max_length=100, unique=True)
+    slug = models.SlugField(max_length=120, unique=True)
+    description = models.TextField(blank=True)
+
+    class Meta:
+        ordering = ["name"]
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class Player(models.Model):
+    full_name = models.CharField(max_length=255)
+    first_name = models.CharField(max_length=100, blank=True)
+    last_name = models.CharField(max_length=100, blank=True)
+    birth_date = models.DateField(null=True, blank=True)
+    nationality = models.CharField(max_length=100, blank=True)
+    height_cm = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
+    weight_kg = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
+    wingspan_cm = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["full_name"]
+
+    def __str__(self) -> str:
+        return self.full_name
+
+
+class Competition(models.Model):
+    name = models.CharField(max_length=150, unique=True)
+    country = models.CharField(max_length=100, blank=True)
+    level = models.CharField(max_length=100, blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["name"]
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class Team(models.Model):
+    name = models.CharField(max_length=150)
+    competition = models.ForeignKey(
+        Competition,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name="teams",
+    )
+    country = models.CharField(max_length=100, blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["name"]
+        unique_together = ("name", "competition")
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class Season(models.Model):
+    name = models.CharField(max_length=20, unique=True)
+    start_year = models.PositiveSmallIntegerField()
+    end_year = models.PositiveSmallIntegerField()
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["-start_year", "-end_year"]
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class PlayerSeason(models.Model):
+    class Position(models.TextChoices):
+        PG = "PG", "PG"
+        SG = "SG", "SG"
+        SF = "SF", "SF"
+        PF = "PF", "PF"
+        C = "C", "C"
+
+    player = models.ForeignKey(Player, on_delete=models.CASCADE, related_name="player_seasons")
+    season = models.ForeignKey(Season, on_delete=models.CASCADE, related_name="player_seasons")
+    team = models.ForeignKey(
+        Team,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name="player_seasons",
+    )
+    competition = models.ForeignKey(
+        Competition,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name="player_seasons",
+    )
+    position = models.CharField(max_length=2, choices=Position.choices)
+    roles = models.ManyToManyField(Role, blank=True, related_name="player_seasons")
+    specialties = models.ManyToManyField(Specialty, blank=True, related_name="player_seasons")
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["player__full_name", "-season__start_year"]
+
+    def __str__(self) -> str:
+        return f"{self.player.full_name} - {self.season.name}"
+
+
+class PlayerSeasonStats(models.Model):
+    player_season = models.OneToOneField(
+        PlayerSeason,
+        on_delete=models.CASCADE,
+        related_name="stats",
+    )
+
+    points = models.DecimalField(max_digits=6, decimal_places=2, null=True, blank=True)
+    assists = models.DecimalField(max_digits=6, decimal_places=2, null=True, blank=True)
+    steals = models.DecimalField(max_digits=6, decimal_places=2, null=True, blank=True)
+    turnovers = models.DecimalField(max_digits=6, decimal_places=2, null=True, blank=True)
+    blocks = models.DecimalField(max_digits=6, decimal_places=2, null=True, blank=True)
+
+    efg_pct = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
+    ts_pct = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
+    plus_minus = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
+    offensive_rating = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
+    defensive_rating = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
+
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        verbose_name_plural = "Player season stats"
+
+    def __str__(self) -> str:
+        return f"Stats for {self.player_season}"