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

apps/accounts/views.py

@@ -1,3 +1,14 @@
-from django.shortcuts import render
-
-# Create your views here.
+from rest_framework.permissions import IsAuthenticated
+from rest_framework.response import Response
+from rest_framework.views import APIView
+
+class MeView(APIView):
+    permission_classes = [IsAuthenticated]
+
+    def get(self,request):
+        return Response({
+            "id": request.user.id,
+            "username": request.user.username,
+            "email": request.user.email,
+            "is_staff": request.user.is_staff,
+        })

apps/common/api/auto_router.py

@@ -0,0 +1,9 @@
+def auto_register(router, viewsets: dict):
+    """
+    viewsets = {
+        "articles": ArticleViewSet,
+        "courses": CourseViewSet,
+    }
+    """
+    for prefix, viewset in viewsets.items():
+        router.register(prefix, viewset, basename=prefix)

apps/common/api/base_serializer.py

@@ -0,0 +1,11 @@
+from rest_framework.serializers import ModelSerializer
+
+class BaseModelSerializer(ModelSerializer):
+    """
+    Base Serializer สำหรับ CMS‑like API
+    - ใช้ fields = "__all__" เป็น default
+    """
+
+    class Meta:
+        abstract = True
+        fields = "__all__"

apps/common/api/base_viewset.py

@@ -0,0 +1,29 @@
+from rest_framework.viewsets import ModelViewSet
+from rest_framework.permissions import IsAuthenticated
+from rest_framework.filters import SearchFilter, OrderingFilter
+from django_filters.rest_framework import DjangoFilterBackend
+
+class BaseModelViewSet(ModelViewSet):
+    """
+    CMS-like Base ViewSet
+    - CRUD อัตโนมัติ
+    - Pagination (จาก settings.py)
+    - Filter / Search / Ordering
+    - Permission กลาง
+    """
+
+    # default permission (override ได้)
+    permission_classes = [IsAuthenticated]
+
+    # filter backend มาตรฐานแบบ CMS
+    filter_backends = [
+        DjangoFilterBackend,
+        SearchFilter,
+        OrderingFilter,
+    ]
+
+    # ค่า default (override ต่อ model)
+    filterset_fields = "__all__"
+    search_fields = []
+    ordering_fields = "__all__"
+    ordering = ["-id"]

apps/common/api/permissions.py

@@ -0,0 +1,12 @@
+from rest_framework.permissions import BasePermission, SAFE_METHODS
+
+class IsStaffOrReadOnly(BasePermission):
+    """
+    - อ่านได้ทุกคน
+    - เขียนได้เฉพาะ staff
+    """
+
+    def has_permission(self, request, view):
+        if request.method in SAFE_METHODS:
+            return True
+        return request.user and request.user.is_staff

apps/common/urls.py

@@ -1,7 +1,38 @@
-from django.urls import path
-
-from apps.common.views import HealthCheckView
-
-urlpatterns = [
-    path("health/", HealthCheckView.as_view(), name="health-check"),
+from django.urls import path, include
+from rest_framework.routers import DefaultRouter
+
+from apps.common.api.auto_router import auto_register
+from apps.common.views import HealthCheckView
+from apps.content.views import ArticleViewSet
+from apps.courses.views import CourseViewSet
+
+# Action-based Views (Enrollment / Progress)
+from apps.courses.views import (
+    EnrollCourseView,
+    MyCoursesView,
+    CompleteLessonView,
+)
+
+# Router สำหรับ CMS-like API
+router = DefaultRouter()
+
+# ใช้ auto_register เฉพาะกับ CMS‑like resources
+auto_register(router, {
+    "articles" : ArticleViewSet,
+    "courses" : CourseViewSet,
+})
+
+urlpatterns = [
+    # Health check
+    path("health/", HealthCheckView.as_view(), name="health-check"),
+
+    # CMS-like API
+    path("api/", include(router.urls)),
+
+    # Enrollment (user ↔ course)
+    path("api/courses/<int:course_id>/enroll/", EnrollCourseView.as_view(), name="enroll-course"),
+    path("api/my/courses/", MyCoursesView.as_view(), name="my-courses"),
+
+    # Progress tracking (user ↔ lesson)
+    path("api/lessons/<int:lesson_id>/complete/", CompleteLessonView.as_view(), name="complete-lesson"),
 ]

apps/content/admin.py

@@ -1,3 +1,10 @@
-from django.contrib import admin
-
-# Register your models here.
+from django.contrib import admin
+from apps.content.models import Article
+from unfold.admin import ModelAdmin
+
+@admin.register(Article)
+class ArticleAdmin(ModelAdmin):
+    list_display = ('id', 'title', 'published', 'created_at')
+    list_filter = ('published',)
+    search_fields = ('title',)
+

apps/content/apps.py

@@ -1,5 +1,5 @@
-from django.apps import AppConfig
-
-
-class ContentConfig(AppConfig):
-    name = 'apps.content'
+from django.apps import AppConfig
+
+class ContentConfig(AppConfig):
+    name = 'apps.content'
+    verbose_name = 'คลังเนื้อหา'

apps/content/migrations/0001_initial.py

@@ -0,0 +1,24 @@
+# Generated by Django 6.0.2 on 2026-05-02 23:06
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Article',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=200)),
+                ('body', models.TextField()),
+                ('published', models.BooleanField(default=False)),
+                ('create_at', models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+    ]

apps/content/migrations/0002_rename_create_at_article_created_at.py

@@ -0,0 +1,18 @@
+# Generated by Django 6.0.2 on 2026-05-02 23:10
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('content', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name='article',
+            old_name='create_at',
+            new_name='created_at',
+        ),
+    ]

apps/content/migrations/0003_alter_article_options.py

@@ -0,0 +1,17 @@
+# Generated by Django 6.0.2 on 2026-05-03 02:29
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('content', '0002_rename_create_at_article_created_at'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='article',
+            options={'verbose_name': 'บทความ', 'verbose_name_plural': 'บทความ'},
+        ),
+    ]

apps/content/models.py

@@ -1,3 +1,14 @@
-from django.db import models
-
-# Create your models here.
+from django.db import models
+
+class Article(models.Model):
+    title = models.CharField(max_length=200) # หัวข้อบทความ
+    body = models.TextField() # เนื้อหา
+    published = models.BooleanField(default=False) # ใช้เปิด/ปิดการแสดงผล
+    created_at = models.DateTimeField(auto_now_add=True) # เวลาสร้าง (เอาไว้ sort / paginate)
+
+    class Meta:
+        verbose_name = "บทความ"
+        verbose_name_plural = "บทความ"
+
+    def __str__(self):
+        return self.title

apps/content/serializers.py

@@ -0,0 +1,6 @@
+from apps.common.api.base_serializer import BaseModelSerializer
+from apps.content.models import Article
+
+class ArticleSerializer(BaseModelSerializer):
+    class Meta(BaseModelSerializer.Meta):
+        model = Article

apps/content/views.py

@@ -1,3 +1,12 @@
-from django.shortcuts import render
-
-# Create your views here.
+from apps.common.api.base_viewset import BaseModelViewSet
+from apps.content.models import Article
+from apps.content.serializers import ArticleSerializer
+
+class ArticleViewSet(BaseModelViewSet):
+    queryset = Article.objects.all()
+    serializer_class = ArticleSerializer
+
+    # CMS-like behavior
+    search_fields = ('title', 'body')
+    filterset_fields = ['published']
+    ordering = ['-created_at']

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)