# bidobelemti/examen_isw613 architecture

> Architecture diagram of the GitHub repository bidobelemti/examen_isw613, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bidobelemti/examen_isw613
- Repository: https://github.com/bidobelemti/examen_isw613

## Overview

##### Project Type and Purpose
- This is a full-stack web application for managing a library (books, loans, fines), built as an exam project for a web applications course.
- The “backend” directory holds an Express + Prisma API; the “frontend” directory holds a React single-page application with Keycloak-based authentication.

##### File Structure Analysis
- Top level: “backend” and “frontend”
- Backend:
- package.json, tsconfig.json, Prisma schema, seed script
- src/app.js initializes Express, loads routes
- controllers (libro, prestamos, multas) implement business logic
- services layer invoked by controllers
- middleware/auth.js for JWT or Keycloak token validation
- routes files map HTTP endpoints to controllers
- prisma/client.js exports the Prisma database client
- Frontend:
- public/ contains index.html, manifest, robots.txt
- src/ contains App.js, global styles, entry index.js
- components/ UI building blocks (BookCard, LoanTable, Navbar, etc.)
- pages/ top-level routes (BooksPage, MyLoansPage, LoginPage, etc.)
- context/AuthContext for user state
- keycloak.js handles the Keycloak adapter
- mocks/ sample JSON for offline testing
- routes/AppRouter.jsx wires React Router

##### Additional Insights from README
- Backend uses Express, Prisma ORM with PostgreSQL, environment variables loaded via dotenv.
- Instructions for validating Prisma schema and testing DB connection via a simple script.

