chore: clarify progression service docstrings

achievements/services/evaluate_achievements.py

@@ -0,0 +1 @@
+"""Service chargé d’évaluer et d’attribuer les succès."""

achivements/services/evaluate_achievements.py

@@ -0,0 +1 @@
+Service chargé de valider la réalisation d'une tâche.

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)),
+            ],
+        ),
+    ]

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)

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')],
+            },
+        ),
+    ]

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)

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'),
+        ),
+    ]

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",
+            )
+        ]

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'),
+        ),
+    ]

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",
+            )
+        ]

config/settings.py

@@ -51,6 +51,9 @@ INSTALLED_APPS = [
     # Interface
     'tailwind',
 
+    # Tailwind
+    'theme',
+
     # Apps
     'apps.accounts',
     'apps.activities',
@@ -59,6 +62,8 @@ INSTALLED_APPS = [
     'apps.achievements',
 ]
 
+TAILWIND_APP_NAME = "theme"
+
 SITE_ID = 1
 AUTH_USER_MODEL = 'accounts.User'
 

progression/services/award_xp.py

@@ -0,0 +1 @@
+"""Service chargé d’attribuer les points d’expérience."""

progression/services/calculate_level.py

@@ -0,0 +1 @@
+"""Service chargé de calculer le niveau d’un joueur à partir de son expérience."""

progression/services/complete_task.py

@@ -0,0 +1 @@
+"""Service chargé de valider la réalisation d'une tâche."""

progression/services/reverse_completion.py

@@ -0,0 +1 @@
+"""Service chargé d’annuler une tâche réalisée et ses récompenses."""

requirements.txt

@@ -21,6 +21,7 @@ jsonschema-specifications==2025.9.1
 markdown-it-py==4.2.0
 MarkupSafe==3.0.4
 mdurl==0.1.2
+pillow==13.0.0
 psycopg==3.3.8
 psycopg-binary==3.3.8
 Pygments==2.21.0