# berrouane-wafa/bib-app architecture

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

- Interactive diagram: https://gitdiagram.com/berrouane-wafa/bib-app
- Repository: https://github.com/berrouane-wafa/bib-app

## Overview

This is a Laravel library-circulation web application: users can authenticate, browse and manage books, authors, publishers and clients, and record loans. The clearest sampled workflow routes requests to controllers, which validate and operate on Eloquent models; loan creation also reduces book stock. The graph preserves the main domain models and visible screens. Source evidence is incomplete, so links for unsampled controller behavior and persistence infrastructure are omitted rather than inferred.

Main entry points: [`routes/web.php`](https://github.com/berrouane-wafa/bib-app/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/LivreController.php`](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/LivreController.php) (Book management), [`app/Http/Controllers/EmpruntController.php`](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/EmpruntController.php) (Loan management), [`app/Models/Livre.php`](https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Livre.php) (Book)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry"]
  node_web_routes["Web routes<br/>[web.php]"]
end

subgraph group_accounts["Authentication"]
  node_auth_controller["Authentication<br/>[AuthController.php]"]
  node_user_model[("User account<br/>[User.php]")]
  node_login_view["Login screen<br/>[login.blade.php]"]
end

subgraph group_catalog["Library catalog"]
  node_author_controller["Author management"]
  node_client_controller["Client management"]
  node_publisher_controller["Publisher management"]
  node_book_controller["Book management"]
  node_author_model[("Author<br/>[Auteur.php]")]
  node_client_model[("Client<br/>[Client.php]")]
  node_publisher_model[("Publisher<br/>[Edition.php]")]
  node_book_model[("Book<br/>[Livre.php]")]
  node_catalog_views["Catalog screens"]
end

subgraph group_circulation["Loan circulation"]
  node_loan_controller["Loan management"]
  node_loan_model[("Loan<br/>[Emprunt.php]")]
  node_loan_views["Loan screens"]
end

node_visitor(("Library user"))

node_visitor -.->|"sends requests"| node_web_routes
node_web_routes -->|"routes to"| node_auth_controller
node_web_routes -->|"routes to"| node_author_controller
node_web_routes -->|"routes to"| node_client_controller
node_web_routes -->|"routes to"| node_publisher_controller
node_web_routes -->|"routes to"| node_book_controller
node_web_routes -->|"routes to"| node_loan_controller
node_auth_controller -->|"renders"| node_login_view
node_book_controller -->|"loads"| node_author_model
node_book_controller -->|"loads"| node_publisher_model
node_book_controller -->|"queries and creates"| node_book_model
node_book_controller -->|"renders"| node_catalog_views
node_author_model -->|"belongs to"| node_book_model
node_publisher_model -->|"belongs to"| node_book_model
node_loan_controller -->|"creates and loads"| node_loan_model
node_loan_controller -->|"loads clients"| node_client_model
node_loan_controller -->|"checks and decrements stock"| node_book_model
node_loan_controller -->|"renders"| node_loan_views
node_loan_model -->|"belongs to"| node_book_model
node_loan_model -->|"belongs to"| node_client_model

click node_web_routes "https://github.com/berrouane-wafa/bib-app/blob/main/routes/web.php"
click node_auth_controller "https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/AuthController.php"
click node_user_model "https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/User.php"
click node_login_view "https://github.com/berrouane-wafa/bib-app/blob/main/resources/views/auth/login.blade.php"
click node_author_controller "https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/AuteurController.php"
click node_client_controller "https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/ClientController.php"
click node_publisher_controller "https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/EditionController.php"
click node_book_controller "https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/LivreController.php"
click node_author_model "https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Auteur.php"
click node_client_model "https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Client.php"
click node_publisher_model "https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Edition.php"
click node_book_model "https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Livre.php"
click node_catalog_views "https://github.com/berrouane-wafa/bib-app/tree/main/resources/views"
click node_loan_controller "https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/EmpruntController.php"
click node_loan_model "https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Emprunt.php"
click node_loan_views "https://github.com/berrouane-wafa/bib-app/tree/main/resources/views/loans"

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_web_routes,node_visitor toneBlue
class node_auth_controller,node_user_model,node_login_view toneAmber
class node_author_controller,node_client_controller,node_publisher_controller,node_book_controller,node_author_model,node_client_model,node_publisher_model,node_book_model,node_catalog_views toneMint
class node_loan_controller,node_loan_model,node_loan_views toneRose
```

## Components

### Web entry

- [Web routes](https://github.com/berrouane-wafa/bib-app/blob/main/routes/web.php): `routes/web.php`

### Authentication

- [Authentication](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [User account](https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/User.php): `app/Models/User.php`
- [Login screen](https://github.com/berrouane-wafa/bib-app/blob/main/resources/views/auth/login.blade.php): `resources/views/auth/login.blade.php`

### Library catalog

- [Author management](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/AuteurController.php): `app/Http/Controllers/AuteurController.php`
- [Client management](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/ClientController.php): `app/Http/Controllers/ClientController.php`
- [Publisher management](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/EditionController.php): `app/Http/Controllers/EditionController.php`
- [Book management](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/LivreController.php): `app/Http/Controllers/LivreController.php`
- [Author](https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Auteur.php): `app/Models/Auteur.php`
- [Client](https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Client.php): `app/Models/Client.php`
- [Publisher](https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Edition.php): `app/Models/Edition.php`
- [Book](https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Livre.php): `app/Models/Livre.php`
- [Catalog screens](https://github.com/berrouane-wafa/bib-app/tree/main/resources/views): `resources/views`

### Loan circulation

- [Loan management](https://github.com/berrouane-wafa/bib-app/blob/main/app/Http/Controllers/EmpruntController.php): `app/Http/Controllers/EmpruntController.php`
- [Loan](https://github.com/berrouane-wafa/bib-app/blob/main/app/Models/Emprunt.php): `app/Models/Emprunt.php`
- [Loan screens](https://github.com/berrouane-wafa/bib-app/tree/main/resources/views/loans): `resources/views/loans`

### Other components

- **Library user**

## Connections

- Library user → Web routes: sends requests
- Web routes → Authentication: routes to (evidence: `routes/web.php`)
- Web routes → Author management: routes to (evidence: `routes/web.php`)
- Web routes → Client management: routes to (evidence: `routes/web.php`)
- Web routes → Publisher management: routes to (evidence: `routes/web.php`)
- Web routes → Book management: routes to (evidence: `routes/web.php`)
- Web routes → Loan management: routes to (evidence: `routes/web.php`)
- Authentication → Login screen: renders (evidence: `app/Http/Controllers/AuthController.php`)
- Book management → Author: loads (evidence: `app/Http/Controllers/LivreController.php`)
- Book management → Publisher: loads (evidence: `app/Http/Controllers/LivreController.php`)
- Book management → Book: queries and creates (evidence: `app/Http/Controllers/LivreController.php`)
- Book management → Catalog screens: renders (evidence: `app/Http/Controllers/LivreController.php`)
- Author → Book: belongs to (evidence: `app/Models/Auteur.php`)
- Publisher → Book: belongs to (evidence: `app/Models/Edition.php`)
- Loan management → Loan: creates and loads (evidence: `app/Http/Controllers/EmpruntController.php`)
- Loan management → Client: loads clients (evidence: `app/Http/Controllers/EmpruntController.php`)
- Loan management → Book: checks and decrements stock (evidence: `app/Http/Controllers/EmpruntController.php`)
- Loan management → Loan screens: renders (evidence: `app/Http/Controllers/EmpruntController.php`)
- Loan → Book: belongs to (evidence: `app/Models/Emprunt.php`)
- Loan → Client: belongs to (evidence: `app/Models/Emprunt.php`)
