How bidobelemti/examen_isw613 works
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