add modules

apps/api/eslint.config.mjs

@@ -1,21 +1,20 @@
 import globals from "globals";
 import jsPlugin from "@eslint/js";
 import tsPlugin from "typescript-eslint";
-import unicornPlugin from 'eslint-plugin-unicorn';
-import prettierConfig from 'eslint-config-prettier';
-import prettierPluginRecommended from 'eslint-plugin-prettier/recommended';
-import sonarjs from 'eslint-plugin-sonarjs';
-
+import unicornPlugin from "eslint-plugin-unicorn";
+// import prettierConfig from "eslint-config-prettier";
+// import prettierPluginRecommended from "eslint-plugin-prettier/recommended";
+import sonarjs from "eslint-plugin-sonarjs";
 
 /** @type {import('eslint').Linter.Config[]} */
 export default [
   {
-    ignores: ["**/seed/**", "**/generated/**"]
+    ignores: ["**/seed/**", "**/generated/**"],
   },
   jsPlugin.configs.recommended,
-  unicornPlugin.configs['recommended'],
-  prettierPluginRecommended,
-  prettierConfig,
+  unicornPlugin.configs["recommended"],
+  // prettierPluginRecommended,
+  // prettierConfig,
   sonarjs.configs.recommended,
   ...tsPlugin.configs.recommended,
   {
@@ -29,9 +28,10 @@ export default [
       "sonarjs/no-hardcoded-passwords": "off",
       "sonarjs/cors": "off",
       "@typescript-eslint/no-namespace": "off",
+      "unicorn/no-useless-undefined": "off",
     },
     languageOptions: {
       globals: globals.node,
-    }
-  }
+    },
+  },
 ];

apps/api/package.json

@@ -19,12 +19,13 @@
     "@prisma/client": "6.11.1",
     "@tiptap/extension-horizontal-rule": "2.1.13",
     "adminjs": "^7.8.17",
+    "axios": "^1.11.0",
     "better-auth": "^1.2.12",
     "cors": "^2.8.5",
     "dotenv": "^17.2.1",
     "express": "^4.21.2",
     "express-async-errors": "^3.1.1",
