How joaquing-eng/rest-api-node works
This is a Node.js/Express blog REST API. The principal workflow is an HTTP request entering the app, passing through a feature route and any authentication, role, validation, or upload middleware, then reaching a controller and service that performs PostgreSQL-backed work. The product also covers JWT registration/login, user profiles and roles, author and post management, avatar uploads, soft-delete trash operations with audit logging, and OpenAPI documentation. Service-to-database links follow the documented layering and service imports; unsampled feature wiring is limited to relationships documented or indexed.
Main entry points: app.js Express app · Auth.Middleware.js JWT and roles · index.js PostgreSQL pool · Authors.Routes.js Author routes
Components 25
HTTP entry
- Express app
src/app.js - Error handling
src/middlewares/Error.Middlewares.js
Identity and access
- Auth routes
src/routes/Auth.Routes.js - Auth controller
src/controllers/Auth.Controller.js - Auth service
src/services/Auth.Service.js - JWT and roles
src/middlewares/Auth.Middleware.js
Blog content
- Author routes
src/routes/Authors.Routes.js - Author validation
src/middlewares/Validate.Authors.js - Author controller
src/controllers/Authors.Controller.js - Author service
src/services/Authors.Services.js - Post routes
src/routes/Posts.Routes.js - Post validation
src/middlewares/Validate.Posts.js - Post controller
src/controllers/Post.Controllers.js - Post service
src/services/Posts.Services.js - Trash routes
src/routes/Trash.Routes.js - Trash controller
src/controllers/Trash.Controller.js - Trash service
src/services/Trash.Service.js
Users and media
- User routes
src/routes/Users.Routes.js - User controller
src/controllers/Users.Controller.js - User service
src/services/Users.Service.js - Avatar uploads
src/middlewares/Upload.Middleware.js
Persistence and contract
- PostgreSQL pool
src/db/index.js - PostgreSQL
sql/schema.sql - OpenAPI contract
src/yaml/swagger.yaml
Other components
- API client
Connections 34
- API client → Express app: sends request
README.md - Express app → Auth routes: mounts routes
src/app.js - Express app → User routes: mounts routes
src/app.js - Express app → Author routes: mounts routes
src/app.js - Express app → Post routes: mounts routes
src/app.js - Express app → Trash routes: mounts routes
src/app.js - Express app → Error handling: uses handler
src/app.js - Express app → OpenAPI contract: loads contract
src/app.js - Auth routes → Auth controller: routes to
src/routes/Auth.Routes.js - Auth routes → JWT and roles: uses auth
src/routes/Auth.Routes.js - JWT and roles → Auth service: loads user
src/middlewares/Auth.Middleware.js - Auth controller → Auth service: delegates
src/controllers/Auth.Controller.js - User routes → JWT and roles: protects routes
src/routes/Users.Routes.js - User routes → Avatar uploads: uses upload
src/routes/Users.Routes.js - User routes → User controller: routes to
src/routes/Users.Routes.js - User controller → User service: delegates
src/controllers/Users.Controller.js - Author routes → JWT and roles: protects writes
src/routes/Authors.Routes.js - Author routes → Author validation: validates input
src/routes/Authors.Routes.js - Author routes → Avatar uploads: uses upload
src/routes/Authors.Routes.js - Author routes → Author controller: routes to
src/routes/Authors.Routes.js - Author controller → Author service: delegates
src/controllers/Authors.Controller.js - Post routes → JWT and roles: protects writes
src/routes/Posts.Routes.js - Post routes → Post validation: validates input
src/routes/Posts.Routes.js - Post routes → Post controller: routes to
src/routes/Posts.Routes.js - Post controller → Post service: delegates
src/controllers/Post.Controllers.js - Trash routes → JWT and roles: protects routes
src/routes/Trash.Routes.js - Trash routes → Trash controller: routes to
src/routes/Trash.Routes.js - Trash controller → Trash service: delegates
src/controllers/Trash.Controller.js - Auth service → PostgreSQL pool: queries
src/services/Auth.Service.js - User service → PostgreSQL pool: queries
src/services/Users.Service.js - Author service → PostgreSQL pool: queries
src/services/Authors.Services.js - Post service → PostgreSQL pool: queries
src/services/Posts.Services.js - Trash service → PostgreSQL pool: queries
src/services/Trash.Service.js - PostgreSQL pool → PostgreSQL: connects to