# tbao04092006/2451220078_24ct2_cnpm architecture

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

- Interactive diagram: https://gitdiagram.com/tbao04092006/2451220078_24ct2_cnpm
- Repository: https://github.com/tbao04092006/2451220078_24ct2_cnpm

## Overview

QuanLiThuVien is a Laravel/MySQL library-management application. Readers search the catalog, request or renew loans, request returns, and handle fines or card renewal; librarians manage inventory and loan circulation; administrators manage staff, policies, proposals, and reporting. Web routes dispatch to role-specific controllers, which use Eloquent domain models and render Blade interfaces. The README documents MySQL persistence and major role interfaces. Some controller and route source was not excerpted, so relationships beyond the cited index or README are omitted.

Main entry points: [`app/Http/Controllers/LibrarianController.php`](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/LibrarianController.php) (Librarian operations), [`app/Http/Controllers/ReaderController.php`](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/ReaderController.php) (Reader operations), [`app/Http/Controllers/AdminController.php`](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/AdminController.php) (Admin operations), [`routes/web.php`](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/routes/web.php) (Web routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_routes["Web routes<br/>[web.php]"]
  node_readerui["Reader interface<br/>[index.blade.php]"]
  node_librarianui["Librarian interface<br/>[index.blade.php]"]
  node_adminui["Admin interface<br/>[index.blade.php]"]
  node_authui["Authentication pages<br/>[login.blade.php]"]
end

subgraph group_operations["Application operations"]
  node_readerctl["Reader operations"]
  node_librarianctl["Librarian operations"]
  node_adminctl["Admin operations"]
  node_paymentctl["Payment operations"]
  node_authctl["Authentication<br/>[AuthController.php]"]
  node_controllerbase["Controller base<br/>[Controller.php]"]
end

subgraph group_domain["Library domain"]
  node_book["Book catalog<br/>[Book.php]"]
  node_borrow["Loan tickets<br/>[BorrowTicket.php]"]
  node_user["User accounts<br/>[User.php]"]
  node_category["Categories<br/>[Category.php]"]
  node_publisher["Publishers<br/>[Publisher.php]"]
  node_proposal["Purchase proposals"]
  node_rules["System rules<br/>[SystemRule.php]"]
  node_transaction["Transactions<br/>[Transaction.php]"]
  node_audit["Audit logs<br/>[AuditLog.php]"]
end

subgraph group_storage["Persistence"]
  node_mysql[("MySQL database")]
end

node_reader(("Reader"))
node_librarian(("Librarian"))
node_admin(("Administrator"))

node_reader -->|"uses"| node_routes
node_librarian -->|"uses"| node_routes
node_admin -->|"uses"| node_routes
node_routes -->|"dispatches"| node_readerctl
node_routes -->|"dispatches"| node_librarianctl
node_routes -->|"dispatches"| node_adminctl
node_routes -->|"dispatches"| node_paymentctl
node_routes -->|"dispatches"| node_authctl
node_readerctl -->|"renders"| node_readerui
node_librarianctl -->|"renders"| node_librarianui
node_adminctl -->|"renders"| node_adminui
node_authctl -->|"serves"| node_authui
node_readerctl -->|"queries"| node_book
node_readerctl -->|"manages"| node_borrow
node_readerctl -->|"reads"| node_rules
node_readerctl -->|"queries"| node_transaction
node_readerctl -->|"records"| node_audit
node_readerctl -->|"reads"| node_user
node_readerctl -->|"queries"| node_category
node_readerctl -->|"queries"| node_publisher
node_librarianctl -->|"manages"| node_book
node_librarianctl -->|"manages"| node_borrow
node_librarianctl -->|"queries"| node_user
node_librarianctl -->|"queries"| node_category
node_librarianctl -->|"queries"| node_publisher
node_librarianctl -->|"queries"| node_proposal
node_librarianctl -->|"reads"| node_rules
node_librarianctl -->|"queries"| node_transaction
node_librarianctl -->|"records"| node_audit
node_adminctl -->|"manages"| node_user
node_adminctl -->|"updates"| node_rules
node_adminctl -->|"reviews"| node_proposal
node_adminctl -->|"queries"| node_transaction
node_adminctl -->|"queries"| node_audit
node_adminctl -->|"queries"| node_book
node_adminctl -->|"queries"| node_category
node_paymentctl -->|"updates"| node_borrow
node_paymentctl -->|"records"| node_transaction
node_paymentctl -->|"reads"| node_rules
node_paymentctl -->|"updates"| node_user
node_authctl -->|"authenticates"| node_user
node_authctl -->|"records"| node_audit
node_book -->|"persists to"| node_mysql
node_borrow -->|"persists to"| node_mysql
node_transaction -->|"persists to"| node_mysql
node_user -->|"persists to"| node_mysql
node_category -->|"persists to"| node_mysql
node_publisher -->|"persists to"| node_mysql

click node_routes "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/routes/web.php"
click node_readerui "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/reader/index.blade.php"
click node_librarianui "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/librarian/index.blade.php"
click node_adminui "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/admin/index.blade.php"
click node_authui "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/auth/login.blade.php"
click node_readerctl "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/ReaderController.php"
click node_librarianctl "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/LibrarianController.php"
click node_adminctl "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/AdminController.php"
click node_paymentctl "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/PaymentController.php"
click node_authctl "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/AuthController.php"
click node_controllerbase "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/Controller.php"
click node_book "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Book.php"
click node_borrow "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/BorrowTicket.php"
click node_user "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/User.php"
click node_category "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Category.php"
click node_publisher "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Publisher.php"
click node_proposal "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/PurchaseProposal.php"
click node_rules "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/SystemRule.php"
click node_transaction "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Transaction.php"
click node_audit "https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/AuditLog.php"

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_routes,node_readerui,node_librarianui,node_adminui,node_authui toneBlue
class node_readerctl,node_librarianctl,node_adminctl,node_paymentctl,node_authctl,node_controllerbase toneAmber
class node_book,node_borrow,node_user,node_category,node_publisher,node_proposal,node_rules,node_transaction,node_audit toneMint
class node_mysql toneRose
class node_reader,node_librarian,node_admin toneIndigo
```

## Components

### Web interface

- [Web routes](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/routes/web.php): `routes/web.php`
- [Reader interface](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/reader/index.blade.php): `resources/views/reader/index.blade.php`
- [Librarian interface](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/librarian/index.blade.php): `resources/views/librarian/index.blade.php`
- [Admin interface](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/admin/index.blade.php): `resources/views/admin/index.blade.php`
- [Authentication pages](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/resources/views/auth/login.blade.php): `resources/views/auth/login.blade.php`

### Application operations

- [Reader operations](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/ReaderController.php): `app/Http/Controllers/ReaderController.php`
- [Librarian operations](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/LibrarianController.php): `app/Http/Controllers/LibrarianController.php`
- [Admin operations](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/AdminController.php): `app/Http/Controllers/AdminController.php`
- [Payment operations](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/PaymentController.php): `app/Http/Controllers/PaymentController.php`
- [Authentication](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [Controller base](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Http/Controllers/Controller.php): `app/Http/Controllers/Controller.php`

### Library domain

- [Book catalog](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Book.php): `app/Models/Book.php`
- [Loan tickets](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/BorrowTicket.php): `app/Models/BorrowTicket.php`
- [User accounts](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/User.php): `app/Models/User.php`
- [Categories](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Category.php): `app/Models/Category.php`
- [Publishers](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Publisher.php): `app/Models/Publisher.php`
- [Purchase proposals](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/PurchaseProposal.php): `app/Models/PurchaseProposal.php`
- [System rules](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/SystemRule.php): `app/Models/SystemRule.php`
- [Transactions](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/Transaction.php): `app/Models/Transaction.php`
- [Audit logs](https://github.com/tbao04092006/2451220078_24ct2_cnpm/blob/main/app/Models/AuditLog.php): `app/Models/AuditLog.php`

### Persistence

- **MySQL database**

### Other components

- **Reader**
- **Librarian**
- **Administrator**

## Connections

- Reader → Web routes: uses (evidence: `README.md`)
- Librarian → Web routes: uses (evidence: `README.md`)
- Administrator → Web routes: uses (evidence: `README.md`)
- Web routes → Reader operations: dispatches (evidence: `routes/web.php`)
- Web routes → Librarian operations: dispatches (evidence: `routes/web.php`)
- Web routes → Admin operations: dispatches (evidence: `routes/web.php`)
- Web routes → Payment operations: dispatches (evidence: `routes/web.php`)
- Web routes → Authentication: dispatches (evidence: `routes/web.php`)
- Reader operations → Reader interface: renders (evidence: `app/Http/Controllers/ReaderController.php`)
- Librarian operations → Librarian interface: renders (evidence: `app/Http/Controllers/LibrarianController.php`)
- Admin operations → Admin interface: renders (evidence: `app/Http/Controllers/AdminController.php`)
- Authentication → Authentication pages: serves (evidence: `README.md`)
- Reader operations → Book catalog: queries (evidence: `app/Http/Controllers/ReaderController.php`)
- Reader operations → Loan tickets: manages (evidence: `app/Http/Controllers/ReaderController.php`)
- Reader operations → System rules: reads (evidence: `app/Http/Controllers/ReaderController.php`)
- Reader operations → Transactions: queries (evidence: `app/Http/Controllers/ReaderController.php`)
- Reader operations → Audit logs: records (evidence: `app/Http/Controllers/ReaderController.php`)
- Reader operations → User accounts: reads (evidence: `app/Http/Controllers/ReaderController.php`)
- Reader operations → Categories: queries (evidence: `app/Http/Controllers/ReaderController.php`)
- Reader operations → Publishers: queries (evidence: `app/Http/Controllers/ReaderController.php`)
- Librarian operations → Book catalog: manages (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → Loan tickets: manages (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → User accounts: queries (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → Categories: queries (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → Publishers: queries (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → Purchase proposals: queries (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → System rules: reads (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → Transactions: queries (evidence: `app/Http/Controllers/LibrarianController.php`)
- Librarian operations → Audit logs: records (evidence: `app/Http/Controllers/LibrarianController.php`)
- Admin operations → User accounts: manages (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → System rules: updates (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → Purchase proposals: reviews (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → Transactions: queries (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → Audit logs: queries (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → Book catalog: queries (evidence: `app/Http/Controllers/AdminController.php`)
- Admin operations → Categories: queries (evidence: `app/Http/Controllers/AdminController.php`)
- Payment operations → Loan tickets: updates (evidence: `app/Http/Controllers/PaymentController.php`)
- Payment operations → Transactions: records (evidence: `app/Http/Controllers/PaymentController.php`)
- Payment operations → System rules: reads (evidence: `app/Http/Controllers/PaymentController.php`)
- Payment operations → User accounts: updates (evidence: `app/Http/Controllers/PaymentController.php`)
- Authentication → User accounts: authenticates (evidence: `app/Http/Controllers/AuthController.php`)
- Authentication → Audit logs: records (evidence: `app/Http/Controllers/AuthController.php`)
- Book catalog → MySQL database: persists to (evidence: `README.md`)
- Loan tickets → MySQL database: persists to (evidence: `README.md`)
- Transactions → MySQL database: persists to (evidence: `README.md`)
- User accounts → MySQL database: persists to (evidence: `README.md`)
- Categories → MySQL database: persists to (evidence: `README.md`)
- Publishers → MySQL database: persists to (evidence: `README.md`)
