# pooja045n/library_management- architecture

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

- Interactive diagram: https://gitdiagram.com/pooja045n/library_management-
- Repository: https://github.com/pooja045n/library_management-

## Overview

##### Project type and purpose
- This is a full-stack MERN (MongoDB, Express, React, Node.js) application named “Library_Management.”
- Purpose: Provide a web interface for students, librarians, and administrators to manage books, requests, user roles, and activity logs in a library.

##### File structure
Top level:
- library-management-frontend → React SPA (UI)
- library-management-backend  → Express REST API (server)
library-management-backend:
- config/db.js → database connection (MongoDB)
- controllers/*.js → request handlers (Auth, Activity, Book management)
- routes/*.js → route definitions by role (admin.js, librarian.js, student.js, auth.js, user.js)
- middleware/*.js → auth (JWT validation), rolecheck (RBAC)
- models/*.js → Mongoose schemas (User, Book, BookRequest, ActivityLog, etc.)
- utils/logActivity.js → central logging of user actions
- mailsent.js → email notifications (e.g., on password reset or request approval)
- seed/*.js → initial data loaders (books.js, users.js)
- index.js → application entrypoint, wires up middleware, routes, server launch
library-management-frontend:
- public/ → static HTML shell, manifest, robots.txt
- src/
– App.js, index.js → root React components, router setup
– components/ → shared UI (StudentNavbar)
– pages/ → page views by user role (auth, home, dashboards, profile, admin panels, librarian panels)
– utils/auth.js → token storage, auth helper functions
– CSS files per component/page

##### Key insights from README
- “I have creating this project using MERN stack”

1. Begin by sketching the browser/UI layer with React router and pages grouped by role.
a. Middleware sub-layer (JWT validation, rolecheck)
b. Controllers layer (authController, adminController, librarianController, studentController)
c. Models layer (User, Book, BookRequest, ActivityLog)
d. Utilities (logActivity, mailsent)
5. Optionally, show seed scripts running at startup from index.js to MongoDB.
6. Lines:
– “HTTP POST /auth/login → authController.login → returns JWT”
– “HTTP GET /librarian/requests → librarianController.getRequests → BookRequest.find()”
– “logActivity.log() → writes to ActivityLog collection”
– “mailsent.sendEmail() → SMTP provider”

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend (Browser)"
        direction TB
        F1["React SPA (Browser)"]:::frontend

        subgraph "Public & Entry"
            direction TB
            P["public/"]:::frontend
            F2["index.js"]:::frontend
            F3["App.js"]:::frontend
        end

        subgraph "Components & Utils"
            direction TB
            C1["StudentNavbar.js"]:::frontend
            C2["auth.js"]:::frontend
        end

        subgraph "Pages"
            direction TB
            subgraph "Student Pages"
                direction TB
                SP1["StudentDashboard.js"]:::frontend
                SP2["RequestBook.js"]:::frontend
                SP3["StudentProfile.js"]:::frontend
                SP4["MyLibrary.jsx"]:::frontend
            end
            subgraph "Librarian Pages"
                direction TB
                LP1["AllocateRequests.js"]:::frontend
                LP2["ManageBooks.js"]:::frontend
                LP3["StudentList.js"]:::frontend
            end
            subgraph "Admin Pages"
                direction TB
                AP1["AdminDashboard.jsx"]:::frontend
                AP2["AddUser.js"]:::frontend
                AP3["ViewUsers.js"]:::frontend
                AP4["ActivityLog.js"]:::frontend
                AP5["ViewStats.js"]:::frontend
            end
            subgraph "Auth Pages"
                direction TB
                AU1["Register.js"]:::frontend
                AU2["ChangePassword.js"]:::frontend
                AU3["Home.js"]:::frontend
            end
        end
    end

    subgraph "Backend (API Layer)"
        direction TB
        B1["index.js"]:::backend

        subgraph "Middleware"
            direction TB
            M1["auth.js"]:::middleware
            M2["rolecheck.js"]:::middleware
        end

        subgraph "Routes"
            direction TB
            R1["auth.js"]:::backend
            R2["user.js"]:::backend
            R3["student.js"]:::backend
            R4["librarian.js"]:::backend
            R5["admin.js"]:::backend
        end

        subgraph "Controllers"
            direction TB
            Ctrl1["authController.js"]:::controller
        end

        subgraph "Models"
            direction TB
            MD1["User.js"]:::model
            MD2["Book.js"]:::model
            MD3["BookRequest.js"]:::model
            MD4["Activity.js"]:::model
            MD5["ActivityLog.js"]:::model
        end

        subgraph "Utilities & Seeds"
            direction TB
            U1["logActivity.js"]:::util
            U2["mailsent.js"]:::util
            subgraph "Seeds"
                direction TB
                S1["users.js"]:::backend
                S2["books.js"]:::backend
            end
        end
    end

    Cyl["MongoDB"]:::infra
    Email["Email Service"]:::infra

    F1 -->|"HTTP Requests"| B1
    B1 --> M1
    M1 --> M2
    B1 --> R1
    B1 --> R2
    B1 --> R3
    B1 --> R4
    B1 --> R5
    R1 --> Ctrl1
    R2 --> Ctrl1
    R3 --> Ctrl1
    R4 --> Ctrl1
    R5 --> Ctrl1
    Ctrl1 -->|"read/write"| Cyl
    Ctrl1 -->|"logs activities"| U1
    Ctrl1 -->|"sends emails"| U2
    U2 --> Email
    B1 -->|"startup seeds"| S1
    B1 -->|"startup seeds"| S2
    S1 --> Cyl
    S2 --> Cyl

    classDef frontend fill:#ddeeff,stroke:#3399ff,color:#000
    classDef backend fill:#ddffdd,stroke:#33aa33,color:#000
    classDef middleware fill:#fff2cc,stroke:#f1c232,color:#000
    classDef controller fill:#f4cccc,stroke:#cc0000,color:#000
    classDef model fill:#ead1dc,stroke:#a64d79,color:#000
    classDef util fill:#e7e6e6,stroke:#8c8c8c,color:#000
    classDef infra fill:#ffe599,stroke:#bf9000,color:#000

    click P "https://github.com/pooja045n/library_management-/tree/main/library-management-frontend/public"
    click F2 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/index.js"
    click F3 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/App.js"
    click C1 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/components/StudentNavbar.js"
    click C2 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/utils/auth.js"
    click SP1 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/StudentDashboard.js"
    click SP2 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/RequestBook.js"
    click SP3 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/StudentProfile.js"
    click SP4 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/MyLibrary.jsx"
    click LP1 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/librarian/AllocateRequests.js"
    click LP2 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/librarian/ManageBooks.js"
    click LP3 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/librarian/StudentList.js"
    click AP1 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/admin/AdminDashboard.jsx"
    click AP2 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/admin/AddUser.js"
    click AP3 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/admin/ViewUsers.js"
    click AP4 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/admin/ActivityLog.js"
    click AP5 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/admin/ViewStats.js"
    click AU1 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/Register.js"
    click AU2 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/ChangePassword.js"
    click AU3 "https://github.com/pooja045n/library_management-/blob/main/library-management-frontend/src/pages/Home.js"
    click B1 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/index.js"
    click Ctrl1 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/controllers/authController.js"
    click R1 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/routes/auth.js"
    click R2 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/routes/user.js"
    click R3 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/routes/student.js"
    click R4 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/routes/librarian.js"
    click R5 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/routes/admin.js"
    click M1 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/middleware/auth.js"
    click M2 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/middleware/rolecheck.js"
    click MD1 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/models/User.js"
    click MD2 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/models/Book.js"
    click MD3 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/models/BookRequest.js"
    click MD4 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/models/Activity.js"
    click MD5 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/models/ActivityLog.js"
    click U1 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/utils/logActivity.js"
    click U2 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/mailsent.js"
    click S1 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/seed/users.js"
    click S2 "https://github.com/pooja045n/library_management-/blob/main/library-management-backend/seed/books.js"
```
