# adrianaherreroglez/tfg-cogersa architecture

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

- Interactive diagram: https://gitdiagram.com/adrianaherreroglez/tfg-cogersa
- Repository: https://github.com/adrianaherreroglez/tfg-cogersa

## Overview

EcoKids is a social gaming API for accounts, friendships, direct messages, and multiplayer rooms with results and rankings. Clients use HTTP routes for account and social actions; the server also accepts authenticated Socket.IO messages, saves them, and emits them to both users. Route modules dispatch to controllers, which query PostgreSQL. The tree contains Flutter platform runners but no Dart application sources, so the client’s screens and API calls cannot be mapped. Links reflect the shown server and route wiring and indexed controller/database references.

Main entry points: [`backend/src/server.js`](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/server.js) (HTTP and sockets), [`backend/src/middleware/authMiddleware.js`](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/middleware/authMiddleware.js) (Token verification), [`backend/src/routes/userRoutes.js`](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/userRoutes.js) (User routes), [`backend/src/config/database.js`](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/config/database.js) (PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_server["HTTP and sockets<br/>[server.js]"]
  node_database[("PostgreSQL<br/>[database.js]")]
end

subgraph group_identity["Accounts"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Account management<br/>[authController.js]"]
  node_auth_middleware["Token verification<br/>[authMiddleware.js]"]
end

subgraph group_social["Social features"]
  node_friends_routes["Friend routes<br/>[friendsRoutes.js]"]
  node_user_routes["User routes<br/>[userRoutes.js]"]
  node_friends_controller["Users and friends"]
  node_messages_routes["Message routes<br/>[messagesRoutes.js]"]
  node_messages_controller["Message storage"]
end

subgraph group_games["Game rooms"]
  node_salas_routes["Room routes<br/>[salasRoutes.js]"]
  node_salas_controller["Rooms and results<br/>[salasController.js]"]
end

node_client(("API clients"))

node_client -->|"sends requests"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_friends_routes
node_server -->|"mounts routes"| node_user_routes
node_server -->|"mounts routes"| node_messages_routes
node_server -->|"mounts routes"| node_salas_routes
node_auth_routes -->|"dispatches to"| node_auth_controller
node_auth_routes -->|"uses"| node_auth_middleware
node_user_routes -->|"dispatches to"| node_auth_controller
node_user_routes -->|"dispatches to"| node_friends_controller
node_user_routes -->|"uses"| node_auth_middleware
node_friends_routes -->|"dispatches to"| node_friends_controller
node_friends_routes -->|"uses"| node_auth_middleware
node_messages_routes -->|"dispatches to"| node_messages_controller
node_messages_routes -->|"uses"| node_auth_middleware
node_salas_routes -->|"dispatches to"| node_salas_controller
node_salas_routes -->|"uses"| node_auth_middleware
node_server -->|"saves messages"| node_messages_controller
node_auth_controller -->|"queries"| node_database
node_friends_controller -->|"queries"| node_database
node_messages_controller -->|"queries"| node_database
node_salas_controller -->|"queries"| node_database

click node_server "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/server.js"
click node_auth_routes "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/authRoutes.js"
click node_auth_controller "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/authController.js"
click node_auth_middleware "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/middleware/authMiddleware.js"
click node_friends_routes "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/friendsRoutes.js"
click node_user_routes "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/userRoutes.js"
click node_friends_controller "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/friendsController.js"
click node_messages_routes "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/messagesRoutes.js"
click node_messages_controller "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/messagesController.js"
click node_salas_routes "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/salasRoutes.js"
click node_salas_controller "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/salasController.js"
click node_database "https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/config/database.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_database,node_client toneBlue
class node_auth_routes,node_auth_controller,node_auth_middleware toneAmber
class node_friends_routes,node_user_routes,node_friends_controller,node_messages_routes,node_messages_controller toneMint
class node_salas_routes,node_salas_controller toneRose
```

## Components

### API entry

- [HTTP and sockets](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/server.js): `backend/src/server.js`
- [PostgreSQL](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/config/database.js): `backend/src/config/database.js`

### Accounts

- [Auth routes](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Account management](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Token verification](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`

### Social features

- [Friend routes](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/friendsRoutes.js): `backend/src/routes/friendsRoutes.js`
- [User routes](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/userRoutes.js): `backend/src/routes/userRoutes.js`
- [Users and friends](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/friendsController.js): `backend/src/controllers/friendsController.js`
- [Message routes](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/messagesRoutes.js): `backend/src/routes/messagesRoutes.js`
- [Message storage](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/messagesController.js): `backend/src/controllers/messagesController.js`

### Game rooms

- [Room routes](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/routes/salasRoutes.js): `backend/src/routes/salasRoutes.js`
- [Rooms and results](https://github.com/adrianaherreroglez/tfg-cogersa/blob/main/backend/src/controllers/salasController.js): `backend/src/controllers/salasController.js`

### Other components

- **API clients**

## Connections

- API clients → HTTP and sockets: sends requests (evidence: `backend/src/server.js`)
- HTTP and sockets → Auth routes: mounts routes (evidence: `backend/src/server.js`)
- HTTP and sockets → Friend routes: mounts routes (evidence: `backend/src/server.js`)
- HTTP and sockets → User routes: mounts routes (evidence: `backend/src/server.js`)
- HTTP and sockets → Message routes: mounts routes (evidence: `backend/src/server.js`)
- HTTP and sockets → Room routes: mounts routes (evidence: `backend/src/server.js`)
- Auth routes → Account management: dispatches to (evidence: `backend/src/routes/authRoutes.js`)
- Auth routes → Token verification: uses (evidence: `backend/src/routes/authRoutes.js`)
- User routes → Account management: dispatches to (evidence: `backend/src/routes/userRoutes.js`)
- User routes → Users and friends: dispatches to (evidence: `backend/src/routes/userRoutes.js`)
- User routes → Token verification: uses (evidence: `backend/src/routes/userRoutes.js`)
- Friend routes → Users and friends: dispatches to (evidence: `backend/src/routes/friendsRoutes.js`)
- Friend routes → Token verification: uses (evidence: `backend/src/routes/friendsRoutes.js`)
- Message routes → Message storage: dispatches to (evidence: `backend/src/routes/messagesRoutes.js`)
- Message routes → Token verification: uses (evidence: `backend/src/routes/messagesRoutes.js`)
- Room routes → Rooms and results: dispatches to (evidence: `backend/src/routes/salasRoutes.js`)
- Room routes → Token verification: uses (evidence: `backend/src/routes/salasRoutes.js`)
- HTTP and sockets → Message storage: saves messages (evidence: `backend/src/server.js`)
- Account management → PostgreSQL: queries (evidence: `backend/src/controllers/authController.js`)
- Users and friends → PostgreSQL: queries (evidence: `backend/src/controllers/friendsController.js`)
- Message storage → PostgreSQL: queries (evidence: `backend/src/controllers/messagesController.js`)
- Rooms and results → PostgreSQL: queries (evidence: `backend/src/controllers/salasController.js`)
