# amaaaaaaaan/expertlancer architecture

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

- Interactive diagram: https://gitdiagram.com/amaaaaaaaan/expertlancer
- Repository: https://github.com/amaaaaaaaan/expertlancer

## Overview

##### Project Type and Purpose
- This is ExpertLancer, a full-stack freelancing web application built with Node.js/Express on the backend and server-rendered EJS views for the frontend.
- It connects clients and freelancers, providing job postings, applications, profiles, real-time chat, AI-backed matching, and analytics.

##### File Structure
- Top-level files:
- app.js — application entrypoint, Express setup
- package.json / package-lock.json — dependencies and scripts
- README.md — project overview
- Directories:
- config/ — database connection (mongooseconnection.js), file-upload config (multer-config.js)
- controllers/ — MVC controllers for user, freelancer, job, project, messaging
- routes/ — Express routers mapping endpoints to controllers
- models/ — Mongoose schemas (User, Freelancer, Job, Project, Message)
- middlewares/ — auth and role-based access control
- uploads/ — persisted file uploads (images, documents)
- views/ — EJS templates (pages for registration, profiles, listings, chat, analytics)
- firebaseConfig.js suggests integration with Firebase (likely for real-time messaging or notifications).

##### README for Additional Insights
- Technology stack confirmation: HTML/JavaScript, Tailwind CSS, Express, MongoDB, JWT/Bcrypt for auth.
- Features: AI matching, skill-gap analysis, real-time chat, search/filter, analytics, collaboration tools.