-    "zod": "^3.24.3"
+    "zod": "^4.0.17"
   },
   "devDependencies": {
     "@better-auth/cli": "^1.2.12",

apps/api/prisma/migrations/20250813194643_adding_unique_id_quiz/migration.sql

@@ -0,0 +1,16 @@
+/*
+  Warnings:
+
+  - A unique constraint covering the columns `[userId,createdAt]` on the table `DailyQuiz` will be added. If there are existing duplicate values, this will fail.
+
+*/
+-- AlterTable
+ALTER TABLE "DailyQuiz" ADD COLUMN     "totalQuestions" INTEGER NOT NULL DEFAULT 10;
+
+-- AlterTable
+ALTER TABLE "Topic" ADD COLUMN     "attempted" INTEGER NOT NULL DEFAULT 0,
+ADD COLUMN     "difficulty" "QuestionDifficulty" NOT NULL DEFAULT 'easy',
+ADD COLUMN     "solved" INTEGER NOT NULL DEFAULT 0;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "DailyQuiz_userId_createdAt_key" ON "DailyQuiz"("userId", "createdAt");

apps/api/prisma/migrations/20250815080928_add_notes_model/migration.sql

@@ -0,0 +1,22 @@
+-- CreateTable
+CREATE TABLE "Note" (
+    "id" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+    "userId" TEXT NOT NULL,
+    "topicId" TEXT NOT NULL,
+    "courseId" TEXT NOT NULL,
+
+    CONSTRAINT "Note_pkey" PRIMARY KEY ("id")
+);
+
+-- AddForeignKey
+ALTER TABLE "Note" ADD CONSTRAINT "Note_userId_fkey" FOREIGN KEY ("userId") REFERENCES "user"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Note" ADD CONSTRAINT "Note_topicId_fkey" FOREIGN KEY ("topicId") REFERENCES "Topic"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Note" ADD CONSTRAINT "Note_courseId_fkey" FOREIGN KEY ("courseId") REFERENCES "Course"("id") ON DELETE CASCADE ON UPDATE CASCADE;

apps/api/prisma/migrations/20250819194732_adding_quiz_date/migration.sql

@@ -0,0 +1,15 @@
+/*
+  Warnings:
+
+  - A unique constraint covering the columns `[userId,quizDate]` on the table `DailyQuiz` will be added. If there are existing duplicate values, this will fail.
+  - Added the required column `quizDate` to the `DailyQuiz` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- DropIndex
+DROP INDEX "DailyQuiz_userId_createdAt_key";
+
+-- AlterTable
+ALTER TABLE "DailyQuiz" ADD COLUMN     "quizDate" TIMESTAMP(3) NOT NULL;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "DailyQuiz_userId_quizDate_key" ON "DailyQuiz"("userId", "quizDate");

apps/api/prisma/migrations/20250821101109_remove_performance_records_from_topic/migration.sql

@@ -0,0 +1,12 @@
+/*
+  Warnings:
+
+  - You are about to drop the column `attempted` on the `Topic` table. All the data in the column will be lost.
+  - You are about to drop the column `difficulty` on the `Topic` table. All the data in the column will be lost.
+  - You are about to drop the column `solved` on the `Topic` table. All the data in the column will be lost.
+
+*/
+-- AlterTable
+ALTER TABLE "Topic" DROP COLUMN "attempted",
+DROP COLUMN "difficulty",
+DROP COLUMN "solved";

apps/api/prisma/schema.prisma

@@ -49,6 +49,7 @@ model Course {
   createdAt   DateTime @default(now())
   updatedAt   DateTime @updatedAt
   topics      Topic[]
+  notes       Note[]
 }
 
 model Topic {
@@ -66,6 +67,26 @@ model Topic {
   userCompletions   UserCompletion[]
   questions         Question[]
   userPerformances  UserTopicPerformance[]
+
+  notes             Note[]
+}
+
+model Note {
+  id      String @id @default(cuid())
+  title   String
+  content String @db.Text
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // --- Relations ---
+  userId   String
+  user     User   @relation(fields: [userId], references: [id], onDelete: Cascade)
+  topicId  String
+  topic    Topic  @relation(fields: [topicId], references: [id], onDelete: Cascade)
+  courseId String
+  course   Course @relation(fields: [courseId], references: [id], onDelete: Cascade)
+
 }
 
 model UserCompletion {
@@ -134,6 +155,10 @@ model DailyQuiz {
   createdAt   DateTime  @default(now())
   updatedAt   DateTime  @updatedAt
   submittedAt DateTime?
+  totalQuestions Int @default(10)
+  quizDate    DateTime  // Should be set to the date (midnight) of the quiz, without time component
+
+  @@unique([userId, quizDate])
 }
 
 model User {
@@ -158,6 +183,7 @@ model User {
   trackId         String?
   joinedTrack     Track?           @relation(fields: [trackId], references: [id], onDelete: Cascade, name: "joinedTrack")
   userCompletions UserCompletion[]
+  notes           Note[]
 
   // Instructors
   createdTracks      Track[]
@@ -226,3 +252,4 @@ model Jwks {
 
   @@map("jwks")
 }
+

apps/api/src/app.ts

@@ -3,13 +3,20 @@ import express from "express";
 import { auth } from "./lib/auth.js";
 import { toNodeHandler } from "better-auth/node";
 import { admin, adminRouter } from "./lib/admin.js";
+import { router, ROUTES_PREFIX } from "./router.js";
+import { addEnhancedSendMethod } from "./middlewares/enhanced-send.js";
 
 const app = express();
-
 app.disable("x-powered-by");
 
 app.all("/api/auth/*", toNodeHandler(auth));
+
 app.use(admin.options.rootPath, adminRouter);
 console.log(`AdminJS is running under ${admin.options.rootPath}`);
 
+app.use(express.json());
+app.use(addEnhancedSendMethod);
+
+app.use(ROUTES_PREFIX, router);
+
 export default app;

apps/api/src/errors/already-submitted-quiz.ts

@@ -0,0 +1,12 @@
+import BaseError from "./base.js";
+
+export default class AlreadySubmittedQuiz extends BaseError<undefined> {
+  constructor() {
+    super(
+      "Quiz has already been submitted",
+      409,
+      undefined,
+      "You will be able to submit a new task by tomorrow",
+    );
+  }
+}

apps/api/src/errors/not-enough-topics.ts

@@ -0,0 +1,12 @@
+import BaseError from "./base.js";
+
+export default class NotEnoughTopics extends BaseError<undefined> {
+  constructor() {
+    super(
+      "Not enough topics completed",
+      422,
+      undefined,
+      "Start to complete more topics to be able to perform this action",
+    );
+  }
+}

apps/api/src/errors/not-found.ts

@@ -0,0 +1,12 @@
+import BaseError from "./base.js";
+
+export class NotFoundError extends BaseError<undefined> {
+  constructor(hint?: string) {
+    super(
+      "Not Found: Ensure the requested resource exists.",
+      404,
+      undefined,
+      hint,
+    );
+  }
+}

apps/api/src/helpers/dates.ts

@@ -0,0 +1,11 @@
+export const getMonthInterval = (month: number, year: number) => {
+  const start = new Date(year, month, 1);
+  const end = new Date(year, month + 1, 1);
+  return { start, end };
+};
+
+export const getStartOfDay = (d: Date) =>
+  new Date(d.getFullYear(), d.getMonth(), d.getDate());
+
+export const getNextDay = (d: Date) =>
+  new Date(d.getFullYear(), d.getMonth(), d.getDate() + 1);

apps/api/src/middlewares/auth.ts

@@ -12,7 +12,12 @@ declare global {
   }
 }
 
-export const requireAuth: RequestHandler = async (req, res, next) => {
+export const requireAuth: RequestHandler<
+  unknown,
+  unknown,
+  unknown,
+  unknown
+> = async (req, res, next) => {
   const data = await auth.api.getSession({
     headers: fromNodeHeaders(req.headers),
   });

apps/api/src/middlewares/enhanced-send.ts

@@ -0,0 +1,28 @@
+import { RequestHandler } from "express";
+import { Pagination } from "../schemas/pagination.js";
+
+declare global {
+  namespace Express {
+    export interface Response {
+      enhancedSend: (
+        statusCode: number,
+        data: unknown,
+        pagination?: Pagination,
+      ) => Response;
+    }
+  }
+}
+
+export const addEnhancedSendMethod: RequestHandler = (req, res, next) => {
+  res.enhancedSend = (statusCode, data, pagination) => {
+    const success = statusCode < 400;
+    return res.status(statusCode).json({
+      success,
+      statusCode,
+      timestamp: new Date(),
+      data,
+      pagination,
+    });
+  };
+  next();
+};

apps/api/src/router.ts

@@ -0,0 +1,14 @@
+import { Router } from "express";
+import { notesRouter } from "./routes/notes.js";
+import { tracksRouter } from "./routes/tracks.js";
+import { coursesRouter } from "./routes/courses.js";
+import { topicsRouter } from "./routes/topics.js";
+
+export const ROUTES_PREFIX = "/api";
+
+export const router = Router();
+
+router.use("/notes", notesRouter);
+router.use("/tracks", tracksRouter);
+router.use("/courses", coursesRouter);
+router.use("/topics", topicsRouter);

apps/api/src/routes/courses.ts

@@ -0,0 +1,54 @@
+import exprees from "express";
+const router = exprees.Router();
+import { requireAuth } from "../middlewares/auth.js";
+import { validate } from "../middlewares/validate.js";
+import {
+  getCourseParamsSchema,
+  getCourseQuerySchema,
+} from "../schemas/courses.js";
+import * as Service from "../services/courses.js";
+import * as topicService from "../services/topics.js";
+
+router.get(
+  "/:courseId",
+  requireAuth,
+  validate({ params: getCourseParamsSchema }),
+  async (req, res) => {
+    const course = await Service.getCourse(req.params.courseId);
+
+    const totalTopics = await Service.getToltalTopics(req.params.courseId);
+
+    const completedTopics = await Service.getCompletedTopics(
+      req.user!.id,
+      req.params.courseId,
+    );
+    const completedPercentage =
+      (completedTopics.length / totalTopics.length) * 100;
+
+    res.enhancedSend(200, {
+      ...course,
+      topics: totalTopics,
+      completedPercentage,
+    });
+  },
+);
+
+router.get(
+  "/:courseId/topics",
+  requireAuth,
+  validate({ params: getCourseParamsSchema, query: getCourseQuerySchema }),
+  async (req, res) => {
+    const { completed } = req.query;
+
+    const topics = await topicService.getToltalTopics(
+      req.params.courseId,
+      completed
+        ? { isCompleted: completed === "true", userId: req.user!.id }
+        : undefined,
+    );
+
+    res.enhancedSend(200, topics);
+  },
+);
+
+export { router as coursesRouter };