feat: implement LMS core (CMS, Courses, Enrollment, Progress, Auth) (Admin + API)

apps/courses/admin.py

@@ -1,3 +1,29 @@
-from django.contrib import admin
-
-# Register your models here.
+from django.contrib import admin
+from unfold.admin import TabularInline, ModelAdmin
+from apps.courses.models import Lesson, Course, Enrollment, LessonProgress
+
+
+class LessonInLine(TabularInline):
+    model = Lesson
+    extra = 1
+
+@admin.register(Course)
+class CourseAdmin(ModelAdmin):
+    inlines = [LessonInLine]
+    list_display = ('id', 'title', 'published', 'created_at')
+    list_filter = ('published',)
+
+@admin.register(Lesson)
+class LessonAdmin(ModelAdmin):
+    list_display = ('id', 'title', 'course', 'order')
+    list_filter = ('course',)
+
+@admin.register(Enrollment)
+class EnrollmentAdmin(ModelAdmin):
+    list_display = ('id', 'course', 'enrolled_at')
+    list_filter = ('course',)
+
+@admin.register(LessonProgress)
+class LessonProgressAdmin(ModelAdmin):
+    list_display = ('user', 'lesson', 'completed')
+    list_filter = ('lesson', 'completed')

apps/courses/apps.py

@@ -1,5 +1,6 @@
-from django.apps import AppConfig
-
-
-class CoursesConfig(AppConfig):
-    name = 'apps.courses'
+from django.apps import AppConfig
+
+
+class CoursesConfig(AppConfig):
+    name = 'apps.courses'
+    verbose_name = 'หลักสูตร'

apps/courses/migrations/0001_initial.py

@@ -0,0 +1,35 @@
+# Generated by Django 6.0.2 on 2026-05-03 00:10
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Course',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=200)),
+                ('description', models.TextField()),
+                ('published', models.BooleanField(default=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Lesson',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=200)),
+                ('content', models.TextField()),
+                ('order', models.PositiveIntegerField(default=0)),
+                ('course', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='lessons', to='courses.course')),
+            ],
+        ),
+    ]

apps/courses/migrations/0002_enrollment_lessonprogress.py

@@ -0,0 +1,41 @@
+# Generated by Django 6.0.2 on 2026-05-03 01:32
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('courses', '0001_initial'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Enrollment',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('enrolled_at', models.DateTimeField(auto_now_add=True)),
+                ('course', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='enrollments', to='courses.course')),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='enrollments', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'unique_together': {('user', 'course')},
+            },
+        ),
+        migrations.CreateModel(
+            name='LessonProgress',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('completed', models.BooleanField(default=False)),
+                ('complete_at', models.DateTimeField(auto_now_add=True)),
+                ('lesson', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='progress_records', to='courses.lesson')),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='lesson_progress', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'unique_together': {('user', 'lesson')},
+            },
+        ),
+    ]

apps/courses/migrations/0003_alter_course_options_alter_enrollment_options_and_more.py

@@ -0,0 +1,29 @@
+# Generated by Django 6.0.2 on 2026-05-03 02:29
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('courses', '0002_enrollment_lessonprogress'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='course',
+            options={'verbose_name': 'หลักสูตร', 'verbose_name_plural': 'หลักสูตร'},
+        ),
+        migrations.AlterModelOptions(
+            name='enrollment',
+            options={'verbose_name': 'การลงทะเบียนเรียน', 'verbose_name_plural': 'การลงทะเบียนเรียน'},
+        ),
+        migrations.AlterModelOptions(
+            name='lesson',
+            options={'verbose_name': 'บทเรียน', 'verbose_name_plural': 'บทเรียน'},
+        ),
+        migrations.AlterModelOptions(
+            name='lessonprogress',
+            options={'verbose_name': 'ความคืบหน้าบทเรียน', 'verbose_name_plural': 'ความคืบหน้าบทเรียน'},
+        ),
+    ]

apps/courses/models.py

