diff --git a/achievements/services/evaluate_achievements.py b/achievements/services/evaluate_achievements.py new file mode 100644 index 0000000..12fac52 --- /dev/null +++ b/achievements/services/evaluate_achievements.py @@ -0,0 +1 @@ +"""Service chargé d’évaluer et d’attribuer les succès.""" diff --git a/achivements/services/evaluate_achievements.py b/achivements/services/evaluate_achievements.py new file mode 100644 index 0000000..9fda8ce --- /dev/null +++ b/achivements/services/evaluate_achievements.py @@ -0,0 +1 @@ +Service chargé de valider la réalisation d'une tâche. diff --git a/apps/accounts/migrations/0001_initial.py b/apps/accounts/migrations/0001_initial.py new file mode 100644 index 0000000..abde5f6 --- /dev/null +++ b/apps/accounts/migrations/0001_initial.py @@ -0,0 +1,62 @@ +# Generated by Django 6.1.3 on 2026-11-04 15:49 + +import django.contrib.auth.models +import django.contrib.auth.validators +import django.db.models.deletion +import django.utils.timezone +import uuid +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('auth', '0012_alter_user_first_name_max_length'), + ] + + operations = [ + migrations.CreateModel( + name='User', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('password', models.CharField(max_length=128, verbose_name='password')), + ('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')), + ('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')), + ('username', models.CharField(error_messages={'unique': 'A user with that username already exists.'}, help_text='Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.', max_length=150, unique=True, validators=[django.contrib.auth.validators.UnicodeUsernameValidator()], verbose_name='username')), + ('first_name', models.CharField(blank=True, max_length=150, verbose_name='first name')), + ('last_name', models.CharField(blank=True, max_length=150, verbose_name='last name')), + ('email', models.EmailField(blank=True, max_length=254, verbose_name='email address')), + ('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')), + ('is_active', models.BooleanField(default=True, help_text='Designates whether this user should be treated as active. Unselect this instead of deleting accounts.', verbose_name='active')), + ('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')), + ('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to. A user will get all permissions granted to each of their groups.', related_name='user_set', related_query_name='user', to='auth.group', verbose_name='groups')), + ('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='user_set', related_query_name='user', to='auth.permission', verbose_name='user permissions')), + ], + options={ + 'verbose_name': 'user', + 'verbose_name_plural': 'users', + 'abstract': False, + }, + managers=[ + ('objects', django.contrib.auth.models.UserManager()), + ], + ), + migrations.CreateModel( + name='PlayerProfile', + fields=[ + ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)), + ('handle', models.SlugField(unique=True)), + ('display_name', models.CharField(max_length=100)), + ('bio', models.TextField(blank=True)), + ('avatar', models.ImageField(blank=True, upload_to='avatars/')), + ('visibility', models.CharField(choices=[('private', 'Privé'), ('local', 'Instance locale'), ('federated', 'Public et fédéré')], default='private', max_length=16)), + ('public_id', models.UUIDField(default=uuid.uuid4, editable=False, unique=True)), + ('created_at', models.DateTimeField(auto_now_add=True)), + ('updated_at', models.DateTimeField(auto_now=True)), + ('user', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, related_name='player_profile', to=settings.AUTH_USER_MODEL)), + ], + ), + ] diff --git a/apps/accounts/models.py b/apps/accounts/models.py index 71a8362..fe9ba72 100644 --- a/apps/accounts/models.py +++ b/apps/accounts/models.py @@ -1,3 +1,39 @@ -from django.db import models +# apps/accounts/models.py -# Create your models here. +import uuid + +from django.conf import settings +from django.db import models +from django.contrib.auth.models import AbstractUser + +class User(AbstractUser): + pass + +class PlayerProfile(models.Model): + class Visibility(models.TextChoices): + PRIVATE = "private", "Privé" + LOCAL = "local", "Instance locale" + FEDERATED = "federated", "Public et fédéré" + + id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) + user = models.OneToOneField( + settings.AUTH_USER_MODEL, + on_delete=models.CASCADE, + related_name="player_profile", + ) + handle = models.SlugField(max_length=50, unique=True) + display_name = models.CharField(max_length=100) + bio = models.TextField(blank=True) + avatar = models.ImageField(upload_to="avatars/", blank=True) + + visibility = models.CharField( + max_length=16, + choices=Visibility.choices, + default=Visibility.PRIVATE, + ) + + # Identifiant stable exposé à la fédération + public_id = models.UUIDField(default=uuid.uuid4, unique=True, editable=False) + + created_at = models.DateTimeField(auto_now_add=True) + updated_at = models.DateTimeField(auto_now=True) diff --git a/apps/achievements/migrations/0001_initial.py b/apps/achievements/migrations/0001_initial.py new file mode 100644 index 0000000..b067ddb --- /dev/null +++ b/apps/achievements/migrations/0001_initial.py @@ -0,0 +1,66 @@ +# Generated by Django 6.1.3 on 2026-11-04 15:49 + +import django.db.models.deletion +import uuid +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + migrations.swappable_dependency(settings.AUTH_USER_MODEL), + ] + + operations = [ + migrations.CreateModel( + name='Achievement', + fields=[ + ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)), + ('slug', models.SlugField(max_length=100, unique=True)), + ('name', models.CharField(max_length=160)), + ('description', models.TextField(blank=True)), + ('icon', models.CharField(blank=True, max_length=80)), + ('rule_type', models.CharField(choices=[('task_count', 'Nombre de réalisations'), ('skill_xp', 'XP dans une compétence'), ('tree_xp', 'XP dans un arbre'), ('total_xp', 'XP total'), ('distinct_tasks', 'Tâches différentes')], max_length=32)), + ('rule_config', models.JSONField(default=dict)), + ('xp_reward', models.PositiveIntegerField(default=0)), + ('is_secret', models.BooleanField(default=False)), + ('is_active', models.BooleanField(default=True)), + ], + ), + migrations.CreateModel( + name='Title', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('slug', models.SlugField(max_length=100, unique=True)), + ('name', models.CharField(max_length=120)), + ('description', models.TextField(blank=True)), + ('achievement', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, related_name='title', to='achievements.achievement')), + ], + ), + migrations.CreateModel( + name='PlayerTitle', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('unlocked_at', models.DateTimeField(auto_now_add=True)), + ('is_equipped', models.BooleanField(default=False)), + ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='titles', to=settings.AUTH_USER_MODEL)), + ('title', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='achievements.title')), + ], + ), + migrations.CreateModel( + name='PlayerAchievement', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('unlocked_at', models.DateTimeField(auto_now_add=True)), + ('progress_snapshot', models.JSONField(default=dict)), + ('achievement', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='players', to='achievements.achievement')), + ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='achievements', to=settings.AUTH_USER_MODEL)), + ], + options={ + 'constraints': [models.UniqueConstraint(fields=('player', 'achievement'), name='unique_player_achievement')], + }, + ), + ] diff --git a/apps/achievements/models.py b/apps/achievements/models.py index 71a8362..035cb3e 100644 --- a/apps/achievements/models.py +++ b/apps/achievements/models.py @@ -1,3 +1,73 @@ +# apps/achivements/models.py + +import uuid + +from django.conf import settings from django.db import models # Create your models here. +class Achievement(models.Model): + class RuleType(models.TextChoices): + TASK_COUNT = "task_count", "Nombre de réalisations" + SKILL_XP = "skill_xp", "XP dans une compétence" + TREE_XP = "tree_xp", "XP dans un arbre" + TOTAL_XP = "total_xp", "XP total" + DISTINCT_TASKS = "distinct_tasks", "Tâches différentes" + + id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) + slug = models.SlugField(max_length=100, unique=True) + name = models.CharField(max_length=160) + description = models.TextField(blank=True) + icon = models.CharField(max_length=80, blank=True) + + rule_type = models.CharField(max_length=32, choices=RuleType.choices) + rule_config = models.JSONField(default=dict) + + xp_reward = models.PositiveIntegerField(default=0) + is_secret = models.BooleanField(default=False) + is_active = models.BooleanField(default=True) + + +class PlayerAchievement(models.Model): + player = models.ForeignKey( + settings.AUTH_USER_MODEL, + on_delete=models.CASCADE, + related_name="achievements", + ) + achievement = models.ForeignKey( + Achievement, + on_delete=models.CASCADE, + related_name="players", + ) + unlocked_at = models.DateTimeField(auto_now_add=True) + progress_snapshot = models.JSONField(default=dict) + + class Meta: + constraints = [ + models.UniqueConstraint( + fields=("player", "achievement"), + name="unique_player_achievement", + ) + ] + + +class Title(models.Model): + slug = models.SlugField(max_length=100, unique=True) + name = models.CharField(max_length=120) + description = models.TextField(blank=True) + achievement = models.OneToOneField( + Achievement, + on_delete=models.CASCADE, + related_name="title", + ) + + +class PlayerTitle(models.Model): + player = models.ForeignKey( + settings.AUTH_USER_MODEL, + on_delete=models.CASCADE, + related_name="titles", + ) + title = models.ForeignKey(Title, on_delete=models.CASCADE) + unlocked_at = models.DateTimeField(auto_now_add=True) + is_equipped = models.BooleanField(default=False) diff --git a/apps/progression/migrations/0001_initial.py b/apps/progression/migrations/0001_initial.py new file mode 100644 index 0000000..ded4f77 --- /dev/null +++ b/apps/progression/migrations/0001_initial.py @@ -0,0 +1,86 @@ +# Generated by Django 6.1.3 on 2026-11-04 15:49 + +import django.db.models.deletion +import uuid +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('skills', '0001_initial'), + migrations.swappable_dependency(settings.AUTH_USER_MODEL), + ] + + operations = [ + migrations.CreateModel( + name='TaskCompletion', + fields=[ + ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)), + ('status', models.CharField(choices=[('pending', 'En attente'), ('accepted', 'Acceptée'), ('rejected', 'Refusée'), ('cancelled', 'Annulée')], default='accepted', max_length=16)), + ('completed_at', models.DateTimeField()), + ('submitted_at', models.DateTimeField(auto_now_add=True)), + ('note', models.TextField(blank=True)), + ('proof_url', models.URLField(blank=True)), + ('idempotency_key', models.CharField(blank=True, max_length=100, null=True)), + ('task_name_snapshot', models.CharField(max_length=160)), + ('xp_snapshot', models.PositiveIntegerField(default=0)), + ('validated_at', models.DateTimeField(blank=True, null=True)), + ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='task_completions', to=settings.AUTH_USER_MODEL)), + ('task', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='completions', to='skills.task')), + ('validated_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='validated_completions', to=settings.AUTH_USER_MODEL)), + ], + ), + migrations.CreateModel( + name='XPTransaction', + fields=[ + ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)), + ('amount', models.IntegerField()), + ('reason', models.CharField(choices=[('task', 'Réalisation d’une tâche'), ('achievement', 'Succès'), ('bonus', 'Bonus'), ('correction', 'Correction'), ('reversal', 'Annulation')], max_length=20)), + ('metadata', models.JSONField(blank=True, default=dict)), + ('created_at', models.DateTimeField(auto_now_add=True)), + ('completion', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='xp_transactions', to='progression.taskcompletion')), + ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='xp_transactions', to=settings.AUTH_USER_MODEL)), + ('reversed_transaction', models.OneToOneField(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='reversal', to='progression.xptransaction')), + ('skill', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='xp_transactions', to='skills.skill')), + ], + ), + migrations.CreateModel( + name='PlayerSkillProgress', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('xp', models.PositiveBigIntegerField(default=0)), + ('level', models.PositiveIntegerField(default=0)), + ('unlocked_at', models.DateTimeField(blank=True, null=True)), + ('updated_at', models.DateTimeField(auto_now=True)), + ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='skill_progress', to=settings.AUTH_USER_MODEL)), + ('skill', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='player_progress', to='skills.skill')), + ], + options={ + 'constraints': [models.UniqueConstraint(fields=('player', 'skill'), name='unique_player_skill_progress')], + }, + ), + migrations.AddIndex( + model_name='taskcompletion', + index=models.Index(fields=['player', '-completed_at'], name='progression_player__24cf43_idx'), + ), + migrations.AddIndex( + model_name='taskcompletion', + index=models.Index(fields=['task', '-completed_at'], name='progression_task_id_ddb5c4_idx'), + ), + migrations.AddConstraint( + model_name='taskcompletion', + constraint=models.UniqueConstraint(condition=models.Q(('idempotency_key__isnull', False)), fields=('player', 'idempotency_key'), name='unique_player_idempotency_key'), + ), + migrations.AddIndex( + model_name='xptransaction', + index=models.Index(fields=['player', 'skill'], name='progression_player__3e4558_idx'), + ), + migrations.AddIndex( + model_name='xptransaction', + index=models.Index(fields=['player', '-created_at'], name='progression_player__435a67_idx'), + ), + ] diff --git a/apps/progression/models.py b/apps/progression/models.py index 71a8362..cb3cfb0 100644 --- a/apps/progression/models.py +++ b/apps/progression/models.py @@ -1,3 +1,143 @@ +# apps/progression/models.py + +import uuid + +from django.conf import settings from django.db import models -# Create your models here. + +class TaskCompletion(models.Model): + class Status(models.TextChoices): + PENDING = "pending", "En attente" + ACCEPTED = "accepted", "Acceptée" + REJECTED = "rejected", "Refusée" + CANCELLED = "cancelled", "Annulée" + + id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) + player = models.ForeignKey( + settings.AUTH_USER_MODEL, + on_delete=models.CASCADE, + related_name="task_completions", + ) + task = models.ForeignKey( + "skills.Task", + on_delete=models.PROTECT, + related_name="completions", + ) + + status = models.CharField( + max_length=16, + choices=Status.choices, + default=Status.ACCEPTED, + ) + + completed_at = models.DateTimeField() + submitted_at = models.DateTimeField(auto_now_add=True) + + note = models.TextField(blank=True) + proof_url = models.URLField(blank=True) + + # Évite les doubles créations lors d’un retry de l’API. + idempotency_key = models.CharField( + max_length=100, + null=True, + blank=True, + ) + + # Snapshot au moment de la validation + task_name_snapshot = models.CharField(max_length=160) + xp_snapshot = models.PositiveIntegerField(default=0) + + validated_by = models.ForeignKey( + settings.AUTH_USER_MODEL, + null=True, + blank=True, + on_delete=models.SET_NULL, + related_name="validated_completions", + ) + validated_at = models.DateTimeField(null=True, blank=True) + + class Meta: + constraints = [ + models.UniqueConstraint( + fields=("player", "idempotency_key"), + condition=models.Q(idempotency_key__isnull=False), + name="unique_player_idempotency_key", + ) + ] + indexes = [ + models.Index(fields=("player", "-completed_at")), + models.Index(fields=("task", "-completed_at")), + ] + +class XPTransaction(models.Model): + class Reason(models.TextChoices): + TASK = "task", "Réalisation d’une tâche" + ACHIEVEMENT = "achievement", "Succès" + BONUS = "bonus", "Bonus" + CORRECTION = "correction", "Correction" + REVERSAL = "reversal", "Annulation" + + id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) + player = models.ForeignKey( + settings.AUTH_USER_MODEL, + on_delete=models.CASCADE, + related_name="xp_transactions", + ) + skill = models.ForeignKey( + "skills.Skill", + on_delete=models.PROTECT, + related_name="xp_transactions", + ) + + # Signé : positif ou négatif + amount = models.IntegerField() + reason = models.CharField(max_length=20, choices=Reason.choices) + + completion = models.ForeignKey( + TaskCompletion, + null=True, + blank=True, + on_delete=models.PROTECT, + related_name="xp_transactions", + ) + reversed_transaction = models.OneToOneField( + "self", + null=True, + blank=True, + on_delete=models.PROTECT, + related_name="reversal", + ) + + metadata = models.JSONField(default=dict, blank=True) + created_at = models.DateTimeField(auto_now_add=True) + + class Meta: + indexes = [ + models.Index(fields=("player", "skill")), + models.Index(fields=("player", "-created_at")), + ] + +class PlayerSkillProgress(models.Model): + player = models.ForeignKey( + settings.AUTH_USER_MODEL, + on_delete=models.CASCADE, + related_name="skill_progress", + ) + skill = models.ForeignKey( + "skills.Skill", + on_delete=models.CASCADE, + related_name="player_progress", + ) + xp = models.PositiveBigIntegerField(default=0) + level = models.PositiveIntegerField(default=0) + unlocked_at = models.DateTimeField(null=True, blank=True) + updated_at = models.DateTimeField(auto_now=True) + + class Meta: + constraints = [ + models.UniqueConstraint( + fields=("player", "skill"), + name="unique_player_skill_progress", + ) + ] diff --git a/apps/skills/apps.py b/apps/skills/apps.py index f76a116..599dfe3 100644 --- a/apps/skills/apps.py +++ b/apps/skills/apps.py @@ -2,5 +2,5 @@ from django.apps import AppConfig class SkillsConfig(AppConfig): - default_auto_field = "django.db.models.BigAutoField" - name = 'apps.skills' + default_auto_field = "django.db.models.BigAutoField" + name = 'apps.skills' diff --git a/apps/skills/migrations/0001_initial.py b/apps/skills/migrations/0001_initial.py new file mode 100644 index 0000000..cafbe8b --- /dev/null +++ b/apps/skills/migrations/0001_initial.py @@ -0,0 +1,86 @@ +# Generated by Django 6.1.3 on 2026-11-04 15:49 + +import django.db.models.deletion +import uuid +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ] + + operations = [ + migrations.CreateModel( + name='SkillTree', + fields=[ + ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)), + ('slug', models.SlugField(max_length=80, unique=True)), + ('name', models.CharField(max_length=120)), + ('description', models.TextField(blank=True)), + ('icon', models.CharField(blank=True, max_length=80)), + ('color', models.CharField(blank=True, max_length=7)), + ('is_active', models.BooleanField(default=True)), + ('sort_order', models.PositiveIntegerField(default=0)), + ('created_at', models.DateTimeField(auto_now_add=True)), + ('updated_at', models.DateTimeField(auto_now=True)), + ], + ), + migrations.CreateModel( + name='Task', + fields=[ + ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)), + ('slug', models.SlugField(max_length=100, unique=True)), + ('name', models.CharField(max_length=160)), + ('description', models.TextField(blank=True)), + ('base_xp', models.PositiveIntegerField()), + ('validation_mode', models.CharField(choices=[('self', 'Auto-validation'), ('peer', 'Validation par un tiers'), ('proof', 'Preuve demandée')], default='self', max_length=16)), + ('cooldown_seconds', models.PositiveIntegerField(default=0)), + ('daily_limit', models.PositiveIntegerField(blank=True, null=True)), + ('is_repeatable', models.BooleanField(default=True)), + ('is_active', models.BooleanField(default=True)), + ('created_at', models.DateTimeField(auto_now_add=True)), + ('updated_at', models.DateTimeField(auto_now=True)), + ], + ), + migrations.CreateModel( + name='Skill', + fields=[ + ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)), + ('slug', models.SlugField(max_length=80)), + ('name', models.CharField(max_length=120)), + ('description', models.TextField(blank=True)), + ('icon', models.CharField(blank=True, max_length=80)), + ('position_x', models.IntegerField(default=0)), + ('position_y', models.IntegerField(default=0)), + ('sort_order', models.PositiveIntegerField(default=0)), + ('is_active', models.BooleanField(default=True)), + ('prerequisites', models.ManyToManyField(blank=True, related_name='unlocks', to='skills.skill')), + ('tree', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='skills', to='skills.skilltree')), + ], + ), + migrations.CreateModel( + name='TaskSkillReward', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('xp', models.PositiveIntegerField()), + ('skill', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='skills.skill')), + ('task', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='skills.task')), + ], + ), + migrations.AddField( + model_name='task', + name='skills', + field=models.ManyToManyField(related_name='tasks', through='skills.TaskSkillReward', to='skills.skill'), + ), + migrations.AddConstraint( + model_name='skill', + constraint=models.UniqueConstraint(fields=('tree', 'slug'), name='unique_skill_slug_per_tree'), + ), + migrations.AddConstraint( + model_name='taskskillreward', + constraint=models.UniqueConstraint(fields=('task', 'skill'), name='unique_reward_per_task_skill'), + ), + ] diff --git a/apps/skills/models.py b/apps/skills/models.py index 71a8362..b8a124e 100644 --- a/apps/skills/models.py +++ b/apps/skills/models.py @@ -1,3 +1,100 @@ +# apps/skills/models.py + +import uuid from django.db import models -# Create your models here. + +class SkillTree(models.Model): + id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) + slug = models.SlugField(max_length=80, unique=True) + name = models.CharField(max_length=120) + description = models.TextField(blank=True) + icon = models.CharField(max_length=80, blank=True) + color = models.CharField(max_length=7, blank=True) + is_active = models.BooleanField(default=True) + sort_order = models.PositiveIntegerField(default=0) + + created_at = models.DateTimeField(auto_now_add=True) + updated_at = models.DateTimeField(auto_now=True) + + +class Skill(models.Model): + id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) + tree = models.ForeignKey( + SkillTree, + on_delete=models.CASCADE, + related_name="skills", + ) + slug = models.SlugField(max_length=80) + name = models.CharField(max_length=120) + description = models.TextField(blank=True) + icon = models.CharField(max_length=80, blank=True) + + # Utilisable pour afficher le graphe + position_x = models.IntegerField(default=0) + position_y = models.IntegerField(default=0) + sort_order = models.PositiveIntegerField(default=0) + + is_active = models.BooleanField(default=True) + prerequisites = models.ManyToManyField( + "self", + symmetrical=False, + blank=True, + related_name="unlocks", + ) + + class Meta: + constraints = [ + models.UniqueConstraint( + fields=("tree", "slug"), + name="unique_skill_slug_per_tree", + ) + ] + +class Task(models.Model): + class ValidationMode(models.TextChoices): + SELF = "self", "Auto-validation" + PEER = "peer", "Validation par un tiers" + PROOF = "proof", "Preuve demandée" + + id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False) + slug = models.SlugField(max_length=100, unique=True) + name = models.CharField(max_length=160) + description = models.TextField(blank=True) + + base_xp = models.PositiveIntegerField() + validation_mode = models.CharField( + max_length=16, + choices=ValidationMode.choices, + default=ValidationMode.SELF, + ) + + cooldown_seconds = models.PositiveIntegerField(default=0) + daily_limit = models.PositiveIntegerField(null=True, blank=True) + is_repeatable = models.BooleanField(default=True) + is_active = models.BooleanField(default=True) + + skills = models.ManyToManyField( + Skill, + through="TaskSkillReward", + related_name="tasks", + ) + + created_at = models.DateTimeField(auto_now_add=True) + updated_at = models.DateTimeField(auto_now=True) + + +class TaskSkillReward(models.Model): + task = models.ForeignKey(Task, on_delete=models.CASCADE) + skill = models.ForeignKey(Skill, on_delete=models.CASCADE) + + # Permet, par exemple, de répartir 10 XP entre maison et écologie. + xp = models.PositiveIntegerField() + + class Meta: + constraints = [ + models.UniqueConstraint( + fields=("task", "skill"), + name="unique_reward_per_task_skill", + ) + ] diff --git a/progression/services/award_xp.py b/progression/services/award_xp.py new file mode 100644 index 0000000..af72247 --- /dev/null +++ b/progression/services/award_xp.py @@ -0,0 +1 @@ +"""Service chargé d’attribuer les points d’expérience.""" diff --git a/progression/services/calculate_level.py b/progression/services/calculate_level.py new file mode 100644 index 0000000..06f9f0b --- /dev/null +++ b/progression/services/calculate_level.py @@ -0,0 +1 @@ +"""Service chargé de calculer le niveau d’un joueur à partir de son expérience.""" diff --git a/progression/services/complete_task.py b/progression/services/complete_task.py new file mode 100644 index 0000000..31aab8d --- /dev/null +++ b/progression/services/complete_task.py @@ -0,0 +1 @@ +"""Service chargé de valider la réalisation d'une tâche.""" diff --git a/progression/services/reverse_completion.py b/progression/services/reverse_completion.py new file mode 100644 index 0000000..d2cfa3a --- /dev/null +++ b/progression/services/reverse_completion.py @@ -0,0 +1 @@ +"""Service chargé d’annuler une tâche réalisée et ses récompenses."""