feat(course): add list courses endpoint

Author: Defelo

Cargo.lock

@@ -58,6 +58,8 @@ academy_core_config_contracts.path = "academy_core/config/contracts"
 academy_core_config_impl.path = "academy_core/config/impl"
 academy_core_contact_contracts.path = "academy_core/contact/contracts"
 academy_core_contact_impl.path = "academy_core/contact/impl"
+academy_core_course_contracts.path = "academy_core/course/contracts"
+academy_core_course_impl.path = "academy_core/course/impl"
 academy_core_finance_contracts.path = "academy_core/finance/contracts"
 academy_core_finance_impl.path = "academy_core/finance/impl"
 academy_core_health_contracts.path = "academy_core/health/contracts"

Cargo.nix

@@ -20,6 +20,8 @@ academy_core_coin_contracts.workspace = true
 academy_core_coin_impl.workspace = true
 academy_core_config_impl.workspace = true
 academy_core_contact_impl.workspace = true
+academy_core_course_contracts.workspace = true
+academy_core_course_impl.workspace = true
 academy_core_finance_contracts.workspace = true
 academy_core_finance_impl.workspace = true
 academy_core_health_impl.workspace = true

Cargo.toml

@@ -8,6 +8,7 @@ use academy_cache_valkey::ValkeyCache;
 use academy_core_coin_impl::{CoinFeatureServiceImpl, coin::CoinServiceImpl};
 use academy_core_config_impl::ConfigFeatureServiceImpl;
 use academy_core_contact_impl::ContactFeatureServiceImpl;
+use academy_core_course_impl::CourseFeatureServiceImpl;
 use academy_core_finance_impl::{
     FinanceFeatureServiceImpl, coin::FinanceCoinServiceImpl, invoice::FinanceInvoiceServiceImpl,
 };
@@ -68,6 +69,7 @@ pub type RestServer = academy_api_rest::RestServer<
     FinanceFeature,
     HeartFeature,
     PremiumFeature,
+    CourseFeature,
     Internal,
 >;
 
@@ -231,4 +233,6 @@ pub type PremiumPlan = PremiumPlanServiceImpl;
 pub type Premium = PremiumServiceImpl<Time, PremiumPurchase, PremiumRepo>;
 pub type PremiumPurchase = PremiumPurchaseServiceImpl<Id, Time, Coin, PremiumPlan, PremiumRepo>;
 
+pub type CourseFeature = CourseFeatureServiceImpl;
+
 pub type Internal = InternalServiceImpl<Database, AuthInternal, UserRepo, Coin, Heart, Premium>;

academy/Cargo.toml

@@ -15,6 +15,7 @@ academy_auth_contracts.workspace = true
 academy_core_coin_contracts.workspace = true
 academy_core_config_contracts.workspace = true
 academy_core_contact_contracts.workspace = true
+academy_core_course_contracts.workspace = true
 academy_core_finance_contracts.workspace = true
 academy_core_health_contracts.workspace = true
 academy_core_heart_contracts.workspace = true

academy/src/environment/types.rs

@@ -6,6 +6,7 @@ use std::{
 use academy_core_coin_contracts::CoinFeatureService;
 use academy_core_config_contracts::ConfigFeatureService;
 use academy_core_contact_contracts::ContactFeatureService;
+use academy_core_course_contracts::CourseFeatureService;
 use academy_core_finance_contracts::FinanceFeatureService;
 use academy_core_health_contracts::HealthFeatureService;
 use academy_core_heart_contracts::HeartFeatureService;
@@ -57,6 +58,7 @@ pub struct RestServer<
     Finance,
     Heart,
     Premium,
+    Course,
     Internal,
 > {
     _config: RestServerConfig,
@@ -72,6 +74,7 @@ pub struct RestServer<
     finance: Finance,
     heart: Heart,
     premium: Premium,
+    course: Course,
     internal: Internal,
 }
 
@@ -101,6 +104,7 @@ impl<
     Finance,
     Heart,
     Premium,
+    Course,
     Internal,
 >
     RestServer<
@@ -116,6 +120,7 @@ impl<
         Finance,
         Heart,
         Premium,
+        Course,
         Internal,
     >
 where
@@ -131,6 +136,7 @@ where
     Finance: FinanceFeatureService,
     Heart: HeartFeatureService,
     Premium: PremiumFeatureService,
+    Course: CourseFeatureService,
     Internal: InternalService,
 {
     pub async fn serve(self) -> anyhow::Result<()> {
@@ -162,6 +168,7 @@ where
                 routes::finance::TAG,
                 routes::heart::TAG,
                 routes::premium::TAG,
+                routes::course::TAG,
                 routes::internal::TAG,
             ]
             .into_iter()
@@ -239,6 +246,7 @@ where
             .merge(routes::finance::router(self.finance.into()))
             .merge(routes::heart::router(self.heart.into()))
             .merge(routes::premium::router(self.premium.into()))
+            .merge(routes::course::router(self.course.into()))
             .merge(routes::internal::router(self.internal.into()))
     }
 }