@@ -1,3 +1,73 @@
-from django.db import models
-
-# Create your models here.
+from django.db import models
+from core import settings
+
+User = settings.AUTH_USER_MODEL
+
+class Enrollment(models.Model):
+    user = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name='enrollments',
+    )
+    course = models.ForeignKey(
+        "Course",
+        on_delete=models.CASCADE,
+        related_name='enrollments',
+    )
+    enrolled_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        unique_together = (('user', 'course'),)
+        verbose_name = "การลงทะเบียนเรียน"
+        verbose_name_plural = "การลงทะเบียนเรียน"
+
+    def __str__(self):
+        return f"{self.user} enrolled in {self.course}"
+
+class LessonProgress(models.Model):
+    user = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name='lesson_progress',
+    )
+    lesson = models.ForeignKey(
+        "Lesson",
+        on_delete=models.CASCADE,
+        related_name='progress_records',
+    )
+    completed = models.BooleanField(default=False)
+    complete_at = models.DateTimeField(auto_now_add=True)
+    class Meta:
+        unique_together = (('user', 'lesson'),)
+        verbose_name = "ความคืบหน้าบทเรียน"
+        verbose_name_plural = "ความคืบหน้าบทเรียน"
+
+class Course(models.Model):
+    title = models.CharField(max_length=200)
+    description = models.TextField()
+    published = models.BooleanField(default=False)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        verbose_name = "หลักสูตร"
+        verbose_name_plural = "หลักสูตร"
+
+    def __str__(self):
+        return self.title
+
+class Lesson(models.Model):
+    course = models.ForeignKey(
+        Course,
+        related_name='lessons',
+        on_delete=models.CASCADE
+    )
+    title = models.CharField(max_length=200)
+    content = models.TextField()
+    order = models.PositiveIntegerField(default=0)
+
+    class Meta:
+        verbose_name = "บทเรียน"
+        verbose_name_plural = "บทเรียน"
+
+    def __str__(self):
+        return f"{self.course.title} - {self.title}"

apps/courses/serializers.py

@@ -0,0 +1,28 @@
+from rest_framework import serializers
+
+from apps.common.api.base_serializer import BaseModelSerializer
+from apps.courses.models import Lesson, Course
+
+class LessonSerializer(BaseModelSerializer):
+    class Meta(BaseModelSerializer.Meta):
+        model = Lesson
+
+class CourseSerializer(BaseModelSerializer):
+    lessons = LessonSerializer(many=True, read_only=True)
+
+    class Meta(BaseModelSerializer.Meta):
+        model = Course
+
+class EnrollCourseResponseSerializer(serializers.Serializer):
+    course_id = serializers.IntegerField()
+    enrolled_at = serializers.DateTimeField()
+
+class MyCourseSerializer(serializers.Serializer):
+    course_id = serializers.IntegerField()
+    title = serializers.CharField()
+    enrolled_at = serializers.DateTimeField()
+
+class CompleteLessonResponseSerializer(serializers.Serializer):
+    lesson_id = serializers.IntegerField()
+    completed = serializers.BooleanField()
+    completed_at = serializers.DateTimeField()

apps/courses/views.py

@@ -1,3 +1,73 @@
-from django.shortcuts import render
-
-# Create your views here.
+from django.utils import timezone
+from rest_framework.permissions import IsAuthenticated
+from rest_framework.response import Response
+from rest_framework.views import APIView
+
+from apps.common.api.base_viewset import BaseModelViewSet
+from apps.common.api.permissions import IsStaffOrReadOnly
+from apps.courses.models import Course, Enrollment, Lesson, LessonProgress
+from apps.courses.serializers import CourseSerializer, EnrollCourseResponseSerializer, MyCourseSerializer, \
+    CompleteLessonResponseSerializer
+
+
+class CourseViewSet(BaseModelViewSet):
+    queryset = Course.objects.all()
+    serializer_class = CourseSerializer
+    permission_classes = [IsStaffOrReadOnly]
+
+    search_fields = ('title', 'description')
+    filterset_fields = ['published']
+    ordering = ['-created_at']
+
+class EnrollCourseView(APIView):
+    permission_classes = [IsAuthenticated]
+
+    def post(self, request, course_id):
+        course = Course.objects.get(id=course_id)
+        enrollment, created = Enrollment.objects.get_or_create(user=request.user, course=course)
+        serializer = EnrollCourseResponseSerializer({
+            'course_id' : course.id,
+            'enrolled_at' : enrollment.enrolled_at,
+        })
+
+        return Response(serializer.data)
+
+class MyCoursesView(APIView):
+    permission_classes = [IsAuthenticated]
+
+    def get(self, request):
+        enrollments = Enrollment.objects.filter(user=request.user)
+
+        data = [
+            {
+                'course_id': e.course.id,
+                'title': e.course.title,
+                'enrolled_at': e.enrolled_at,
+           } for e in enrollments
+        ]
+
+        serializer = MyCourseSerializer(data, many=True)
+        return Response(serializer.data)
+
+class CompleteLessonView(APIView):
+    permission_classes = [IsAuthenticated]
+
+    def post(self, request, lesson_id):
+        lesson = Lesson.objects.get(id=lesson_id)
+
+        progress, _ = LessonProgress.objects.get_or_create(
+            user=request.user,
+            lesson=lesson
+        )
+
+        progress.completed = True
+        progress.complete_at = timezone.now()
+        progress.save()
+
+        serializer = CompleteLessonResponseSerializer({
+            'lesson_id' : lesson.id,
+            'completed' : progress.completed,
+            'completed_at' : progress.complete_at,
+        })
+
+        return Response(serializer.data)