# maorte/udemy-app architecture

> Architecture diagram of the GitHub repository maorte/udemy-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maorte/udemy-app
- Repository: https://github.com/maorte/udemy-app

## Overview

##### Project Type and Purpose
- This is a full-stack MERN (MongoDB, Express.js, React, Node.js) application that simulates an online course platform (like Udemy).
- The frontend is a React/Redux single-page app; the backend is an Express.js REST API following the MVC pattern; data is persisted in MongoDB.

##### File Structure
- Top-level “client” directory: a React app using Redux Toolkit (slices in `features/`), React Router pages in `pages/`, styled-components, and an API abstraction in `src/API/api.js`.
- Top-level “server” directory: an Express.js project organized into `routers/`, `controllers/`, `models/`, and middleware (`auth.js`, `adminAuth.js`). Mongoose setup in `db/mongoose.js`.
- Config and utility files: `.env` in client, `store/` for Redux middleware, `utils/` for protected routes on client; on the server, Multer/Sharp handle avatar uploads.

##### README Insights
- Backend uses MVC.
- Authentication via bcrypt (password hashing) and JWT (token issuance + middleware).
- Multer + Sharp for image upload/processing.
- Two user roles: admin (can add videos/courses) and regular (view/comment).

##### Main Components
a. Frontend (React/Redux SPA)
- UI Components & Pages (AccountBox, CourseCard, VideoPage, etc.)
- Redux Store & Slices (auth, courses, videos, comments, users)
- API Client Layer (api.js)
- Route Guards (ProtectedRoute, ProtectedAdminRoute)
b. Backend (Node/Express)
- HTTP Server (Express app)
- Routers (user, course, video, comment)
- Controllers (business logic per resource)
- Models (Mongoose schemas for User, Course, Video, Comment)
- Middleware (auth, adminAuth, Multer for file uploads)
c. Database
- MongoDB (hosted or local) accessed via Mongoose
d. File Storage (for avatars)
- Local filesystem or cloud bucket, processed by Sharp
e. External Services
- JWT issuer/validator
- Bcrypt for hashing

##### Relationships and Data Flows
- User (browser) ↔ React SPA
- React SPA dispatches actions → Redux slices → uses api.js → HTTP requests to Express API
- Express middleware validates JWT → routers dispatch to controllers → controllers use Mongoose models → CRUD operations on MongoDB
- Avatar upload endpoint: client → Multer middleware → Sharp image processing → stored in filesystem/DB → controller returns URL
- Comments/videos/courses endpoints follow similar request → controller → model → response flow

