# phamquocdien/261dasa230179_06_nhom20 architecture

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

- Interactive diagram: https://gitdiagram.com/phamquocdien/261dasa230179_06_nhom20
- Repository: https://github.com/phamquocdien/261dasa230179_06_nhom20

## Overview

This is a Vietnamese library-management system with browser, JSON API, and console modes. The principal web workflow sends user actions through the JavaScript API client to the PHP endpoint and then to the C++ action dispatcher; the dispatcher coordinates domain services and JSON-backed state. The codebase also includes catalog, membership, lending, fines, reservations, loan slips, renewals, and interest-ranking capabilities. Edges reflect excerpted calls, imports, or README statements; links from PHP to the C++ executable and several unsampled service interactions remain unverified.

Main entry points: [`src/main.cpp`](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/main.cpp) (Action dispatcher), [`src/presentation/script.js`](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/script.js) (Web application), [`src/presentation/js/api.js`](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/api.js) (JSON API client), [`src/dsa_core/repositories`](https://github.com/phamquocdien/261dasa230179_06_nhom20/tree/main/src/dsa_core/repositories) (Domain repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Web interface"]
  node_webapp["Web application<br/>[script.js]"]
  node_catalogui["Catalog UI<br/>[book.js]"]
  node_circulationui["Borrow / return UI<br/>[borrowBook.js]"]
  node_memberui["Members and fines<br/>[memberRegister.js]"]
  node_renewui["Renewal UI<br/>[renewBook.js]"]
  node_reservationui["Reservation UI<br/>[reservation.js]"]
  node_slipui["Loan slip UI<br/>[loanSlip.js]"]
  node_navigationui["Navigation UI<br/>[navigation.js]"]
  node_apiclient["JSON API client<br/>[api.js]"]
end

subgraph group_entry["Application entry"]
  node_phpapi["PHP API endpoint<br/>[api.php]"]
  node_dispatcher["Action dispatcher<br/>[main.cpp]"]
end

subgraph group_domain["Library operations"]
  node_bookservice["Catalog service<br/>[BookService.cpp]"]
  node_memberservice["Member service<br/>[MemberService.cpp]"]
  node_loanservice["Loan and fine service<br/>[LoanService.cpp]"]
  node_reservationservice["Reservation service"]
  node_renewservice["Renewal service<br/>[RenewService.cpp]"]
  node_slipservice["Loan slip service"]
  node_interest["Interest ranking"]
  node_adminservice["Administration service<br/>[AdminService.cpp]"]
end

subgraph group_data["Data and persistence"]
  node_repositories["Domain repositories"]
  node_models["Library records"]
  node_mapper["JSON mapper<br/>[JsonMapper.cpp]"]
  node_database[("JSON database<br/>[JsonDatabase.cpp]")]
end

subgraph group_structures["DSA structures"]
  node_avl["AVL book index<br/>[AVLTree.cpp]"]
  node_hashtable["Hash table<br/>[HashTable.h]"]
end

node_patron(("Library user"))
node_operator(("Console operator"))

node_patron -->|"uses"| node_webapp
node_operator -->|"uses console"| node_dispatcher
node_webapp -->|"initializes"| node_catalogui
node_webapp -->|"initializes"| node_slipui
node_webapp -->|"initializes"| node_circulationui
node_webapp -->|"initializes"| node_memberui
node_webapp -->|"initializes"| node_renewui
node_webapp -->|"initializes"| node_reservationui
node_webapp -->|"initializes"| node_navigationui
node_catalogui -->|"sends requests"| node_apiclient
node_slipui -->|"sends requests"| node_apiclient
node_navigationui -->|"sends requests"| node_apiclient
node_memberui -->|"sends requests"| node_apiclient
node_apiclient -->|"POSTs JSON"| node_phpapi
node_phpapi -.->|"dispatches actions"| node_dispatcher
node_dispatcher -->|"calls"| node_bookservice
node_dispatcher -->|"calls"| node_loanservice
node_dispatcher -->|"calls"| node_reservationservice
node_dispatcher -.->|"calls"| node_memberservice
node_dispatcher -->|"calls"| node_slipservice
node_dispatcher -->|"converts JSON"| node_mapper
node_dispatcher -->|"loads and saves"| node_database
node_bookservice -->|"uses catalog store"| node_repositories
node_loanservice -->|"uses domain stores"| node_repositories
node_reservationservice -->|"uses domain stores"| node_repositories
node_repositories -->|"stores records"| node_models
node_mapper -->|"maps records"| node_models
node_dispatcher -->|"uses index"| node_avl
node_interest -->|"reads books"| node_repositories
node_dispatcher -.->|"calls"| node_renewservice
node_dispatcher -.->|"calls"| node_adminservice
node_dispatcher -.->|"calls"| node_interest

click node_webapp "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/script.js"
click node_catalogui "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/book.js"
click node_circulationui "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/borrowBook.js"
click node_memberui "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/memberRegister.js"
click node_renewui "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/renewBook.js"
click node_reservationui "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/reservation.js"
click node_slipui "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/loanSlip.js"
click node_navigationui "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/navigation.js"
click node_apiclient "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/api.js"
click node_phpapi "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/api/api.php"
click node_dispatcher "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/main.cpp"
click node_bookservice "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/BookService.cpp"
click node_memberservice "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/MemberService.cpp"
click node_loanservice "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/LoanService.cpp"
click node_reservationservice "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/ReservationService.cpp"
click node_renewservice "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/RenewService.cpp"
click node_slipservice "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/LoanSlipService.cpp"
click node_interest "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/InterestManager.cpp"
click node_adminservice "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/AdminService.cpp"
click node_repositories "https://github.com/phamquocdien/261dasa230179_06_nhom20/tree/main/src/dsa_core/repositories"
click node_models "https://github.com/phamquocdien/261dasa230179_06_nhom20/tree/main/src/dsa_core/models"
click node_mapper "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/persistence/JsonMapper.cpp"
click node_database "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/persistence/JsonDatabase.cpp"
click node_avl "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/structures/AVLTree.cpp"
click node_hashtable "https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/structures/HashTable.h"

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_webapp,node_catalogui,node_circulationui,node_memberui,node_renewui,node_reservationui,node_slipui,node_navigationui,node_apiclient,node_patron toneBlue
class node_phpapi,node_dispatcher toneAmber
class node_bookservice,node_memberservice,node_loanservice,node_reservationservice,node_renewservice,node_slipservice,node_interest,node_adminservice toneMint
class node_repositories,node_models,node_mapper,node_database toneRose
class node_avl,node_hashtable,node_operator toneIndigo
```

## Components

### Web interface

- [Web application](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/script.js): `src/presentation/script.js`
- [Catalog UI](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/book.js): `src/presentation/js/book.js`
- [Borrow / return UI](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/borrowBook.js): `src/presentation/js/borrowBook.js`
- [Members and fines](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/memberRegister.js): `src/presentation/js/memberRegister.js`
- [Renewal UI](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/renewBook.js): `src/presentation/js/renewBook.js`
- [Reservation UI](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/reservation.js): `src/presentation/js/reservation.js`
- [Loan slip UI](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/loanSlip.js): `src/presentation/js/loanSlip.js`
- [Navigation UI](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/navigation.js): `src/presentation/js/navigation.js`
- [JSON API client](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/presentation/js/api.js): `src/presentation/js/api.js`

### Application entry

- [PHP API endpoint](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/api/api.php): `src/api/api.php`
- [Action dispatcher](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/main.cpp): `src/main.cpp`

### Library operations

- [Catalog service](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/BookService.cpp): `src/dsa_core/services/BookService.cpp`
- [Member service](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/MemberService.cpp): `src/dsa_core/services/MemberService.cpp`
- [Loan and fine service](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/LoanService.cpp): `src/dsa_core/services/LoanService.cpp`
- [Reservation service](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/ReservationService.cpp): `src/dsa_core/services/ReservationService.cpp`
- [Renewal service](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/RenewService.cpp): `src/dsa_core/services/RenewService.cpp`
- [Loan slip service](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/LoanSlipService.cpp): `src/dsa_core/services/LoanSlipService.cpp`
- [Interest ranking](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/InterestManager.cpp): `src/dsa_core/services/InterestManager.cpp`
- [Administration service](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/services/AdminService.cpp): `src/dsa_core/services/AdminService.cpp`

### Data and persistence

- [Domain repositories](https://github.com/phamquocdien/261dasa230179_06_nhom20/tree/main/src/dsa_core/repositories): `src/dsa_core/repositories`
- [Library records](https://github.com/phamquocdien/261dasa230179_06_nhom20/tree/main/src/dsa_core/models): `src/dsa_core/models`
- [JSON mapper](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/persistence/JsonMapper.cpp): `src/persistence/JsonMapper.cpp`
- [JSON database](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/persistence/JsonDatabase.cpp): `src/persistence/JsonDatabase.cpp`

### DSA structures

- [AVL book index](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/structures/AVLTree.cpp): `src/dsa_core/structures/AVLTree.cpp`
- [Hash table](https://github.com/phamquocdien/261dasa230179_06_nhom20/blob/main/src/dsa_core/structures/HashTable.h): `src/dsa_core/structures/HashTable.h`

### Other components

- **Library user**
- **Console operator**

## Connections

- Library user → Web application: uses
- Console operator → Action dispatcher: uses console
- Web application → Catalog UI: initializes (evidence: `src/presentation/script.js`)
- Web application → Loan slip UI: initializes (evidence: `src/presentation/script.js`)
- Web application → Borrow / return UI: initializes (evidence: `src/presentation/script.js`)
- Web application → Members and fines: initializes (evidence: `src/presentation/script.js`)
- Web application → Renewal UI: initializes (evidence: `src/presentation/script.js`)
- Web application → Reservation UI: initializes (evidence: `src/presentation/script.js`)
- Web application → Navigation UI: initializes (evidence: `src/presentation/script.js`)
- Catalog UI → JSON API client: sends requests (evidence: `src/presentation/js/book.js`)
- Loan slip UI → JSON API client: sends requests (evidence: `src/presentation/js/loanSlip.js`)
- Navigation UI → JSON API client: sends requests (evidence: `src/presentation/js/navigation.js`)
- Members and fines → JSON API client: sends requests
- JSON API client → PHP API endpoint: POSTs JSON (evidence: `src/presentation/js/api.js`)
- PHP API endpoint → Action dispatcher: dispatches actions
- Action dispatcher → Catalog service: calls (evidence: `src/main.cpp`)
- Action dispatcher → Loan and fine service: calls (evidence: `src/main.cpp`)
- Action dispatcher → Reservation service: calls (evidence: `src/main.cpp`)
- Action dispatcher → Member service: calls
- Action dispatcher → Loan slip service: calls (evidence: `src/main.cpp`)
- Action dispatcher → JSON mapper: converts JSON (evidence: `src/main.cpp`)
- Action dispatcher → JSON database: loads and saves (evidence: `src/main.cpp`)
- Catalog service → Domain repositories: uses catalog store
- Loan and fine service → Domain repositories: uses domain stores
- Reservation service → Domain repositories: uses domain stores
- Domain repositories → Library records: stores records (evidence: `src/dsa_core/repositories/BookRepository.h`)
- JSON mapper → Library records: maps records
- Action dispatcher → AVL book index: uses index (evidence: `src/main.cpp`)
- Interest ranking → Domain repositories: reads books
- Action dispatcher → Renewal service: calls
- Action dispatcher → Administration service: calls
- Action dispatcher → Interest ranking: calls
