Deploy Backend from GitHub Actions Commit: 1c0ff318f0e1e2dcc5a8efca696bd39b29d61aaa

package-lock.json

@@ -15,6 +15,7 @@
         "@nestjs/passport": "^11.0.5",
         "@nestjs/platform-express": "^11.1.27",
         "@nestjs/swagger": "^11.4.4",
+        "@nestjs/throttler": "^6.5.0",
         "@prisma/client": "^5.7.0",
         "@supabase/supabase-js": "^2.39.0",
         "bcryptjs": "^3.0.3",
@@ -1891,6 +1892,17 @@
         }
       }
     },
+    "node_modules/@nestjs/throttler": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/@nestjs/throttler/-/throttler-6.5.0.tgz",
+      "integrity": "sha512-9j0ZRfH0QE1qyrj9JjIRDz5gQLPqq9yVC2nHsrosDVAfI5HHw08/aUAWx9DZLSdQf4HDkmhTTEGLrRFHENvchQ==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@nestjs/common": "^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0",
+        "@nestjs/core": "^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0",
+        "reflect-metadata": "^0.1.13 || ^0.2.0"
+      }
+    },
     "node_modules/@noble/hashes": {
       "version": "1.8.0",
       "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz",
@@ -4612,6 +4624,7 @@
       "version": "2.3.3",
       "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
       "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
       "optional": true,

package.json

@@ -27,6 +27,7 @@
     "@nestjs/passport": "^11.0.5",
     "@nestjs/platform-express": "^11.1.27",
     "@nestjs/swagger": "^11.4.4",
+    "@nestjs/throttler": "^6.5.0",
     "@prisma/client": "^5.7.0",
     "@supabase/supabase-js": "^2.39.0",
     "bcryptjs": "^3.0.3",

prisma/schema.prisma

@@ -84,12 +84,9 @@ model ConceptNode {
   comments      Comment[]
   quizzes       Quiz[]
 
-  // Synchronized Lesson Framework Fields
-  storyIntro     Json?
-  lessonContents Json?
-  minigame       Json?
-  finalSummary   Json?
-  lessonType     String?            // "classic" | "adventure"
+  // Component-based Lesson Flow
+  lessonFlow     Json?
+  lessonType     String             @default("flow")
 
   @@index([chapterId, orderIndex])
 }
@@ -179,6 +176,10 @@ model Progress {
   flashcardCompleted Boolean     @default(false)
   podcastCompleted   Boolean     @default(false)
   quizCompleted      Boolean     @default(false)
+  activeComponentId  String?
+  currentComponentIndex Int      @default(0)
+  completedComponentIds Json?
+  componentResults   Json?
   updatedAt          DateTime    @updatedAt
   user               User        @relation(fields: [userId], references: [id], onDelete: Cascade)
   node               ConceptNode @relation(fields: [nodeId], references: [id], onDelete: Cascade)

prisma/seed.ts

@@ -6,6 +6,270 @@ import { createClient } from '@supabase/supabase-js';
 
 const prisma = new PrismaClient();
 
+function buildDefaultLessonFlow(node: any) {
+  const flow: any[] = [];
+
+  if (node.videoUrl) {
+    flow.push({
+      id: 'lesson-video',
+      type: 'media',
+      title: 'Video nhập môn',
+      config: {
+        mediaType: 'video',
+        url: node.videoUrl,
+        title: node.title,
+        subtitle: node.quickTake,
+      },
+      completionRule: { type: 'viewed' },
+    });
+  }
+
+  flow.push({
+    id: 'main-reading',
+    type: 'markdown',
+    title: node.title,
+    config: {
+      content: node.originalText,
+    },
+    completionRule: { type: 'viewed' },
+  });
+
+  flow.push({
+    id: 'quick-check',
+    type: 'mcq',
+    title: 'Kiểm tra nhanh',
+    config: {
+      question: `Ý chính của bài "${node.title}" là gì?`,
+      options: [
+        { id: 'a', text: node.quickTake, isCorrect: true, explanation: node.summary },
+        { id: 'b', text: 'Đây chỉ là một nội dung phụ, chưa phản ánh trọng tâm bài học.', isCorrect: false },
+        { id: 'c', text: 'Bài học này không có mối liên hệ với thế giới quan và phương pháp luận.', isCorrect: false },
+      ],
+    },
+    completionRule: { type: 'correct' },
+  });
+
+  flow.push({
+    id: 'final-summary',
+    type: 'final_summary',
+    title: 'Đúc kết bài học',
+    config: {
+      message: node.quickTake,
+      keyTakeaways: [node.summary],
+      rewards: { xp: 80, badge: 'Hoàn thành bài học' },
+    },
+    completionRule: { type: 'viewed' },
+  });
+
+  return flow;
+}
+
+function buildOriginLessonFlow(node: any) {
+  return [
+    {
+      id: 'origin-intro',
+      type: 'dialogue',
+      title: 'Nhiệm vụ khai sáng',
+      config: {
+        lines: [
+          {
+            who: 'guide',
+            text: 'Nhiệm vụ của bạn: đi tìm nguồn gốc khai sinh của triết học. Hành trình này có hai mảnh ghép: nguồn gốc nhận thức và nguồn gốc xã hội.',
+          },
+        ],
+      },
+      completionRule: { type: 'viewed' },
+    },
+    {
+      id: 'origin-video',
+      type: 'media',
+      title: 'Bối cảnh cổ đại',
+      config: {
+        mediaType: 'video',
+        url: node.videoUrl,
+        title: 'Triết học ra đời trong bước ngoặt tư duy của nhân loại',
+        subtitle: 'Từ huyền thoại đến lý luận',
+      },
+      completionRule: { type: 'viewed' },
+    },
+    {
+      id: 'cognitive-origin',
+      type: 'mcq',
+      title: 'Nguồn gốc nhận thức',
+      config: {
+        question: 'Điều gì làm cho tư duy triết học bắt đầu thay thế tư duy huyền thoại?',
+        options: [
+          { id: 'a', text: 'Con người bắt đầu tìm quy luật và lý lẽ để giải thích thế giới.', isCorrect: true, explanation: 'Đây là bước chuyển từ niềm tin huyền thoại sang tư duy lý luận.' },
+          { id: 'b', text: 'Con người từ bỏ hoàn toàn nhu cầu hiểu biết thế giới.', isCorrect: false },
+          { id: 'c', text: 'Con người chỉ tăng cường nghi lễ cúng bái.', isCorrect: false },
+        ],
+      },
+      completionRule: { type: 'correct' },
+    },
+    {
+      id: 'social-origin-chain',
+      type: 'sequence_sorting',
+      title: 'Chuỗi nhân quả xã hội',
+      config: {
+        instruction: 'Chọn các mắt xích theo đúng thứ tự hình thành điều kiện xã hội của triết học.',
+        items: [
+          { id: 'c1', order: 0, text: 'Sản xuất phát triển, của cải dư thừa và chế độ tư hữu hình thành.' },
+          { id: 'c2', order: 1, text: 'Xã hội phân chia giai cấp.' },
+          { id: 'c3', order: 2, text: 'Lao động trí óc tách khỏi lao động chân tay.' },
+          { id: 'c4', order: 3, text: 'Tầng lớp trí thức hệ thống hóa tri thức thành triết học.' },
+        ],
+        successFeedback: 'Chuỗi nhân quả đã hoàn chỉnh: đây là nguồn gốc xã hội của triết học.',
+      },
+      completionRule: { type: 'correct' },
+    },
+    {
+      id: 'origin-reading',
+      type: 'markdown',
+      title: 'Đúc kết hai nguồn gốc',
+      config: {
+        content: node.originalText,
+      },
+      completionRule: { type: 'viewed' },
+    },
+    {
+      id: 'origin-final',
+      type: 'final_summary',
+      title: 'Hoàn thành bài học',
+      config: {
+        message: node.quickTake,
+        keyTakeaways: [
+          'Nguồn gốc nhận thức: nhu cầu hiểu biết thế giới và năng lực tư duy trừu tượng.',
+          'Nguồn gốc xã hội: phân công lao động, giai cấp và tầng lớp trí thức.',
+        ],
+        rewards: { xp: 120, badge: 'Nhà Khai Sáng' },
+      },
+      completionRule: { type: 'viewed' },
+    },
+  ];
+}
+
+function buildLesson1bFlow(source: any) {
+  return [
+    {
+      id: 'ancient-origin-map',
+      type: 'target_matching',
+      title: 'Nguồn gốc thuật ngữ triết học',
+      config: {
+        targets: [
+          { id: 'china', label: 'Trung Quốc', icon: 'temple_buddhist' },
+          { id: 'india', label: 'Ấn Độ', icon: 'water' },
+          { id: 'greece', label: 'Hy Lạp', icon: 'account_balance' },
+        ],
+        items: [
+          { id: 'zhe', text: '哲', targetId: 'china' },
+          { id: 'darsana', text: "Dar'sana", targetId: 'india' },
+          { id: 'philosophia', text: 'φιλοσοφία', targetId: 'greece' },
+        ],
+        summary: 'Triết học xuất hiện ở nhiều trung tâm văn minh lớn và biểu hiện nhu cầu nhận thức bậc cao của con người.',
+      },
+      completionRule: { type: 'correct' },
+    },
+    {
+      id: 'worldview-sorting',
+      type: 'category_sorting',
+      title: 'Phân loại thế giới quan',
+      config: {
+        categories: [
+          { id: 'myth-religion', label: 'Thần thoại - Tôn giáo' },
+          { id: 'philosophy', label: 'Triết học' },
+        ],
+        cards: [
+          { id: 'faith', text: 'Niềm tin', categoryId: 'myth-religion' },
+          { id: 'ritual', text: 'Nghi lễ', categoryId: 'myth-religion' },
+          { id: 'reason', text: 'Công cụ lý tính', categoryId: 'philosophy' },
+          { id: 'law', text: 'Quy luật', categoryId: 'philosophy' },
+        ],
+        summary: 'Triết học tìm cách lý giải thế giới bằng lý tính, logic và khái quát hóa.',
+      },
+      completionRule: { type: 'correct' },
+    },
+    {
+      id: 'philosophy-features',
+      type: 'mindmap_reveal',
+      title: 'Bốn đặc trưng cốt lõi',
+      config: {
+        center: 'Triết học',
+        nodes: [
+          { id: 'social-consciousness', label: 'Hình thái ý thức xã hội', detail: 'Triết học là một hình thái ý thức xã hội bậc cao.' },
+          { id: 'whole', label: 'Chỉnh thể toàn vẹn', detail: 'Triết học xem xét thế giới trong tính chỉnh thể.' },
+          { id: 'universal-laws', label: 'Quy luật phổ biến', detail: 'Triết học hướng tới các quy luật chung nhất của tự nhiên, xã hội và tư duy.' },
+          { id: 'worldview-core', label: 'Hạt nhân thế giới quan', detail: 'Triết học là hạt nhân lý luận của thế giới quan.' },
+        ],
+      },
+      completionRule: { type: 'viewed' },
+    },
+    {
+      id: 'marxist-definition',
+      type: 'mcq',
+      title: 'Định nghĩa triết học Mác - Lênin',
+      config: {
+        question: 'Định nghĩa nào phù hợp nhất với triết học Mác - Lênin?',
+        options: [
+          { id: 'a', text: 'Tập hợp các niềm tin tôn giáo.', isCorrect: false },
+          { id: 'b', text: 'Hệ thống tri thức lý luận chung nhất về thế giới, vị trí con người trong thế giới và phương pháp nhận thức, cải tạo thế giới.', isCorrect: true, explanation: 'Đây là cách hiểu khái quát về chức năng thế giới quan và phương pháp luận của triết học.' },
+          { id: 'c', text: 'Một khoa học thực nghiệm nghiên cứu riêng một lĩnh vực.', isCorrect: false },
+        ],
+      },
+      completionRule: { type: 'correct' },
+    },
+    {
+      id: 'philosophy-science-matching',
+      type: 'matching_columns',
+      title: 'Phân biệt tri thức triết học và khoa học cụ thể',
+      config: {
+        leftColumn: [
+          { id: 'philosophy', text: 'Tri thức triết học' },
+          { id: 'specific-science', text: 'Khoa học cụ thể' },
+          { id: 'worldview', text: 'Thế giới quan' },
+        ],
+        rightColumn: [
+          { id: 'general', text: 'Khái quát những vấn đề chung nhất' },
+          { id: 'domain', text: 'Nghiên cứu một lĩnh vực, đối tượng cụ thể' },
+          { id: 'orientation', text: 'Định hướng cách con người nhìn nhận thế giới' },
+        ],
+        correctPairs: [
+          { leftId: 'philosophy', rightId: 'general' },
+          { leftId: 'specific-science', rightId: 'domain' },
+          { leftId: 'worldview', rightId: 'orientation' },
+        ],
+      },
+      completionRule: { type: 'correct' },
+    },
+    {
+      id: 'all-philosophy-is-science',
+      type: 'true_false',
+      title: 'Mọi học thuyết triết học đều là khoa học?',
+      config: {
+        statement: 'Mọi học thuyết triết học đều là khoa học.',
+        correctAnswer: false,
+        explanation: 'Không phải mọi học thuyết triết học đều khoa học; tính khoa học phụ thuộc vào cơ sở lý luận, phương pháp và khả năng phản ánh đúng hiện thực.',
+      },
+      completionRule: { type: 'correct' },
+    },
+    {
+      id: 'lesson-1b-final',
+      type: 'final_summary',
+      title: 'Hoàn thành bài 1.b',
+      config: {
+        message: source.finalSummary?.summary?.finalStatement || 'Bạn đã nắm được khái niệm triết học.',
+        keyTakeaways: [
+          'Triết học là hệ thống tri thức lý luận chung nhất về thế giới.',
+          'Triết học là hạt nhân lý luận của thế giới quan.',
+          'Cần phân biệt tri thức triết học với tri thức của các khoa học cụ thể.',
+        ],
+        rewards: source.finalSummary?.rewards || { xp: 120, badge: 'Người khai mở tư duy' },
+        quiz: source.finalSummary?.quiz || [],
+      },
+      completionRule: { type: 'viewed' },
+    },
+  ];
+}
+
 async function main() {
   console.log('Seeding PhiloMind philosophy sanctuary database with Vietnamese Marxist-Leninist Philosophy...');
 
@@ -380,6 +644,11 @@ async function main() {
   const createdCh1Nodes = [];
   for (const n of ch1Nodes) {
     const isNode2 = n.title === 'Khái niệm triết học';
+    const lessonFlow = isNode2
+      ? buildLesson1bFlow(seedingData.lesson_1b)
+      : n.title === 'Nguồn gốc của triết học'
+        ? buildOriginLessonFlow(n)
+        : buildDefaultLessonFlow(n);
     const node = await prisma.conceptNode.create({
       data: {
         title: n.title,
@@ -391,11 +660,8 @@ async function main() {
         videoUrl: n.videoUrl,
         orderIndex: n.orderIndex,
         chapterId: chapter1.id,
-        lessonType: isNode2 ? 'adventure' : (n.lessonType || 'classic'),
-        storyIntro: isNode2 ? seedingData.lesson_1b.storyIntro : (n.storyIntro ? (n.storyIntro as any) : undefined),
-        lessonContents: isNode2 ? seedingData.lesson_1b.lessonContents : (n.lessonContents ? (n.lessonContents as any) : undefined),
-        minigame: isNode2 ? seedingData.lesson_1b.minigame : (n.minigame ? (n.minigame as any) : undefined),
-        finalSummary: isNode2 ? seedingData.lesson_1b.finalSummary : (n.finalSummary ? (n.finalSummary as any) : undefined),
+        lessonType: 'flow',
+        lessonFlow: lessonFlow as any,
       }
     });
     createdCh1Nodes.push(node);
@@ -439,7 +705,8 @@ async function main() {
         videoUrl: n.videoUrl,
         orderIndex: n.orderIndex,
         chapterId: chapter2.id,
-        lessonType: 'classic',
+        lessonType: 'flow',
+        lessonFlow: buildDefaultLessonFlow(n) as any,
       }
     });
     createdCh2Nodes.push(node);
@@ -481,7 +748,8 @@ async function main() {
         videoUrl: n.videoUrl,
         orderIndex: n.orderIndex,
         chapterId: chapter3.id,
-        lessonType: 'classic',
+        lessonType: 'flow',
+        lessonFlow: buildDefaultLessonFlow(n) as any,
       }
     });
     createdCh3Nodes.push(node);

src/app.module.ts

@@ -12,12 +12,18 @@ import { UsersModule } from './users/users.module';
 import { PhilosofunModule } from './philosofun/philosofun.module';
 import { AuthModule } from './auth/auth.module';
 import { AppController } from './app.controller';
+import { ThrottlerModule, ThrottlerGuard } from '@nestjs/throttler';
+import { APP_GUARD } from '@nestjs/core';
 
 @Module({
   imports: [
     ConfigModule.forRoot({
       isGlobal: true,
     }),
+    ThrottlerModule.forRoot([{
+      ttl: 60000,
+      limit: 100, // 100 requests per minute by default
+    }]),
     DatabaseModule,
     AIModule,
     SupabaseModule,
@@ -31,5 +37,11 @@ import { AppController } from './app.controller';
     AuthModule,
   ],
   controllers: [AppController],
+  providers: [
+    {
+      provide: APP_GUARD,
+      useClass: ThrottlerGuard,
+    },
+  ],
 })
 export class AppModule {}

src/courses/chapters.controller.ts

@@ -0,0 +1,50 @@
+import { Controller, Get, Post, Body, Param, Query, Put, Delete, UseGuards } from '@nestjs/common';
+import { CoursesService } from './courses.service';
+import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { JwtAuthGuard } from '../auth/jwt-auth.guard';
+import { RolesGuard } from '../auth/roles.guard';
+import { Roles } from '../auth/roles.decorator';
+import { CreateChapterDto } from './dto/create-chapter.dto';
+import { UpdateChapterDto } from './dto/update-chapter.dto';
+
+@ApiTags('Courses & Roadmaps')
+@Controller('chapters')
+@UseGuards(JwtAuthGuard, RolesGuard)
+@ApiBearerAuth()
+export class ChaptersController {
+  constructor(private coursesService: CoursesService) {}
+
+  @Post()
+  @Roles('admin')
+  @ApiOperation({ summary: 'Create a new chapter (Admin)' })
+  async createChapter(@Body() dto: CreateChapterDto) {
+    return this.coursesService.createChapter(dto.title, dto.orderIndex, dto.courseId, dto.parentChapterId);
+  }
+
+  @Get()
+  @ApiOperation({ summary: 'List all chapters' })
+  async getChapters(@Query('courseId') courseId?: string) {
+    return this.coursesService.getChapters(courseId);
+  }
+
+  @Get(':id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Get single chapter details (Admin)' })
+  async getChapterById(@Param('id') id: string) {
+    return this.coursesService.getChapterById(id);
+  }
+
+  @Put(':id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Update a chapter (Admin)' })
+  async updateChapter(@Param('id') id: string, @Body() dto: UpdateChapterDto) {
+    return this.coursesService.updateChapter(id, dto.title, dto.orderIndex, dto.parentChapterId);
+  }
+
+  @Delete(':id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Delete a chapter (Admin)' })
+  async deleteChapter(@Param('id') id: string) {
+    return this.coursesService.deleteChapter(id);
+  }
+}

