# joaquing-eng/rest-api-node architecture

> Architecture diagram of the GitHub repository joaquing-eng/rest-api-node, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joaquing-eng/rest-api-node
- Repository: https://github.com/joaquing-eng/rest-api-node

## Overview

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: [`src/app.js`](https://github.com/joaquing-eng/rest-api-node/blob/main/src/app.js) (Express app), [`src/middlewares/Auth.Middleware.js`](https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Auth.Middleware.js) (JWT and roles), [`src/db/index.js`](https://github.com/joaquing-eng/rest-api-node/blob/main/src/db/index.js) (PostgreSQL pool), [`src/routes/Authors.Routes.js`](https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Authors.Routes.js) (Author routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP entry"]
  node_app["Express app<br/>[app.js]"]
  node_errors["Error handling"]
end

subgraph group_security["Identity and access"]
  node_auth_routes["Auth routes<br/>[Auth.Routes.js]"]
  node_auth_controller["Auth controller<br/>[Auth.Controller.js]"]
  node_auth_service["Auth service<br/>[Auth.Service.js]"]
  node_auth_middleware["JWT and roles<br/>[Auth.Middleware.js]"]
end

subgraph group_content["Blog content"]
  node_authors_routes["Author routes<br/>[Authors.Routes.js]"]
  node_authors_validation["Author validation"]
  node_authors_controller["Author controller"]
  node_authors_service["Author service"]
  node_posts_routes["Post routes<br/>[Posts.Routes.js]"]
  node_posts_validation["Post validation<br/>[Validate.Posts.js]"]
  node_posts_controller["Post controller"]
  node_posts_service["Post service<br/>[Posts.Services.js]"]
  node_trash_routes["Trash routes<br/>[Trash.Routes.js]"]
  node_trash_controller["Trash controller"]
  node_trash_service["Trash service<br/>[Trash.Service.js]"]
end

subgraph group_accounts["Users and media"]
  node_users_routes["User routes<br/>[Users.Routes.js]"]
  node_users_controller["User controller"]
  node_users_service["User service<br/>[Users.Service.js]"]
  node_upload["Avatar uploads"]
end

subgraph group_persistence["Persistence and contract"]
  node_db_pool["PostgreSQL pool<br/>[index.js]"]
  node_database[("PostgreSQL<br/>[schema.sql]")]
  node_openapi["OpenAPI contract<br/>[swagger.yaml]"]
end

node_client(("API client"))

node_client -->|"sends request"| node_app
node_app -->|"mounts routes"| node_auth_routes
node_app -->|"mounts routes"| node_users_routes
node_app -->|"mounts routes"| node_authors_routes
node_app -->|"mounts routes"| node_posts_routes
node_app -->|"mounts routes"| node_trash_routes
node_app -->|"uses handler"| node_errors
node_app -->|"loads contract"| node_openapi
node_auth_routes -->|"routes to"| node_auth_controller
node_auth_routes -->|"uses auth"| node_auth_middleware
node_auth_middleware -->|"loads user"| node_auth_service
node_auth_controller -->|"delegates"| node_auth_service
node_users_routes -->|"protects routes"| node_auth_middleware
node_users_routes -->|"uses upload"| node_upload
node_users_routes -->|"routes to"| node_users_controller
node_users_controller -->|"delegates"| node_users_service
node_authors_routes -->|"protects writes"| node_auth_middleware
node_authors_routes -->|"validates input"| node_authors_validation
node_authors_routes -->|"uses upload"| node_upload
node_authors_routes -->|"routes to"| node_authors_controller
node_authors_controller -->|"delegates"| node_authors_service
node_posts_routes -->|"protects writes"| node_auth_middleware
node_posts_routes -->|"validates input"| node_posts_validation
node_posts_routes -->|"routes to"| node_posts_controller
node_posts_controller -->|"delegates"| node_posts_service
node_trash_routes -->|"protects routes"| node_auth_middleware
node_trash_routes -->|"routes to"| node_trash_controller
node_trash_controller -->|"delegates"| node_trash_service
node_auth_service -->|"queries"| node_db_pool
node_users_service -->|"queries"| node_db_pool
node_authors_service -->|"queries"| node_db_pool
node_posts_service -->|"queries"| node_db_pool
node_trash_service -->|"queries"| node_db_pool
node_db_pool -.->|"connects to"| node_database

click node_app "https://github.com/joaquing-eng/rest-api-node/blob/main/src/app.js"
click node_errors "https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Error.Middlewares.js"
click node_auth_routes "https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Auth.Routes.js"
click node_auth_controller "https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Auth.Controller.js"
click node_auth_service "https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Auth.Service.js"
click node_auth_middleware "https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Auth.Middleware.js"
click node_users_routes "https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Users.Routes.js"
click node_users_controller "https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Users.Controller.js"
click node_users_service "https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Users.Service.js"
click node_upload "https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Upload.Middleware.js"
click node_authors_routes "https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Authors.Routes.js"
click node_authors_validation "https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Validate.Authors.js"
click node_authors_controller "https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Authors.Controller.js"
click node_authors_service "https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Authors.Services.js"
click node_posts_routes "https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Posts.Routes.js"
click node_posts_validation "https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Validate.Posts.js"
click node_posts_controller "https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Post.Controllers.js"
click node_posts_service "https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Posts.Services.js"
click node_trash_routes "https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Trash.Routes.js"
click node_trash_controller "https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Trash.Controller.js"
click node_trash_service "https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Trash.Service.js"
click node_db_pool "https://github.com/joaquing-eng/rest-api-node/blob/main/src/db/index.js"
click node_database "https://github.com/joaquing-eng/rest-api-node/blob/main/sql/schema.sql"
click node_openapi "https://github.com/joaquing-eng/rest-api-node/blob/main/src/yaml/swagger.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_errors,node_client toneBlue
class node_auth_routes,node_auth_controller,node_auth_service,node_auth_middleware toneAmber
class node_authors_routes,node_authors_validation,node_authors_controller,node_authors_service,node_posts_routes,node_posts_validation,node_posts_controller,node_posts_service,node_trash_routes,node_trash_controller,node_trash_service toneMint
class node_users_routes,node_users_controller,node_users_service,node_upload toneRose
class node_db_pool,node_database,node_openapi toneIndigo
```

## Components

### HTTP entry

- [Express app](https://github.com/joaquing-eng/rest-api-node/blob/main/src/app.js): `src/app.js`
- [Error handling](https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Error.Middlewares.js): `src/middlewares/Error.Middlewares.js`

### Identity and access

- [Auth routes](https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Auth.Routes.js): `src/routes/Auth.Routes.js`
- [Auth controller](https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Auth.Controller.js): `src/controllers/Auth.Controller.js`
- [Auth service](https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Auth.Service.js): `src/services/Auth.Service.js`
- [JWT and roles](https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Auth.Middleware.js): `src/middlewares/Auth.Middleware.js`

### Blog content

- [Author routes](https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Authors.Routes.js): `src/routes/Authors.Routes.js`
- [Author validation](https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Validate.Authors.js): `src/middlewares/Validate.Authors.js`
- [Author controller](https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Authors.Controller.js): `src/controllers/Authors.Controller.js`
- [Author service](https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Authors.Services.js): `src/services/Authors.Services.js`
- [Post routes](https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Posts.Routes.js): `src/routes/Posts.Routes.js`
- [Post validation](https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Validate.Posts.js): `src/middlewares/Validate.Posts.js`
- [Post controller](https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Post.Controllers.js): `src/controllers/Post.Controllers.js`
- [Post service](https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Posts.Services.js): `src/services/Posts.Services.js`
- [Trash routes](https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Trash.Routes.js): `src/routes/Trash.Routes.js`
- [Trash controller](https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Trash.Controller.js): `src/controllers/Trash.Controller.js`
- [Trash service](https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Trash.Service.js): `src/services/Trash.Service.js`

### Users and media

- [User routes](https://github.com/joaquing-eng/rest-api-node/blob/main/src/routes/Users.Routes.js): `src/routes/Users.Routes.js`
- [User controller](https://github.com/joaquing-eng/rest-api-node/blob/main/src/controllers/Users.Controller.js): `src/controllers/Users.Controller.js`
- [User service](https://github.com/joaquing-eng/rest-api-node/blob/main/src/services/Users.Service.js): `src/services/Users.Service.js`
- [Avatar uploads](https://github.com/joaquing-eng/rest-api-node/blob/main/src/middlewares/Upload.Middleware.js): `src/middlewares/Upload.Middleware.js`

### Persistence and contract

- [PostgreSQL pool](https://github.com/joaquing-eng/rest-api-node/blob/main/src/db/index.js): `src/db/index.js`
- [PostgreSQL](https://github.com/joaquing-eng/rest-api-node/blob/main/sql/schema.sql): `sql/schema.sql`
- [OpenAPI contract](https://github.com/joaquing-eng/rest-api-node/blob/main/src/yaml/swagger.yaml): `src/yaml/swagger.yaml`

### Other components

- **API client**

## Connections

- API client → Express app: sends request (evidence: `README.md`)
- Express app → Auth routes: mounts routes (evidence: `src/app.js`)
- Express app → User routes: mounts routes (evidence: `src/app.js`)
- Express app → Author routes: mounts routes (evidence: `src/app.js`)
- Express app → Post routes: mounts routes (evidence: `src/app.js`)
- Express app → Trash routes: mounts routes (evidence: `src/app.js`)
- Express app → Error handling: uses handler (evidence: `src/app.js`)
- Express app → OpenAPI contract: loads contract (evidence: `src/app.js`)
- Auth routes → Auth controller: routes to (evidence: `src/routes/Auth.Routes.js`)
- Auth routes → JWT and roles: uses auth (evidence: `src/routes/Auth.Routes.js`)
- JWT and roles → Auth service: loads user (evidence: `src/middlewares/Auth.Middleware.js`)
- Auth controller → Auth service: delegates (evidence: `src/controllers/Auth.Controller.js`)
- User routes → JWT and roles: protects routes (evidence: `src/routes/Users.Routes.js`)
- User routes → Avatar uploads: uses upload (evidence: `src/routes/Users.Routes.js`)
- User routes → User controller: routes to (evidence: `src/routes/Users.Routes.js`)
- User controller → User service: delegates (evidence: `src/controllers/Users.Controller.js`)
- Author routes → JWT and roles: protects writes (evidence: `src/routes/Authors.Routes.js`)
- Author routes → Author validation: validates input (evidence: `src/routes/Authors.Routes.js`)
- Author routes → Avatar uploads: uses upload (evidence: `src/routes/Authors.Routes.js`)
- Author routes → Author controller: routes to (evidence: `src/routes/Authors.Routes.js`)
- Author controller → Author service: delegates (evidence: `src/controllers/Authors.Controller.js`)
- Post routes → JWT and roles: protects writes (evidence: `src/routes/Posts.Routes.js`)
- Post routes → Post validation: validates input (evidence: `src/routes/Posts.Routes.js`)
- Post routes → Post controller: routes to (evidence: `src/routes/Posts.Routes.js`)
- Post controller → Post service: delegates (evidence: `src/controllers/Post.Controllers.js`)
- Trash routes → JWT and roles: protects routes (evidence: `src/routes/Trash.Routes.js`)
- Trash routes → Trash controller: routes to (evidence: `src/routes/Trash.Routes.js`)
- Trash controller → Trash service: delegates (evidence: `src/controllers/Trash.Controller.js`)
- Auth service → PostgreSQL pool: queries (evidence: `src/services/Auth.Service.js`)
- User service → PostgreSQL pool: queries (evidence: `src/services/Users.Service.js`)
- Author service → PostgreSQL pool: queries (evidence: `src/services/Authors.Services.js`)
- Post service → PostgreSQL pool: queries (evidence: `src/services/Posts.Services.js`)
- Trash service → PostgreSQL pool: queries (evidence: `src/services/Trash.Service.js`)
- PostgreSQL pool → PostgreSQL: connects to
