# celesvie/perpus_tobias architecture

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

- Interactive diagram: https://gitdiagram.com/celesvie/perpus_tobias
- Repository: https://github.com/celesvie/perpus_tobias

## Overview

PUSTAKA is a Laravel library-management web application. Members browse and filter the public catalog, register or sign in, and submit borrowing requests; librarians review requests, process returns and fines, and manage library records and reports. BorrowingService implements the central circulation rules, including stock changes and overdue-fine calculation. The graph preserves the documented member, admin, catalog, master-data, and reporting capabilities. Some unsampled controller and route behavior is represented only where the README or source index documents it.

Main entry points: [`routes/web.php`](https://github.com/celesvie/perpus_tobias/blob/main/routes/web.php) (Web routes), [`app/Services/BorrowingService.php`](https://github.com/celesvie/perpus_tobias/blob/main/app/Services/BorrowingService.php) (Circulation rules), [`app/Models/Book.php`](https://github.com/celesvie/perpus_tobias/blob/main/app/Models/Book.php) (Library records), [`app/Http/Controllers/Admin/ReportController.php`](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/ReportController.php) (Reports and export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and catalog"]
  node_auth["Sign-in and registration"]
  node_public_catalog["Public catalog"]
  node_home_categories["Home and categories<br/>[HomeController.php]"]
  node_member_account["Member account and history"]
end

subgraph group_circulation["Borrowing and fines"]
  node_member_borrowing["Member borrowing"]
  node_admin_borrowing["Admin circulation"]
  node_borrowing_service["Circulation rules"]
  node_fine_admin["Fine administration<br/>[FineController.php]"]
end

subgraph group_admin["Library administration"]
  node_catalog_admin["Book management<br/>[BookController.php]"]
  node_metadata_admin["Catalog metadata"]
  node_members_admin["Member management"]
  node_settings_admin["Library settings"]
  node_reports["Reports and export"]
end

subgraph group_domain["Library domain"]
  node_library_models[("Library records<br/>[Book.php]")]
  node_borrowing_model[("Borrowing records<br/>[Borrowing.php]")]
  node_fine_model[("Fine records<br/>[Fine.php]")]
  node_activity_log[("Activity audit<br/>[ActivityLog.php]")]
end

subgraph group_platform["Application runtime"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_role_gate["Role access gate"]
end

node_member(("Member"))
node_librarian(("Librarian"))

node_member -.->|"uses web app"| node_web_routes
node_librarian -.->|"uses admin"| node_web_routes
node_web_routes -->|"routes requests"| node_auth
node_web_routes -->|"routes catalog"| node_public_catalog
node_web_routes -->|"routes pages"| node_home_categories
node_web_routes -.->|"routes borrowing"| node_member_borrowing
node_web_routes -.->|"routes circulation"| node_admin_borrowing
node_web_routes -->|"routes reports"| node_reports
node_web_routes -->|"routes books"| node_catalog_admin
node_web_routes -.->|"routes metadata"| node_metadata_admin
node_web_routes -->|"routes members"| node_members_admin
node_web_routes -->|"routes fines"| node_fine_admin
node_web_routes -->|"routes settings"| node_settings_admin
node_web_routes -->|"applies role checks"| node_role_gate
node_member_borrowing -->|"requests or cancels"| node_borrowing_service
node_admin_borrowing -->|"approves or returns"| node_borrowing_service
node_catalog_admin -->|"manages books"| node_library_models
node_public_catalog -->|"searches and reads"| node_library_models
node_borrowing_service -->|"creates and updates"| node_borrowing_model
node_borrowing_service -->|"checks and adjusts stock"| node_library_models
node_borrowing_service -->|"creates or pays"| node_fine_model
node_borrowing_service -->|"records events"| node_activity_log
node_borrowing_service -.->|"reads loan settings"| node_settings_admin
node_reports -->|"aggregates circulation"| node_borrowing_model
node_reports -->|"sums fines"| node_fine_model
node_reports -->|"counts books and members"| node_library_models
node_library_models -->|"has borrowings"| node_borrowing_model
node_borrowing_model -->|"has fine"| node_fine_model
node_metadata_admin -.->|"maintains metadata"| node_library_models
node_member_account -.->|"manages member data"| node_library_models

click node_web_routes "https://github.com/celesvie/perpus_tobias/blob/main/routes/web.php"
click node_role_gate "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Middleware/EnsureUserHasRole.php"
click node_auth "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Auth/RegisterController.php"
click node_public_catalog "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/CatalogController.php"
click node_home_categories "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/HomeController.php"
click node_member_borrowing "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Member/BorrowingController.php"
click node_member_account "https://github.com/celesvie/perpus_tobias/blob/main/app/Services/MemberAccountService.php"
click node_admin_borrowing "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/BorrowingController.php"
click node_borrowing_service "https://github.com/celesvie/perpus_tobias/blob/main/app/Services/BorrowingService.php"
click node_fine_admin "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/FineController.php"
click node_catalog_admin "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/BookController.php"
click node_metadata_admin "https://github.com/celesvie/perpus_tobias/blob/main/app/Services/CatalogMetadataService.php"
click node_members_admin "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/MemberController.php"
click node_settings_admin "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/SettingController.php"
click node_reports "https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/ReportController.php"
click node_library_models "https://github.com/celesvie/perpus_tobias/blob/main/app/Models/Book.php"
click node_borrowing_model "https://github.com/celesvie/perpus_tobias/blob/main/app/Models/Borrowing.php"
click node_fine_model "https://github.com/celesvie/perpus_tobias/blob/main/app/Models/Fine.php"
click node_activity_log "https://github.com/celesvie/perpus_tobias/blob/main/app/Models/ActivityLog.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_auth,node_public_catalog,node_home_categories,node_member_account toneBlue
class node_member_borrowing,node_admin_borrowing,node_borrowing_service,node_fine_admin toneAmber
class node_catalog_admin,node_metadata_admin,node_members_admin,node_settings_admin,node_reports toneMint
class node_library_models,node_borrowing_model,node_fine_model,node_activity_log toneRose
class node_web_routes,node_role_gate,node_member,node_librarian toneIndigo
```

## Components

### Access and catalog

- [Sign-in and registration](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Auth/RegisterController.php): `app/Http/Controllers/Auth/RegisterController.php`
- [Public catalog](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/CatalogController.php): `app/Http/Controllers/CatalogController.php`
- [Home and categories](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/HomeController.php): `app/Http/Controllers/HomeController.php`
- [Member account and history](https://github.com/celesvie/perpus_tobias/blob/main/app/Services/MemberAccountService.php): `app/Services/MemberAccountService.php`

### Borrowing and fines

- [Member borrowing](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Member/BorrowingController.php): `app/Http/Controllers/Member/BorrowingController.php`
- [Admin circulation](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/BorrowingController.php): `app/Http/Controllers/Admin/BorrowingController.php`
- [Circulation rules](https://github.com/celesvie/perpus_tobias/blob/main/app/Services/BorrowingService.php): `app/Services/BorrowingService.php`
- [Fine administration](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/FineController.php): `app/Http/Controllers/Admin/FineController.php`

### Library administration

- [Book management](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/BookController.php): `app/Http/Controllers/Admin/BookController.php`
- [Catalog metadata](https://github.com/celesvie/perpus_tobias/blob/main/app/Services/CatalogMetadataService.php): `app/Services/CatalogMetadataService.php`
- [Member management](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/MemberController.php): `app/Http/Controllers/Admin/MemberController.php`
- [Library settings](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/SettingController.php): `app/Http/Controllers/Admin/SettingController.php`
- [Reports and export](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Controllers/Admin/ReportController.php): `app/Http/Controllers/Admin/ReportController.php`

### Library domain

- [Library records](https://github.com/celesvie/perpus_tobias/blob/main/app/Models/Book.php): `app/Models/Book.php`
- [Borrowing records](https://github.com/celesvie/perpus_tobias/blob/main/app/Models/Borrowing.php): `app/Models/Borrowing.php`
- [Fine records](https://github.com/celesvie/perpus_tobias/blob/main/app/Models/Fine.php): `app/Models/Fine.php`
- [Activity audit](https://github.com/celesvie/perpus_tobias/blob/main/app/Models/ActivityLog.php): `app/Models/ActivityLog.php`

### Application runtime

- [Web routes](https://github.com/celesvie/perpus_tobias/blob/main/routes/web.php): `routes/web.php`
- [Role access gate](https://github.com/celesvie/perpus_tobias/blob/main/app/Http/Middleware/EnsureUserHasRole.php): `app/Http/Middleware/EnsureUserHasRole.php`

### Other components

- **Member**
- **Librarian**

## Connections

- Member → Web routes: uses web app (evidence: `README.md`)
- Librarian → Web routes: uses admin (evidence: `README.md`)
- Web routes → Sign-in and registration: routes requests (evidence: `routes/web.php`)
- Web routes → Public catalog: routes catalog (evidence: `routes/web.php`)
- Web routes → Home and categories: routes pages (evidence: `routes/web.php`)
- Web routes → Member borrowing: routes borrowing
- Web routes → Admin circulation: routes circulation
- Web routes → Reports and export: routes reports (evidence: `routes/web.php`)
- Web routes → Book management: routes books (evidence: `routes/web.php`)
- Web routes → Catalog metadata: routes metadata
- Web routes → Member management: routes members (evidence: `routes/web.php`)
- Web routes → Fine administration: routes fines (evidence: `routes/web.php`)
- Web routes → Library settings: routes settings (evidence: `routes/web.php`)
- Web routes → Role access gate: applies role checks
- Member borrowing → Circulation rules: requests or cancels (evidence: `app/Http/Controllers/Member/BorrowingController.php`)
- Admin circulation → Circulation rules: approves or returns (evidence: `app/Http/Controllers/Admin/BorrowingController.php`)
- Book management → Library records: manages books (evidence: `app/Http/Controllers/Admin/BookController.php`)
- Public catalog → Library records: searches and reads (evidence: `app/Http/Controllers/CatalogController.php`)
- Circulation rules → Borrowing records: creates and updates (evidence: `app/Services/BorrowingService.php`)
- Circulation rules → Library records: checks and adjusts stock (evidence: `app/Services/BorrowingService.php`)
- Circulation rules → Fine records: creates or pays (evidence: `app/Services/BorrowingService.php`)
- Circulation rules → Activity audit: records events (evidence: `app/Services/BorrowingService.php`)
- Circulation rules → Library settings: reads loan settings
- Reports and export → Borrowing records: aggregates circulation (evidence: `app/Http/Controllers/Admin/ReportController.php`)
- Reports and export → Fine records: sums fines (evidence: `app/Http/Controllers/Admin/ReportController.php`)
- Reports and export → Library records: counts books and members (evidence: `app/Http/Controllers/Admin/ReportController.php`)
- Library records → Borrowing records: has borrowings (evidence: `app/Models/Book.php`)
- Borrowing records → Fine records: has fine (evidence: `app/Models/Borrowing.php`)
- Catalog metadata → Library records: maintains metadata
- Member account and history → Library records: manages member data