src/courses/courses.controller.ts

@@ -1,275 +1,13 @@
-import { Controller, Get, Post, Body, Param, Query, Patch, Put, Delete, UseInterceptors, UploadedFile, BadRequestException, UseGuards, Req } from '@nestjs/common';
+import { Controller, Get, Post, Body, Param, Query, Put, Delete, UseInterceptors, UploadedFile, BadRequestException, UseGuards, Req } from '@nestjs/common';
 import { CoursesService } from './courses.service';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
-import { IsString, IsNotEmpty, IsOptional, IsNumber } from 'class-validator';
 import { FileInterceptor } from '@nestjs/platform-express';
 import { JwtAuthGuard } from '../auth/jwt-auth.guard';
 import { RolesGuard } from '../auth/roles.guard';
 import { Roles } from '../auth/roles.decorator';
-
-class CreateCourseDto {
-  @IsString()
-  @IsNotEmpty()
-  title: string;
-
-  @IsString()
-  @IsOptional()
-  description?: string;
-
-  @IsString()
-  @IsNotEmpty()
-  userId: string;
-}
-
-class UpdateCourseDto {
-  @IsString()
-  @IsOptional()
-  title?: string;
-
-  @IsString()
-  @IsOptional()
-  description?: string;
-}
-
-class UploadDocDto {
-  @IsString()
-  @IsNotEmpty()
-  fileName: string;
-
-  @IsString()
-  @IsNotEmpty()
-  content: string;
-}
-
-class UpdateProgressDto {
-  @IsString()
-  @IsOptional()
-  userId: string;
-
-  @IsString()
-  @IsOptional()
-  status?: string;
-
-  @IsOptional()
-  lessonCompleted?: boolean;
-
-  @IsOptional()
-  flashcardCompleted?: boolean;
-
-  @IsOptional()
-  podcastCompleted?: boolean;
-
-  @IsOptional()
-  quizCompleted?: boolean;
-}
-
-class CreateChapterDto {
-  @IsString()
-  @IsNotEmpty()
-  title: string;
-
-  @IsNumber()
-  @IsNotEmpty()
-  orderIndex: number;
-
-  @IsString()
-  @IsNotEmpty()
-  courseId: string;
-
-  @IsString()
-  @IsOptional()
-  parentChapterId?: string;
-}
-
-class UpdateChapterDto {
-  @IsString()
-  @IsOptional()
-  title?: string;
-
-  @IsNumber()
-  @IsOptional()
-  orderIndex?: number;
-
-  @IsString()
-  @IsOptional()
-  parentChapterId?: string;
-}
-
-class CreateNodeDto {
-  @IsString()
-  @IsNotEmpty()
-  title: string;
-
-  @IsString()
-  @IsNotEmpty()
-  summary: string;
-
-  @IsString()
-  @IsNotEmpty()
-  originalText: string;
-
-  @IsString()
-  @IsNotEmpty()
-  quickTake: string;
-
-  @IsString()
-  @IsOptional()
-  difficulty?: string;
-
-  @IsString()
-  @IsOptional()
-  timeToRead?: string;
-
-  @IsString()
-  @IsOptional()
-  videoUrl?: string; // YouTube Video URL
-
-  @IsNumber()
-  @IsNotEmpty()
-  orderIndex: number;
-
-  @IsString()
-  @IsNotEmpty()
-  chapterId: string;
-
-  @IsString()
-  @IsNotEmpty()
-  lessonType: string;
-
-  @IsOptional()
-  storyIntro?: any;
-
-  @IsOptional()
-  lessonContents?: any;
-
-  @IsOptional()
-  minigame?: any;
-
-  @IsOptional()
-  finalSummary?: any;
-}
-
-class UpdateNodeDto {
-  @IsString()
-  @IsOptional()
-  title?: string;
-
-  @IsString()
-  @IsOptional()
-  summary?: string;
-
-  @IsString()
-  @IsOptional()
-  originalText?: string;
-
-  @IsString()
-  @IsOptional()
-  quickTake?: string;
-
-  @IsString()
-  @IsOptional()
-  difficulty?: string;
-
-  @IsString()
-  @IsOptional()
-  timeToRead?: string;
-
-  @IsString()
-  @IsOptional()
-  videoUrl?: string; // YouTube Video URL
-
-  @IsNumber()
-  @IsOptional()
-  orderIndex?: number;
-
-  @IsString()
-  @IsOptional()
-  lessonType?: string;
-
-  @IsOptional()
-  storyIntro?: any;
-
-  @IsOptional()
-  lessonContents?: any;
-
-  @IsOptional()
-  minigame?: any;
-
-  @IsOptional()
-  finalSummary?: any;
-}
-
-class SynthesizePodcastDto {
-  @IsString()
-  @IsNotEmpty()
-  nodeId: string;
-
-  @IsString()
-  @IsNotEmpty()
-  scriptText: string;
-}
-
-class CreateWarmupDto {
-  @IsString()
-  @IsNotEmpty()
-  type: string; // "image-guess" | "story"
-
-  @IsString()
-  @IsNotEmpty()
-  title: string;
-
-  @IsString()
-  @IsOptional()
-  image?: string;
-
-  @IsString()
-  @IsOptional()
-  blanks?: string;
-
-  @IsString()
-  @IsOptional()
-  answer?: string;
-
-  @IsString()
-  @IsOptional()
-  story?: string;
-
-  @IsString()
-  @IsOptional()
-  question?: string;
-
-  @IsOptional()
-  options?: string[];
-
-  @IsOptional()
-  correctIndex?: number;
-
-  @IsString()
-  @IsNotEmpty()
-  reveal: string;
-}
-
-class CreatePodcastDto {
-  @IsString()
-  @IsNotEmpty()
-  nodeId: string;
-
-  @IsString()
-  @IsNotEmpty()
-  audioUrl: string;
-
-  @IsNotEmpty()
-  transcript: any;
-}
-
-class UpdatePodcastDto {
-  @IsString()
-  @IsOptional()
-  audioUrl?: string;
-
-  @IsOptional()
-  transcript?: any;
-}
+import { CreateCourseDto } from './dto/create-course.dto';
+import { UpdateCourseDto } from './dto/update-course.dto';
+import { UploadDocDto } from './dto/upload-doc.dto';
 
 @ApiTags('Courses & Roadmaps')
 @Controller()
