bisco/hoopscout-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add initial django scouting domain models baseline

Browse Source
This commit is contained in:
bisco
2026-04-06 19:07:53 +02:00
parent 2994089f1e
commit d5b00eee98
16 changed files with 540 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

0
app/scouting/__init__.py Normal file
View File

70
app/scouting/admin.py Normal file
View File

@ -0,0 +1,70 @@
from django.contrib import admin
from .models import (
Competition,
Player,
PlayerSeason,
PlayerSeasonStats,
Role,
Season,
Specialty,
Team,
)
@admin.register(Role)
class RoleAdmin(admin.ModelAdmin):
list_display = ("name", "slug")
search_fields = ("name", "slug")
@admin.register(Specialty)
class SpecialtyAdmin(admin.ModelAdmin):
list_display = ("name", "slug")
search_fields = ("name", "slug")
@admin.register(Player)
class PlayerAdmin(admin.ModelAdmin):
list_display = ("full_name", "nationality", "birth_date")
search_fields = ("full_name", "first_name", "last_name", "nationality")
@admin.register(Competition)
class CompetitionAdmin(admin.ModelAdmin):
list_display = ("name", "country", "level")
search_fields = ("name", "country", "level")
@admin.register(Team)
class TeamAdmin(admin.ModelAdmin):
list_display = ("name", "competition", "country")
search_fields = ("name", "country")
list_filter = ("competition",)
@admin.register(Season)
class SeasonAdmin(admin.ModelAdmin):
list_display = ("name", "start_year", "end_year")
search_fields = ("name",)
@admin.register(PlayerSeason)
class PlayerSeasonAdmin(admin.ModelAdmin):
list_display = ("player", "season", "team", "competition", "position")
list_filter = ("season", "competition", "position")
search_fields = ("player__full_name", "team__name", "competition__name")
filter_horizontal = ("roles", "specialties")
@admin.register(PlayerSeasonStats)
class PlayerSeasonStatsAdmin(admin.ModelAdmin):
list_display = (
"player_season",
"points",
"assists",
"steals",
"turnovers",
"blocks",
)
search_fields = ("player_season__player__full_name", "player_season__season__name")

6
app/scouting/apps.py Normal file
View File

@ -0,0 +1,6 @@
from django.apps import AppConfig
class ScoutingConfig(AppConfig):
default_auto_field = "django.db.models.BigAutoField"
name = "scouting"

145
app/scouting/migrations/0001_initial.py Normal file
View File

@ -0,0 +1,145 @@
# Generated by Django 5.2.2 on 2026-04-06 17:05
import django.db.models.deletion
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='Competition',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=150, unique=True)),
('country', models.CharField(blank=True, max_length=100)),
('level', models.CharField(blank=True, max_length=100)),
('created_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
],
options={
'ordering': ['name'],
},
),
migrations.CreateModel(
name='Player',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('full_name', models.CharField(max_length=255)),
('first_name', models.CharField(blank=True, max_length=100)),
('last_name', models.CharField(blank=True, max_length=100)),
('birth_date', models.DateField(blank=True, null=True)),
('nationality', models.CharField(blank=True, max_length=100)),
('height_cm', models.DecimalField(blank=True, decimal_places=2, max_digits=5, null=True)),
('weight_kg', models.DecimalField(blank=True, decimal_places=2, max_digits=5, null=True)),
('wingspan_cm', models.DecimalField(blank=True, decimal_places=2, max_digits=5, null=True)),
('created_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
],
options={
'ordering': ['full_name'],
},
),
migrations.CreateModel(
name='Role',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=100, unique=True)),
('slug', models.SlugField(max_length=120, unique=True)),
('description', models.TextField(blank=True)),
],
options={
'ordering': ['name'],
},
),
migrations.CreateModel(
name='Season',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('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)),
],
options={
'ordering': ['-start_year', '-end_year'],
},
),
migrations.CreateModel(
name='Specialty',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=100, unique=True)),
('slug', models.SlugField(max_length=120, unique=True)),
('description', models.TextField(blank=True)),
],
options={
'ordering': ['name'],
},
),
migrations.CreateModel(
name='PlayerSeason',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('position', models.CharField(choices=[('PG', 'PG'), ('SG', 'SG'), ('SF', 'SF'), ('PF', 'PF'), ('C', 'C')], max_length=2)),
('created_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
('competition', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='player_seasons', to='scouting.competition')),
('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='player_seasons', to='scouting.player')),
('roles', models.ManyToManyField(blank=True, related_name='player_seasons', to='scouting.role')),
('season', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='player_seasons', to='scouting.season')),
('specialties', models.ManyToManyField(blank=True, related_name='player_seasons', to='scouting.specialty')),
],
options={
'ordering': ['player__full_name', '-season__start_year'],
},
),
migrations.CreateModel(
name='PlayerSeasonStats',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('points', models.DecimalField(blank=True, decimal_places=2, max_digits=6, null=True)),
('assists', models.DecimalField(blank=True, decimal_places=2, max_digits=6, null=True)),
('steals', models.DecimalField(blank=True, decimal_places=2, max_digits=6, null=True)),
('turnovers', models.DecimalField(blank=True, decimal_places=2, max_digits=6, null=True)),
('blocks', models.DecimalField(blank=True, decimal_places=2, max_digits=6, null=True)),
('efg_pct', models.DecimalField(blank=True, decimal_places=2, max_digits=5, null=True)),
('ts_pct', models.DecimalField(blank=True, decimal_places=2, max_digits=5, null=True)),
('plus_minus', models.DecimalField(blank=True, decimal_places=2, max_digits=7, null=True)),
('offensive_rating', models.DecimalField(blank=True, decimal_places=2, max_digits=7, null=True)),
('defensive_rating', models.DecimalField(blank=True, decimal_places=2, max_digits=7, null=True)),
('created_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
('player_season', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, related_name='stats', to='scouting.playerseason')),
],
options={
'verbose_name_plural': 'Player season stats',
},
),
migrations.CreateModel(
name='Team',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=150)),
('country', models.CharField(blank=True, max_length=100)),
('created_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
('competition', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='teams', to='scouting.competition')),
],
options={
'ordering': ['name'],
'unique_together': {('name', 'competition')},
},
),
migrations.AddField(
model_name='playerseason',
name='team',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='player_seasons', to='scouting.team'),
),
]

0
app/scouting/migrations/__init__.py Normal file
View File

159
app/scouting/models.py Normal file
View File

@ -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}"