# abelmruso/p6_mon_vieux_grimoire architecture

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

- Interactive diagram: https://gitdiagram.com/abelmruso/p6_mon_vieux_grimoire
- Repository: https://github.com/abelmruso/p6_mon_vieux_grimoire

## Overview

##### Project type and purpose
- From the file tree and README, “Mon vieux Grimoire” is a full-stack web application for managing books and user accounts.
- Frontend: a React single-page app (in /src, public/, manifest.json).
- Backend: a Node.js/Express REST API (in /backend) with controllers, models, routes, middleware, and a MongoDB connection (config/db.js).

##### Relationships & data flows
- Browser → (HTTP/HTTPS) → React App (served from backend or static host)
- React App → (REST calls via fetch/axios) → Express API endpoints
- Express API → (Mongoose queries) → MongoDB
- File upload path: React form → POST /api/books/upload (Express multer middleware) → local storage or cloud
- Auth flow: SignIn page → POST /api/users/login → JWT token → stored in client → included in Authorization header on protected routes

##### Architectural patterns & tech
- Frontend: Component-based SPA, React Router, custom hooks (src/lib), global CSS modules
- Backend: MVCish structure (models/controllers/routes), middleware pipeline (auth, CORS, rate limiting), environment config
- Database: MongoDB via Mongoose (assumed from models naming and db.js)
- Build & deployment: Dockerfile at root, babel-plugin macros

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    Client(("Client / Browser")):::client

    %% Frontend Layer
    subgraph "Frontend (React SPA)"
        direction TB
        Index["src/index.js"]:::frontend
        App["src/App.jsx"]:::frontend
        subgraph "Pages"
            direction TB
            Home["Home.jsx"]:::frontend
            SignIn["SignIn.jsx"]:::frontend
            AddBook["AddBook.jsx"]:::frontend
            BookInfo["Book.jsx"]:::frontend
            UpdateBook["UpdateBook.jsx"]:::frontend
        end
        subgraph "Components"
            direction TB
            BestRated["BestRatedBooks.jsx"]:::frontend
            BookForm["BookForm.jsx"]:::frontend
            BookItem["BookItem.jsx"]:::frontend
            BookRating["BookRatingForm.jsx"]:::frontend
            Header["Header.jsx"]:::frontend
            Footer["Footer.jsx"]:::frontend
            BackArrow["BackArrow.jsx"]:::frontend
            Scroll["ScrollToTop.jsx"]:::frontend
        end
        subgraph "Lib & Utils"
            direction TB
            Common["src/lib/common.js"]:::frontend
            Hooks["src/lib/customHooks.js"]:::frontend
            Functions["src/lib/functions.jsx"]:::frontend
            Constants["src/utils/constants.js"]:::frontend
        end
        subgraph "Static Assets"
            direction TB
            HTML["public/index.html"]:::assets
            Manifest["public/manifest.json"]:::assets
            DataJSON["public/data/data.json"]:::assets
            Robots["public/robots.txt"]:::assets
            Images["src/images/"]:::assets
        end
    end

    %% Backend Layer
    subgraph "Backend (Express API)"
        direction TB
        Server["backend/server.js"]:::backend
        AppJS["backend/app.js"]:::backend
        ConfigDB["backend/config/db.js"]:::backend
        subgraph "Models"
            direction TB
            BookModel["backend/models/Book.js"]:::backend
            UserModel["backend/models/User.js"]:::backend
        end
        subgraph "Controllers"
            direction TB
            BookCtrl["backend/controllers/book.controller.js"]:::backend
            UserCtrl["backend/controllers/user.controller.js"]:::backend
        end
        subgraph "Routes"
            direction TB
            BookRoutes["backend/routes/book.routes.js"]:::backend
            UserRoutes["backend/routes/user.routes.js"]:::backend
        end
        subgraph "Middleware"
            direction TB
            Auth["backend/middleware/auth.js"]:::backend
            CORS["backend/middleware/cors.js"]:::backend
            Limiter["backend/middleware/limiter.js"]:::backend
            Multer["backend/middleware/multer.config.js"]:::backend
        end
        ImagesStore["backend/images/"]:::backend
    end

    %% Database
    MongoDB[(MongoDB)]:::database

    %% Connections
    Client -->|"loads SPA"| Index
    Index -->|"renders"| App
    App -->|"routes to pages"| Home
    App --> SignIn
    App --> AddBook
    App --> BookInfo
    App --> UpdateBook
    Home --> BestRated
    AddBook --> BookForm
    BookInfo --> BookItem
    BookInfo --> BookRating
    App --> Common
    App --> Hooks
    App --> Functions
    App --> Constants
    App --> HTML
    App --> Manifest
    App --> DataJSON
    App --> Robots
    App --> Images
    App -->|"API requests (REST)"| AppJS
    AppJS -->|"uses routes"| BookRoutes
    AppJS --> UserRoutes
    BookRoutes --> BookCtrl
    UserRoutes --> UserCtrl
    BookCtrl --> BookModel
    UserCtrl --> UserModel
    AppJS --> ConfigDB
    ConfigDB --> MongoDB
    AppJS --> Auth
    AppJS --> CORS
    AppJS --> Limiter
    AppJS --> Multer
    AppJS --> ImagesStore
    MongoDB -->|"<queries>"|BookModel
    MongoDB --> UserModel

    %% Click Events
    click Index "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/index.js"
    click App "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/App.jsx"
    click Home "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/pages/Home/Home.jsx"
    click SignIn "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/pages/SignIn/SignIn.jsx"
    click AddBook "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/pages/AddBook/AddBook.jsx"
    click BookInfo "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/pages/Book/Book.jsx"
    click UpdateBook "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/pages/updateBook/UpdateBook.jsx"
    click BestRated "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/Books/BestRatedBooks/BestRatedBooks.jsx"
    click BookForm "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/Books/BookForm/BookForm.jsx"
    click BookItem "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/Books/BookItem/BookItem.jsx"
    click BookRating "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/Books/BookRatingForm/BookRatingForm.jsx"
    click Header "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/Header/Header.jsx"
    click Footer "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/Footer/Footer.jsx"
    click BackArrow "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/BackArrow/BackArrow.jsx"
    click Scroll "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/components/ScrollToTop/ScrollToTop.jsx"
    click Common "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/lib/common.js"
    click Hooks "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/lib/customHooks.js"
    click Functions "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/lib/functions.jsx"
    click Constants "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/src/utils/constants.js"
    click HTML "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/public/index.html"
    click Manifest "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/public/manifest.json"
    click DataJSON "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/public/data/data.json"
    click Robots "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/public/robots.txt"
    click Images "https://github.com/abelmruso/p6_mon_vieux_grimoire/tree/main/src/images/"
    click Server "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/server.js"
    click AppJS "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/app.js"
    click ConfigDB "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/config/db.js"
    click BookModel "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/models/Book.js"
    click UserModel "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/models/User.js"
    click BookCtrl "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/controllers/book.controller.js"
    click UserCtrl "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/controllers/user.controller.js"
    click BookRoutes "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/routes/book.routes.js"
    click UserRoutes "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/routes/user.routes.js"
    click Auth "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/middleware/auth.js"
    click CORS "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/middleware/cors.js"
    click Limiter "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/middleware/limiter.js"
    click Multer "https://github.com/abelmruso/p6_mon_vieux_grimoire/blob/main/backend/middleware/multer.config.js"
    click ImagesStore "https://github.com/abelmruso/p6_mon_vieux_grimoire/tree/main/backend/images/"

    %% Styles
    classDef client fill:#FFD700,stroke:#333,stroke-width:1px;
    classDef frontend fill:#8FBC8F,stroke:#333,stroke-width:1px;
    classDef backend fill:#87CEFA,stroke:#333,stroke-width:1px;
    classDef database fill:#FFA07A,stroke:#333,stroke-width:1px;
    classDef assets fill:#EEE8AA,stroke:#333,stroke-width:1px;
```
