# elion74/tblogs architecture

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

- Interactive diagram: https://gitdiagram.com/elion74/tblogs
- Repository: https://github.com/elion74/tblogs

## Overview

##### Project Type & Purpose
- TBlogs is a **full-stack social media application**.
- Frontend: React.js SPA (single-page application).
- Backend: Node.js + Express REST API.
- Persistence: MongoDB (with Mongoose models) + local file storage for images (via multer).

##### File Structure
- Top-level split:
- `/client` → React app (components, pages, services).
- `/backend` → Express.js API (controllers, models, routes, config, middlewares).
- Key backend files:
- `backend/server.js` – entry point, sets up Express, CORS, cookie parsing, routes.
- `backend/config/Storage.js` – multer config for file uploads.
- `controllers/*_controller.js` – business logic for auth, posts, articles, home.
- `models/*_model.js` – Mongoose schemas for users and posts.
- `routes/*_routes.js` – route definitions (mount controllers).
- `middlewares/checkAuth.js` – JWT authentication guard.
- Key frontend files:
- `client/src/index.js` – React root.
- `client/src/components` & `client/src/pages` – UI components and page layouts.
- `client/src/services/*.js` – modules to call backend API endpoints.

##### Extract Insights from README
- Uses JWT + bcrypt for auth, CORS and cookies for sessions.
- Image uploads handled with multer.
- Two separate npm processes: `npm start` on client (port 3000) and backend (port 5000).

##### Main Components & Their Interactions
a. Frontend (React SPA)
- Hosts UI pages (Home, Article, Create, Login, MyBlog, Update, Error).
- Calls backend via `fetch`/`axios` in `services/*.js`.
b. Backend API (Express)
- Exposes endpoints: `/auth/*`, `/article/*`, `/post/*`, `/home/*`.
- Middlewares: CORS, cookie-parser, body-parsing, JWT auth.
c. Business Logic
- Controllers receive HTTP requests, perform validation, talk to models.
d. Data Layer
- Mongoose models connect to MongoDB.
- Local image storage (imguploads folder) via multer Storage.js.
e. External Services & Libraries
- MongoDB database.
- bcrypt (password hashing), jsonwebtoken (JWT), multer (file upload), cors, cookie-parser.

##### Architectural Patterns & Principles
- Clear separation of concerns:
- Presentation (React) vs API layer (Express) vs Data (MongoDB).
- MVC-like pattern in backend: Controllers → Models → Views (HTTP responses).
- Use of middleware pipeline for cross-cutting concerns (auth, parsing).
- RESTful resource naming in routes.

##### Essential Elements
- Component labels: React UI, HTTP Client, Express Router, Controllers, Models, MongoDB, Image Store.
- Blue: Frontend
- Green: Backend core
- Orange: Data & Storage
- Notes on key libraries (Mongoose, bcrypt, multer).

- How the user interacts with the React front end.
- How that front end uses the services layer to communicate with the Express API.
- How Express routes requests through authentication and business logic to the data layer.
- Where images and user data reside.