@@ -289,8 +27,9 @@ export class CoursesController {
 
   @Get('courses')
   @ApiOperation({ summary: 'Retrieve courses list' })
-  async getCourses(@Query('userId') userId?: string) {
-    return this.coursesService.getCourses(userId);
+  async getCourses(@Req() req: any, @Query('userId') userId?: string) {
+    const resolvedUserId = req.user.role === 'admin' ? (userId || req.user.id) : req.user.id;
+    return this.coursesService.getCourses(resolvedUserId);
   }
 
   @Get('courses/:id')
@@ -321,202 +60,6 @@ export class CoursesController {
     return this.coursesService.processDocumentUpload(courseId, dto.fileName, dto.content);
   }
 
-  // ==================== CHAPTERS ====================
-
-  @Post('chapters')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Create a new chapter (Admin)' })
-  async createChapter(@Body() dto: CreateChapterDto) {
-    return this.coursesService.createChapter(dto.title, dto.orderIndex, dto.courseId, dto.parentChapterId);
-  }
-
-  @Get('chapters')
-  @ApiOperation({ summary: 'List all chapters (Admin)' })
-  async getChapters(@Query('courseId') courseId?: string) {
-    return this.coursesService.getChapters(courseId);
-  }
-
-  @Get('chapters/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Get single chapter details (Admin)' })
-  async getChapterById(@Param('id') id: string) {
-    return this.coursesService.getChapterById(id);
-  }
-
-  @Put('chapters/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Update a chapter (Admin)' })
-  async updateChapter(@Param('id') id: string, @Body() dto: UpdateChapterDto) {
-    return this.coursesService.updateChapter(id, dto.title, dto.orderIndex, dto.parentChapterId);
-  }
-
-  @Delete('chapters/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Delete a chapter (Admin)' })
-  async deleteChapter(@Param('id') id: string) {
-    return this.coursesService.deleteChapter(id);
-  }
-
-  // ==================== CONCEPT NODES ====================
-
-  @Get('courses/:id/journey')
-  @ApiOperation({ summary: 'Get course journey roadmap nodes' })
-  async getCourseJourney(@Param('id') courseId: string, @Req() req: any) {
-    return this.coursesService.getCourseJourney(courseId, req.user.id);
-  }
-
-  @Get('courses/nodes/:nodeId')
-  @ApiOperation({ summary: 'Retrieve comprehensive learn detail for a concept node' })
-  async getNodeDetails(@Param('nodeId') nodeId: string, @Req() req: any) {
-    return this.coursesService.getNodeDetails(nodeId, req.user.id);
-  }
-
-  @Get('courses/nodes/:nodeId/core')
-  @ApiOperation({ summary: 'Retrieve core progress and type info for a concept node' })
-  async getNodeCore(@Param('nodeId') nodeId: string, @Req() req: any) {
-    return this.coursesService.getNodeCore(nodeId, req.user.id);
-  }
-
-  @Post('courses/nodes/:nodeId/complete')
-  @ApiOperation({ summary: 'Mark node as completed and auto-unlock next node' })
-  async completeNode(
-    @Param('nodeId') nodeId: string,
-    @Req() req: any,
-  ) {
-    return this.coursesService.completeNode(nodeId, req.user.id);
-  }
-
-  @Patch('courses/nodes/:nodeId/progress')
-  @ApiOperation({ summary: 'Update node learn progress status' })
-  async updateNodeProgress(
-    @Param('nodeId') nodeId: string,
-    @Body() dto: UpdateProgressDto,
-    @Req() req: any,
-  ) {
-    return this.coursesService.updateNodeProgress(
-      req.user.id,
-      nodeId,
-      dto.status,
-      dto.lessonCompleted,
-      dto.flashcardCompleted,
-      dto.podcastCompleted,
-      dto.quizCompleted,
-    );
-  }
-
-  @Post('nodes')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Create a new concept node (Admin)' })
-  async createNode(@Body() dto: CreateNodeDto) {
-    return this.coursesService.createNode(dto);
-  }
-
-  @Get('nodes')
-  @Roles('admin')
-  @ApiOperation({ summary: 'List all concept nodes (Admin)' })
-  async getNodes(@Query('chapterId') chapterId?: string) {
-    return this.coursesService.getNodes(chapterId);
-  }
-
-  @Put('nodes/:nodeId')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Update a concept node (Admin)' })
-  async updateNode(@Param('nodeId') nodeId: string, @Body() dto: UpdateNodeDto) {
-    return this.coursesService.updateNode(nodeId, dto);
-  }
-
-  @Delete('nodes/:nodeId')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Delete a concept node (Admin)' })
-  async deleteNode(@Param('nodeId') nodeId: string) {
-    return this.coursesService.deleteNode(nodeId);
-  }
-
-  // ==================== PODCASTS ====================
-
-  @Get('podcasts')
-  @Roles('admin')
-  @ApiOperation({ summary: 'List all podcasts (Admin)' })
-  async getPodcasts() {
-    return this.coursesService.getPodcasts();
-  }
-
-  @Get('podcasts/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Get single podcast details (Admin)' })
-  async getPodcastById(@Param('id') id: string) {
-    return this.coursesService.getPodcastById(id);
-  }
-
-  @Post('podcasts')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Create a new podcast manually (Admin)' })
-  async createPodcast(@Body() dto: CreatePodcastDto) {
-    return this.coursesService.createPodcast(dto);
-  }
-
-  @Put('podcasts/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Update a podcast (Admin)' })
-  async updatePodcast(@Param('id') id: string, @Body() dto: UpdatePodcastDto) {
-    return this.coursesService.updatePodcast(id, dto);
-  }
-
-  @Delete('podcasts/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Delete a podcast (Admin)' })
-  async deletePodcast(@Param('id') id: string) {
-    return this.coursesService.deletePodcast(id);
-  }
-
-  @Post('podcasts/synthesize')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Synthesize script text via TTS and return public audio URL for preview' })
-  async synthesizePodcast(@Body() dto: SynthesizePodcastDto) {
-    return this.coursesService.synthesizePodcast(dto.nodeId, dto.scriptText);
-  }
-
-  // ==================== WARMUPS ====================
-
-  @Post('nodes/:nodeId/warmups')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Create a new warmup for a concept node (Admin)' })
-  async createWarmup(@Param('nodeId') nodeId: string, @Body() dto: CreateWarmupDto) {
-    return this.coursesService.createWarmup(nodeId, dto);
-  }
-
-  @Get('nodes/:nodeId/warmups')
-  @ApiOperation({ summary: 'List all warmups for a concept node' })
-  async getWarmups(@Param('nodeId') nodeId: string) {
-    return this.coursesService.getWarmups(nodeId);
-  }
-
-  @Delete('warmups/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Delete a warmup by ID (Admin)' })
-  async deleteWarmup(@Param('id') id: string) {
-    return this.coursesService.deleteWarmup(id);
-  }
-
-  // ==================== DISCUSSIONS / COMMENTS ====================
-
-  @Post('courses/nodes/:nodeId/comments')
-  @ApiOperation({ summary: 'Post a comment on a concept node discussion' })
-  async createComment(
-    @Param('nodeId') nodeId: string,
-    @Body() dto: { userId: string; content: string; role?: string },
-    @Req() req: any,
-  ) {
-    const role = req.user.role === 'admin' ? 'admin' : 'student';
-    return this.coursesService.createComment(nodeId, req.user.id, dto.content, role);
-  }
-
-  @Get('courses/nodes/:nodeId/comments')
-  @ApiOperation({ summary: 'Get all comments for a concept node discussion' })
-  async getComments(@Param('nodeId') nodeId: string) {
-    return this.coursesService.getComments(nodeId);
-  }
-
   // ==================== BUCKET FILE UPLOADER ====================
 
   @Post('files/upload')