- Frontend SPA (React + React Router + AuthContext + Keycloak adapter)
- Backend API Server (Express app)
- Prisma ORM (Prisma client + schema)
- PostgreSQL Database
- External Auth Provider (Keycloak)
- (Optional) Static hosting/CDN for frontend assets
- User’s browser → SPA (HTTP/HTTPS)
- SPA → Keycloak (OIDC/OpenID Connect) for login → Keycloak → SPA (token)
- SPA → API Server (REST calls, JWT in Authorization header)
- API Server → Prisma client → PostgreSQL
- API Server applies auth middleware before protected routes
- Seed script or CI pipelines can modify the database
c. Architectural Patterns
- Frontend: component-based UI, context for global auth state, route-based code splitting
- Backend: layered MVC-style organization (routes → middleware → controllers → services → data layer)
- ORM pattern via Prisma
d. Key Technologies
- React, React Router, Context API, Keycloak JavaScript adapter
- Node.js, Express.js, Prisma ORM, PostgreSQL, dotenv

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Client Tier
  subgraph "Client (Browser)"
    Browser((User Browser)):::external
    subgraph "Frontend SPA"
      AIndex["index.js"]:::frontend
      App["App.js"]:::frontend
      Router["AppRouter.jsx"]:::frontend
      AuthC["AuthContext.jsx"]:::frontend
      KC["keycloak.js"]:::frontend
      subgraph "Components"
        BC["BookCard.jsx"]:::frontend
        BD["BookDetails.jsx"]:::frontend
        LT["LoanTable.jsx"]:::frontend
        NB["Navbar.jsx"]:::frontend
      end
      subgraph "Pages"
        BP["BooksPage.jsx"]:::frontend
        BDP["BookDetailPage.jsx"]:::frontend
        ML["MyLoansPage.jsx"]:::frontend
        LP["LoginPage.jsx"]:::frontend
        NF["NotFound.jsx"]:::frontend
      end
      subgraph "Mocks"
        M1["libros.json"]:::frontend
        M2["prestamos.json"]:::frontend
      end
      Public["index.html"]:::frontend
    end
  end

  %% Server Tier
  subgraph "Server"
    APIServer["Express API Server (app.js)"]:::backend
    AuthMW["Auth Middleware (auth.js)"]:::backend
    subgraph "Routes"
      RAuth["auth.js"]:::backend
      RLib["libro.routes.js"]:::backend
      RPres["prestamos.routes.js"]:::backend
      RMult["multas.routes.js"]:::backend
    end
    subgraph "Controllers"
      CLib["libro.controller.js"]:::backend
      CPres["prestamos.controller.js"]:::backend
      CMult["multas.controller.js"]:::backend
    end
    SLib["libro.service.js"]:::backend
    PrismaClient["Prisma Client (client.js)"]:::backend
    Schema["schema.prisma"]:::backend
    Seed["seed.ts"]:::backend
    TestConn["test_connection.js"]:::backend
    subgraph "Utils"
      UConst["constants.js"]:::backend
      UDate["date.utils.js"]:::backend
    end
  end

  %% External Services
  DB["PostgreSQL Database"]:::database
  KCServer(("Keycloak Auth Server")):::external
  CDN["Static Hosting/CDN"]:::external

  %% Data Flows
  Browser -->|HTTPS| Public
  Browser -->|loads| AIndex
  AIndex --> App
  App --> Router
  App --> AuthC
  App --> KC
  Router --> BP
  Router --> BDP
  Router --> ML
  Router --> LP
  Router --> NF
  App --> BC
  App --> BD
  App --> LT
  App --> NB
  App --> M1
  App --> M2

  Browser -->|OIDC/Auth| KCServer
  KCServer -->|Token| App

  App -->|REST JSON| APIServer
  APIServer --> AuthMW
  AuthMW --> RAuth
  AuthMW --> RLib
  AuthMW --> RPres
  AuthMW --> RMult
  RLib --> CLib
  RPres --> CPres
  RMult --> CMult
  CLib --> SLib
  SLib --> PrismaClient
  CLib --> PrismaClient
  PrismaClient -->|SQL| DB

  Seed -->|Seeds DB| DB
  TestConn -->|Connects| DB
  CDN -->|Hosts| Public

  %% Click Events
  click AIndex "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/index.js"
  click App "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/App.js"
  click Router "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/routes/AppRouter.jsx"
  click AuthC "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/context/AuthContext.jsx"
  click KC "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/keycloak.js"
  click BC "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/components/BookCard.jsx"
  click BD "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/components/BookDetails.jsx"
  click LT "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/components/LoanTable.jsx"
  click NB "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/components/Navbar.jsx"
  click BP "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/pages/BooksPage.jsx"
  click BDP "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/pages/BookDetailPage.jsx"
  click ML "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/pages/MyLoansPage.jsx"
  click LP "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/pages/LoginPage.jsx"
  click NF "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/pages/NotFound.jsx"
  click M1 "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/mocks/libros.json"
  click M2 "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/src/mocks/prestamos.json"
  click Public "https://github.com/bidobelemti/examen_isw613/blob/main/frontend/public/index.html"
  click APIServer "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/app.js"
  click AuthMW "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/middleware/auth.js"
  click RAuth "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/routes/auth.js"
  click RLib "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/routes/libro.routes.js"
  click RPres "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/routes/prestamos.routes.js"
  click RMult "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/routes/multas.routes.js"
  click CLib "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/controllers/libro.controller.js"
  click CPres "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/controllers/prestamos.controller.js"
  click CMult "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/controllers/multas.controller.js"
  click SLib "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/services/libro.service.js"
  click PrismaClient "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/prisma/client.js"
  click Schema "https://github.com/bidobelemti/examen_isw613/blob/main/backend/prisma/schema.prisma"
  click Seed "https://github.com/bidobelemti/examen_isw613/blob/main/backend/prisma/seed.ts"
  click TestConn "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/test_connection.js"
  click UConst "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/utils/constants.js"
  click UDate "https://github.com/bidobelemti/examen_isw613/blob/main/backend/src/utils/date.utils.js"

  %% Styles
  classDef frontend fill:#D0E8FF,stroke:#333,stroke-width:1px
  classDef backend fill:#D0F0C0,stroke:#333,stroke-width:1px
  classDef external fill:#FFE080,stroke:#333,stroke-width:1px
  classDef database fill:#DDDDDD,stroke:#333,stroke-width:1px
```
