How kaibabenja/fullreservasapi works
Project type and purpose
• This is a TypeScript-based Node.js RESTful API ("fullreservas-api") providing reservation functionality for shops (e.g., restaurants).
• It follows a modular, layered architecture: each domain (address, bookings, contentblocks, memberships, shops, users) has its own controllers, services, models, routes, schemas and types.
• Key features (inferred from file tree): CRUD endpoints per domain, email notifications, file uploads, input validation, Swagger documentation, MySQL persistence via Sequelize, external integrations (Firebase, Cloudflare, Nodemailer).
File structure
• Top-level:
• src/app.ts – Express app setup and startup
• src/config – environment, database, middleware, external-service configs
• src/middlewares – request pre-processors (file upload, schema validation)
• src/modules – domain folders, each containing MVC + service + types + schemas
• src/routes – main router aggregator
• src/swagger-ui + src/swagger – API documentation setup
• src/utils – shared utilities (error handling, formatters, validators)
• Config & deployment files: .env.example, tsconfig.json, vercel.json
• Database: MySQL with Sequelize (initAssociations.ts, sequelize.config.ts).