# angelalop03/tripeas-backend architecture

> Architecture diagram of the GitHub repository angelalop03/tripeas-backend, 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/angelalop03/tripeas-backend
- Repository: https://github.com/angelalop03/tripeas-backend

## Overview

TripEas is a travel-group backend API. Clients send requests through Express routes to domain controllers; the controllers implement account, trip, participant, expense, itinerary, list, roulette, document, and photo-album capabilities. The sampled expense workflow records shared costs and computes a minimal settlement. Supabase provides the configured backend client; the excerpts show direct Auth, database, and Storage operations in several controllers. Other controller-to-storage calls are not asserted where only imports were indexed.

Main entry points: [`src/app.js`](https://github.com/angelalop03/tripeas-backend/blob/main/src/app.js) (Express app), [`src/config/supabaseClient.js`](https://github.com/angelalop03/tripeas-backend/blob/main/src/config/supabaseClient.js) (Supabase client), [`src/controllers/gastosController.js`](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/gastosController.js) (Shared expenses), [`src/routes/authRoutes.js`](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/authRoutes.js) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API routing"]
  node_app["Express app<br/>[app.js]"]
  node_auth_route["Auth routes<br/>[authRoutes.js]"]
  node_users_route["User routes<br/>[usuariosRoutes.js]"]
  node_trips_route["Trip routes<br/>[viajesRoutes.js]"]
  node_people_route["Participant routes"]
  node_expenses_route["Expense routes<br/>[gastosRoutes.js]"]
  node_calendar_route["Calendar routes"]
  node_lists_route["List routes<br/>[listasRoutes.js]"]
  node_roulette_route["Roulette routes<br/>[ruletaRoutes.js]"]
  node_documents_route["Document routes"]
  node_album_route["Album routes<br/>[albumRoutes.js]"]
  node_server["Server entry<br/>[index.js]"]
end

subgraph group_identity["Identity and trips"]
  node_auth["Authentication<br/>[authController.js]"]
  node_users["User profiles"]
  node_trips["Trip management"]
  node_participants["Trip participants"]
end

subgraph group_planning["Trip planning"]
  node_calendar["Trip calendar"]
  node_lists["Trip lists"]
  node_roulette["Decision roulette"]
end

subgraph group_shared["Shared resources"]
  node_expenses["Shared expenses"]
  node_settlement["Settlement algorithm"]
  node_documents["Travel documents"]
  node_album["Photo album<br/>[albumController.js]"]
end

subgraph group_platform["Backend services"]
  node_supabase_client["Supabase client<br/>[supabaseClient.js]"]
  node_supabase[("Supabase services")]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_server -->|"starts"| node_app
node_app -->|"mounts"| node_auth_route
node_app -->|"mounts"| node_users_route
node_app -->|"mounts"| node_trips_route
node_app -->|"mounts"| node_people_route
node_app -->|"mounts"| node_expenses_route
node_app -->|"mounts"| node_calendar_route
node_app -->|"mounts"| node_lists_route
node_app -->|"mounts"| node_roulette_route
node_app -->|"mounts"| node_documents_route
node_app -->|"mounts"| node_album_route
node_auth_route -->|"dispatches"| node_auth
node_users_route -->|"dispatches"| node_users
node_trips_route -->|"dispatches"| node_trips
node_people_route -->|"dispatches"| node_participants
node_expenses_route -->|"dispatches"| node_expenses
node_calendar_route -->|"dispatches"| node_calendar
node_lists_route -->|"dispatches"| node_lists
node_roulette_route -->|"dispatches"| node_roulette
node_documents_route -->|"dispatches"| node_documents
node_album_route -->|"dispatches"| node_album
node_auth -->|"uses"| node_supabase_client
node_trips -->|"queries"| node_supabase_client
node_participants -->|"queries"| node_supabase_client
node_expenses -->|"queries"| node_supabase_client
node_documents -->|"uploads and queries"| node_supabase_client
node_expenses -->|"calculates with"| node_settlement
node_supabase_client -->|"connects to"| node_supabase

click node_app "https://github.com/angelalop03/tripeas-backend/blob/main/src/app.js"
click node_auth_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/authRoutes.js"
click node_users_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/usuariosRoutes.js"
click node_trips_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/viajesRoutes.js"
click node_people_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/participantesRoutes.js"
click node_expenses_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/gastosRoutes.js"
click node_calendar_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/calendarioRoutes.js"
click node_lists_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/listasRoutes.js"
click node_roulette_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/ruletaRoutes.js"
click node_documents_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/documentosRoutes.js"
click node_album_route "https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/albumRoutes.js"
click node_auth "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/authController.js"
click node_users "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/usuariosController.js"
click node_trips "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/viajesController.js"
click node_participants "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/participantesController.js"
click node_expenses "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/gastosController.js"
click node_settlement "https://github.com/angelalop03/tripeas-backend/blob/main/src/utils/liquidacionGastos.js"
click node_calendar "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/calendarioController.js"
click node_lists "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/listasController.js"
click node_roulette "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/ruletaController.js"
click node_documents "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/documentosController.js"
click node_album "https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/albumController.js"
click node_supabase_client "https://github.com/angelalop03/tripeas-backend/blob/main/src/config/supabaseClient.js"
click node_server "https://github.com/angelalop03/tripeas-backend/blob/main/src/index.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_auth_route,node_users_route,node_trips_route,node_people_route,node_expenses_route,node_calendar_route,node_lists_route,node_roulette_route,node_documents_route,node_album_route,node_server,node_client toneBlue
class node_auth,node_users,node_trips,node_participants toneAmber
class node_calendar,node_lists,node_roulette toneMint
class node_expenses,node_settlement,node_documents,node_album toneRose
class node_supabase_client,node_supabase toneIndigo
```

## Components

### API routing

- [Express app](https://github.com/angelalop03/tripeas-backend/blob/main/src/app.js): `src/app.js`
- [Auth routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/authRoutes.js): `src/routes/authRoutes.js`
- [User routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/usuariosRoutes.js): `src/routes/usuariosRoutes.js`
- [Trip routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/viajesRoutes.js): `src/routes/viajesRoutes.js`
- [Participant routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/participantesRoutes.js): `src/routes/participantesRoutes.js`
- [Expense routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/gastosRoutes.js): `src/routes/gastosRoutes.js`
- [Calendar routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/calendarioRoutes.js): `src/routes/calendarioRoutes.js`
- [List routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/listasRoutes.js): `src/routes/listasRoutes.js`
- [Roulette routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/ruletaRoutes.js): `src/routes/ruletaRoutes.js`
- [Document routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/documentosRoutes.js): `src/routes/documentosRoutes.js`
- [Album routes](https://github.com/angelalop03/tripeas-backend/blob/main/src/routes/albumRoutes.js): `src/routes/albumRoutes.js`
- [Server entry](https://github.com/angelalop03/tripeas-backend/blob/main/src/index.js): `src/index.js`

### Identity and trips

- [Authentication](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/authController.js): `src/controllers/authController.js`
- [User profiles](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/usuariosController.js): `src/controllers/usuariosController.js`
- [Trip management](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/viajesController.js): `src/controllers/viajesController.js`
- [Trip participants](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/participantesController.js): `src/controllers/participantesController.js`

### Trip planning

- [Trip calendar](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/calendarioController.js): `src/controllers/calendarioController.js`
- [Trip lists](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/listasController.js): `src/controllers/listasController.js`
- [Decision roulette](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/ruletaController.js): `src/controllers/ruletaController.js`

### Shared resources

- [Shared expenses](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/gastosController.js): `src/controllers/gastosController.js`
- [Settlement algorithm](https://github.com/angelalop03/tripeas-backend/blob/main/src/utils/liquidacionGastos.js): `src/utils/liquidacionGastos.js`
- [Travel documents](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/documentosController.js): `src/controllers/documentosController.js`
- [Photo album](https://github.com/angelalop03/tripeas-backend/blob/main/src/controllers/albumController.js): `src/controllers/albumController.js`

### Backend services

- [Supabase client](https://github.com/angelalop03/tripeas-backend/blob/main/src/config/supabaseClient.js): `src/config/supabaseClient.js`
- **Supabase services**

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `src/app.js`)
- Server entry → Express app: starts (evidence: `src/index.js`)
- Express app → Auth routes: mounts (evidence: `src/app.js`)
- Express app → User routes: mounts (evidence: `src/app.js`)
- Express app → Trip routes: mounts (evidence: `src/app.js`)
- Express app → Participant routes: mounts (evidence: `src/app.js`)
- Express app → Expense routes: mounts (evidence: `src/app.js`)
- Express app → Calendar routes: mounts (evidence: `src/app.js`)
- Express app → List routes: mounts (evidence: `src/app.js`)
- Express app → Roulette routes: mounts (evidence: `src/app.js`)
- Express app → Document routes: mounts (evidence: `src/app.js`)
- Express app → Album routes: mounts (evidence: `src/app.js`)
- Auth routes → Authentication: dispatches (evidence: `src/routes/authRoutes.js`)
- User routes → User profiles: dispatches (evidence: `src/routes/usuariosRoutes.js`)
- Trip routes → Trip management: dispatches (evidence: `src/routes/viajesRoutes.js`)
- Participant routes → Trip participants: dispatches (evidence: `src/routes/participantesRoutes.js`)
- Expense routes → Shared expenses: dispatches (evidence: `src/routes/gastosRoutes.js`)
- Calendar routes → Trip calendar: dispatches (evidence: `src/routes/calendarioRoutes.js`)
- List routes → Trip lists: dispatches (evidence: `src/routes/listasRoutes.js`)
- Roulette routes → Decision roulette: dispatches (evidence: `src/routes/ruletaRoutes.js`)
- Document routes → Travel documents: dispatches (evidence: `src/routes/documentosRoutes.js`)
- Album routes → Photo album: dispatches (evidence: `src/routes/albumRoutes.js`)
- Authentication → Supabase client: uses (evidence: `src/controllers/authController.js`)
- Trip management → Supabase client: queries (evidence: `src/controllers/viajesController.js`)
- Trip participants → Supabase client: queries (evidence: `src/controllers/participantesController.js`)
- Shared expenses → Supabase client: queries (evidence: `src/controllers/gastosController.js`)
- Travel documents → Supabase client: uploads and queries (evidence: `src/controllers/documentosController.js`)
- Shared expenses → Settlement algorithm: calculates with (evidence: `src/controllers/gastosController.js`)
- Supabase client → Supabase services: connects to (evidence: `src/config/supabaseClient.js`)
