# antonny890/libreria-universal-fronted-backend architecture

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

- Interactive diagram: https://gitdiagram.com/antonny890/libreria-universal-fronted-backend
- Repository: https://github.com/antonny890/libreria-universal-fronted-backend

## Overview

Universal Library is a bookstore application: readers browse and filter a catalog, manage a cart, and check out; administrators manage books, while users can register, sign in, and update profiles. The React app centralizes state in LibraryContext, with cart calculations and browser persistence as internal layers. Its Laravel API exposes authentication, catalog, category, and order endpoints. Source evidence shows the API route registrations and several frontend state dependencies; the frontend-to-backend HTTP wiring and several service implementations were not excerpted, so that integration is shown as unverified.

Main entry points: [`libreria-universal/src/App.tsx`](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/App.tsx) (App shell), [`libreria-universal/src/context/useLibrary.ts`](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/useLibrary.ts) (State hook), [`libreria-universal-backend/routes/api.php`](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/routes/api.php) (API routes), [`libreria-universal/src/context/LibraryContext.tsx`](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/LibraryContext.tsx) (Library state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React storefront"]
  node_app["App shell<br/>[App.tsx]"]
  node_catalog["Catalog views<br/>[CatalogSection.tsx]"]
  node_admin["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_bookdetail["Book details"]
  node_bookform["Book editor<br/>[BookFormModal.tsx]"]
  node_cartui["Cart and checkout<br/>[CartDrawer.tsx]"]
  node_checkoutui["Checkout modal<br/>[CheckoutModal.tsx]"]
  node_authui["Sign-in dialog<br/>[AuthModal.tsx]"]
  node_profileui["User profile"]
end

subgraph group_state["Client state"]
  node_context["Library state<br/>[LibraryContext.tsx]"]
  node_hook["State hook<br/>[useLibrary.ts]"]
  node_contextvalue["State contract"]
  node_cartlogic["Cart calculations<br/>[cartService.ts]"]
  node_storage[("Browser storage<br/>[libraryStorage.ts]")]
  node_mockdata["Sample catalog data<br/>[mockData.ts]"]
  node_frontendapi["API client<br/>[libraryApi.ts]"]
end

subgraph group_api["Laravel API"]
  node_api_routes["API routes<br/>[api.php]"]
  node_authcontroller["Authentication API<br/>[AuthController.php]"]
  node_bookcontroller["Book catalog API"]
  node_categorycontroller["Category API"]
  node_ordercontroller["Order API"]
end

subgraph group_domain["Backend domain"]
  node_authservice["Authentication service<br/>[AuthService.php]"]
  node_bookmodel["Book model<br/>[Libro.php]"]
  node_catalogseed["Catalog seeder<br/>[CatalogoSeeder.php]"]
end

node_reader(("Reader or admin"))

node_reader -->|"uses"| node_app
node_app -->|"renders"| node_catalog
node_app -->|"renders"| node_admin
node_app -->|"renders"| node_cartui
node_app -->|"renders"| node_checkoutui
node_app -->|"renders"| node_bookdetail
node_app -->|"renders"| node_bookform
node_app -->|"renders"| node_profileui
node_app -->|"renders"| node_authui
node_app -->|"provides state"| node_context
node_catalog -.->|"reads state"| node_hook
node_admin -.->|"reads state"| node_hook
node_cartui -.->|"reads state"| node_hook
node_checkoutui -.->|"reads state"| node_hook
node_authui -->|"reads state"| node_hook
node_profileui -.->|"reads state"| node_hook
node_hook -->|"reads context"| node_contextvalue
node_context -->|"reads and writes"| node_storage
node_context -->|"uses calculations"| node_cartlogic
node_context -->|"loads defaults"| node_mockdata
node_context -->|"uses client"| node_frontendapi
node_cartui -.->|"calculates totals"| node_cartlogic
node_reader -.->|"sends API requests"| node_api_routes
node_frontendapi -.->|"calls API"| node_api_routes
node_api_routes -->|"routes to"| node_authcontroller
node_api_routes -->|"routes to"| node_bookcontroller
node_api_routes -->|"routes to"| node_categorycontroller
node_api_routes -->|"routes to"| node_ordercontroller
node_authcontroller -->|"delegates auth"| node_authservice
node_bookcontroller -.->|"queries books"| node_bookmodel
node_catalogseed -->|"seeds books"| node_bookmodel

click node_app "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/App.tsx"
click node_catalog "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/CatalogSection.tsx"
click node_admin "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/AdminDashboard.tsx"
click node_bookdetail "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/BookDetailModal.tsx"
click node_bookform "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/BookFormModal.tsx"
click node_cartui "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/CartDrawer.tsx"
click node_checkoutui "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/CheckoutModal.tsx"
click node_authui "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/AuthModal.tsx"
click node_profileui "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/UserProfileModal.tsx"
click node_context "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/LibraryContext.tsx"
click node_hook "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/useLibrary.ts"
click node_contextvalue "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/LibraryContextValue.ts"
click node_cartlogic "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/services/cartService.ts"
click node_storage "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/services/libraryStorage.ts"
click node_mockdata "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/data/mockData.ts"
click node_frontendapi "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/services/libraryApi.ts"
click node_api_routes "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/routes/api.php"
click node_authcontroller "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/AuthController.php"
click node_bookcontroller "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/LibroController.php"
click node_categorycontroller "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/CategoriaController.php"
click node_ordercontroller "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/PedidoController.php"
click node_authservice "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Services/AuthService.php"
click node_bookmodel "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Models/Libro.php"
click node_catalogseed "https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/database/seeders/CatalogoSeeder.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_app,node_catalog,node_admin,node_bookdetail,node_bookform,node_cartui,node_checkoutui,node_authui,node_profileui toneBlue
class node_context,node_hook,node_contextvalue,node_cartlogic,node_storage,node_mockdata,node_frontendapi toneAmber
class node_api_routes,node_authcontroller,node_bookcontroller,node_categorycontroller,node_ordercontroller toneMint
class node_authservice,node_bookmodel,node_catalogseed toneRose
class node_reader toneIndigo
```

## Components

### React storefront

- [App shell](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/App.tsx): `libreria-universal/src/App.tsx`
- [Catalog views](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/CatalogSection.tsx): `libreria-universal/src/components/CatalogSection.tsx`
- [Admin dashboard](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/AdminDashboard.tsx): `libreria-universal/src/components/AdminDashboard.tsx`
- [Book details](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/BookDetailModal.tsx): `libreria-universal/src/components/BookDetailModal.tsx`
- [Book editor](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/BookFormModal.tsx): `libreria-universal/src/components/BookFormModal.tsx`
- [Cart and checkout](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/CartDrawer.tsx): `libreria-universal/src/components/CartDrawer.tsx`
- [Checkout modal](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/CheckoutModal.tsx): `libreria-universal/src/components/CheckoutModal.tsx`
- [Sign-in dialog](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/AuthModal.tsx): `libreria-universal/src/components/AuthModal.tsx`
- [User profile](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/components/UserProfileModal.tsx): `libreria-universal/src/components/UserProfileModal.tsx`

### Client state

- [Library state](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/LibraryContext.tsx): `libreria-universal/src/context/LibraryContext.tsx`
- [State hook](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/useLibrary.ts): `libreria-universal/src/context/useLibrary.ts`
- [State contract](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/context/LibraryContextValue.ts): `libreria-universal/src/context/LibraryContextValue.ts`
- [Cart calculations](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/services/cartService.ts): `libreria-universal/src/services/cartService.ts`
- [Browser storage](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/services/libraryStorage.ts): `libreria-universal/src/services/libraryStorage.ts`
- [Sample catalog data](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/data/mockData.ts): `libreria-universal/src/data/mockData.ts`
- [API client](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal/src/services/libraryApi.ts): `libreria-universal/src/services/libraryApi.ts`

### Laravel API

- [API routes](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/routes/api.php): `libreria-universal-backend/routes/api.php`
- [Authentication API](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/AuthController.php): `libreria-universal-backend/app/Http/Controllers/Api/V1/AuthController.php`
- [Book catalog API](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/LibroController.php): `libreria-universal-backend/app/Http/Controllers/Api/V1/LibroController.php`
- [Category API](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/CategoriaController.php): `libreria-universal-backend/app/Http/Controllers/Api/V1/CategoriaController.php`
- [Order API](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Http/Controllers/Api/V1/PedidoController.php): `libreria-universal-backend/app/Http/Controllers/Api/V1/PedidoController.php`

### Backend domain

- [Authentication service](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Services/AuthService.php): `libreria-universal-backend/app/Services/AuthService.php`
- [Book model](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/app/Models/Libro.php): `libreria-universal-backend/app/Models/Libro.php`
- [Catalog seeder](https://github.com/antonny890/libreria-universal-fronted-backend/blob/main/libreria-universal-backend/database/seeders/CatalogoSeeder.php): `libreria-universal-backend/database/seeders/CatalogoSeeder.php`

### Other components

- **Reader or admin**

## Connections

- Reader or admin → App shell: uses
- App shell → Catalog views: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → Admin dashboard: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → Cart and checkout: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → Checkout modal: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → Book details: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → Book editor: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → User profile: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → Sign-in dialog: renders (evidence: `libreria-universal/src/App.tsx`)
- App shell → Library state: provides state (evidence: `libreria-universal/src/App.tsx`)
- Catalog views → State hook: reads state
- Admin dashboard → State hook: reads state
- Cart and checkout → State hook: reads state
- Checkout modal → State hook: reads state
- Sign-in dialog → State hook: reads state (evidence: `libreria-universal/src/components/AuthModal.tsx`)
- User profile → State hook: reads state
- State hook → State contract: reads context (evidence: `libreria-universal/src/context/useLibrary.ts`)
- Library state → Browser storage: reads and writes (evidence: `libreria-universal/src/context/LibraryContext.tsx`)
- Library state → Cart calculations: uses calculations (evidence: `libreria-universal/src/context/LibraryContext.tsx`)
- Library state → Sample catalog data: loads defaults (evidence: `libreria-universal/src/context/LibraryContext.tsx`)
- Library state → API client: uses client (evidence: `libreria-universal/src/context/LibraryContext.tsx`)
- Cart and checkout → Cart calculations: calculates totals
- Reader or admin → API routes: sends API requests
- API client → API routes: calls API
- API routes → Authentication API: routes to (evidence: `libreria-universal-backend/routes/api.php`)
- API routes → Book catalog API: routes to (evidence: `libreria-universal-backend/routes/api.php`)
- API routes → Category API: routes to (evidence: `libreria-universal-backend/routes/api.php`)
- API routes → Order API: routes to (evidence: `libreria-universal-backend/routes/api.php`)
- Authentication API → Authentication service: delegates auth (evidence: `libreria-universal-backend/app/Http/Controllers/Api/V1/AuthController.php`)
- Book catalog API → Book model: queries books
- Catalog seeder → Book model: seeds books (evidence: `libreria-universal-backend/database/seeders/CatalogoSeeder.php`)