@@ -529,28 +72,4 @@ export class CoursesController {
     }
     return this.coursesService.saveUploadedFile(file.originalname, file.buffer, file.mimetype);
   }
-
-  // ==================== PDF REFERENCE DOCUMENTS CRUD ====================
-
-  @Post('documents')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Save a PDF document reference' })
-  async createDocument(
-    @Body() dto: { courseId: string; fileName: string; fileUrl: string; status?: string; title?: string; description?: string },
-  ) {
-    return this.coursesService.createDocument(dto.courseId, dto.fileName, dto.fileUrl, dto.status, dto.title, dto.description);
-  }
-
-  @Get('documents')
-  @ApiOperation({ summary: 'List all reference PDF documents' })
-  async listDocuments(@Query('courseId') courseId?: string) {
-    return this.coursesService.listDocuments(courseId);
-  }
-
-  @Delete('documents/:id')
-  @Roles('admin')
-  @ApiOperation({ summary: 'Delete a PDF reference document by ID' })
-  async deleteDocument(@Param('id') id: string) {
-    return this.coursesService.deleteDocument(id);
-  }
 }

src/courses/courses.module.ts

@@ -1,9 +1,12 @@
 import { Module } from '@nestjs/common';
 import { CoursesService } from './courses.service';
 import { CoursesController } from './courses.controller';
+import { ChaptersController } from './chapters.controller';
+import { NodesController } from './nodes.controller';
+import { PodcastsController } from './podcasts.controller';
 
 @Module({
-  controllers: [CoursesController],
+  controllers: [CoursesController, ChaptersController, NodesController, PodcastsController],
   providers: [CoursesService],
 })
 export class CoursesModule {}

src/courses/courses.service.ts

@@ -6,6 +6,7 @@ import { SupabaseService } from '../supabase/supabase.service';
 import * as fs from 'fs';
 import * as path from 'path';
 import { randomUUID } from 'crypto';
+import { NodeSchemaValidator } from './validators/node-schema.validator';
 
 @Injectable()
 export class CoursesService {
@@ -196,6 +197,10 @@ export class CoursesService {
                 flashcardCompleted: true,
                 podcastCompleted: true,
                 quizCompleted: true,
+                activeComponentId: true,
+                currentComponentIndex: true,
+                completedComponentIds: true,
+                componentResults: true,
               }
             },
             _count: { select: { flashcards: true } },
@@ -245,6 +250,10 @@ export class CoursesService {
             flashcardCompleted: true,
             podcastCompleted: true,
             quizCompleted: true,
+            activeComponentId: true,
+            currentComponentIndex: true,
+            completedComponentIds: true,
+            componentResults: true,
           }
         },
       },