academy_api/rest/Cargo.toml

@@ -0,0 +1,117 @@
+use academy_models::{
+    SearchTerm,
+    course::{
+        CourseAuthor, CourseAuthorName, CourseDescription, CourseFilter, CourseId,
+        CourseLectureTitle, CourseLectureUserSummary, CourseSectionTitle, CourseSectionUserSummary,
+        CourseTitle, CourseUserSummary,
+    },
+    url::Url,
+};
+use schemars::JsonSchema;
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, JsonSchema)]
+pub struct ApiCourseUserSummary {
+    pub id: CourseId,
+    pub title: CourseTitle,
+    pub description: CourseDescription,
+    pub category: Option<String>,
+    pub language: Option<&'static str>,
+    pub image: Option<Url>,
+    pub authors: Vec<ApiCourseAuthor>,
+    pub price: u64,
+    pub learnings_goals: Vec<String>,
+    pub requirements: Vec<String>,
+    pub last_update: i64,
+    pub sections: Vec<ApiCourseSectionUserSummary>,
+    pub completed: Option<bool>,
+}
+
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, JsonSchema)]
+pub struct ApiCourseAuthor {
+    pub name: CourseAuthorName,
+    pub url: Option<Url>,
+}
+
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, JsonSchema)]
+pub struct ApiCourseSectionUserSummary {
+    pub title: CourseSectionTitle,
+    pub lectures: Vec<ApiCourseLectureUserSummary>,
+    pub completed: Option<bool>,
+}
+
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, JsonSchema)]
+pub struct ApiCourseLectureUserSummary {
+    pub title: CourseLectureTitle,
+    pub duration: u64,
+    pub completed: Option<bool>,
+}
+
+#[derive(Debug, Clone, PartialEq, Eq, Deserialize, JsonSchema)]
+pub struct ApiCourseFilter {
+    /// Search in `title`
+    pub search_term: Option<SearchTerm>,
+    /// Filter by author
+    pub author: Option<SearchTerm>,
+    /// Return only free (`true`) or unfree (`false`) courses
+    pub free: Option<bool>,
+}
+
+impl From<CourseUserSummary> for ApiCourseUserSummary {
+    fn from(value: CourseUserSummary) -> Self {
+        Self {
+            id: value.base.id,
+            title: value.base.title,
+            description: value.base.description,
+            category: None,
+            language: Some("de"),
+            image: value.base.image_url,
+            authors: value.base.authors.into_iter().map(Into::into).collect(),
+            price: value.base.price,
+            learnings_goals: vec![],
+            requirements: vec![],
+            last_update: value.base.last_update.timestamp(),
+            sections: value.sections.into_iter().map(Into::into).collect(),
+            completed: value.completed,
+        }
+    }
+}
+
+impl From<CourseAuthor> for ApiCourseAuthor {
+    fn from(value: CourseAuthor) -> Self {
+        Self {
+            name: value.name,
+            url: value.url,
+        }
+    }
+}
+
+impl From<CourseSectionUserSummary> for ApiCourseSectionUserSummary {
+    fn from(value: CourseSectionUserSummary) -> Self {
+        Self {
+            title: value.title,
+            lectures: value.lectures.into_iter().map(Into::into).collect(),
+            completed: value.completed,
+        }
+    }
+}
+
+impl From<CourseLectureUserSummary> for ApiCourseLectureUserSummary {
+    fn from(value: CourseLectureUserSummary) -> Self {
+        Self {
+            title: value.title,
+            duration: value.duration.as_secs(),
+            completed: value.completed,
+        }
+    }
+}
+
+impl From<ApiCourseFilter> for CourseFilter {
+    fn from(value: ApiCourseFilter) -> Self {
+        Self {
+            search_term: value.search_term,
+            author: value.author,
+            free: value.free,
+        }
+    }
+}