# palmistry2310/freelancer-marketplace architecture

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

- Interactive diagram: https://gitdiagram.com/palmistry2310/freelancer-marketplace
- Repository: https://github.com/palmistry2310/freelancer-marketplace

## Overview

##### Main Components

a) Client Layer:
- EJS views structure with main sections:
- Authentication views (login/signup)
- Job-related views (create/list/my jobs)
- Home view
- Public assets (CSS files)

b) Server Layer:
- Express.js application (app.js as the entry point)
- Route handlers (authRoutes.js, jobRoutes.js)
- Controllers (authController.js, jobController.js)
- Middleware layer (middleware.js)
- Models layer (User.js, Job.js)

c) Database Layer:
- MongoDB Atlas (as mentioned in deployment section)

##### Component Relationships

- Client → Server: Show HTTP requests (GET/POST) flowing through the routes
- Server → Database: Illustrate MongoDB interactions through Mongoose models
- Authentication Flow: Highlight JWT token-based auth flow as described in README

##### Specific Implementation Details

a) Frontend Components:
**Views (EJS Templates)**
- Auth Module
- Login
- Signup
- Job Module
- Create Job
- Job List
- My Jobs
- Home Page

b) Backend Architecture:
**Express Server**
- Routes Layer
- Auth Routes
- Job Routes
- Controller Layer
- Auth Controller
- Job Controller
- Middleware
- JWT Authentication
- Models
- User Model
- Job Model

##### Data Flow Indicators

- User authentication flow
- Job creation/retrieval flow
- API endpoints interaction
- Database queries/responses

##### Important Notes

Specific features:
- Protected routes requiring JWT authentication
- Error handling responses (401, 404, 500)
- Environment configuration requirements
- Deployment architecture (Render + MongoDB Atlas)

##### Additional Elements

- API endpoints table (as provided in README)
- Error handling patterns
- Environment variables configuration

##### Technical Stack Indicators

- Frontend: EJS, CSS
- Backend: Express.js, Node.js
- Database: MongoDB
- Authentication: JWT
- Deployment: Render, MongoDB Atlas

This system design should provide a clear understanding of how the freelance marketplace operates, from user interaction through to data persistence, while maintaining security through JWT authentication and following RESTful API principles.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Views["Views Layer"]
        AuthViews["Authentication Views"]:::frontend
        JobViews["Job Management Views"]:::frontend
        HomeView["Home View"]:::frontend
        NavComp["Navigation Component"]:::frontend
        PublicAssets["Public Assets"]:::frontend
        
        Views --> AuthViews
        Views --> JobViews
        Views --> HomeView
        Views --> NavComp
        
        AuthViews --> Login["Login View"]:::frontend
        AuthViews --> Signup["Signup View"]:::frontend
        
        JobViews --> CreateJob["Create Job View"]:::frontend
        JobViews --> JobList["Job List View"]:::frontend
        JobViews --> MyJobs["My Jobs View"]:::frontend
        
        PublicAssets --> AuthCSS["Auth Styles"]:::frontend
        PublicAssets --> CreateJobCSS["Create Job Styles"]:::frontend
        PublicAssets --> JobListCSS["Job List Styles"]:::frontend
        PublicAssets --> MyJobCSS["My Jobs Styles"]:::frontend
        PublicAssets --> NavCSS["Navigation Styles"]:::frontend
        PublicAssets --> HomeCSS["Homepage Styles"]:::frontend
    end
    
    subgraph Server
        App["Express App"]:::backend
        
        subgraph Routes
            AuthRoutes["Auth Routes"]:::backend
            JobRoutes["Job Routes"]:::backend
        end
        
        subgraph Controllers
            AuthController["Auth Controller"]:::backend
            JobController["Job Controller"]:::backend
        end
        
        subgraph Middleware
            JWTAuth["JWT Authentication"]:::security
        end
        
        subgraph Models
            UserModel["User Model"]:::backend
            JobModel["Job Model"]:::backend
        end
        
        App --> Routes
        Routes --> Controllers
        Controllers --> Models
        Routes --> JWTAuth
    end
    
    subgraph Database
        MongoDB[(MongoDB Atlas)]:::database
    end
    
    Views --> App
    Models --> MongoDB
    
    %% Click Events
    click App "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/app.js"
    click AuthController "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/controllers/authController.js"
    click AuthRoutes "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/routes/authRoutes.js"
    click AuthViews "https://github.com/Palmistry2310/Freelancer-marketplace/tree/main/views/auth"
    click AuthCSS "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/public/auth.css"
    click JobController "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/controllers/jobController.js"
    click JobRoutes "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/routes/jobRoutes.js"
    click JobViews "https://github.com/Palmistry2310/Freelancer-marketplace/tree/main/views/job"
    click CreateJobCSS "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/public/createJob.css"
    click JobListCSS "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/public/joblist.css"
    click MyJobCSS "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/public/myjob.css"
    click UserModel "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/models/User.js"
    click JobModel "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/models/Job.js"
    click JWTAuth "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/middleware.js"
    click NavComp "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/components/navbar.ejs"
    click NavCSS "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/public/navbar.css"
    click HomeView "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/views/home.ejs"
    click HomeCSS "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/public/homepage.css"
    click Login "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/views/auth/login.ejs"
    click Signup "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/views/auth/signup.ejs"
    click CreateJob "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/views/job/createJob.ejs"
    click JobList "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/views/job/jobList.ejs"
    click MyJobs "https://github.com/Palmistry2310/Freelancer-marketplace/blob/main/views/job/myJobs.ejs"
    
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef security fill:#e74c3c,stroke:#c0392b,color:white
    classDef database fill:#f1c40f,stroke:#f39c12,color:white
    
    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        Backend["Backend Component"]:::backend
        Security["Security Component"]:::security
        Database["Database Component"]:::database
    end
```