@@ -519,6 +528,8 @@ export class CoursesService {
 
   async createNode(dto: any) {
     await this.getChapterById(dto.chapterId);
+    const lessonFlow = dto.lessonFlow || this.buildDefaultLessonFlow(dto);
+    NodeSchemaValidator.validateNode(lessonFlow);
     return this.prisma.conceptNode.create({
       data: {
         title: dto.title,
@@ -530,11 +541,8 @@ export class CoursesService {
         videoUrl: dto.videoUrl || null,
         orderIndex: dto.orderIndex,
         chapterId: dto.chapterId,
-        lessonType: dto.lessonType,
-        storyIntro: dto.storyIntro !== undefined ? dto.storyIntro : null,
-        lessonContents: dto.lessonContents !== undefined ? dto.lessonContents : null,
-        minigame: dto.minigame !== undefined ? dto.minigame : null,
-        finalSummary: dto.finalSummary !== undefined ? dto.finalSummary : null,
+        lessonType: 'flow',
+        lessonFlow: lessonFlow as any,
       },
     });
   }
@@ -553,6 +561,9 @@ export class CoursesService {
 
   async updateNode(nodeId: string, dto: any) {
     await this.getNodeDetails(nodeId, 'admin-user');
+    if (dto.lessonFlow !== undefined) {
+      NodeSchemaValidator.validateNode(dto.lessonFlow);
+    }
     return this.prisma.conceptNode.update({
       where: { id: nodeId },
       data: {
@@ -564,11 +575,103 @@ export class CoursesService {
         timeToRead: dto.timeToRead,
         videoUrl: dto.videoUrl !== undefined ? dto.videoUrl : undefined,
         orderIndex: dto.orderIndex,
-        lessonType: dto.lessonType !== undefined ? dto.lessonType : undefined,
-        storyIntro: dto.storyIntro !== undefined ? dto.storyIntro : undefined,
-        lessonContents: dto.lessonContents !== undefined ? dto.lessonContents : undefined,
-        minigame: dto.minigame !== undefined ? dto.minigame : undefined,
-        finalSummary: dto.finalSummary !== undefined ? dto.finalSummary : undefined,
+        lessonType: 'flow',
+        lessonFlow: dto.lessonFlow !== undefined ? (dto.lessonFlow as any) : undefined,
+      },
+    });
+  }
+
+  private buildDefaultLessonFlow(dto: any) {
+    const flow: any[] = [];
+
+    if (dto.videoUrl) {
+      flow.push({
+        id: 'lesson-video',
+        type: 'media',
+        title: 'Video nhập môn',
+        config: {
+          mediaType: 'video',
+          url: dto.videoUrl,
+          title: dto.title,
+        },
+        completionRule: { type: 'viewed' },
+      });
+    }
+
+    flow.push({
+      id: 'main-reading',
+      type: 'markdown',
+      title: dto.title || 'Nội dung bài học',
+      config: {
+        content: dto.originalText || dto.summary || 'Nội dung bài học đang được cập nhật.',
+      },
+      completionRule: { type: 'viewed' },
+    });
+
+    flow.push({
+      id: 'final-summary',
+      type: 'final_summary',
+      title: 'Đúc kết bài học',
+      config: {
+        message: dto.quickTake || dto.summary || 'Hoàn thành bài học.',
+        keyTakeaways: [dto.summary || dto.quickTake || 'Nắm được nội dung trọng tâm của bài học.'],
+        rewards: { xp: 80, badge: 'Hoàn thành bài học' },
+      },
+      completionRule: { type: 'viewed' },
+    });
+
+    return flow;
+  }
+
+  async updateComponentProgress(
+    userId: string,
+    nodeId: string,
+    activeComponentId?: string,
+    currentComponentIndex?: number,
+    completedComponentIds?: string[],
+    componentResult?: any,
+  ) {
+    const existing = await this.prisma.progress.findFirst({
+      where: { userId, nodeId },
+    });
+
+    const previousResults = Array.isArray(existing?.componentResults)
+      ? (existing?.componentResults as any[])
+      : [];
+    const nextResults = componentResult
+      ? [
+          ...previousResults.filter((result) => result.componentId !== componentResult.componentId),
+          {
+            ...componentResult,
+            completedAt: componentResult.completedAt || new Date().toISOString(),
+          },
+        ]
+      : previousResults;
+
+    const updateData: any = {
+      status: existing?.status === 'completed' ? 'completed' : 'in_progress',
+    };
+    if (activeComponentId !== undefined) updateData.activeComponentId = activeComponentId;
+    if (currentComponentIndex !== undefined) updateData.currentComponentIndex = currentComponentIndex;
+    if (completedComponentIds !== undefined) updateData.completedComponentIds = completedComponentIds as any;
+    if (componentResult !== undefined) updateData.componentResults = nextResults as any;
+
+    if (existing) {
+      return this.prisma.progress.update({
+        where: { id: existing.id },
+        data: updateData,
+      });
+    }
+
+    return this.prisma.progress.create({
+      data: {
+        userId,
+        nodeId,
+        status: 'in_progress',
+        activeComponentId: activeComponentId || null,
+        currentComponentIndex: currentComponentIndex || 0,
+        completedComponentIds: (completedComponentIds || []) as any,
+        componentResults: nextResults as any,
       },
     });
   }

src/courses/dto/create-chapter.dto.ts

@@ -0,0 +1,19 @@
+import { IsString, IsNotEmpty, IsOptional, IsNumber } from 'class-validator';
+
+export class CreateChapterDto {
+  @IsString()
+  @IsNotEmpty()
+  title: string;
+
+  @IsNumber()
+  @IsNotEmpty()
+  orderIndex: number;
+
+  @IsString()
+  @IsNotEmpty()
+  courseId: string;
+
+  @IsString()
+  @IsOptional()
+  parentChapterId?: string;
+}

src/courses/dto/create-comment.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class CreateCommentDto {
+  @IsString()
+  @IsOptional()
+  userId?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  content: string;
+
+  @IsString()
+  @IsOptional()
+  role?: string;
+}

src/courses/dto/create-course.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class CreateCourseDto {
+  @IsString()
+  @IsNotEmpty()
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  userId: string;
+}

src/courses/dto/create-document-ref.dto.ts

@@ -0,0 +1,27 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class CreateDocumentRefDto {
+  @IsString()
+  @IsNotEmpty()
+  courseId: string;
+
+  @IsString()
+  @IsNotEmpty()
+  fileName: string;
+
+  @IsString()
+  @IsNotEmpty()
+  fileUrl: string;
+
+  @IsString()
+  @IsOptional()
+  status?: string;
+
+  @IsString()
+  @IsOptional()
+  title?: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+}

src/courses/dto/create-node.dto.ts

@@ -0,0 +1,45 @@
+import { IsString, IsNotEmpty, IsOptional, IsNumber } from 'class-validator';
+
+export class CreateNodeDto {
+  @IsString()
+  @IsNotEmpty()
+  title: string;
+
+  @IsString()
+  @IsNotEmpty()
+  summary: string;
+
+  @IsString()
+  @IsNotEmpty()
+  originalText: string;
+
+  @IsString()
+  @IsNotEmpty()
+  quickTake: string;
+
+  @IsString()
+  @IsOptional()
+  difficulty?: string;
+
+  @IsString()
+  @IsOptional()
+  timeToRead?: string;
+
+  @IsString()
+  @IsOptional()
+  videoUrl?: string;
+
+  @IsNumber()
+  @IsNotEmpty()
+  orderIndex: number;
+
+  @IsString()
+  @IsNotEmpty()
+  chapterId: string;
+
+  @IsOptional()
+  lessonType?: string;
+
+  @IsOptional()
+  lessonFlow?: any;
+}

src/courses/dto/create-podcast.dto.ts

@@ -0,0 +1,14 @@
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class CreatePodcastDto {
+  @IsString()
+  @IsNotEmpty()
+  nodeId: string;
+
+  @IsString()
+  @IsNotEmpty()
+  audioUrl: string;
+
+  @IsNotEmpty()
+  transcript: any;
+}

src/courses/dto/create-warmup.dto.ts

@@ -0,0 +1,41 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class CreateWarmupDto {
+  @IsString()
+  @IsNotEmpty()
+  type: string;
+
+  @IsString()
+  @IsNotEmpty()
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  image?: string;
+
+  @IsString()
+  @IsOptional()
+  blanks?: string;
+
+  @IsString()
+  @IsOptional()
+  answer?: string;
+
+  @IsString()
+  @IsOptional()
+  story?: string;
+
+  @IsString()
+  @IsOptional()
+  question?: string;
+
+  @IsOptional()
+  options?: string[];
+
+  @IsOptional()
+  correctIndex?: number;
+
+  @IsString()
+  @IsNotEmpty()
+  reveal: string;
+}

src/courses/dto/synthesize-podcast.dto.ts

@@ -0,0 +1,11 @@
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class SynthesizePodcastDto {
+  @IsString()
+  @IsNotEmpty()
+  nodeId: string;
+
+  @IsString()
+  @IsNotEmpty()
+  scriptText: string;
+}

src/courses/dto/update-chapter.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsOptional, IsNumber } from 'class-validator';
+
+export class UpdateChapterDto {
+  @IsString()
+  @IsOptional()
+  title?: string;
+
+  @IsNumber()
+  @IsOptional()
+  orderIndex?: number;
+
+  @IsString()
+  @IsOptional()
+  parentChapterId?: string;
+}

src/courses/dto/update-component-progress.dto.ts

@@ -0,0 +1,18 @@
+import { IsArray, IsNumber, IsOptional, IsString } from 'class-validator';
+
+export class UpdateComponentProgressDto {
+  @IsString()
+  @IsOptional()
+  activeComponentId?: string;
+
+  @IsNumber()
+  @IsOptional()
+  currentComponentIndex?: number;
+
+  @IsArray()
+  @IsOptional()
+  completedComponentIds?: string[];
+
+  @IsOptional()
+  componentResult?: any;
+}

src/courses/dto/update-course.dto.ts

@@ -0,0 +1,11 @@
+import { IsString, IsOptional } from 'class-validator';
+
+export class UpdateCourseDto {
+  @IsString()
+  @IsOptional()
+  title?: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+}

src/courses/dto/update-node.dto.ts

@@ -0,0 +1,42 @@
+import { IsString, IsOptional, IsNumber } from 'class-validator';
+
+export class UpdateNodeDto {
+  @IsString()
+  @IsOptional()
+  title?: string;
+
+  @IsString()
+  @IsOptional()
+  summary?: string;
+
+  @IsString()
+  @IsOptional()
+  originalText?: string;
+
+  @IsString()
+  @IsOptional()
+  quickTake?: string;
+
+  @IsString()
+  @IsOptional()
+  difficulty?: string;
+
+  @IsString()
+  @IsOptional()
+  timeToRead?: string;
+
+  @IsString()
+  @IsOptional()
+  videoUrl?: string;
+
+  @IsNumber()
+  @IsOptional()
+  orderIndex?: number;
+
+  @IsString()
+  @IsOptional()
+  lessonType?: string;
+
+  @IsOptional()
+  lessonFlow?: any;
+}

src/courses/dto/update-podcast.dto.ts

@@ -0,0 +1,10 @@
+import { IsString, IsOptional } from 'class-validator';
+
+export class UpdatePodcastDto {
+  @IsString()
+  @IsOptional()
+  audioUrl?: string;
+
+  @IsOptional()
+  transcript?: any;
+}

src/courses/dto/update-progress.dto.ts

@@ -0,0 +1,27 @@
+import { IsString, IsOptional, IsBoolean } from 'class-validator';
+
+export class UpdateProgressDto {
+  @IsString()
+  @IsOptional()
+  userId?: string;
+
+  @IsString()
+  @IsOptional()
+  status?: string;
+
+  @IsOptional()
+  @IsBoolean()
+  lessonCompleted?: boolean;
+
+  @IsOptional()
+  @IsBoolean()
+  flashcardCompleted?: boolean;
+
+  @IsOptional()
+  @IsBoolean()
+  podcastCompleted?: boolean;
+
+  @IsOptional()
+  @IsBoolean()
+  quizCompleted?: boolean;
+}

src/courses/dto/upload-doc.dto.ts

@@ -0,0 +1,11 @@
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class UploadDocDto {
+  @IsString()
+  @IsNotEmpty()
+  fileName: string;
+
+  @IsString()
+  @IsNotEmpty()
+  content: string;
+}

src/courses/nodes.controller.ts

@@ -0,0 +1,178 @@
+import { Controller, Get, Post, Body, Param, Query, Patch, Put, Delete, UseGuards, Req } from '@nestjs/common';
+import { CoursesService } from './courses.service';
+import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { JwtAuthGuard } from '../auth/jwt-auth.guard';
+import { RolesGuard } from '../auth/roles.guard';
+import { Roles } from '../auth/roles.decorator';
+import { CreateNodeDto } from './dto/create-node.dto';
+import { UpdateNodeDto } from './dto/update-node.dto';
+import { UpdateProgressDto } from './dto/update-progress.dto';
+import { UpdateComponentProgressDto } from './dto/update-component-progress.dto';
+import { CreateWarmupDto } from './dto/create-warmup.dto';
+import { CreateCommentDto } from './dto/create-comment.dto';
+import { CreateDocumentRefDto } from './dto/create-document-ref.dto';
+
+@ApiTags('Courses & Roadmaps')
+@Controller()
+@UseGuards(JwtAuthGuard, RolesGuard)
+@ApiBearerAuth()
+export class NodesController {
+  constructor(private coursesService: CoursesService) {}
+
+  // ==================== CONCEPT NODES ====================
+
+  @Get('courses/:id/journey')
+  @ApiOperation({ summary: 'Get course journey roadmap nodes' })
+  async getCourseJourney(@Param('id') courseId: string, @Req() req: any) {
+    return this.coursesService.getCourseJourney(courseId, req.user.id);
+  }
+
+  @Get('courses/nodes/:nodeId')
+  @ApiOperation({ summary: 'Retrieve comprehensive learn detail for a concept node' })
+  async getNodeDetails(@Param('nodeId') nodeId: string, @Req() req: any) {
+    return this.coursesService.getNodeDetails(nodeId, req.user.id);
+  }
+
+  @Get('courses/nodes/:nodeId/core')
+  @ApiOperation({ summary: 'Retrieve core progress and type info for a concept node' })
+  async getNodeCore(@Param('nodeId') nodeId: string, @Req() req: any) {
+    return this.coursesService.getNodeCore(nodeId, req.user.id);
+  }
+
+  @Post('courses/nodes/:nodeId/complete')
+  @ApiOperation({ summary: 'Mark node as completed and auto-unlock next node' })
+  async completeNode(
+    @Param('nodeId') nodeId: string,
+    @Req() req: any,
+  ) {
+    return this.coursesService.completeNode(nodeId, req.user.id);
+  }
+
+  @Patch('courses/nodes/:nodeId/progress')
+  @ApiOperation({ summary: 'Update node learn progress status' })
+  async updateNodeProgress(
+    @Param('nodeId') nodeId: string,
+    @Body() dto: UpdateProgressDto,
+    @Req() req: any,
+  ) {
+    return this.coursesService.updateNodeProgress(
+      req.user.id,
+      nodeId,
+      dto.status,
+      dto.lessonCompleted,
+      dto.flashcardCompleted,
+      dto.podcastCompleted,
+      dto.quizCompleted,
+    );
+  }
+
+  @Patch('courses/nodes/:nodeId/component-progress')
+  @ApiOperation({ summary: 'Update component-based lesson progress' })
+  async updateComponentProgress(
+    @Param('nodeId') nodeId: string,
+    @Body() dto: UpdateComponentProgressDto,
+    @Req() req: any,
+  ) {
+    return this.coursesService.updateComponentProgress(
+      req.user.id,
+      nodeId,
+      dto.activeComponentId,
+      dto.currentComponentIndex,
+      dto.completedComponentIds,
+      dto.componentResult,
+    );
+  }
+
+  @Post('nodes')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Create a new concept node (Admin)' })
+  async createNode(@Body() dto: CreateNodeDto) {
+    return this.coursesService.createNode(dto);
+  }
+
+  @Get('nodes')
+  @Roles('admin')
+  @ApiOperation({ summary: 'List all concept nodes (Admin)' })
+  async getNodes(@Query('chapterId') chapterId?: string) {
+    return this.coursesService.getNodes(chapterId);
+  }
+
+  @Put('nodes/:nodeId')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Update a concept node (Admin)' })
+  async updateNode(@Param('nodeId') nodeId: string, @Body() dto: UpdateNodeDto) {
+    return this.coursesService.updateNode(nodeId, dto);
+  }
+
+  @Delete('nodes/:nodeId')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Delete a concept node (Admin)' })
+  async deleteNode(@Param('nodeId') nodeId: string) {
+    return this.coursesService.deleteNode(nodeId);
+  }
+
+  // ==================== WARMUPS ====================
+
+  @Post('nodes/:nodeId/warmups')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Create a new warmup for a concept node (Admin)' })
+  async createWarmup(@Param('nodeId') nodeId: string, @Body() dto: CreateWarmupDto) {
+    return this.coursesService.createWarmup(nodeId, dto);
+  }
+
+  @Get('nodes/:nodeId/warmups')
+  @ApiOperation({ summary: 'List all warmups for a concept node' })
+  async getWarmups(@Param('nodeId') nodeId: string) {
+    return this.coursesService.getWarmups(nodeId);
+  }
+
+  @Delete('warmups/:id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Delete a warmup by ID (Admin)' })
+  async deleteWarmup(@Param('id') id: string) {
+    return this.coursesService.deleteWarmup(id);
+  }
+
+  // ==================== DISCUSSIONS / COMMENTS ====================
+
+  @Post('courses/nodes/:nodeId/comments')
+  @ApiOperation({ summary: 'Post a comment on a concept node discussion' })
+  async createComment(
+    @Param('nodeId') nodeId: string,
+    @Body() dto: CreateCommentDto,
+    @Req() req: any,
+  ) {
+    const role = req.user.role === 'admin' ? 'admin' : 'student';
+    return this.coursesService.createComment(nodeId, req.user.id, dto.content, role);
+  }
+
+  @Get('courses/nodes/:nodeId/comments')
+  @ApiOperation({ summary: 'Get all comments for a concept node discussion' })
+  async getComments(@Param('nodeId') nodeId: string) {
+    return this.coursesService.getComments(nodeId);
+  }
+
+  // ==================== PDF REFERENCE DOCUMENTS CRUD ====================
+
+  @Post('documents')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Save a PDF document reference' })
+  async createDocument(
+    @Body() dto: CreateDocumentRefDto,
+  ) {
+    return this.coursesService.createDocument(dto.courseId, dto.fileName, dto.fileUrl, dto.status, dto.title, dto.description);
+  }
+
+  @Get('documents')
+  @ApiOperation({ summary: 'List all reference PDF documents' })
+  async listDocuments(@Query('courseId') courseId?: string) {
+    return this.coursesService.listDocuments(courseId);
+  }
+
+  @Delete('documents/:id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Delete a PDF reference document by ID' })
+  async deleteDocument(@Param('id') id: string) {
+    return this.coursesService.deleteDocument(id);
+  }
+}

src/courses/podcasts.controller.ts

@@ -0,0 +1,61 @@
+import { Controller, Get, Post, Body, Param, Put, Delete, UseGuards } from '@nestjs/common';
+import { CoursesService } from './courses.service';
+import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { JwtAuthGuard } from '../auth/jwt-auth.guard';
+import { RolesGuard } from '../auth/roles.guard';
+import { Roles } from '../auth/roles.decorator';
+import { CreatePodcastDto } from './dto/create-podcast.dto';
+import { UpdatePodcastDto } from './dto/update-podcast.dto';
+import { SynthesizePodcastDto } from './dto/synthesize-podcast.dto';
+import { Throttle } from '@nestjs/throttler';
+
+@ApiTags('Courses & Roadmaps')
+@Controller('podcasts')
+@UseGuards(JwtAuthGuard, RolesGuard)
+@ApiBearerAuth()
+export class PodcastsController {
+  constructor(private coursesService: CoursesService) {}
+
+  @Get()
+  @Roles('admin')
+  @ApiOperation({ summary: 'List all podcasts (Admin)' })
+  async getPodcasts() {
+    return this.coursesService.getPodcasts();
+  }
+
+  @Get(':id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Get single podcast details (Admin)' })
+  async getPodcastById(@Param('id') id: string) {
+    return this.coursesService.getPodcastById(id);
+  }
+
+  @Post()
+  @Roles('admin')
+  @ApiOperation({ summary: 'Create a new podcast manually (Admin)' })
+  async createPodcast(@Body() dto: CreatePodcastDto) {
+    return this.coursesService.createPodcast(dto);
+  }
+
+  @Put(':id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Update a podcast (Admin)' })
+  async updatePodcast(@Param('id') id: string, @Body() dto: UpdatePodcastDto) {
+    return this.coursesService.updatePodcast(id, dto);
+  }
+
+  @Delete(':id')
+  @Roles('admin')
+  @ApiOperation({ summary: 'Delete a podcast (Admin)' })
+  async deletePodcast(@Param('id') id: string) {
+    return this.coursesService.deletePodcast(id);
+  }
+
+  @Post('synthesize')
+  @Throttle({ default: { limit: 5, ttl: 60000 } })
+  @Roles('admin')
+  @ApiOperation({ summary: 'Synthesize script text via TTS and return public audio URL for preview' })
+  async synthesizePodcast(@Body() dto: SynthesizePodcastDto) {
+    return this.coursesService.synthesizePodcast(dto.nodeId, dto.scriptText);
+  }
+}

