# bouaboi/libraryapi architecture

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

- Interactive diagram: https://gitdiagram.com/bouaboi/libraryapi
- Repository: https://github.com/bouaboi/libraryapi

## Overview

This is an ASP.NET Core library-management REST API. Members and administrators use its endpoints to manage books, members, borrowing and returns, fines, and settings; authentication supplies JWT access tokens and refresh-token rotation. The graph follows documented API-to-service-to-data access layers and the sampled borrow/return database behavior. Some service and data-access implementations were not sampled, so their internal calls are omitted; dashed links indicate documented but unsampled paths.

Main entry points: [`LibraryApi/Controllers`](https://github.com/bouaboi/libraryapi/tree/main/LibraryApi/Controllers) (REST controllers), [`LibraryDataAccessLayer/Data/LibraryDbContext.cs`](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/Data/LibraryDbContext.cs) (EF Core context), [`LibraryApi/Controllers/AuthController.cs`](https://github.com/bouaboi/libraryapi/blob/main/LibraryApi/Controllers/AuthController.cs) (Authentication), [`LibraryDataAccessLayer/BorrowData.cs`](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/BorrowData.cs) (Borrow and return data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and security"]
  node_controllers["REST controllers"]
  node_auth["Authentication<br/>[AuthController.cs]"]
  node_authorization["JWT and ownership policy<br/>[Program.cs]"]
  node_owner_handler["Owner/admin check"]
end

subgraph group_business["Business services"]
  node_book_service["Book service<br/>[BookService.cs]"]
  node_borrow_service["Borrow service<br/>[BorrowService.cs]"]
  node_member_service["Member service<br/>[MemberService.cs]"]
  node_fines_service["Fines service<br/>[FinesService.cs]"]
  node_settings_service["Settings service<br/>[SettingService.cs]"]
  node_registration_services["Registration services<br/>[RegisterService.cs]"]
  node_admin_registration["Admin registration"]
  node_user_service["User lookup<br/>[UserService.cs]"]
end

subgraph group_data["Data access"]
  node_book_data["Books data<br/>[BookData.cs]"]
  node_borrow_data["Borrow and return data<br/>[BorrowData.cs]"]
  node_member_data["Member data<br/>[MemberData.cs]"]
  node_fine_data["Fine data<br/>[FinesData.cs]"]
  node_settings_data["Settings data<br/>[SettingData.cs]"]
  node_registration_data["Registration data<br/>[RegisterData.cs]"]
  node_admin_registration_data["Admin account data"]
  node_user_data["User data<br/>[UserData.cs]"]
  node_token_data["Refresh-token data<br/>[TokensData.cs]"]
  node_db_context["EF Core context"]
end

subgraph group_domain["Library domain"]
  node_dtos["Request and response DTOs"]
  node_entities["Library entities"]
end

node_caller(("Members and admins"))
node_sqlserver[("SQL Server")]

node_caller -->|"calls endpoints"| node_controllers
node_controllers -->|"routes auth"| node_auth
node_controllers -->|"delegates books"| node_book_service
node_controllers -->|"delegates borrows"| node_borrow_service
node_controllers -->|"delegates members"| node_member_service
node_controllers -->|"delegates fines"| node_fines_service
node_controllers -->|"delegates settings"| node_settings_service
node_auth -->|"registers members"| node_registration_services
node_auth -->|"registers admins"| node_admin_registration
node_auth -->|"looks up users"| node_user_service
node_auth -.->|"rotates tokens"| node_token_data
node_authorization -->|"registers handler"| node_owner_handler
node_book_service -->|"calls data access"| node_book_data
node_borrow_service -->|"calls data access"| node_borrow_data
node_member_service -->|"calls data access"| node_member_data
node_fines_service -->|"calls data access"| node_fine_data
node_settings_service -->|"calls data access"| node_settings_data
node_registration_services -->|"calls data access"| node_registration_data
node_admin_registration -->|"calls data access"| node_admin_registration_data
node_user_service -->|"calls data access"| node_user_data
node_book_data -->|"queries database"| node_db_context
node_borrow_data -->|"reads and writes"| node_db_context
node_member_data -->|"queries database"| node_db_context
node_registration_data -->|"writes accounts"| node_db_context
node_admin_registration_data -->|"writes accounts"| node_db_context
node_settings_data -->|"reads and writes"| node_db_context
node_db_context -->|"uses EF Core"| node_sqlserver
node_db_context -->|"maps tables"| node_entities
node_controllers -.->|"accepts and returns"| node_dtos
node_borrow_data -.->|"creates late fines"| node_fine_data

click node_controllers "https://github.com/bouaboi/libraryapi/tree/main/LibraryApi/Controllers"
click node_auth "https://github.com/bouaboi/libraryapi/blob/main/LibraryApi/Controllers/AuthController.cs"
click node_authorization "https://github.com/bouaboi/libraryapi/blob/main/LibraryApi/Program.cs"
click node_owner_handler "https://github.com/bouaboi/libraryapi/blob/main/LibraryApi/Authorization/MemberOwnerOrAdminHandler.cs"
click node_book_service "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/BookService.cs"
click node_borrow_service "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/BorrowService.cs"
click node_member_service "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/MemberService.cs"
click node_fines_service "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/FinesService.cs"
click node_settings_service "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/SettingService.cs"
click node_registration_services "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/RegisterService.cs"
click node_admin_registration "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/RegisterAdminService.cs"
click node_user_service "https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/UserService.cs"
click node_book_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/BookData.cs"
click node_borrow_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/BorrowData.cs"
click node_member_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/MemberData.cs"
click node_fine_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/FinesData.cs"
click node_settings_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/SettingData.cs"
click node_registration_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/RegisterData.cs"
click node_admin_registration_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/RegisterAdminData.cs"
click node_user_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/UserData.cs"
click node_token_data "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/TokensData.cs"
click node_db_context "https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/Data/LibraryDbContext.cs"
click node_dtos "https://github.com/bouaboi/libraryapi/tree/main/LibraryDTOs"
click node_entities "https://github.com/bouaboi/libraryapi/tree/main/LibraryModuls"

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_controllers,node_auth,node_authorization,node_owner_handler toneBlue
class node_book_service,node_borrow_service,node_member_service,node_fines_service,node_settings_service,node_registration_services,node_admin_registration,node_user_service,node_sqlserver toneAmber
class node_book_data,node_borrow_data,node_member_data,node_fine_data,node_settings_data,node_registration_data,node_admin_registration_data,node_user_data,node_token_data,node_db_context toneMint
class node_dtos,node_entities toneRose
class node_caller toneIndigo
```

## Components

### API and security

- [REST controllers](https://github.com/bouaboi/libraryapi/tree/main/LibraryApi/Controllers): `LibraryApi/Controllers`
- [Authentication](https://github.com/bouaboi/libraryapi/blob/main/LibraryApi/Controllers/AuthController.cs): `LibraryApi/Controllers/AuthController.cs`
- [JWT and ownership policy](https://github.com/bouaboi/libraryapi/blob/main/LibraryApi/Program.cs): `LibraryApi/Program.cs`
- [Owner/admin check](https://github.com/bouaboi/libraryapi/blob/main/LibraryApi/Authorization/MemberOwnerOrAdminHandler.cs): `LibraryApi/Authorization/MemberOwnerOrAdminHandler.cs`

### Business services

- [Book service](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/BookService.cs): `LibraryBusinessLayer/BookService.cs`
- [Borrow service](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/BorrowService.cs): `LibraryBusinessLayer/BorrowService.cs`
- [Member service](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/MemberService.cs): `LibraryBusinessLayer/MemberService.cs`
- [Fines service](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/FinesService.cs): `LibraryBusinessLayer/FinesService.cs`
- [Settings service](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/SettingService.cs): `LibraryBusinessLayer/SettingService.cs`
- [Registration services](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/RegisterService.cs): `LibraryBusinessLayer/RegisterService.cs`
- [Admin registration](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/RegisterAdminService.cs): `LibraryBusinessLayer/RegisterAdminService.cs`
- [User lookup](https://github.com/bouaboi/libraryapi/blob/main/LibraryBusinessLayer/UserService.cs): `LibraryBusinessLayer/UserService.cs`

### Data access

- [Books data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/BookData.cs): `LibraryDataAccessLayer/BookData.cs`
- [Borrow and return data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/BorrowData.cs): `LibraryDataAccessLayer/BorrowData.cs`
- [Member data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/MemberData.cs): `LibraryDataAccessLayer/MemberData.cs`
- [Fine data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/FinesData.cs): `LibraryDataAccessLayer/FinesData.cs`
- [Settings data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/SettingData.cs): `LibraryDataAccessLayer/SettingData.cs`
- [Registration data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/RegisterData.cs): `LibraryDataAccessLayer/RegisterData.cs`
- [Admin account data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/RegisterAdminData.cs): `LibraryDataAccessLayer/RegisterAdminData.cs`
- [User data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/UserData.cs): `LibraryDataAccessLayer/UserData.cs`
- [Refresh-token data](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/TokensData.cs): `LibraryDataAccessLayer/TokensData.cs`
- [EF Core context](https://github.com/bouaboi/libraryapi/blob/main/LibraryDataAccessLayer/Data/LibraryDbContext.cs): `LibraryDataAccessLayer/Data/LibraryDbContext.cs`

### Library domain

- [Request and response DTOs](https://github.com/bouaboi/libraryapi/tree/main/LibraryDTOs): `LibraryDTOs`
- [Library entities](https://github.com/bouaboi/libraryapi/tree/main/LibraryModuls): `LibraryModuls`

### Other components

- **Members and admins**
- **SQL Server**

## Connections

- Members and admins → REST controllers: calls endpoints
- REST controllers → Authentication: routes auth (evidence: `LibraryApi/Controllers/AuthController.cs`)
- REST controllers → Book service: delegates books (evidence: `LibraryApi/Controllers/BooksController.cs`)
- REST controllers → Borrow service: delegates borrows (evidence: `LibraryApi/Controllers/BorrowsController.cs`)
- REST controllers → Member service: delegates members (evidence: `LibraryApi/Controllers/MembersController.cs`)
- REST controllers → Fines service: delegates fines (evidence: `LibraryApi/Controllers/FInesController.cs`)
- REST controllers → Settings service: delegates settings (evidence: `LibraryApi/Controllers/SettingsController.cs`)
- Authentication → Registration services: registers members (evidence: `LibraryApi/Controllers/AuthController.cs`)
- Authentication → Admin registration: registers admins (evidence: `LibraryApi/Controllers/AuthController.cs`)
- Authentication → User lookup: looks up users (evidence: `LibraryApi/Controllers/AuthController.cs`)
- Authentication → Refresh-token data: rotates tokens
- JWT and ownership policy → Owner/admin check: registers handler (evidence: `LibraryApi/Program.cs`)
- Book service → Books data: calls data access (evidence: `LibraryBusinessLayer/BookService.cs`)
- Borrow service → Borrow and return data: calls data access (evidence: `LibraryBusinessLayer/BorrowService.cs`)
- Member service → Member data: calls data access (evidence: `LibraryBusinessLayer/MemberService.cs`)
- Fines service → Fine data: calls data access (evidence: `LibraryBusinessLayer/FinesService.cs`)
- Settings service → Settings data: calls data access (evidence: `LibraryBusinessLayer/SettingService.cs`)
- Registration services → Registration data: calls data access (evidence: `LibraryBusinessLayer/RegisterService.cs`)
- Admin registration → Admin account data: calls data access (evidence: `LibraryBusinessLayer/RegisterAdminService.cs`)
- User lookup → User data: calls data access (evidence: `LibraryBusinessLayer/UserService.cs`)
- Books data → EF Core context: queries database (evidence: `LibraryDataAccessLayer/BookData.cs`)
- Borrow and return data → EF Core context: reads and writes (evidence: `LibraryDataAccessLayer/BorrowData.cs`)
- Member data → EF Core context: queries database (evidence: `LibraryDataAccessLayer/MemberData.cs`)
- Registration data → EF Core context: writes accounts (evidence: `LibraryDataAccessLayer/RegisterData.cs`)
- Admin account data → EF Core context: writes accounts (evidence: `LibraryDataAccessLayer/RegisterAdminData.cs`)
- Settings data → EF Core context: reads and writes (evidence: `LibraryDataAccessLayer/SettingData.cs`)
- EF Core context → SQL Server: uses EF Core
- EF Core context → Library entities: maps tables (evidence: `LibraryDataAccessLayer/Data/LibraryDbContext.cs`)
- REST controllers → Request and response DTOs: accepts and returns (evidence: `LibraryApi/Controllers/AuthController.cs`)
- Borrow and return data → Fine data: creates late fines
