# ccivam/social-media-website architecture

> Architecture diagram of the GitHub repository ccivam/social-media-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ccivam/social-media-website
- Repository: https://github.com/ccivam/social-media-website

## Overview

##### Main Components

A. Frontend Layer:
- Views (EJS templates)
- Static Assets (CSS, JavaScript, Images)
- Client-side JavaScript modules

B. Backend Layer:
- Express.js Server
- Authentication System
- API Layer (v1)
- Controllers
- Models

C. Database Layer:
- MongoDB

D. External Services:
- Google OAuth Integration

##### Component Relationships and Structure

**[Client Browser] → [Frontend Layer] → [Backend Layer] → [Database Layer]**

A. Frontend Layer (Top):
- To Static Assets (assets/)
- Client-side JavaScript modules (home_posts.js, toggle_likes.js)

B. Backend Layer (Middle):
- Express Server (Main Application)
- Authentication Module
- Local Strategy
- JWT Strategy
- Google OAuth Strategy
- API Routes (v1)
- Controllers
- Middleware

C. Database Layer (Bottom):
- MongoDB Collections
- Users
- Posts
- Comments
- Likes

##### Key Interactions to Highlight

A. Authentication Flow:
- Local login
- Google OAuth
- JWT token generation

B. Data Flow:
- Post creation/retrieval
- Comment management
- Like system
- File uploads (avatars)

##### Implementation Details

**[Client Layer]**
- ↓
**[Frontend (Views + Assets)]**
- ↓
**[Authentication Layer]**
- ↓
**[Application Layer (Controllers + Routes)]**
- ↓
**[Data Layer (Models + MongoDB)]**

##### Additional Elements