src/courses/validators/node-schema.validator.ts

@@ -0,0 +1,132 @@
+import { BadRequestException } from '@nestjs/common';
+
+const SUPPORTED_COMPONENT_TYPES = new Set([
+  'dialogue',
+  'media',
+  'markdown',
+  'target_matching',
+  'category_sorting',
+  'mindmap_reveal',
+  'mcq',
+  'matching_columns',
+  'true_false',
+  'sequence_sorting',
+  'final_summary',
+]);
+
+function requireArray(value: any, label: string) {
+  if (!Array.isArray(value)) {
+    throw new BadRequestException(`${label} must be an array`);
+  }
+}
+
+function requireString(value: any, label: string) {
+  if (typeof value !== 'string' || value.trim() === '') {
+    throw new BadRequestException(`${label} must be a non-empty string`);
+  }
+}
+
+function requireObject(value: any, label: string) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    throw new BadRequestException(`${label} must be a JSON object`);
+  }
+}
+
+export class NodeSchemaValidator {
+  static validateLessonFlow(data: any) {
+    requireArray(data, 'lessonFlow');
+
+    const ids = new Set<string>();
+    data.forEach((component: any, idx: number) => {
+      requireObject(component, `lessonFlow[${idx}]`);
+      requireString(component.id, `lessonFlow[${idx}].id`);
+      requireString(component.type, `lessonFlow[${idx}].type`);
+
+      if (ids.has(component.id)) {
+        throw new BadRequestException(`lessonFlow[${idx}].id duplicates "${component.id}"`);
+      }
+      ids.add(component.id);
+
+      if (!SUPPORTED_COMPONENT_TYPES.has(component.type)) {
+        throw new BadRequestException(`lessonFlow[${idx}].type "${component.type}" is not supported`);
+      }
+
+      requireObject(component.config, `lessonFlow[${idx}].config`);
+      this.validateComponentConfig(component, idx);
+
+      if (component.completionRule) {
+        requireObject(component.completionRule, `lessonFlow[${idx}].completionRule`);
+        requireString(component.completionRule.type, `lessonFlow[${idx}].completionRule.type`);
+      }
+    });
+  }
+
+  private static validateComponentConfig(component: any, idx: number) {
+    const config = component.config;
+    const label = `lessonFlow[${idx}].config`;
+
+    if (component.type === 'dialogue') {
+      requireArray(config.lines, `${label}.lines`);
+      config.lines.forEach((line: any, lineIdx: number) => {
+        requireString(line.text, `${label}.lines[${lineIdx}].text`);
+      });
+    }
+
+    if (component.type === 'media') {
+      requireString(config.url, `${label}.url`);
+    }
+
+    if (component.type === 'markdown') {
+      requireString(config.content, `${label}.content`);
+    }
+
+    if (component.type === 'target_matching') {
+      requireArray(config.targets, `${label}.targets`);
+      requireArray(config.items, `${label}.items`);
+    }
+
+    if (component.type === 'category_sorting') {
+      requireArray(config.categories, `${label}.categories`);
+      requireArray(config.cards, `${label}.cards`);
+    }
+
+    if (component.type === 'mindmap_reveal') {
+      requireArray(config.nodes, `${label}.nodes`);
+    }
+
+    if (component.type === 'mcq') {
+      requireString(config.question, `${label}.question`);
+      requireArray(config.options, `${label}.options`);
+      if (!config.options.some((option: any) => option.isCorrect === true || option.correct === true)) {
+        throw new BadRequestException(`${label}.options must contain at least one correct option`);
+      }
+    }
+
+    if (component.type === 'matching_columns') {
+      requireArray(config.leftColumn, `${label}.leftColumn`);
+      requireArray(config.rightColumn, `${label}.rightColumn`);
+      requireArray(config.correctPairs, `${label}.correctPairs`);
+    }
+
+    if (component.type === 'true_false') {
+      requireString(config.statement, `${label}.statement`);
+      if (typeof config.correctAnswer !== 'boolean') {
+        throw new BadRequestException(`${label}.correctAnswer must be a boolean`);
+      }
+    }
+
+    if (component.type === 'sequence_sorting') {
+      requireArray(config.items, `${label}.items`);
+    }
+
+    if (component.type === 'final_summary') {
+      if (config.keyTakeaways !== undefined) {
+        requireArray(config.keyTakeaways, `${label}.keyTakeaways`);
+      }
+    }
+  }
+
+  static validateNode(lessonFlow: any) {
+    this.validateLessonFlow(lessonFlow);
+  }
+}