##### Architectural Patterns & Design Principles
- Frontend: Component-based UI + Redux for state, separation of concerns (presentation vs. container components)
- Backend: MVC (routers→controllers→models)
- Layered architecture: UI layer → API layer → Business logic layer → Data access layer
- Auth patterns: JWT stateless authentication + role-based access (admin vs. user)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "React App"
        direction TB
        AccountBox["AccountBox"]:::frontend
        CourseCard["CourseCard"]:::frontend
        CommentComp["Comment"]:::frontend
        VideoPage["VideoPage"]:::frontend
        AddCourse["AddCourse Page"]:::frontend
        AddVideo["AddVideo Page"]:::frontend
        Store["Redux Store"]:::redux
        Middleware["Redux Middleware"]:::redux
        AuthSlice["Auth Slice"]:::redux
        CoursesSlice["Courses Slice"]:::redux
        VideosSlice["Videos Slice"]:::redux
        CommentsSlice["Comments Slice"]:::redux
        UsersSlice["Users Slice"]:::redux
        APIClient["API Client (api.js)"]:::frontend
        ProtectedRoute["ProtectedRoute"]:::frontend
        ProtectedAdminRoute["ProtectedAdminRoute"]:::frontend
    end

    %% Backend Layer
    subgraph "Express Server"
        direction TB
        ExpressApp["Express App (index.js)"]:::backend
        MongooseConn["Mongoose Connection (mongoose.js)"]:::backend
        AuthMW["Auth Middleware"]:::backend
        AdminMW["AdminAuth Middleware"]:::backend
        UserRouter["User Router"]:::backend
        CourseRouter["Course Router"]:::backend
        VideoRouter["Video Router"]:::backend
        CommentRouter["Comment Router"]:::backend
        UserController["User Controller"]:::backend
        CourseController["Course Controller"]:::backend
        VideoController["Video Controller"]:::backend
        CommentController["Comment Controller"]:::backend
        UserModel["User Model"]:::model
        CourseModel["Course Model"]:::model
        VideoModel["Video Model"]:::model
        CommentModel["Comment Model"]:::model
    end

    %% Database & Storage
    MongoDB["MongoDB"]:::database
    FileStorage["File Storage"]:::storage

    %% External Services
    JWT["JWT Service"]:::external
    Bcrypt["Bcrypt"]:::external
    Multer["Multer"]:::external
    Sharp["Sharp"]:::external

    %% Frontend flow
    AccountBox -->|interacts| Store
    CourseCard -->|interacts| Store
    CommentComp -->|interacts| Store
    VideoPage -->|interacts| Store
    AddCourse -->|interacts| Store
    AddVideo -->|interacts| Store
    Store -->|uses| Middleware
    Middleware -->|dispatches| AuthSlice
    Middleware -->|dispatches| CoursesSlice
    Middleware -->|dispatches| VideosSlice
    Middleware -->|dispatches| CommentsSlice
    Middleware -->|dispatches| UsersSlice
    Store -->|calls| APIClient
    ProtectedRoute -->|wraps| VideoPage
    ProtectedAdminRoute -->|wraps| AddCourse
    ProtectedAdminRoute -->|wraps| AddVideo
    APIClient -->|HTTP| ExpressApp

    %% Backend flow
    ExpressApp -->|use| AuthMW
    ExpressApp -->|use| AdminMW
    ExpressApp -->|register| UserRouter
    ExpressApp -->|register| CourseRouter
    ExpressApp -->|register| VideoRouter
    ExpressApp -->|register| CommentRouter
    AuthMW -->|validate| JWT
    AuthMW -->|hash/compare| Bcrypt
    CourseRouter -->|route| CourseController
    UserRouter -->|route| UserController
    VideoRouter -->|route| VideoController
    CommentRouter -->|route| CommentController
    CourseController -->|CRUD| CourseModel
    UserController -->|CRUD| UserModel
    VideoController -->|CRUD| VideoModel
    CommentController -->|CRUD| CommentModel
    MongooseConn -->|connect| MongoDB
    VideoController -->|upload| Multer
    Multer -->|process| Sharp
    Sharp -->|store| FileStorage
    FileStorage -->|URL| VideoController

    %% Database to Controllers
    CourseModel -->|data| CourseController
    UserModel -->|data| UserController
    VideoModel -->|data| VideoController
    CommentModel -->|data| CommentController

    %% Click Events
    click AccountBox "https://github.com/maorte/udemy-app/blob/main/client/src/components/AccountBox/index.jsx"
    click CourseCard "https://github.com/maorte/udemy-app/blob/main/client/src/components/CourseCard/CourseCard.component.jsx"
    click CommentComp "https://github.com/maorte/udemy-app/blob/main/client/src/components/Comment/Comment.component.jsx"
    click VideoPage "https://github.com/maorte/udemy-app/blob/main/client/src/pages/VideoPage/Video.component.jsx"
    click AddCourse "https://github.com/maorte/udemy-app/blob/main/client/src/pages/AddCourse/AddCourse.component.jsx"
    click AddVideo "https://github.com/maorte/udemy-app/blob/main/client/src/pages/AddVideoPage/AddVideo.component.jsx"
    click Store "https://github.com/maorte/udemy-app/blob/main/client/src/store/store.js"
    click Middleware "https://github.com/maorte/udemy-app/blob/main/client/src/store/middleware.js"
    click AuthSlice "https://github.com/maorte/udemy-app/blob/main/client/src/features/auth/authSlice.js"
    click CoursesSlice "https://github.com/maorte/udemy-app/blob/main/client/src/features/courses/coursesSlice.js"
    click VideosSlice "https://github.com/maorte/udemy-app/blob/main/client/src/features/videos/videosSlice.js"
    click CommentsSlice "https://github.com/maorte/udemy-app/blob/main/client/src/features/comments/commentsSlice.js"
    click UsersSlice "https://github.com/maorte/udemy-app/blob/main/client/src/features/users/usersSlice.js"
    click APIClient "https://github.com/maorte/udemy-app/blob/main/client/src/API/api.js"
    click ProtectedRoute "https://github.com/maorte/udemy-app/blob/main/client/src/utils/ProtectedRoute.js"
    click ProtectedAdminRoute "https://github.com/maorte/udemy-app/blob/main/client/src/utils/ProtectedAdminRoute.js"
    click ExpressApp "https://github.com/maorte/udemy-app/blob/main/server/index.js"
    click MongooseConn "https://github.com/maorte/udemy-app/blob/main/server/db/mongoose.js"
    click UserRouter "https://github.com/maorte/udemy-app/blob/main/server/routers/user.js"
    click CourseRouter "https://github.com/maorte/udemy-app/blob/main/server/routers/course.js"
    click VideoRouter "https://github.com/maorte/udemy-app/blob/main/server/routers/video.js"
    click CommentRouter "https://github.com/maorte/udemy-app/blob/main/server/routers/comment.js"
    click UserController "https://github.com/maorte/udemy-app/blob/main/server/controllers/userController.js"
    click CourseController "https://github.com/maorte/udemy-app/blob/main/server/controllers/courseController.js"
    click VideoController "https://github.com/maorte/udemy-app/blob/main/server/controllers/videoController.js"
    click CommentController "https://github.com/maorte/udemy-app/blob/main/server/controllers/commentController.js"
    click UserModel "https://github.com/maorte/udemy-app/blob/main/server/models/user.js"
    click CourseModel "https://github.com/maorte/udemy-app/blob/main/server/models/course.js"
    click VideoModel "https://github.com/maorte/udemy-app/blob/main/server/models/video.js"
    click CommentModel "https://github.com/maorte/udemy-app/blob/main/server/models/comment.js"
    click AuthMW "https://github.com/maorte/udemy-app/blob/main/server/middleware/auth.js"
    click AdminMW "https://github.com/maorte/udemy-app/blob/main/server/middleware/adminAuth.js"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#3399FF,stroke-width:1px
    classDef redux fill:#E8F0FE,stroke:#4C6EF5,stroke-width:1px
    classDef backend fill:#E6F4EA,stroke:#2E8B57,stroke-width:1px
    classDef model fill:#F0F4C3,stroke:#9E9D24,stroke-width:1px
    classDef database fill:#FFE0B2,stroke:#FB8C00,stroke-width:1px
    classDef storage fill:#F3E5F5,stroke:#8E24AA,stroke-width:1px
    classDef external fill:#F5F5F5,stroke:#757575,stroke-width:1px
```