This level of detail ensures all stakeholders can see the end-to-end flow and understand each component’s responsibilities. Happy diagramming!

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        UserBrowser["User Browser"]:::external
        ReactEntryIndex["React SPA Entry Point"]:::frontend
        ReactComponents["React UI Components"]:::frontend
        ReactPages["React Page Layouts"]:::frontend
        subgraph "HTTP Client Services"
            direction TB
            ArticleService["articleService.js"]:::frontend
            AuthService["authService.js"]:::frontend
            HomeService["homeService.js"]:::frontend
            MyBlogService["myblogService.js"]:::frontend
        end
    end

    %% Backend Layer
    subgraph "Backend / Express API" 
        direction TB
        ExpressServer["Express Server\n(server.js)"]:::backend
        subgraph "Routing Layer"
            direction TB
            AuthRoutes["auth_routes.js"]:::backend
            ArticleRoutes["article_routes.js"]:::backend
            PostRoutes["post_routes.js"]:::backend
            HomeRoutes["home_routes.js"]:::backend
        end
        AuthMiddleware["Authentication Middleware\n(checkAuth.js)"]:::backend
        subgraph "Controllers"
            direction TB
            AuthController["auth_controller.js"]:::backend
            ArticleController["article_controller.js"]:::backend
            PostController["post_controller.js"]:::backend
            HomeController["home_controller.js"]:::backend
        end
        StorageConfig["File Upload Storage\n(Storage.js)"]:::backend
        subgraph "Models"
            direction TB
            UserModel["user_model.js"]:::backend
            PostModel["post_model.js"]:::backend
        end
    end

    %% Data Layer
    subgraph "Data & Storage"
        direction TB
        MongoDB["MongoDB Database"]:::data
        FileStorage["Image File Storage\n(imguploads)"]:::data
    end

    %% Connections
    UserBrowser -->|"loads SPA"| ReactEntryIndex
    ReactEntryIndex --> ReactComponents
    ReactEntryIndex --> ReactPages
    ReactComponents --> ArticleService
    ReactComponents --> AuthService
    ReactPages --> HomeService
    ReactPages --> MyBlogService
    ArticleService -->|"API Calls"| ExpressServer
    AuthService --> ExpressServer
    HomeService --> ExpressServer
    MyBlogService --> ExpressServer

    ExpressServer -->|"mounts routes"| AuthRoutes
    ExpressServer --> ArticleRoutes
    ExpressServer --> PostRoutes
    ExpressServer --> HomeRoutes

    AuthRoutes --> AuthMiddleware
    ArticleRoutes --> AuthMiddleware
    PostRoutes --> AuthMiddleware
    HomeRoutes --> AuthMiddleware

    AuthMiddleware --> AuthController
    ArticleRoutes --> ArticleController
    PostRoutes --> PostController
    HomeRoutes --> HomeController

    AuthController --> UserModel
    ArticleController --> PostModel
    PostController --> PostModel
    HomeController --> PostModel

    ArticleController --> StorageConfig
    PostController --> StorageConfig

    UserModel --> MongoDB
    PostModel --> MongoDB

    StorageConfig --> FileStorage

    %% Click Events
    click ReactEntryIndex "https://github.com/elion74/tblogs/blob/main/client/src/index.js"
    click ReactComponents "https://github.com/elion74/tblogs/tree/main/client/src/components"
    click ReactPages "https://github.com/elion74/tblogs/tree/main/client/src/pages"
    click ArticleService "https://github.com/elion74/tblogs/blob/main/client/src/services/articleService.js"
    click AuthService "https://github.com/elion74/tblogs/blob/main/client/src/services/authService.js"
    click HomeService "https://github.com/elion74/tblogs/blob/main/client/src/services/homeService.js"
    click MyBlogService "https://github.com/elion74/tblogs/blob/main/client/src/services/myblogService.js"
    click ExpressServer "https://github.com/elion74/tblogs/blob/main/backend/server.js"
    click AuthRoutes "https://github.com/elion74/tblogs/blob/main/backend/routes/auth_routes.js"
    click ArticleRoutes "https://github.com/elion74/tblogs/blob/main/backend/routes/article_routes.js"
    click PostRoutes "https://github.com/elion74/tblogs/blob/main/backend/routes/post_routes.js"
    click HomeRoutes "https://github.com/elion74/tblogs/blob/main/backend/routes/home_routes.js"
    click AuthMiddleware "https://github.com/elion74/tblogs/blob/main/backend/middlewares/checkAuth.js"
    click StorageConfig "https://github.com/elion74/tblogs/blob/main/backend/config/Storage.js"
    click AuthController "https://github.com/elion74/tblogs/blob/main/backend/controllers/auth_controller.js"
    click ArticleController "https://github.com/elion74/tblogs/blob/main/backend/controllers/article_controller.js"
    click PostController "https://github.com/elion74/tblogs/blob/main/backend/controllers/post_controller.js"
    click HomeController "https://github.com/elion74/tblogs/blob/main/backend/controllers/home_controller.js"
    click UserModel "https://github.com/elion74/tblogs/blob/main/backend/models/user_model.js"
    click PostModel "https://github.com/elion74/tblogs/blob/main/backend/models/post_model.js"
    click FileStorage "https://github.com/elion74/tblogs/tree/main/backend/imguploads"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085
    classDef backend fill:#d4edda,stroke:#155724,color:#155724
    classDef data fill:#ffe5b4,stroke:#cc7a00,color:#cc7a00
    classDef external fill:#f8d7da,stroke:#721c24,color:#721c24
```