src/debate/debates.controller.ts

@@ -1,34 +1,12 @@
 import { Controller, Get, Post, Body, Param, Query, Delete, Put, UseGuards, Req } from '@nestjs/common';
 import { DebatesService } from './debates.service';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
-import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
 import { JwtAuthGuard } from '../auth/jwt-auth.guard';
 import { RolesGuard } from '../auth/roles.guard';
 import { Roles } from '../auth/roles.decorator';
-
-class DebateMessageDto {
-  @IsString()
-  @IsOptional()
-  userId: string;
-
-  @IsString()
-  @IsNotEmpty()
-  message: string;
-}
-
-class CreateDebateTopicDto {
-  @IsString()
-  @IsNotEmpty()
-  title: string;
-
-  @IsString()
-  @IsNotEmpty()
-  description: string;
-
-  @IsString()
-  @IsNotEmpty()
-  initialPrompt: string;
-}
+import { DebateMessageDto } from './dto/debate-message.dto';
+import { CreateDebateTopicDto } from './dto/create-debate-topic.dto';
+import { Throttle } from '@nestjs/throttler';
 
 @ApiTags('Socratic AI Debate')
 @Controller('debates')
@@ -75,6 +53,7 @@ export class DebatesController {
   }
 
   @Post('topic/:topicId/message')
+  @Throttle({ default: { limit: 5, ttl: 60000 } })
   @ApiOperation({ summary: 'Post a user argument to a topic debate session and get rebuttal' })
   async sendTopicDebateMessage(
     @Param('topicId') topicId: string,
@@ -100,6 +79,7 @@ export class DebatesController {
   }
 
   @Post(':nodeId/message')
+  @Throttle({ default: { limit: 5, ttl: 60000 } })
   @ApiOperation({ summary: 'Post a user argument and get a Socratic rebuttal' })
   async sendDebateMessage(
     @Param('nodeId') nodeId: string,

src/debate/dto/create-debate-topic.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class CreateDebateTopicDto {
+  @IsString()
+  @IsNotEmpty()
+  title: string;
+
+  @IsString()
+  @IsNotEmpty()
+  description: string;
+
+  @IsString()
+  @IsNotEmpty()
+  initialPrompt: string;
+}

src/debate/dto/debate-message.dto.ts

@@ -0,0 +1,11 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class DebateMessageDto {
+  @IsString()
+  @IsOptional()
+  userId?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  message: string;
+}

src/flashcards/dto/create-flashcard.dto.ts

@@ -0,0 +1,19 @@
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class CreateFlashcardDto {
+  @IsString()
+  @IsNotEmpty()
+  nodeId: string;
+
+  @IsString()
+  @IsNotEmpty()
+  tag: string;
+
+  @IsString()
+  @IsNotEmpty()
+  question: string;
+
+  @IsString()
+  @IsNotEmpty()
+  answer: string;
+}

src/flashcards/dto/review-card.dto.ts

@@ -0,0 +1,16 @@
+import { IsString, IsNotEmpty, IsNumber, Min, Max, IsOptional } from 'class-validator';
+
+export class ReviewCardDto {
+  @IsString()
+  @IsOptional()
+  userId?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  flashcardId: string;
+
+  @IsNumber()
+  @Min(1)
+  @Max(4)
+  ease: number;
+}

src/flashcards/dto/update-flashcard.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsOptional } from 'class-validator';
+
+export class UpdateFlashcardDto {
+  @IsString()
+  @IsOptional()
+  tag?: string;
+
+  @IsString()
+  @IsOptional()
+  question?: string;
+
+  @IsString()
+  @IsOptional()
+  answer?: string;
+}

src/flashcards/flashcards.controller.ts

@@ -1,57 +1,12 @@
 import { Controller, Get, Post, Body, Query, Put, Delete, Param, UseGuards, Req } from '@nestjs/common';
 import { FlashcardsService } from './flashcards.service';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
-import { IsString, IsNotEmpty, IsNumber, Min, Max, IsOptional } from 'class-validator';
 import { JwtAuthGuard } from '../auth/jwt-auth.guard';
 import { RolesGuard } from '../auth/roles.guard';
 import { Roles } from '../auth/roles.decorator';
-
-class ReviewCardDto {
-  @IsString()
-  @IsOptional()
-  userId: string;
-
-  @IsString()
-  @IsNotEmpty()
-  flashcardId: string;
-
-  @IsNumber()
-  @Min(1)
-  @Max(4)
-  ease: number; // 1 | 2 | 3 | 4
-}
-
-class CreateFlashcardDto {
-  @IsString()
-  @IsNotEmpty()
-  nodeId: string;
-
-  @IsString()
-  @IsNotEmpty()
-  tag: string;
-
-  @IsString()
-  @IsNotEmpty()
-  question: string;
-
-  @IsString()
-  @IsNotEmpty()
-  answer: string;
-}
-
-class UpdateFlashcardDto {
-  @IsString()
-  @IsOptional()
-  tag?: string;
-
-  @IsString()
-  @IsOptional()
-  question?: string;
-
-  @IsString()
-  @IsOptional()
-  answer?: string;
-}
+import { ReviewCardDto } from './dto/review-card.dto';
+import { CreateFlashcardDto } from './dto/create-flashcard.dto';
+import { UpdateFlashcardDto } from './dto/update-flashcard.dto';
 
 @ApiTags('Spaced Repetition Flashcards')
 @Controller('flashcards')

src/philosofun/dto/create-philosofun.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class CreatePhilosofunDto {
+  @IsString()
+  @IsNotEmpty()
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  videoUrl: string;
+}

src/philosofun/dto/update-philosofun.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsOptional } from 'class-validator';
+
+export class UpdatePhilosofunDto {
+  @IsString()
+  @IsOptional()
+  title?: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsString()
+  @IsOptional()
+  videoUrl?: string;
+}

