# trinhkimloan/htttql_thuvien architecture

> Architecture diagram of the GitHub repository trinhkimloan/htttql_thuvien, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/trinhkimloan/htttql_thuvien
- Repository: https://github.com/trinhkimloan/htttql_thuvien

## Overview

This is a library-management web application for readers, librarians, and managers. Users interact with the React interface, whose API client sends authenticated requests to an Express service; that service applies authentication and role checks, runs library workflows, and persists results in MySQL. The domain includes catalog and reader administration, circulation, reservations, fines, reports, reader accounts, and notifications. Backend routes are concentrated in one large file, so several workflow nodes share its path. The README is empty; feature coverage follows the sampled UI and route excerpts, and the client-to-server link is unverified in the excerpts.

Main entry points: [`backend/src/index.js`](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js) (HTTP routes), [`backend/src/db.js`](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/db.js) (Database access), [`frontend/src/App.jsx`](https://github.com/trinhkimloan/htttql_thuvien/blob/main/frontend/src/App.jsx) (Library interface), [`frontend/src/api.js`](https://github.com/trinhkimloan/htttql_thuvien/blob/main/frontend/src/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Library interface<br/>[App.jsx]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_service["API service"]
  node_entry["HTTP routes<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_helpers["Domain helpers<br/>[helpers.js]"]
end

subgraph group_domain["Library workflows"]
  node_catalog["Catalog management<br/>[index.js]"]
  node_readers["Reader management<br/>[index.js]"]
  node_circulation["Loans and returns<br/>[index.js]"]
  node_reservations["Reservations<br/>[index.js]"]
  node_fines["Fines<br/>[index.js]"]
  node_reports["Reports<br/>[index.js]"]
  node_notifications["Notifications<br/>[index.js]"]
  node_profile["Reader profile<br/>[index.js]"]
end

subgraph group_state["Persistence"]
  node_db["Database access<br/>[db.js]"]
  node_mysql[("MySQL database")]
end

node_reader(("Library user"))

node_reader -->|"uses"| node_app
node_app -->|"calls"| node_api
node_api -.->|"sends requests"| node_entry
node_entry -->|"checks access"| node_auth
node_entry -->|"uses"| node_helpers
node_entry -->|"routes catalog"| node_catalog
node_entry -->|"routes readers"| node_readers
node_entry -->|"routes loans"| node_circulation
node_entry -->|"routes reservations"| node_reservations
node_entry -->|"routes fines"| node_fines
node_entry -->|"routes reports"| node_reports
node_entry -->|"routes notices"| node_notifications
node_entry -->|"routes profile"| node_profile
node_auth -->|"reads accounts"| node_db
node_entry -->|"queries data"| node_db
node_db -->|"connects"| node_mysql

click node_app "https://github.com/trinhkimloan/htttql_thuvien/blob/main/frontend/src/App.jsx"
click node_api "https://github.com/trinhkimloan/htttql_thuvien/blob/main/frontend/src/api.js"
click node_entry "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_auth "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/auth.js"
click node_helpers "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/helpers.js"
click node_catalog "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_readers "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_circulation "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_reservations "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_fines "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_reports "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_notifications "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_profile "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js"
click node_db "https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/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_app,node_api,node_reader toneBlue
class node_entry,node_auth,node_helpers toneAmber
class node_catalog,node_readers,node_circulation,node_reservations,node_fines,node_reports,node_notifications,node_profile toneMint
class node_db,node_mysql toneRose
```

## Components

### Web client

- [Library interface](https://github.com/trinhkimloan/htttql_thuvien/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API client](https://github.com/trinhkimloan/htttql_thuvien/blob/main/frontend/src/api.js): `frontend/src/api.js`

### API service

- [HTTP routes](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Authentication](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/auth.js): `backend/src/auth.js`
- [Domain helpers](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/helpers.js): `backend/src/helpers.js`

### Library workflows

- [Catalog management](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Reader management](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Loans and returns](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Reservations](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Fines](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Reports](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Notifications](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`
- [Reader profile](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/index.js): `backend/src/index.js`

### Persistence

- [Database access](https://github.com/trinhkimloan/htttql_thuvien/blob/main/backend/src/db.js): `backend/src/db.js`
- **MySQL database**

### Other components

- **Library user**

## Connections

- Library user → Library interface: uses
- Library interface → API client: calls (evidence: `frontend/src/App.jsx`)
- API client → HTTP routes: sends requests
- HTTP routes → Authentication: checks access (evidence: `backend/src/index.js`)
- HTTP routes → Domain helpers: uses (evidence: `backend/src/index.js`)
- HTTP routes → Catalog management: routes catalog (evidence: `backend/src/index.js`)
- HTTP routes → Reader management: routes readers (evidence: `backend/src/index.js`)
- HTTP routes → Loans and returns: routes loans (evidence: `backend/src/index.js`)
- HTTP routes → Reservations: routes reservations (evidence: `backend/src/index.js`)
- HTTP routes → Fines: routes fines (evidence: `backend/src/index.js`)
- HTTP routes → Reports: routes reports (evidence: `backend/src/index.js`)
- HTTP routes → Notifications: routes notices (evidence: `backend/src/index.js`)
- HTTP routes → Reader profile: routes profile (evidence: `backend/src/index.js`)
- Authentication → Database access: reads accounts (evidence: `backend/src/auth.js`)
- HTTP routes → Database access: queries data (evidence: `backend/src/index.js`)
- Database access → MySQL database: connects (evidence: `backend/src/db.js`)
