Feat(Course): Fetch recent courses use case

README.md

@@ -196,10 +196,10 @@
 ### Courses
 - [ ] GET /courses/:courseId - Get course details
 - [ ] GET /courses/:courseId/instructor - Get course instructor details
-- [ ] GET /courses/:courseId/evaluations - Get course evaluations - make use case
+- [ ] GET /courses/:courseId/evaluation - Get course evaluation average
 - [ ] GET /courses/:courseId/stats - Get course statistics, like duration and number of classes
 - [ ] GET /courses/:courseId/metrics - Get course metrics for a dashboard
-- [ ] GET /courses - Get recent courses with instructor and evaluations - make use case
+- [ ] GET /courses - Get recent courses with instructor and evaluation average
 - [ ] GET /courses/filter - Filter courses by name or tags
 - [ ] GET /courses/:courseId/students - Get students enrolled in this course
 - [ ] GET /courses/:courseId/modules - Get course modules

src/domain/course-management/application/repositories/courses-repository.ts

@@ -8,6 +8,7 @@ import { type StudentWithCoursesDTO } from './../../enterprise/entities/dtos/stu
 
 export interface CoursesRepository {
   findById: (id: string) => Promise<Course | null>
+  findAll: () => Promise<Course[]>
   findManyByInstructorId: (instructorId: string) => Promise<Course[]>
   queryByName: (name: string) => Promise<Course[]>
   queryByTags: (tags: Tag[]) => Promise<Course[]>

src/domain/course-management/application/use-cases/fetch-recent-courses.spec.ts

@@ -0,0 +1,62 @@
+import { makeCourse } from '../../../../../test/factories/make-course'
+import { InMemoryClassesRepository } from '../../../../../test/repositories/in-memory-classes-repository'
+import { InMemoryCourseTagsRepository } from '../../../../../test/repositories/in-memory-course-tags-repository'
+import { InMemoryCoursesRepository } from '../../../../../test/repositories/in-memory-courses-repository'
+import { InMemoryEnrollmentsRepository } from '../../../../../test/repositories/in-memory-enrollments-repository'
+import { InMemoryInstructorRepository } from '../../../../../test/repositories/in-memory-instructors-repository'
+import { InMemoryModulesRepository } from '../../../../../test/repositories/in-memory-modules-repository'
+import { InMemoryStudentsRepository } from '../../../../../test/repositories/in-memory-students-repository'
+import { FetchRecentCoursesUseCase } from './fetch-recent-courses'
+
+let inMemoryClassesRepository: InMemoryClassesRepository
+let inMemoryCourseTagsRepository: InMemoryCourseTagsRepository
+let inMemoryEnrollmentsRepository: InMemoryEnrollmentsRepository
+let inMemoryStudentsRepository: InMemoryStudentsRepository
+let inMemoryInstructorsRepository: InMemoryInstructorRepository
+let inMemoryModulesRepository: InMemoryModulesRepository
+let inMemoryCoursesRepository: InMemoryCoursesRepository
+let sut: FetchRecentCoursesUseCase
+
+describe('Fetch recent courses use case', () => {
+  beforeEach(() => {
+    inMemoryClassesRepository = new InMemoryClassesRepository()
+    inMemoryCourseTagsRepository = new InMemoryCourseTagsRepository()
+    inMemoryStudentsRepository = new InMemoryStudentsRepository()
+    inMemoryInstructorsRepository = new InMemoryInstructorRepository()
+
+    inMemoryModulesRepository = new InMemoryModulesRepository(inMemoryClassesRepository)
+
+    inMemoryEnrollmentsRepository = new InMemoryEnrollmentsRepository(
+      inMemoryClassesRepository, inMemoryModulesRepository, inMemoryStudentsRepository
+    )
+    inMemoryCoursesRepository = new InMemoryCoursesRepository(inMemoryModulesRepository, inMemoryInstructorsRepository, inMemoryEnrollmentsRepository, inMemoryStudentsRepository, inMemoryCourseTagsRepository)
+
+    sut = new FetchRecentCoursesUseCase(inMemoryCoursesRepository)
+  })
+
+  it('should be able to fetch recent courses correctly', async () => {
+    const firstCourse = makeCourse({ name: 'John Doe Course 1', createdAt: new Date('2023-01-01') })
+    const secondCourse = makeCourse({ name: 'John Doe Course 2', createdAt: new Date('2023-01-02') })
+
+    await Promise.all([
+      inMemoryCoursesRepository.create(firstCourse),
+      inMemoryCoursesRepository.create(secondCourse)
+    ])
+
+    const result = await sut.exec()
+
+    console.log(result.value)
+
+    expect(result.isRight()).toBe(true)
+    expect(result.value).toMatchObject({
+      courses: [
+        expect.objectContaining({
+          name: 'John Doe Course 2'
+        }),
+        expect.objectContaining({
+          name: 'John Doe Course 1'
+        })
+      ]
+    })
+  })
+})

src/domain/course-management/application/use-cases/fetch-recent-courses.ts

@@ -0,0 +1,25 @@
+import { right, type Either } from '@/core/either'
+import { type UseCase } from '@/core/use-cases/use-case'
+import { type Course } from '../../enterprise/entities/course'
+import { type CoursesRepository } from '../repositories/courses-repository'
+
+type FetchRecentCoursesUseCaseResponse = Either<
+null,
+{
+  courses: Course[]
+}
+>
+
+export class FetchRecentCoursesUseCase implements UseCase<null, FetchRecentCoursesUseCaseResponse> {
+  constructor(
+    private readonly coursesRepository: CoursesRepository
+  ) { }
+
+  async exec(): Promise<FetchRecentCoursesUseCaseResponse> {
+    const courses = await this.coursesRepository.findAll()
+
+    return right({
+      courses
+    })
+  }
+}

src/domain/course-management/enterprise/entities/dtos/course-with-instructor-and-evaluation.ts

@@ -0,0 +1,8 @@
+import { type CourseDTO } from './course'
+import { type InstructorDTO } from './instructor'
+
+export interface CourseWithInstructorAndEvaluation {
+  course: CourseDTO
+  instructor: InstructorDTO
+  evaluationAverage: number
+}

test/repositories/in-memory-courses-repository.ts

@@ -37,6 +37,12 @@ export class InMemoryCoursesRepository implements CoursesRepository {
     return course
   }
 
+  async findAll(): Promise<Course[]> {
+    const courses = [...this.items]
+
+    return courses.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+  }
+
   async findManyByInstructorId(instructorId: string): Promise<Course[]> {
     return this.items.filter(courseToCompare => courseToCompare.instructorId.toString() === instructorId)
   }