# camilomvj/proyectodsi architecture

> Architecture diagram of the GitHub repository camilomvj/proyectodsi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/camilomvj/proyectodsi
- Repository: https://github.com/camilomvj/proyectodsi

## Overview

This repository’s product runtime is a Spanish-language tourism and business-management API: clients submit resource requests, which are routed through validation and service logic to persistence, then receive JSON responses. Its domain includes tourist places and attractions, businesses and services, events, menus, advertising, users, and related records. The frontend is an unmodified React/Vite starter rather than a demonstrated product interface. The source index supports several service-to-repository links, but many route registrations and domain implementations were not excerpted; those uncertain connections are omitted.

Main entry points: [`backend/src/services/services.routes.js`](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/services.routes.js) (Service routes), [`backend/src/db/db.js`](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/db/db.js) (Postgres pool), [`backend/src/services/usuarios.service.js`](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/usuarios.service.js) (User accounts), [`backend/src/services/service-utils.js`](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/service-utils.js) (Service utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_server["HTTP server<br/>[server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_route_index["Route index<br/>[index.js]"]
  node_service_router["Service routes<br/>[services.routes.js]"]
  node_validation["Request validation"]
  node_update_schemas["Update schemas<br/>[update.dto.js]"]
end

subgraph group_domain["Tourism domain"]
  node_places_service["Places and attractions"]
  node_complex_service["Tourist complexes"]
  node_attractions_service["Independent attractions"]
  node_events_service["National events"]
  node_categories_service["Categories"]
end

subgraph group_commerce["Business services"]
  node_business_service["Business services"]
  node_campaign_service["Advertising campaigns"]
  node_menus_service["Menus and items<br/>[menus.service.js]"]
end

subgraph group_identity["Identity and access"]
  node_users_service["User accounts"]
  node_auth["Authentication<br/>[auth.middleware.js]"]
end

subgraph group_persistence["Persistence"]
  node_service_utils["Service utilities<br/>[service-utils.js]"]
  node_db_pool[("Postgres pool<br/>[db.js]")]
  node_places_repo["Places repository"]
  node_owners_repo["Owners repository"]
  node_users_repo["Users repository"]
  node_business_repo["Business repository"]
  node_campaign_repo["Campaign repository"]
  node_categories_repo["Categories repository"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_server
node_server -->|"starts"| node_app
node_app -->|"mounts API"| node_route_index
node_route_index -.->|"routes to"| node_service_router
node_service_router -->|"validates requests"| node_validation
node_service_router -->|"uses schemas"| node_update_schemas
node_service_router -->|"dispatches to"| node_places_service
node_service_router -->|"dispatches to"| node_events_service
node_service_router -->|"dispatches to"| node_categories_service
node_service_router -->|"dispatches to"| node_business_service
node_service_router -->|"dispatches to"| node_campaign_service
node_service_router -->|"dispatches to"| node_menus_service
node_service_router -->|"dispatches to"| node_users_service
node_places_service -.->|"uses helpers"| node_service_utils
node_complex_service -->|"creates places"| node_places_repo
node_complex_service -->|"checks owners"| node_owners_repo
node_attractions_service -->|"creates places"| node_places_repo
node_attractions_service -->|"checks owners"| node_owners_repo
node_events_service -.->|"uses helpers"| node_service_utils
node_categories_service -->|"queries"| node_categories_repo
node_business_service -->|"queries"| node_business_repo
node_campaign_service -->|"queries"| node_campaign_repo
node_users_service -->|"queries"| node_users_repo
node_users_service -.->|"issues JWT"| node_auth
node_service_utils -->|"opens transactions"| node_db_pool
node_places_repo -->|"queries"| node_db_pool
node_owners_repo -->|"queries"| node_db_pool
node_users_repo -->|"queries"| node_db_pool

click node_server "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/server.js"
click node_app "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/app.js"
click node_route_index "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/routes/index.js"
click node_service_router "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/services.routes.js"
click node_validation "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/middlewares/validacion.middleware.js"
click node_update_schemas "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/dtos/update.dto.js"
click node_places_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/lugares_turisticos.service.js"
click node_complex_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/complejos_turisticos.service.js"
click node_attractions_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/atractivos_independientes.service.js"
click node_events_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/eventos_nacionales.service.js"
click node_categories_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/categorias.service.js"
click node_business_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/servicios.service.js"
click node_campaign_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/campanias_publicitarias.service.js"
click node_menus_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/menus.service.js"
click node_users_service "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/usuarios.service.js"
click node_auth "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/middlewares/auth.middleware.js"
click node_service_utils "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/service-utils.js"
click node_db_pool "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/db/db.js"
click node_places_repo "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/lugares_turisticos.repository.js"
click node_owners_repo "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/propietarios_negocios.repository.js"
click node_users_repo "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/usuarios.repository.js"
click node_business_repo "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/servicios.repository.js"
click node_campaign_repo "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/campanias_publicitarias.repository.js"
click node_categories_repo "https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/categorias.repository.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_server,node_app,node_route_index,node_service_router,node_validation,node_update_schemas,node_client toneBlue
class node_places_service,node_complex_service,node_attractions_service,node_events_service,node_categories_service toneAmber
class node_business_service,node_campaign_service,node_menus_service toneMint
class node_users_service,node_auth toneRose
class node_service_utils,node_db_pool,node_places_repo,node_owners_repo,node_users_repo,node_business_repo,node_campaign_repo,node_categories_repo toneIndigo
```

## Components

### API runtime

- [HTTP server](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/server.js): `backend/src/server.js`
- [Express app](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/app.js): `backend/src/app.js`
- [Route index](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Service routes](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/services.routes.js): `backend/src/services/services.routes.js`
- [Request validation](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/middlewares/validacion.middleware.js): `backend/src/middlewares/validacion.middleware.js`
- [Update schemas](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/dtos/update.dto.js): `backend/src/dtos/update.dto.js`

### Tourism domain

- [Places and attractions](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/lugares_turisticos.service.js): `backend/src/services/lugares_turisticos.service.js`
- [Tourist complexes](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/complejos_turisticos.service.js): `backend/src/services/complejos_turisticos.service.js`
- [Independent attractions](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/atractivos_independientes.service.js): `backend/src/services/atractivos_independientes.service.js`
- [National events](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/eventos_nacionales.service.js): `backend/src/services/eventos_nacionales.service.js`
- [Categories](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/categorias.service.js): `backend/src/services/categorias.service.js`

### Business services

- [Business services](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/servicios.service.js): `backend/src/services/servicios.service.js`
- [Advertising campaigns](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/campanias_publicitarias.service.js): `backend/src/services/campanias_publicitarias.service.js`
- [Menus and items](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/menus.service.js): `backend/src/services/menus.service.js`

### Identity and access

- [User accounts](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/usuarios.service.js): `backend/src/services/usuarios.service.js`
- [Authentication](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/middlewares/auth.middleware.js): `backend/src/middlewares/auth.middleware.js`

### Persistence

- [Service utilities](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/services/service-utils.js): `backend/src/services/service-utils.js`
- [Postgres pool](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/db/db.js): `backend/src/db/db.js`
- [Places repository](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/lugares_turisticos.repository.js): `backend/src/repositories/lugares_turisticos.repository.js`
- [Owners repository](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/propietarios_negocios.repository.js): `backend/src/repositories/propietarios_negocios.repository.js`
- [Users repository](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/usuarios.repository.js): `backend/src/repositories/usuarios.repository.js`
- [Business repository](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/servicios.repository.js): `backend/src/repositories/servicios.repository.js`
- [Campaign repository](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/campanias_publicitarias.repository.js): `backend/src/repositories/campanias_publicitarias.repository.js`
- [Categories repository](https://github.com/camilomvj/proyectodsi/blob/main/backend/src/repositories/categorias.repository.js): `backend/src/repositories/categorias.repository.js`

### Other components

- **API client**

## Connections

- API client → HTTP server: sends requests
- HTTP server → Express app: starts (evidence: `backend/src/server.js`)
- Express app → Route index: mounts API (evidence: `backend/src/app.js`)
- Route index → Service routes: routes to
- Service routes → Request validation: validates requests (evidence: `backend/src/services/services.routes.js`)
- Service routes → Update schemas: uses schemas (evidence: `backend/src/services/services.routes.js`)
- Service routes → Places and attractions: dispatches to (evidence: `backend/src/services/services.routes.js`)
- Service routes → National events: dispatches to (evidence: `backend/src/services/services.routes.js`)
- Service routes → Categories: dispatches to (evidence: `backend/src/services/services.routes.js`)
- Service routes → Business services: dispatches to (evidence: `backend/src/services/services.routes.js`)
- Service routes → Advertising campaigns: dispatches to (evidence: `backend/src/services/services.routes.js`)
- Service routes → Menus and items: dispatches to (evidence: `backend/src/services/services.routes.js`)
- Service routes → User accounts: dispatches to (evidence: `backend/src/services/services.routes.js`)
- Places and attractions → Service utilities: uses helpers
- Tourist complexes → Places repository: creates places (evidence: `backend/src/services/complejos_turisticos.service.js`)
- Tourist complexes → Owners repository: checks owners (evidence: `backend/src/services/complejos_turisticos.service.js`)
- Independent attractions → Places repository: creates places (evidence: `backend/src/services/atractivos_independientes.service.js`)
- Independent attractions → Owners repository: checks owners (evidence: `backend/src/services/atractivos_independientes.service.js`)
- National events → Service utilities: uses helpers
- Categories → Categories repository: queries (evidence: `backend/src/services/categorias.service.js`)
- Business services → Business repository: queries (evidence: `backend/src/services/servicios.service.js`)
- Advertising campaigns → Campaign repository: queries (evidence: `backend/src/services/campanias_publicitarias.service.js`)
- User accounts → Users repository: queries (evidence: `backend/src/services/usuarios.service.js`)
- User accounts → Authentication: issues JWT
- Service utilities → Postgres pool: opens transactions (evidence: `backend/src/services/service-utils.js`)
- Places repository → Postgres pool: queries (evidence: `backend/src/repositories/lugares_turisticos.repository.js`)
- Owners repository → Postgres pool: queries (evidence: `backend/src/repositories/propietarios_negocios.repository.js`)
- Users repository → Postgres pool: queries (evidence: `backend/src/repositories/usuarios.repository.js`)
