not-andy-branch

.gitignore

@@ -19,6 +19,7 @@ frontend/.env
 # vim
 *.swp
 *.*~
+/*~
 
 # OS files
 .DS_Store

backend/api/models.py

@@ -1,11 +1,116 @@
+from django.core.validators import MaxValueValidator, MinValueValidator
 from django.db import models
 
-# Create your models here.
+from colorfield.fields import ColorField
+
 from django.contrib.auth.models import User
 
-class UserProgress(models.Model):
+class UserProfile(models.Model):
     user = models.OneToOneField(User, on_delete=models.CASCADE)
+
+
+class UserProgress(models.Model):
+    user = models.OneToOneField(UserProfile, on_delete=models.CASCADE)
     data = models.JSONField(default=dict)
 
     def __str__(self):
-        return f"{self.user.username}'s level progress"
+        return f"{self.user.username}'s level progress"
+
+
+
+class Level(models.Model):
+    COLOR_PALETTE = [
+        ("#FFFFFF", "white",),
+        ("#000000", "black",),
+    ]
+    level = models.IntegerField(default=1, blank=True, null=True)
+    level_name = models.CharField(max_length=200)
+    experience = models.IntegerField(default=0, blank=True, null=True)
+    icon = models.ImageField(blank=True, null=True)
+    color_wheel = ColorField(samples=COLOR_PALETTE, blank=True, null=True)
+    color = models.CharField(max_length=500, blank=True, null=True, help_text="Comma-separated hex colors for gradient")
+    display_name = models.CharField(
+        max_length=300,
+        blank=True,
+        editable=False,
+        verbose_name="Display Name (with Roman if needed)"
+    )
+
+    is_active = models.IntegerField(
+        default=1,
+        blank=True,
+        null=True,
+        help_text='1->Active, 0->Inactive',
+        choices=((1, 'Active'), (0, 'Inactive')),
+        verbose_name="Set active?"
+    )
+
+    def __str__(self):
+        return f"{self.level_name} (Level {self.level})"
+
+#essentially treated like a through model branching together users & levels
+class User_Level(models.Model):
+    COLOR_PALETTE = [
+        ("#FFFFFF", "white",),
+        ("#000000", "black",),
+    ]
+    level = models.ForeignKey(Level, on_delete=models.CASCADE)
+    min_accuracy = models.FloatField(validators=[MaxValueValidator(100)])
+    max_keystrokes = models.IntegerField(blank=True, null=True)
+    stars = models.IntegerField(validators=[MinValueValidator(1), MaxValueValidator(1)]) #create a function to determine accuracy & time, pulled from frontend data
+    is_active = models.IntegerField(
+        default=1,
+        blank=True,
+        null=True,
+        help_text='1->Active, 0->Inactive',
+        choices=((1, 'Active'), (0, 'Inactive')),
+        verbose_name="Set active?"
+    )
+
+    def __str__(self):
+        return f"{self.level_name} (Level {self.level})"
+
+    class Meta():
+        verbose_name_plural = "User's Levels"
+
+
+
+class UserLevelInstance(models.Model):
+    user = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name="level_attempts"
+    )
+    level = models.ForeignKey(
+        Level,
+        on_delete=models.CASCADE,
+        related_name="user_instances"
+    )
+    max_time = models.FloatField(
+        blank=True, null=True,
+        help_text="Time taken (seconds) to complete the level"
+    )
+    stroke_count = models.IntegerField(
+        blank=True, null=True,
+        help_text="Number of keystrokes used during the attempt"
+    )
+    accuracy = models.FloatField(
+        blank=True, null=True,
+        help_text="Accuracy percentage (0–100) submitted by the frontend"
+    )
+    completed = models.BooleanField(default=False)
+    stars_earned = models.IntegerField(
+        default=0,
+        validators=[MinValueValidator(0), MaxValueValidator(3)],
+        help_text="0=not completed, 1=completed, 2=+accuracy, 3=+accuracy & time"
+    )
+    attempted_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        ordering = ["-stars_earned", "-attempted_at"]
+
+    def __str__(self):
+        return (
+            f"{self.user.username} → Level {self.level_id} | "
+            f"{'✓' if self.completed else '✗'} | ⭐{self.stars_earned}"
+        )

backend/api/serializers.py

@@ -0,0 +1,17 @@
+from rest_framework import serializers
+from .models import Level
+
+class LevelSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Level
+        fields = [
+            'id',
+            'level',
+            'level_name',
+            'display_name',
+            'experience',
+            'color',
+            'color_wheel',
+            'icon',
+            'is_active',
+        ]

backend/api/urls.py

@@ -1,9 +1,13 @@
 from django.urls import path
 from . import views
+from .views import StarView, ProgressView
 
 urlpatterns = [
     path('auth/register/', views.RegisterView.as_view()),
     path('auth/me/', views.UserDetailView.as_view()),
-    path('progress/', views.get_progress),
+    path('progress/', views.UserProgress),
     path('progress/save/', views.save_level),
+    path("api/stars/<int:level_id>/", StarView.as_view(), name="star-view"),
+    path("api/progress/", ProgressView.as_view(), name="progress"),
+    path("api/progress/save/", ProgressView.as_view(), name="progress-save"),
 ]