src/philosofun/philosofun.controller.ts

@@ -1,38 +1,11 @@
 import { Controller, Get, Post, Body, Param, Put, Delete, UseGuards } from '@nestjs/common';
 import { PhilosofunService } from './philosofun.service';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
-import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
 import { JwtAuthGuard } from '../auth/jwt-auth.guard';
 import { RolesGuard } from '../auth/roles.guard';
 import { Roles } from '../auth/roles.decorator';
-
-class CreatePhilosofunDto {
-  @IsString()
-  @IsNotEmpty()
-  title: string;
-
-  @IsString()
-  @IsOptional()
-  description?: string;
-
-  @IsString()
-  @IsNotEmpty()
-  videoUrl: string;
-}
-
-class UpdatePhilosofunDto {
-  @IsString()
-  @IsOptional()
-  title?: string;
-
-  @IsString()
-  @IsOptional()
-  description?: string;
-
-  @IsString()
-  @IsOptional()
-  videoUrl?: string;
-}
+import { CreatePhilosofunDto } from './dto/create-philosofun.dto';
+import { UpdatePhilosofunDto } from './dto/update-philosofun.dto';
 
 @ApiTags('Philosofun')
 @Controller('philosofun')

src/quizzes/dto/create-quiz.dto.ts

@@ -0,0 +1,22 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class CreateQuizDto {
+  @IsString()
+  @IsOptional()
+  nodeId?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  type: string;
+
+  @IsString()
+  @IsNotEmpty()
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsNotEmpty()
+  questions: any;
+}

src/quizzes/dto/update-quiz.dto.ts

@@ -0,0 +1,22 @@
+import { IsString, IsOptional } from 'class-validator';
+
+export class UpdateQuizDto {
+  @IsString()
+  @IsOptional()
+  nodeId?: string;
+
+  @IsString()
+  @IsOptional()
+  type?: string;
+
+  @IsString()
+  @IsOptional()
+  title?: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsOptional()
+  questions?: any;
+}

src/quizzes/quizzes.controller.ts

@@ -1,52 +1,11 @@
 import { Controller, Get, Post, Body, Param, Query, Put, Delete, UseGuards } from '@nestjs/common';
 import { QuizzesService } from './quizzes.service';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
-import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
 import { JwtAuthGuard } from '../auth/jwt-auth.guard';
 import { RolesGuard } from '../auth/roles.guard';
 import { Roles } from '../auth/roles.decorator';
-
-class CreateQuizDto {
-  @IsString()
-  @IsOptional()
-  nodeId?: string;
-
-  @IsString()
-  @IsNotEmpty()
-  type: string; // "mcq" | "matching" | "essay" | "image" | "analysis"
-
-  @IsString()
-  @IsNotEmpty()
-  title: string;
-
-  @IsString()
-  @IsOptional()
-  description?: string;
-
-  @IsNotEmpty()
-  questions: any;
-}
-
-class UpdateQuizDto {
-  @IsString()
-  @IsOptional()
-  nodeId?: string;
-
-  @IsString()
-  @IsOptional()
-  type?: string;
-
-  @IsString()
-  @IsOptional()
-  title?: string;
-
-  @IsString()
-  @IsOptional()
-  description?: string;
-
-  @IsOptional()
-  questions?: any;
-}
+import { CreateQuizDto } from './dto/create-quiz.dto';
+import { UpdateQuizDto } from './dto/update-quiz.dto';
 
 @ApiTags('Quizzes & Interactive Systems')
 @Controller('quizzes')

src/users/dto/create-feedback.dto.ts

@@ -0,0 +1,11 @@
+import { IsString, IsNotEmpty, IsOptional } from 'class-validator';
+
+export class CreateFeedbackDto {
+  @IsString()
+  @IsOptional()
+  userId?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  content: string;
+}

src/users/dto/google-login.dto.ts

@@ -0,0 +1,7 @@
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class GoogleLoginDto {
+  @IsString()
+  @IsNotEmpty()
+  idToken: string;
+}

src/users/dto/login.dto.ts

@@ -0,0 +1,11 @@
+import { IsString, IsNotEmpty, IsOptional, IsEmail } from 'class-validator';
+
+export class LoginDto {
+  @IsEmail()
+  @IsNotEmpty()
+  email: string;
+
+  @IsString()
+  @IsOptional()
+  password?: string;
+}

src/users/dto/register.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsNotEmpty, IsOptional, IsEmail } from 'class-validator';
+
+export class RegisterDto {
+  @IsEmail()
+  @IsNotEmpty()
+  email: string;
+
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @IsString()
+  @IsOptional()
+  password?: string;
+}

src/users/dto/supabase-login.dto.ts

@@ -0,0 +1,7 @@
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class SupabaseLoginDto {
+  @IsString()
+  @IsNotEmpty()
+  token: string;
+}

src/users/dto/update-user.dto.ts

@@ -0,0 +1,15 @@
+import { IsString, IsOptional, IsNumber } from 'class-validator';
+
+export class UpdateUserDto {
+  @IsString()
+  @IsOptional()
+  name?: string;
+
+  @IsString()
+  @IsOptional()
+  email?: string;
+
+  @IsNumber()
+  @IsOptional()
+  streak?: number;
+}

src/users/users.controller.ts

@@ -1,70 +1,15 @@
 import { Controller, Get, Post, Body, Param, Query, Put, Delete, HttpCode, UseGuards, Req, ForbiddenException } from '@nestjs/common';
 import { UsersService } from './users.service';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
-import { IsString, IsNotEmpty, IsOptional, IsEmail, IsNumber } from 'class-validator';
 import { JwtAuthGuard } from '../auth/jwt-auth.guard';
 import { RolesGuard } from '../auth/roles.guard';
 import { Roles } from '../auth/roles.decorator';
-
-class RegisterDto {
-  @IsEmail()
-  @IsNotEmpty()
-  email: string;
-
-  @IsString()
-  @IsNotEmpty()
-  name: string;
-
-  @IsString()
-  @IsOptional()
-  password?: string;
-}
-
-class LoginDto {
-  @IsEmail()
-  @IsNotEmpty()
-  email: string;
-
-  @IsString()
-  @IsOptional()
-  password?: string;
-}
-
-class GoogleLoginDto {
-  @IsString()
-  @IsNotEmpty()
-  idToken: string;
-}
-
-class SupabaseLoginDto {
-  @IsString()
-  @IsNotEmpty()
-  token: string;
-}
-
-class UpdateUserDto {
-  @IsString()
-  @IsOptional()
-  name?: string;
-
-  @IsString()
-  @IsOptional()
-  email?: string;
-
-  @IsNumber()
-  @IsOptional()
-  streak?: number;
-}
-
-class CreateFeedbackDto {
-  @IsString()
-  @IsOptional()
-  userId: string;
-
-  @IsString()
-  @IsNotEmpty()
-  content: string;
-}
+import { RegisterDto } from './dto/register.dto';
+import { LoginDto } from './dto/login.dto';
+import { GoogleLoginDto } from './dto/google-login.dto';
+import { SupabaseLoginDto } from './dto/supabase-login.dto';
+import { UpdateUserDto } from './dto/update-user.dto';
+import { CreateFeedbackDto } from './dto/create-feedback.dto';
 
 @ApiTags('Authentication & User Management')
 @Controller()