- Notes about environment configurations
- Gulp build process
- Production vs development environments

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph "Views Layer"
        Views["Views Container"]
        SignIn["Sign In View"]:::view
        SignUp["Sign Up View"]:::view
        Home["Home View"]:::view
        Profile["User Profile"]:::view
        
        Views --> SignIn
        Views --> SignUp
        Views --> Home
        Views --> Profile
    end

    subgraph "Static Assets"
        Assets["Assets Container"]
        CSS["CSS Files"]:::static
        ClientJS["Client JavaScript"]:::static
        PostsJS["Posts Handler"]:::static
        LikesJS["Likes Handler"]:::static
        
        Assets --> CSS
        Assets --> ClientJS
        ClientJS --> PostsJS
        ClientJS --> LikesJS
    end

    subgraph "Authentication"
        Auth["Authentication System"]
        Local["Local Strategy"]:::auth
        JWT["JWT Strategy"]:::auth
        Google["Google OAuth"]:::auth
        
        Auth --> Local
        Auth --> JWT
        Auth --> Google
    end

    subgraph "API Layer"
        API["API v1"]:::api
        PostsAPI["Posts API"]:::api
        UsersAPI["Users API"]:::api
        
        API --> PostsAPI
        API --> UsersAPI
    end

    subgraph "Controllers"
        Controllers["Controllers Layer"]
        PostsCtrl["Posts Controller"]:::controller
        UsersCtrl["Users Controller"]:::controller
        CommentsCtrl["Comments Controller"]:::controller
        LikesCtrl["Likes Controller"]:::controller
        
        Controllers --> PostsCtrl
        Controllers --> UsersCtrl
        Controllers --> CommentsCtrl
        Controllers --> LikesCtrl
    end

    subgraph "Data Models"
        Models["Models Layer"]
        UserModel["User Model"]:::model
        PostModel["Post Model"]:::model
        CommentModel["Comment Model"]:::model
        LikeModel["Like Model"]:::model
        
        Models --> UserModel
        Models --> PostModel
        Models --> CommentModel
        Models --> LikeModel
    end

    subgraph "Storage"
        Upload["File Upload System"]
        Avatars["Avatar Storage"]:::storage
        Logs["Production Logs"]:::storage
        
        Upload --> Avatars
    end

    subgraph "Database"
        MongoDB["MongoDB"]:::database
        DBConfig["Database Config"]:::config
        
        MongoDB --> DBConfig
    end

    Browser --> Views
    Browser --> Assets
    Views --> Auth
    Auth --> Controllers
    Auth --> API
    Controllers --> Models
    API --> Models
    Models --> MongoDB
    Controllers --> Upload

    %% Component Mappings
    click SignIn "https://github.com/Ccivam/Social-Media-Website/blob/master/views/user_sign_in.ejs"
    click SignUp "https://github.com/Ccivam/Social-Media-Website/blob/master/views/user_sign_up.ejs"
    click Home "https://github.com/Ccivam/Social-Media-Website/blob/master/views/Home.ejs"
    click Profile "https://github.com/Ccivam/Social-Media-Website/blob/master/views/user_profile.ejs"
    click CSS "https://github.com/Ccivam/Social-Media-Website/tree/master/assets/css"
    click ClientJS "https://github.com/Ccivam/Social-Media-Website/tree/master/assets/js"
    click PostsJS "https://github.com/Ccivam/Social-Media-Website/blob/master/assets/js/home_posts.js"
    click LikesJS "https://github.com/Ccivam/Social-Media-Website/blob/master/assets/js/toggle_likes.js"
    click Local "https://github.com/Ccivam/Social-Media-Website/blob/master/config/passport-local-strategy.js"
    click JWT "https://github.com/Ccivam/Social-Media-Website/blob/master/config/passport-jwt-strategy.js"
    click Google "https://github.com/Ccivam/Social-Media-Website/blob/master/config/passport-google-oauth-strategy.js"
    click API "https://github.com/Ccivam/Social-Media-Website/tree/master/routes/api/v1"
    click PostsAPI "https://github.com/Ccivam/Social-Media-Website/blob/master/controllers/api/v1/posts_api.js"
    click UsersAPI "https://github.com/Ccivam/Social-Media-Website/blob/master/controllers/api/v1/users_api.js"
    click PostsCtrl "https://github.com/Ccivam/Social-Media-Website/blob/master/controllers/posts_controller.js"
    click UsersCtrl "https://github.com/Ccivam/Social-Media-Website/blob/master/controllers/users_controllers.js"
    click CommentsCtrl "https://github.com/Ccivam/Social-Media-Website/blob/master/controllers/comments.js"
    click LikesCtrl "https://github.com/Ccivam/Social-Media-Website/blob/master/controllers/likes_controller.js"
    click UserModel "https://github.com/Ccivam/Social-Media-Website/blob/master/model/user.js"
    click PostModel "https://github.com/Ccivam/Social-Media-Website/blob/master/model/post.js"
    click CommentModel "https://github.com/Ccivam/Social-Media-Website/blob/master/model/comment.js"
    click LikeModel "https://github.com/Ccivam/Social-Media-Website/blob/master/model/like.js"
    click DBConfig "https://github.com/Ccivam/Social-Media-Website/blob/master/config/mongoose.js"
    click Avatars "https://github.com/Ccivam/Social-Media-Website/tree/master/uploads/users/avatars"
    click Logs "https://github.com/Ccivam/Social-Media-Website/tree/master/production_logs"

    %% Styling
    classDef view fill:#2196F3,stroke:#1565C0,color:white
    classDef static fill:#4CAF50,stroke:#2E7D32,color:white
    classDef auth fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef api fill:#FF9800,stroke:#EF6C00,color:white
    classDef controller fill:#F44336,stroke:#C62828,color:white
    classDef model fill:#00BCD4,stroke:#00838F,color:white
    classDef storage fill:#795548,stroke:#4E342E,color:white
    classDef database fill:#FFC107,stroke:#FFA000,color:white
    classDef config fill:#607D8B,stroke:#455A64,color:white
```
