# janardannn/scaler-lite architecture

> Architecture diagram of the GitHub repository janardannn/scaler-lite, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/janardannn/scaler-lite
- Repository: https://github.com/janardannn/scaler-lite

## Overview

##### Project type and purpose
- This is a full-stack online learning platform ("scaler lite") built on Next.js (App Router) with TypeScript.
- It provides course browsing, lecture viewing (reading & quizzes), enrollment, progress tracking, user profiles, instructor course creation, and file uploads.

##### File structure
- Top-level config and metadata: package.json, next.config.ts, tsconfig.json, prisma/schema.prisma, public/ (static assets).
- Frontend + backend are co-located under src/app:
- `/src/app/page.tsx`, `/src/app/layout.tsx`, `/src/app/...` for React pages + server-side components.
- `/src/app/api/*` for Next.js serverless API routes (NextAuth, courses, lectures, profile, uploadthing, db-ops).
- Shared code:
- `src/components/` UI components (shadcn/ui + custom).
- `src/hooks`, `src/lib`, `src/utils`, `src/providers`, `src/types`.
- Prisma schema defines MongoDB models (User, Course, Lecture, Progress, Score, Enrollment).

##### Insights from README
- Stack: Next.js App Router + TypeScript, Prisma ORM + MongoDB, NextAuth.js, UploadThing for file uploads, Tailwind + shadcn/ui.
- API contracts documented: endpoints for auth, courses, lectures, enrollments, quiz submissions, profile updates, file uploads, DB seeding.

