feat: filter courses by release status

Author: wangeguo

Cargo.lock

@@ -8,7 +8,7 @@ resolver = "2"
 [package]
 name = "backend"
 description = "Backend API and services for StackClass"
-version = "1.0.1"
+version = "1.1.0"
 edition = "2024"
 
 default-run = "stackclass-server"

Cargo.toml

@@ -0,0 +1,4 @@
+-- Migration to add index on courses.release_status for better query performance
+
+-- Add index on release_status column
+CREATE INDEX idx_courses_release_status ON courses(release_status);

migrations/0012_add_release_status_index.sql

@@ -6,16 +6,16 @@
     "license": {
       "name": ""
     },
-    "version": "1.0.1"
+    "version": "1.1.0"
   },
   "paths": {
     "/v1/courses": {
       "get": {
         "tags": [
           "Course"
         ],
-        "summary": "Find all courses.",
-        "operationId": "find-all-courses",
+        "summary": "Find all released courses (beta and live status)",
+        "operationId": "find-released-courses",
         "responses": {
           "200": {
             "description": "Courses retrieved successfully",

openapi.json

@@ -38,17 +38,17 @@ use crate::{
 
 // The Course Service Handlers.
 
-/// Find all courses.
+/// Find all released courses (beta and live status)
 #[utoipa::path(
-    operation_id = "find-all-courses",
+    operation_id = "find-released-courses",
     get, path = "/v1/courses",
     responses(
         (status = 200, description = "Courses retrieved successfully", body = Vec<CourseResponse>),
     ),
     tag = "Course"
 )]
 pub async fn find(State(ctx): State<Arc<Context>>) -> Result<impl IntoResponse> {
-    Ok((StatusCode::OK, Json(CourseService::find(ctx).await?)))
+    Ok((StatusCode::OK, Json(CourseService::find_released(ctx).await?)))
 }
 
 /// Create a course.

src/handler/course.rs

@@ -82,6 +82,17 @@ impl CourseRepository {
         Ok(rows)
     }
 
+    /// Find all released courses (beta and live status)
+    pub(crate) async fn find_released(db: &Database) -> Result<Vec<CourseModel>> {
+        let rows = sqlx::query_as::<_, CourseModel>(
+            r#"SELECT * FROM courses WHERE release_status != 'alpha'"#,
+        )
+        .fetch_all(db.pool())
+        .await?;
+
+        Ok(rows)
+    }
+
     /// Update a course in the database.
     pub async fn update(tx: &mut Transaction<'_>, course: &CourseModel) -> Result<CourseModel> {
         let row = sqlx::query_as::<_, CourseModel>(

src/repository/course.rs

@@ -41,6 +41,12 @@ impl CourseService {
         Ok(courses.into_iter().map(Into::into).collect())
     }
 
+    /// Find all released courses (beta and live status)
+    pub async fn find_released(ctx: Arc<Context>) -> Result<Vec<CourseResponse>> {
+        let courses = CourseRepository::find_released(&ctx.database).await?;
+        Ok(courses.into_iter().map(Into::into).collect())
+    }
+
     /// Create new course from git repository URL
     pub async fn create(ctx: Arc<Context>, repository: &str) -> Result<CourseResponse> {
         let Config { cache_dir, github_token, .. } = &ctx.config;