# vignesh-d-2003/e-books-project architecture

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

- Interactive diagram: https://gitdiagram.com/vignesh-d-2003/e-books-project
- Repository: https://github.com/vignesh-d-2003/e-books-project

## Overview

##### Project type and purpose
- This is a full-stack e-Library application. The frontend is built with Next.js (in the top-level `src/app` directory), providing server-side-rendered pages and client-side components for user authentication, book browsing, and an admin dashboard.
- The backend is a Spring Boot service (in the `E-Library/` folder) exposing REST endpoints for user, book, category, and file operations, using JWT for authentication and Supabase as the external database and file-storage provider.

##### File structure
- Top level:
- Next.js app under `src/app`, `src/components`, `src/context`, `src/services`
- Spring Boot app under `E-Library/src/main/java/com/example/E_Library`
- Build/config files: `package.json`, `next.config.mjs`, `pom.xml`, `.env`, `.mvn`, etc.
- Patterns:
- Frontend follows the Next.js App Router (page.js files for routes) and a context-/service-based API layer (`AuthContext.js`, `bookService.js`, etc.).
- Backend uses MVC: controllers → services → utilities, with cross-cutting concerns handled by aspects and filters (LoggingAspect, MdcFilter, JwtRequestFilter).
- Deployment/config: environment variables in `.env`, CORS and security in `configuration/`, logging via `logback-spring.xml`.

##### README for additional insights
- Bootstrapped with Create Next App for the front end, deployed on Vercel by default.
- No explicit architectural docs in the README, so infer from file layout and naming conventions.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User
    User(("User")) 

    %% Frontend Layer
    subgraph "Frontend"
        direction TB
        UI["Next.js UI"]:::frontend
        Context["AuthContext"]:::frontend
        UtilsFE["Utils"]:::frontend
        subgraph "API Layer"
            direction TB
            API["api.js"]:::frontend
            AuthSvc["authService.js"]:::frontend
            BookSvc["bookService.js"]:::frontend
            CatSvc["categoryService.js"]:::frontend
        end
    end

    %% HTTP Boundary
    UI -->|"uses Context"| Context
    UI -->|"renders pages"| UtilsFE
    UI -->|"calls"| API
    Context --> API
    UtilsFE --> API
    API --> AuthSvc
    API --> BookSvc
    API --> CatSvc
    AuthSvc -->|"/api/login"| BE[("Spring Boot API")]:::backend
    BookSvc -->|"/api/books"| BE
    CatSvc -->|"/api/categories"| BE

    %% Backend Layer
    subgraph "Backend"
        direction TB
        subgraph "Filters & Security"
            direction TB
            CORS["GlobalCorsFilter"]:::filter
            JwtReq["JwtRequestFilter"]:::filter
            Entry["JwtAuthenticationEntryPoint"]:::filter
            MDC["MdcFilter"]:::filter
            Trace["TraceIdFilter"]:::filter
        end
        subgraph "Controllers"
            direction TB
            UserCtrl["UserController"]:::backend
            BookCtrl["BookController"]:::backend
            CatCtrl["CategoryController"]:::backend
            FileCtrl["FileController"]:::backend
        end
        subgraph "Services"
            direction TB
            UserSvc["UserService"]:::backend
            JwtSvc["JwtService"]:::backend
            SupaSvc["SupabaseService"]:::backend
        end
        subgraph "Utilities"
            direction TB
            JwtUtil["JwtUtil"]:::backend
        end
        subgraph "Aspects"
            direction TB
            LogAsp["LoggingAspect"]:::aspect
        end
    end

    %% Backend Connections
    BE --> CORS
    CORS --> JwtReq
    JwtReq --> Entry
    Entry --> MDC
    MDC --> Trace
    Trace --> UserCtrl
    Trace --> BookCtrl
    Trace --> CatCtrl
    Trace --> FileCtrl

    UserCtrl --> UserSvc
    BookCtrl --> SupaSvc
    CatCtrl --> SupaSvc
    FileCtrl --> SupaSvc
    UserSvc --> JwtSvc
    JwtSvc --> JwtUtil
    SupaSvc -->|"CRUD & File"| DB[(Supabase DB)]:::external
    SupaSvc -->|"Storage"| Bucket[(Supabase Storage)]:::external
    LogAsp -.-> UserCtrl
    LogAsp -.-> BookCtrl
    LogAsp -.-> CatCtrl
    LogAsp -.-> FileCtrl
    LogAsp -.-> UserSvc

    %% User Interaction Flow
    User --> UI

    %% Click Events
    click UI "https://github.com/vignesh-d-2003/e-books-project/tree/main/src/app"
    click Context "https://github.com/vignesh-d-2003/e-books-project/blob/main/src/context/AuthContext.js"
    click UtilsFE "https://github.com/vignesh-d-2003/e-books-project/blob/main/src/lib/utils.js"
    click API "https://github.com/vignesh-d-2003/e-books-project/blob/main/src/services/api.js"
    click AuthSvc "https://github.com/vignesh-d-2003/e-books-project/blob/main/src/services/authService.js"
    click BookSvc "https://github.com/vignesh-d-2003/e-books-project/blob/main/src/services/bookService.js"
    click CatSvc "https://github.com/vignesh-d-2003/e-books-project/blob/main/src/services/categoryService.js"
    click BE "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/ELibraryApplication.java"
    click UserCtrl "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/controller/UserController.java"
    click BookCtrl "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/controller/BookController.java"
    click CatCtrl "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/controller/CategoryController.java"
    click FileCtrl "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/controller/FileController.java"
    click UserSvc "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/service/UserService.java"
    click JwtSvc "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/service/JwtService.java"
    click SupaSvc "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/service/SupabaseService.java"
    click JwtUtil "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/utils/JwtUtil.java"
    click JwtReq "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/configuration/JwtRequestFilter.java"
    click Entry "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/configuration/JwtAuthenticationEntryPoint.java"
    click MDC "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/configuration/MdcFilter.java"
    click Trace "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/configuration/TraceIdFilter.java"
    click CORS "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/configuration/GlobalCorsFilter.java"
    click LogAsp "https://github.com/vignesh-d-2003/e-books-project/blob/main/E-Library/src/main/java/com/example/E_Library/aspect/LoggingAspect.java"

    %% Styles
    classDef frontend fill:#BBDEFB,stroke:#1E88E5,color:#0D47A1
    classDef backend fill:#C8E6C9,stroke:#388E3C,color:#1B5E20
    classDef external fill:#FFE0B2,stroke:#FB8C00,color:#E65100
    classDef filter fill:#FFCDD2,stroke:#E53935,color:#B71C1C
    classDef aspect fill:#D1C4E9,stroke:#8E24AA,color:#4A148C
```