##### Detail
- Every major API domain (auth, courses, lectures, profile, uploads, db-ops)
- Both SSR page flows and client-side interactions (e.g., quiz submission)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Zone
    subgraph "Client (Browser)" 
        direction TB
        Browser["Web Browser"]:::frontend
        PageHome["Home Page"]:::frontend
        PageLayout["App Layout"]:::frontend
        PageSignIn["Auth Sign-In Page"]:::frontend
        PageCoursesList["Courses List Page"]:::frontend
        PageCourseDetail["Course Detail Page"]:::frontend
        PageLecture["Lecture Page"]:::frontend
        PageMyCourses["My Courses Page"]:::frontend
        PageInstructorCreate["Instructor Create Course Page"]:::frontend
        PageProfileComplete["Profile Complete Page"]:::frontend
    end

    Browser -->|"renders"| PageHome
    Browser --> PageLayout
    Browser --> PageSignIn
    Browser --> PageCoursesList
    Browser --> PageCourseDetail
    Browser --> PageLecture
    Browser --> PageMyCourses
    Browser --> PageInstructorCreate
    Browser --> PageProfileComplete

    %% Next.js Application
    subgraph "Next.js App (Vercel)" 
        direction TB

        subgraph "Page Rendering (SSR/SSG)" 
            direction TB
            SSR["SSR / SSG Pages"]:::api
        end

        subgraph "API Layer (Serverless Functions)" 
            direction TB
            subgraph "Auth API" 
                NextAuthRoute["[...nextauth] Route"]:::api
                AuthLib["auth.ts"]:::api
                AuthProvider["auth-provider.tsx"]:::frontend
            end
            subgraph "Courses API" 
                CoursesRoute["courses Route"]:::api
                CourseIdRoute["[courseId] Route"]:::api
                CourseEnroll["/enroll Route"]:::api
                MyCoursesRoute["/my-courses Route"]:::api
            end
            subgraph "Lectures API" 
                LectureRoute["lecture Route"]:::api
                LectureComplete["/complete Route"]:::api
                LectureSubmit["/submit Route"]:::api
            end
            subgraph "Profile API" 
                ProfileRoute["profile Route"]:::api
            end
            subgraph "Upload API" 
                UploadRoute["uploadthing Route"]:::api
                UploadCore["uploadthing/core.ts"]:::api
                UploadUtil["uploadthing.ts"]:::api
            end
            subgraph "DB-ops API" 
                SeedRoute["/seed Route"]:::api
                UpdateUsersRoute["/update-existing-users Route"]:::api
            end
        end

        PrismaClient["Prisma Client"]:::orm
    end

    %% External Services
    subgraph "External Services"
        direction TB
        MongoDB["MongoDB Atlas"]:::db
        UploadThingService["UploadThing Service"]:::external
        CloudStorage["Cloud Storage"]:::external
        GoogleOAuth["Google OAuth"]:::external
    end

    %% Flows
    Browser -->|"HTTP Requests"| SSR
    Browser -->|"API Calls"| NextAuthRoute
    Browser -->|"API Calls"| CoursesRoute
    Browser -->|"API Calls"| LectureRoute
    Browser -->|"API Calls"| ProfileRoute
    Browser -->|"API Calls"| UploadRoute

    NextAuthRoute -->|"uses"| AuthLib
    NextAuthRoute -->|"uses"| AuthProvider
    NextAuthRoute -->|"OAuth Flow"| GoogleOAuth

    CoursesRoute -->|"DB Queries"| PrismaClient
    CourseIdRoute -->|"DB Queries"| PrismaClient
    CourseEnroll -->|"DB Writes"| PrismaClient
    MyCoursesRoute -->|"DB Queries"| PrismaClient

    LectureRoute -->|"DB Queries"| PrismaClient
    LectureComplete -->|"DB Writes"| PrismaClient
    LectureSubmit -->|"DB Writes"| PrismaClient

    ProfileRoute -->|"DB Queries/Writes"| PrismaClient

    UploadRoute -->|"calls"| UploadThingService
    UploadThingService -->|"stores"| CloudStorage

    SeedRoute -->|"DB Ops"| PrismaClient
    UpdateUsersRoute -->|"DB Ops"| PrismaClient

    PrismaClient -->|"connects"| MongoDB

    %% Click Events for Component Mapping
    click PageHome "https://github.com/janardannn/scaler-lite/blob/main/src/app/page.tsx"
    click PageLayout "https://github.com/janardannn/scaler-lite/blob/main/src/app/layout.tsx"
    click PageSignIn "https://github.com/janardannn/scaler-lite/blob/main/src/app/auth/sign-in/page.tsx"
    click PageCoursesList "https://github.com/janardannn/scaler-lite/blob/main/src/app/courses/page.tsx"
    click PageCourseDetail "https://github.com/janardannn/scaler-lite/blob/main/src/app/courses/[courseId]/page.tsx"
    click PageLecture "https://github.com/janardannn/scaler-lite/blob/main/src/app/courses/[courseId]/lectures/[lectureId]/page.tsx"
    click PageMyCourses "https://github.com/janardannn/scaler-lite/blob/main/src/app/courses/my-courses/page.tsx"
    click PageInstructorCreate "https://github.com/janardannn/scaler-lite/blob/main/src/app/instructor/courses/create/page.tsx"
    click PageProfileComplete "https://github.com/janardannn/scaler-lite/blob/main/src/app/profile/complete/page.tsx"

    click NextAuthRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/auth/[...nextauth]/route.ts"
    click AuthLib "https://github.com/janardannn/scaler-lite/blob/main/src/lib/auth.ts"
    click AuthProvider "https://github.com/janardannn/scaler-lite/blob/main/src/providers/auth-provider.tsx"

    click CoursesRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/courses/route.ts"
    click CourseIdRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/courses/[courseId]/route.ts"
    click CourseEnroll "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/courses/[courseId]/enroll/route.ts"
    click MyCoursesRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/courses/my-courses/route.ts"

    click LectureRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/courses/[courseId]/lectures/[lectureId]/route.ts"
    click LectureComplete "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/courses/[courseId]/lectures/[lectureId]/complete/route.ts"
    click LectureSubmit "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/courses/[courseId]/lectures/[lectureId]/submit/route.ts"

    click ProfileRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/profile/route.ts"

    click UploadRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/uploadthing/route.ts"
    click UploadCore "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/uploadthing/core.ts"
    click UploadUtil "https://github.com/janardannn/scaler-lite/blob/main/src/utils/uploadthing.ts"

    click SeedRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/db-ops/seed/route.ts"
    click UpdateUsersRoute "https://github.com/janardannn/scaler-lite/blob/main/src/app/api/db-ops/update-existing-users/route.ts"

    click PrismaClient "https://github.com/janardannn/scaler-lite/blob/main/src/lib/prisma.ts"
    click MongoDB "https://github.com/janardannn/scaler-lite/blob/main/prisma/schema.prisma"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0044CC,stroke-width:1px
    classDef api fill:#C8FACC,stroke:#228B22,stroke-width:1px
    classDef orm fill:#FFE4B3,stroke:#DAA520,stroke-width:1px
    classDef db fill:#FFDFC4,stroke:#CD5C5C,stroke-width:1px
    classDef external fill:#E8D0FF,stroke:#800080,stroke-width:1px
```
