How nikkkitosss/library-management-system works
This is an Express backend for a library management system. Requests enter through the HTTP routes, pass applicable validation and authorization, reach controllers, and then invoke domain services; services use Prisma for persistent user, book, and loan operations. Major workflows cover authentication and password recovery, catalog administration, user profiles and avatar management, and loan creation/return/listing. Sampled source confirms the auth, book, and avatar call paths; the README documents loan and SMTP capabilities whose implementation details were not fully sampled.
Main entry points: index.ts Route Mounts · client.ts Prisma Client · auth.routes.ts Auth Routes · books.routes.ts Book Routes
Components 26
HTTP API
- Server Startup
src/server.ts - Express App
src/app.ts - Route Mounts
src/routes/index.ts - Auth Routes
src/routes/auth.routes.ts - Book Routes
src/routes/books.routes.ts - Loan Routes
src/routes/loans.routes.ts - User Routes
src/routes/users.routes.ts - Auth Controller
src/controllers/authController.ts - Book Controller
src/controllers/bookController.ts - Loan Controller
src/controllers/loanController.ts - User Controller
src/controllers/userController.ts
Domain Services
- Authentication
src/services/authService.ts - Book Catalog
src/services/bookService.ts - Loan Management
src/services/loanService.ts - User Management
src/services/userService.ts
Shared Infrastructure
- Request Schemas
src/schemas/index.ts - JWT Authorization
src/middleware/auth.middleware.ts - Upload Middleware
src/middleware/upload.middleware.ts - Configuration
src/config.ts - Email Delivery
src/utils/sendMail.ts - Avatar Processing
src/utils/avatarFiles.ts
Persistence and Files
- Prisma Client
src/db/client.ts - Library Database
prisma/schema.prisma - Avatar Files
src/app.ts
Other components
- API Client
- SMTP Service
Connections 34
- API Client → Express App: sends requests
README.md - Server Startup → Express App: starts
src/server.ts - Express App → Route Mounts: mounts
src/app.ts - Route Mounts → Auth Routes: registers
src/routes/index.ts - Route Mounts → Book Routes: registers
src/routes/index.ts - Route Mounts → Loan Routes: registers
src/routes/index.ts - Route Mounts → User Routes: registers
src/routes/index.ts - Auth Routes → Auth Controller: dispatches
src/routes/auth.routes.ts - Book Routes → Book Controller: dispatches
src/routes/books.routes.ts - Loan Routes → Loan Controller: dispatches
src/routes/loans.routes.ts - User Routes → User Controller: dispatches
src/routes/users.routes.ts - Auth Routes → Request Schemas: validates with
src/routes/auth.routes.ts - Book Routes → Request Schemas: validates with
src/routes/books.routes.ts - Loan Routes → Request Schemas: validates with
src/routes/loans.routes.ts - Auth Routes → JWT Authorization: protects logout
src/routes/auth.routes.ts - Book Routes → JWT Authorization: checks roles
src/routes/books.routes.ts - User Routes → JWT Authorization: protects routes
src/routes/users.routes.ts - User Routes → Upload Middleware: parses uploads
src/routes/users.routes.ts - Auth Controller → Authentication: invokes
src/controllers/authController.ts - Book Controller → Book Catalog: invokes
src/controllers/bookController.ts - Loan Controller → Loan Management: invokes
src/controllers/loanController.ts - User Controller → User Management: invokes
src/controllers/userController.ts - User Controller → Avatar Processing: processes images
src/controllers/userController.ts - Authentication → Prisma Client: queries
src/services/authService.ts - Book Catalog → Prisma Client: queries
src/services/bookService.ts - Loan Management → Prisma Client: queries
src/services/loanService.ts - User Management → Prisma Client: queries
src/services/userService.ts - Prisma Client → Library Database: accesses
- Authentication → Email Delivery: sends reset email
src/services/authService.ts - Email Delivery → SMTP Service: delivers email
README.md - Email Delivery → Configuration: reads settings
src/utils/sendMail.ts - Authentication → Configuration: uses token settings
- Avatar Processing → Avatar Files: writes images
- Express App → Avatar Files: serves uploads
src/app.ts