# kscold/kscold-blog architecture

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

- Interactive diagram: https://gitdiagram.com/kscold/kscold-blog
- Repository: https://github.com/kscold/kscold-blog

## Overview

##### Project type and purpose
- This is a full-stack side-project: a personal technical blog and real-time chat system.
- Frontend: React SPA with Redux state management, React Router v6.4, SCSS styling, Axios for API calls, socket.io-client for real-time.
- Backend: Node.js + Express REST API, Sequelize-MySQL for relational data, Mongoose-MongoDB for chat data, Passport + JWT for authentication, Socket.io for real-time chat, file uploads stored locally (future S3).

##### File structure
- Top-level separation:
- FE_React/: React application (public/, src/ with api/, components/, hooks/, layout/, page/, redux/, router/, scss/, setupProxy.js).
- BE_Node(Express)/: Express app (app.js, config/, controllers/, services/, models/, schemas/, routes/, passport/, middlewares/, uploads/).
- Patterns:
- FE: component-based + duck-pattern Redux + structured pages.
- BE: MVC-style (controllers → services → models), Passport strategies, Socket.io server in app.js.

##### README for additional insights
- Real-time chat feature using Socket.io.
- Rich text editor via React-Quill + Markdown.
- Tree-structure sidebar for coding categories (recursive React component).
- File upload via multipart/form-data API.
- JWT authentication stored in cookies, role-based UI (admin vs user).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (Client)"
        ReactSPA["React SPA"]:::client
        subgraph "Redux Store"
            ReduxIndex["index.js"]:::client
            ReduxUser["user.js"]:::client
            ReduxCoding["coding.js"]:::client
        end
        subgraph "React Router"
            RouterIndex["index.js"]:::client
            RouterCoding["codingRouter.js"]:::client
        end
        APIClient["API Client (Axios)"]:::client
        SCSS["SCSS Styling (scss/)"]:::client
        Components["React Components (components/)"]:::client
        Hooks["Custom Hooks"]:::client
        Proxy["Setup Proxy"]:::client
    end

    %% Backend Layer
    subgraph "Backend (Server)"
        ExpressApp["app.js"]:::server
        subgraph "Routes"
            UserRoute["user.js"]:::server
            CodingRoute["codingPage.js"]:::server
            ChatRoute["chat.js"]:::server
        end
        subgraph "Controllers"
            UserController["userController.js"]:::server
            CodingController["condingPageController.js"]:::server
            ChatController["chatController.js"]:::server
        end
        subgraph "Services"
            UserService["userService.js"]:::server
            CodingService["codingPageService.js"]:::server
        end
        subgraph "Sequelize Models (MySQL)"
            UserModel["user.js"]:::database
            CodingPost["codingPost.js"]:::database
            SidebarModel["codingPostSidebar.js"]:::database
            Hashtag["hashtag.js"]:::database
            SQLIndex["index.js"]:::database
        end
        subgraph "Mongoose Schemas (MongoDB)"
            MongoIndex["index.js"]:::database
            MongoUser["user.js"]:::database
            ChatSchema["chat.js"]:::database
        end
        subgraph "Auth Module"
            LocalStrategy["localStrategy.js"]:::server
            PassportIndex["index.js"]:::server
        end
        Middleware["middlewares/index.js"]:::server
        Config["config/config.json"]:::server
    end

    %% Data Layer
    subgraph "Data & Storage"
        MySQLDB["MySQL (Sequelize)"]:::db
        MongoDB["MongoDB (Mongoose)"]:::db
        FileStorage["File Storage (uploads/)"]:::storage
    end

    %% Relationships
    ReactSPA -->|"HTTP /auth, /coding, /upload"| ExpressApp
    ReactSPA -->|"WebSocket chat:message"| ExpressApp
    APIClient -->|"REST calls"| ExpressApp
    ReactSPA -->|uses| ReduxIndex
    ReactSPA -->|routes| RouterIndex
    ExpressApp -->|uses| UserRoute
    ExpressApp -->|uses| CodingRoute
    ExpressApp -->|uses| ChatRoute
    UserRoute -->|calls| UserController
    CodingRoute -->|calls| CodingController
    ChatRoute -->|calls| ChatController
    UserController -->|business logic| UserService
    CodingController -->|business logic| CodingService
    ExpressApp -->|auth| LocalStrategy
    ExpressApp -->|middleware| Middleware
    ExpressApp -->|config| Config
    UserService -->|Sequelize| UserModel
    CodingService -->|Sequelize| CodingPost
    CodingService -->|Sequelize| SidebarModel
    CodingService -->|Sequelize| Hashtag
    ExpressApp -->|connect| MySQLDB
    ExpressApp -->|connect| MongoDB
    ExpressApp -->|store files| FileStorage
    ExpressApp -->|socket.io| ReactSPA

    %% Database connections
    MySQLDB --> SQLIndex
    MongoDB --> MongoIndex

    %% Click Events
    click ReactSPA "https://github.com/kscold/kscold-blog/tree/main/FE_React/"
    click ReduxIndex "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/redux/index.js"
    click ReduxUser "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/redux/user.js"
    click ReduxCoding "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/redux/coding.js"
    click RouterIndex "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/router/index.js"
    click RouterCoding "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/router/codingRouter.js"
    click APIClient "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/api/index.js"
    click SCSS "https://github.com/kscold/kscold-blog/tree/main/FE_React/src/scss/"
    click Components "https://github.com/kscold/kscold-blog/tree/main/FE_React/src/components/"
    click Hooks "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/hooks/useCheckToken.jsx"
    click Proxy "https://github.com/kscold/kscold-blog/blob/main/FE_React/src/setupProxy.js"
    click ExpressApp "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/app.js"
    click UserRoute "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/routes/user.js"
    click CodingRoute "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/routes/codingPage.js"
    click ChatRoute "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/routes/chat.js"
    click UserController "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/controllers/userController.js"
    click CodingController "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/controllers/condingPageController.js"
    click ChatController "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/controllers/chatController.js"
    click UserService "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/services/userService.js"
    click CodingService "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/services/codingPageService.js"
    click UserModel "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/models/user.js"
    click CodingPost "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/models/codingPost.js"
    click SidebarModel "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/models/codingPostSidebar.js"
    click Hashtag "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/models/hashtag.js"
    click SQLIndex "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/models/index.js"
    click MongoIndex "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/schemas/index.js"
    click MongoUser "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/schemas/user.js"
    click ChatSchema "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/schemas/chat.js"
    click LocalStrategy "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/passport/localStrategy.js"
    click PassportIndex "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/passport/index.js"
    click Middleware "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/middlewares/index.js"
    click Config "https://github.com/kscold/kscold-blog/blob/main/BE_Node(Express)/config/config.json"

    %% Styles
    classDef client fill:#e8f5e9,stroke:#2e7d32,stroke-width:1px
    classDef server fill:#e3f2fd,stroke:#1565c0,stroke-width:1px
    classDef database fill:#fff3e0,stroke:#ef6c00,stroke-width:1px
    classDef db fill:#ffe0b2,stroke:#e65100,stroke-width:1px
    classDef storage fill:#eceff1,stroke:#607d8b,stroke-width:1px
```
