# ignaci0vidal/ifts16-i.vidal-api-peritos-forenses architecture

> Architecture diagram of the GitHub repository ignaci0vidal/ifts16-i.vidal-api-peritos-forenses, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses
- Repository: https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses

## Overview

This is a REST API for managing forensic-expert users and their roles. A client sends requests through the Express application and peritos routes to handlers that validate input, query or update user and role records, and return JSON; logical deactivation preserves records while excluding them from active-user queries. The README also documents SQLite and PostgreSQL support, role filtering, request logging, and centralized JSON errors. Source excerpts show the main request wiring and model access; the database is documented, but its deployed instance is not inspected.

Main entry points: [`src/app.js`](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/app.js) (Express App), [`src/controllers/peritos.controller.js`](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/controllers/peritos.controller.js) (Perito Handlers), [`src/config/database.js`](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/config/database.js) (Database Config), [`src/utils/logger.js`](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/utils/logger.js) (Request and Event Logger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["Express App<br/>[app.js]"]
  node_routes["Perito Routes<br/>[peritos.routes.js]"]
  node_errors["Error Handler<br/>[errorHandler.js]"]
end

subgraph group_domain["Perito Management"]
  node_controller["Perito Handlers"]
end

subgraph group_persistence["Persistence"]
  node_user["User Model<br/>[user.js]"]
  node_role["Role Model<br/>[role.js]"]
  node_associations["Model Associations<br/>[index.js]"]
  node_database["Database Config<br/>[database.js]"]
  node_store[("SQLite / PostgreSQL")]
end

subgraph group_operations["Runtime Support"]
  node_server["Server Startup<br/>[server.js]"]
  node_logger["Request and Event Logger<br/>[logger.js]"]
end

node_client(("API Client"))

node_client -->|"sends HTTP requests"| node_app
node_server -->|"starts"| node_app
node_server -->|"authenticates and syncs"| node_database
node_server -->|"logs startup"| node_logger
node_app -->|"mounts routes"| node_routes
node_app -->|"handles errors with"| node_errors
node_app -->|"formats HTTP logs with"| node_logger
node_routes -->|"dispatches requests"| node_controller
node_controller -->|"queries and updates"| node_user
node_controller -->|"checks and filters by role"| node_role
node_controller -->|"logs user events"| node_logger
node_errors -->|"logs errors"| node_logger
node_associations -->|"associates models"| node_user
node_associations -->|"associates models"| node_role
node_user -->|"defines model on"| node_database
node_role -->|"defines model on"| node_database
node_database -.->|"connects via Sequelize"| node_store

click node_server "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/server.js"
click node_app "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/app.js"
click node_routes "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/routes/peritos.routes.js"
click node_controller "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/controllers/peritos.controller.js"
click node_user "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/models/user.js"
click node_role "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/models/role.js"
click node_associations "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/models/index.js"
click node_database "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/config/database.js"
click node_errors "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/middlewares/errorHandler.js"
click node_logger "https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/utils/logger.js"

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_routes,node_errors,node_client toneBlue
class node_controller toneAmber
class node_user,node_role,node_associations,node_database,node_store toneMint
class node_server,node_logger toneRose
```

## Components

### HTTP API

- [Express App](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/app.js): `src/app.js`
- [Perito Routes](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/routes/peritos.routes.js): `src/routes/peritos.routes.js`
- [Error Handler](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/middlewares/errorHandler.js): `src/middlewares/errorHandler.js`

### Perito Management

- [Perito Handlers](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/controllers/peritos.controller.js): `src/controllers/peritos.controller.js`

### Persistence

- [User Model](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/models/user.js): `src/models/user.js`
- [Role Model](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/models/role.js): `src/models/role.js`
- [Model Associations](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/models/index.js): `src/models/index.js`
- [Database Config](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/config/database.js): `src/config/database.js`
- **SQLite / PostgreSQL**

### Runtime Support

- [Server Startup](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/server.js): `src/server.js`
- [Request and Event Logger](https://github.com/ignaci0vidal/ifts16-i.vidal-api-peritos-forenses/blob/main/src/utils/logger.js): `src/utils/logger.js`

### Other components

- **API Client**

## Connections

- API Client → Express App: sends HTTP requests (evidence: `README.md`)
- Server Startup → Express App: starts (evidence: `src/server.js`)
- Server Startup → Database Config: authenticates and syncs (evidence: `src/server.js`)
- Server Startup → Request and Event Logger: logs startup (evidence: `src/server.js`)
- Express App → Perito Routes: mounts routes (evidence: `src/app.js`)
- Express App → Error Handler: handles errors with (evidence: `src/app.js`)
- Express App → Request and Event Logger: formats HTTP logs with (evidence: `src/app.js`)
- Perito Routes → Perito Handlers: dispatches requests (evidence: `src/routes/peritos.routes.js`)
- Perito Handlers → User Model: queries and updates (evidence: `src/controllers/peritos.controller.js`)
- Perito Handlers → Role Model: checks and filters by role (evidence: `src/controllers/peritos.controller.js`)
- Perito Handlers → Request and Event Logger: logs user events (evidence: `src/controllers/peritos.controller.js`)
- Error Handler → Request and Event Logger: logs errors (evidence: `src/middlewares/errorHandler.js`)
- Model Associations → User Model: associates models (evidence: `src/models/index.js`)
- Model Associations → Role Model: associates models (evidence: `src/models/index.js`)
- User Model → Database Config: defines model on (evidence: `src/models/user.js`)
- Role Model → Database Config: defines model on (evidence: `src/models/role.js`)
- Database Config → SQLite / PostgreSQL: connects via Sequelize
