# vanvanvan17/24ct2-tran-van-viet-cnpm architecture

> Architecture diagram of the GitHub repository vanvanvan17/24ct2-tran-van-viet-cnpm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vanvanvan17/24ct2-tran-van-viet-cnpm
- Repository: https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm

## Overview

VNLibrary is a Vietnamese library-management web application backed by MySQL. Its principal workflow is staff managing readers and books, recording loans and returns, and updating availability; related workflows cover reservations, purchases and payments, fines, reporting, and administration. The main page and API routes are present, but the sampled page does not show its API calls, so those links are not asserted. The graph shows verified database and authentication dependencies; unsampled capabilities are represented from the documented feature list and repository tree.

Main entry points: [`src/lib/auth.js`](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/lib/auth.js) (Session and audit logic), [`src/lib/db.js`](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/lib/db.js) (MySQL database), [`src/app/api/books`](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/books) (Books and categories), [`src/app/api/readers`](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/readers) (Reader management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Web interface"]
  node_home["Library workspace<br/>[page.jsx]"]
  node_sign_in["Sign in<br/>[page.jsx]"]
  node_sign_up["Registration<br/>[page.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Authentication routes"]
  node_auth_logic["Session and audit logic<br/>[auth.js]"]
end

subgraph group_catalog["Library operations"]
  node_books["Books and categories"]
  node_readers["Reader management"]
  node_borrows["Loans and returns"]
  node_inventory["Stock adjustment<br/>[route.js]"]
  node_reservations["Reservations"]
end

subgraph group_finance["Acquisition and finance"]
  node_purchases["Purchases and payments"]
  node_fines["Fines and payments"]
end

subgraph group_admin["Administration and insight"]
  node_dashboard["Dashboard<br/>[route.js]"]
  node_reports["Reports and export"]
  node_notifications["Notifications<br/>[route.js]"]
  node_users["Account management"]
  node_profile["Personal profile<br/>[route.js]"]
  node_settings["Library settings<br/>[route.js]"]
  node_audit["Audit log<br/>[route.js]"]
end

subgraph group_storage["Persistence"]
  node_database[("MySQL database<br/>[db.js]")]
end

node_staff(("Library staff"))

node_staff -->|"uses"| node_home
node_staff -->|"signs in"| node_sign_in
node_staff -->|"registers"| node_sign_up
node_auth_api -->|"uses"| node_auth_logic
node_auth_logic -->|"reads and writes"| node_database
node_books -->|"checks access"| node_auth_logic
node_books -->|"queries"| node_database
node_readers -->|"checks access"| node_auth_logic
node_readers -->|"queries"| node_database
node_borrows -->|"checks access"| node_auth_logic
node_borrows -->|"transacts"| node_database
node_inventory -->|"checks access"| node_auth_logic
node_inventory -->|"transacts"| node_database
node_reservations -->|"checks access"| node_auth_logic
node_purchases -->|"checks access"| node_auth_logic
node_purchases -->|"transacts"| node_database
node_dashboard -->|"checks access"| node_auth_logic
node_dashboard -->|"queries"| node_database
node_profile -->|"uses"| node_auth_logic
node_profile -->|"updates"| node_database
node_users -->|"checks access"| node_auth_logic
node_users -->|"queries"| node_database
node_audit -->|"uses"| node_auth_logic
node_audit -->|"queries"| node_database

click node_home "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/page.jsx"
click node_sign_in "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/login/page.jsx"
click node_sign_up "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/register/page.jsx"
click node_auth_api "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/auth"
click node_auth_logic "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/lib/auth.js"
click node_books "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/books"
click node_readers "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/readers"
click node_borrows "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/borrows"
click node_inventory "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/inventory/route.js"
click node_reservations "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/reservations"
click node_purchases "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/purchases"
click node_fines "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/fines"
click node_dashboard "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/dashboard/route.js"
click node_reports "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/reports"
click node_notifications "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/notifications/route.js"
click node_users "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/users"
click node_profile "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/profile/route.js"
click node_settings "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/settings/route.js"
click node_audit "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/audit/route.js"
click node_database "https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/lib/db.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_sign_in,node_sign_up toneBlue
class node_auth_api,node_auth_logic toneAmber
class node_books,node_readers,node_borrows,node_inventory,node_reservations toneMint
class node_purchases,node_fines toneRose
class node_dashboard,node_reports,node_notifications,node_users,node_profile,node_settings,node_audit,node_staff toneIndigo
class node_database toneTeal
```

## Components

### Web interface

- [Library workspace](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/page.jsx): `src/app/page.jsx`
- [Sign in](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/login/page.jsx): `src/app/login/page.jsx`
- [Registration](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/register/page.jsx): `src/app/register/page.jsx`

### Identity and access

- [Authentication routes](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/auth): `src/app/api/auth`
- [Session and audit logic](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/lib/auth.js): `src/lib/auth.js`

### Library operations

- [Books and categories](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/books): `src/app/api/books`
- [Reader management](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/readers): `src/app/api/readers`
- [Loans and returns](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/borrows): `src/app/api/borrows`
- [Stock adjustment](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/inventory/route.js): `src/app/api/inventory/route.js`
- [Reservations](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/reservations): `src/app/api/reservations`

### Acquisition and finance

- [Purchases and payments](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/purchases): `src/app/api/purchases`
- [Fines and payments](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/fines): `src/app/api/fines`

### Administration and insight

- [Dashboard](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/dashboard/route.js): `src/app/api/dashboard/route.js`
- [Reports and export](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/reports): `src/app/api/reports`
- [Notifications](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/notifications/route.js): `src/app/api/notifications/route.js`
- [Account management](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/tree/main/src/app/api/users): `src/app/api/users`
- [Personal profile](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/profile/route.js): `src/app/api/profile/route.js`
- [Library settings](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/settings/route.js): `src/app/api/settings/route.js`
- [Audit log](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/app/api/audit/route.js): `src/app/api/audit/route.js`

### Persistence

- [MySQL database](https://github.com/vanvanvan17/24ct2-tran-van-viet-cnpm/blob/main/src/lib/db.js): `src/lib/db.js`

### Other components

- **Library staff**

## Connections

- Library staff → Library workspace: uses (evidence: `README.md`)
- Library staff → Sign in: signs in (evidence: `README.md`)
- Library staff → Registration: registers (evidence: `README.md`)
- Authentication routes → Session and audit logic: uses (evidence: `src/app/api/auth/login/route.js`)
- Session and audit logic → MySQL database: reads and writes (evidence: `src/lib/auth.js`)
- Books and categories → Session and audit logic: checks access (evidence: `src/app/api/books/route.js`)
- Books and categories → MySQL database: queries (evidence: `src/app/api/books/route.js`)
- Reader management → Session and audit logic: checks access (evidence: `src/app/api/readers/route.js`)
- Reader management → MySQL database: queries (evidence: `src/app/api/readers/route.js`)
- Loans and returns → Session and audit logic: checks access (evidence: `src/app/api/borrows/route.js`)
- Loans and returns → MySQL database: transacts (evidence: `src/app/api/borrows/route.js`)
- Stock adjustment → Session and audit logic: checks access (evidence: `src/app/api/inventory/route.js`)
- Stock adjustment → MySQL database: transacts (evidence: `src/app/api/inventory/route.js`)
- Reservations → Session and audit logic: checks access (evidence: `src/app/api/reservations/route.js`)
- Purchases and payments → Session and audit logic: checks access (evidence: `src/app/api/purchases/route.js`)
- Purchases and payments → MySQL database: transacts (evidence: `src/app/api/purchases/route.js`)
- Dashboard → Session and audit logic: checks access (evidence: `src/app/api/dashboard/route.js`)
- Dashboard → MySQL database: queries (evidence: `src/app/api/dashboard/route.js`)
- Personal profile → Session and audit logic: uses (evidence: `src/app/api/profile/route.js`)
- Personal profile → MySQL database: updates (evidence: `src/app/api/profile/route.js`)
- Account management → Session and audit logic: checks access (evidence: `src/app/api/users/route.js`)
- Account management → MySQL database: queries (evidence: `src/app/api/users/route.js`)
- Audit log → Session and audit logic: uses (evidence: `src/app/api/audit/route.js`)
- Audit log → MySQL database: queries (evidence: `src/app/api/audit/route.js`)