a. Main Components
- Client Browser – EJS views + Tailwind CSS + client-side JS (GSAP animations, filters).
- Web Server – Express app (app.js) with:
– Router layer (routes/*.js)
– Controller layer (controllers/*.js)
– Business-logic (AI matching service stub, skill analysis module)
– Middleware (auth-middleware, role checks)
- Database – MongoDB instance (collections for users, freelancers, jobs, projects, messages).
- File Storage – Local uploads folder via Multer (or Firebase Storage if configured).
- Real-Time Service – Firebase Realtime Database / Firestore or Socket Service for chat.
- External Services –
– AI/ML matching engine (could be in-house or third-party API)
– Analytics dashboard service (real-time usage stats)

b. Relationships and Interactions
- Client ↔ HTTP(S) requests → Express routers → controllers → MongoDB
- File upload endpoints use Multer middleware → uploads folder (or Firebase)
- Auth middleware intercepts protected routes, validates JWT, reads Bcrypt-hashed credentials
- Chat page uses WebSocket or Firebase SDK for bidirectional messaging → messages collection or real-time DB

c. Architectural Patterns and Principles
- MVC pattern (Models, Views, Controllers)
- Layered architecture (Routing → Controllers → Services → Data Access)
- Stateless authentication (JWT)
- Single codebase for frontend (server-rendered) and backend
- Separation of concerns via middleware

d. Key Technologies and Libraries
- Node.js, Express.js
- MongoDB + Mongoose ODM
- Multer for file uploads
- Firebase SDK (for chat/notifications)
- JWT & Bcrypt for authentication

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        Client["Client Browser<br/>(EJS Views, Tailwind CSS, GSAP, Remix Icon)"]:::frontend
    end

    %% Server Layer
    subgraph "Server Layer"
        direction TB
        App["app.js"]:::backend
        PackageJSON["package.json"]:::backend
        PackageLock["package-lock.json"]:::backend

        subgraph "Configuration"
            direction TB
            DBConfig["mongooseconnection.js"]:::backend
            FileUploadConfig["multer-config.js"]:::backend
            FirebaseConfig["firebaseConfig.js"]:::backend
        end

        subgraph "Routing Layer"
            direction TB
            UserRoutes["userRoutes.js"]:::backend
            FreelancerRoutes["freelancerRoutes.js"]:::backend
            JobRoutes["jobRoutes.js"]:::backend
            ProjectRoutes["projectRoutes.js"]:::backend
        end

        subgraph "Controller Layer"
            direction TB
            UserController["userController.js"]:::backend
            FreelancerController["freelancerController.js"]:::backend
            JobController["jobController.js"]:::backend
            ProjectController["projectController.js"]:::backend
        end

        subgraph "Middleware"
            direction TB
            AuthMiddleware["auth-middleware.js"]:::backend
            RoleMiddleware["freelancerMiddleware.js"]:::backend
        end

        subgraph "Models"
            direction TB
            UserModel["user.js"]:::db
            FreelancerModel["freelancer.js"]:::db
            JobModel["job.js"]:::db
            ProjectModel["project.js"]:::db
            MessageModel["message.js"]:::db
        end

        subgraph "Services"
            direction TB
            AIMatching["AI Matching Service"]:::external
            SkillGap["Skill-Gap Analysis"]:::external
        end
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        MongoDB["MongoDB Database"]:::db
        Uploads["uploads/ (File Storage via Multer)"]:::storage
        FirebaseDB["Firebase Realtime DB"]:::external
    end

    %% External Services
    subgraph "External Services"
        direction TB
        AIMLAPI["Third-Party AI/ML API"]:::external
        AnalyticsAPI["Analytics Dashboard Service"]:::external
    end

    %% Client to Server
    Client -->|"HTTP(S) Requests / WebSocket"| App

    %% Server startup dependencies
    App --> PackageJSON
    App --> PackageLock
    App --> DBConfig
    App --> FileUploadConfig
    App --> FirebaseConfig

    %% Routing flow
    App --> UserRoutes
    App --> FreelancerRoutes
    App --> JobRoutes
    App --> ProjectRoutes

    UserRoutes --> UserController
    FreelancerRoutes --> FreelancerController
    JobRoutes --> JobController
    ProjectRoutes --> ProjectController

    %% Middleware
    UserRoutes --> AuthMiddleware
    FreelancerRoutes --> AuthMiddleware
    FreelancerRoutes --> RoleMiddleware

    %% Controllers use Models and Services
    UserController --> UserModel
    FreelancerController --> FreelancerModel
    JobController --> JobModel
    ProjectController --> ProjectModel
    JobController --> AIMatching
    FreelancerController --> SkillGap

    %% Data persistence
    UserModel --> MongoDB
    FreelancerModel --> MongoDB
    JobModel --> MongoDB
    ProjectModel --> MongoDB
    MessageModel --> MongoDB

    %% File uploads
    FileUploadConfig --> Uploads
    JobController --> Uploads
    ProjectController --> Uploads

    %% Real-time messaging
    Client --> FirebaseDB
    MessageModel --> FirebaseDB
    Client -->|"WebSocket/Firebase SDK"| FirebaseDB

    %% External service calls
    AIMatching -.-> AIMLAPI
    AnalyticsAPI --> MongoDB
    App -.-> AnalyticsAPI

    %% Click Events
    click App "https://github.com/amaaaaaaaan/expertlancer/blob/main/app.js"
    click PackageJSON "https://github.com/amaaaaaaaan/expertlancer/blob/main/package.json"
    click PackageLock "https://github.com/amaaaaaaaan/expertlancer/blob/main/package-lock.json"
    click DBConfig "https://github.com/amaaaaaaaan/expertlancer/blob/main/config/mongooseconnection.js"
    click FileUploadConfig "https://github.com/amaaaaaaaan/expertlancer/blob/main/config/multer-config.js"
    click FirebaseConfig "https://github.com/amaaaaaaaan/expertlancer/blob/main/firebaseConfig.js"
    click UserRoutes "https://github.com/amaaaaaaaan/expertlancer/blob/main/routes/userRoutes.js"
    click FreelancerRoutes "https://github.com/amaaaaaaaan/expertlancer/blob/main/routes/freelancerRoutes.js"
    click JobRoutes "https://github.com/amaaaaaaaan/expertlancer/blob/main/routes/jobRoutes.js"
    click ProjectRoutes "https://github.com/amaaaaaaaan/expertlancer/blob/main/routes/projectRoutes.js"
    click UserController "https://github.com/amaaaaaaaan/expertlancer/blob/main/controllers/userController.js"
    click FreelancerController "https://github.com/amaaaaaaaan/expertlancer/blob/main/controllers/freelancerController.js"
    click JobController "https://github.com/amaaaaaaaan/expertlancer/blob/main/controllers/jobController.js"
    click ProjectController "https://github.com/amaaaaaaaan/expertlancer/blob/main/controllers/projectController.js"
    click AuthMiddleware "https://github.com/amaaaaaaaan/expertlancer/blob/main/middlewares/auth-middleware.js"
    click RoleMiddleware "https://github.com/amaaaaaaaan/expertlancer/blob/main/middlewares/freelancerMiddleware.js"
    click UserModel "https://github.com/amaaaaaaaan/expertlancer/blob/main/models/user.js"
    click FreelancerModel "https://github.com/amaaaaaaaan/expertlancer/blob/main/models/freelancer.js"
    click JobModel "https://github.com/amaaaaaaaan/expertlancer/blob/main/models/job.js"
    click ProjectModel "https://github.com/amaaaaaaaan/expertlancer/blob/main/models/project.js"
    click MessageModel "https://github.com/amaaaaaaaan/expertlancer/blob/main/models/message.js"

    %% Styles
    classDef frontend fill:#E8F1FB,stroke:#0366D6,color:#0366D6
    classDef backend fill:#F0F4C3,stroke:#827717,color:#827717
    classDef db fill:#FFF8E1,stroke:#FF6F00,color:#BF360C
    classDef storage fill:#F3E5F5,stroke:#6A1B9A,color:#4A148C
    classDef external fill:#E0F7FA,stroke:#006064,color:#006064
```
