# liryoz/backend-fastapi architecture

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

- Interactive diagram: https://gitdiagram.com/liryoz/backend-fastapi
- Repository: https://github.com/liryoz/backend-fastapi

## Overview

Es una API FastAPI para autenticación JWT y gestión de citas, productos y usuarios. El flujo principal recibe una solicitud HTTP, aplica validación de token donde corresponde, procesa la operación y consulta o actualiza listas en memoria. El inicio de sesión verifica credenciales y emite un JWT; luego las rutas protegidas validan ese token. El README documenta el flujo de citas y las capacidades principales. Las relaciones no mostradas en extractos se omiten; las listas en memoria se reinician al arrancar.

Main entry points: [`main.py`](https://github.com/liryoz/backend-fastapi/blob/main/main.py) (Aplicación FastAPI), [`routes/citasRoutes.py`](https://github.com/liryoz/backend-fastapi/blob/main/routes/citasRoutes.py) (Rutas de citas), [`routes/productosRoutes.py`](https://github.com/liryoz/backend-fastapi/blob/main/routes/productosRoutes.py) (Rutas de productos), [`routes/usersRoutes.py`](https://github.com/liryoz/backend-fastapi/blob/main/routes/usersRoutes.py) (Rutas de usuarios)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Aplicación y rutas"]
  node_app["Aplicación FastAPI<br/>[main.py]"]
  node_api_models["Modelos de API"]
end

subgraph group_security["Autenticación y seguridad"]
  node_auth_routes["Rutas de acceso<br/>[authRoutes.py]"]
  node_auth_service["Inicio de sesión<br/>[authService.py]"]
  node_jwt_utils["Emisión JWT<br/>[jwtUtils.py]"]
  node_token_validation["Validación JWT"]
  node_settings["Configuración JWT<br/>[settings.py]"]
end

subgraph group_appointments["Gestión de citas"]
  node_appointment_routes["Rutas de citas<br/>[citasRoutes.py]"]
  node_appointment_service["Lógica de citas<br/>[citasService.py]"]
  node_appointment_store[("Citas en memoria<br/>[citasRepository.py]")]
end

subgraph group_catalog["Usuarios y catálogo"]
  node_users_store[("Usuarios en memoria<br/>[usersRepository.py]")]
  node_product_routes["Rutas de productos<br/>[productosRoutes.py]"]
  node_product_service["Listado de productos"]
  node_product_store[("Productos en memoria")]
  node_user_routes["Rutas de usuarios<br/>[usersRoutes.py]"]
end

node_client(("Cliente UI"))

node_app -->|"registra router"| node_auth_routes
node_app -->|"registra router"| node_appointment_routes
node_app -->|"registra router"| node_product_routes
node_app -->|"registra router"| node_user_routes
node_client -->|"envía solicitudes"| node_app
node_auth_routes -->|"invoca acceso"| node_auth_service
node_auth_service -->|"busca credenciales"| node_users_store
node_auth_service -->|"crea token"| node_jwt_utils
node_token_validation -->|"lee configuración"| node_settings
node_appointment_routes -->|"exige token"| node_token_validation
node_product_routes -->|"exige token"| node_token_validation
node_user_routes -->|"exige token"| node_token_validation
node_appointment_routes -->|"invoca operaciones"| node_appointment_service
node_appointment_service -->|"lee y guarda citas"| node_appointment_store
node_appointment_routes -->|"valida y responde"| node_api_models
node_auth_routes -->|"valida y responde"| node_api_models
node_product_routes -->|"invoca listado"| node_product_service
node_product_service -->|"consulta productos"| node_product_store
node_product_routes -->|"forma respuesta"| node_api_models
node_user_routes -->|"consulta usuarios"| node_users_store
node_user_routes -->|"forma respuesta"| node_api_models

click node_app "https://github.com/liryoz/backend-fastapi/blob/main/main.py"
click node_auth_routes "https://github.com/liryoz/backend-fastapi/blob/main/routes/authRoutes.py"
click node_auth_service "https://github.com/liryoz/backend-fastapi/blob/main/services/authService.py"
click node_users_store "https://github.com/liryoz/backend-fastapi/blob/main/repositories/usersRepository.py"
click node_jwt_utils "https://github.com/liryoz/backend-fastapi/blob/main/utils/jwtUtils.py"
click node_token_validation "https://github.com/liryoz/backend-fastapi/blob/main/middlewares/validacion_token.py"
click node_settings "https://github.com/liryoz/backend-fastapi/blob/main/config/settings.py"
click node_appointment_routes "https://github.com/liryoz/backend-fastapi/blob/main/routes/citasRoutes.py"
click node_appointment_service "https://github.com/liryoz/backend-fastapi/blob/main/services/citasService.py"
click node_appointment_store "https://github.com/liryoz/backend-fastapi/blob/main/repositories/citasRepository.py"
click node_product_routes "https://github.com/liryoz/backend-fastapi/blob/main/routes/productosRoutes.py"
click node_product_service "https://github.com/liryoz/backend-fastapi/blob/main/services/productosService.py"
click node_product_store "https://github.com/liryoz/backend-fastapi/blob/main/repositories/productosRepository.py"
click node_user_routes "https://github.com/liryoz/backend-fastapi/blob/main/routes/usersRoutes.py"
click node_api_models "https://github.com/liryoz/backend-fastapi/tree/main/models"

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_api_models,node_client toneBlue
class node_auth_routes,node_auth_service,node_jwt_utils,node_token_validation,node_settings toneAmber
class node_appointment_routes,node_appointment_service,node_appointment_store toneMint
class node_users_store,node_product_routes,node_product_service,node_product_store,node_user_routes toneRose
```

## Components

### Aplicación y rutas

- [Aplicación FastAPI](https://github.com/liryoz/backend-fastapi/blob/main/main.py): `main.py`
- [Modelos de API](https://github.com/liryoz/backend-fastapi/tree/main/models): `models`

### Autenticación y seguridad

- [Rutas de acceso](https://github.com/liryoz/backend-fastapi/blob/main/routes/authRoutes.py): `routes/authRoutes.py`
- [Inicio de sesión](https://github.com/liryoz/backend-fastapi/blob/main/services/authService.py): `services/authService.py`
- [Emisión JWT](https://github.com/liryoz/backend-fastapi/blob/main/utils/jwtUtils.py): `utils/jwtUtils.py`
- [Validación JWT](https://github.com/liryoz/backend-fastapi/blob/main/middlewares/validacion_token.py): `middlewares/validacion_token.py`
- [Configuración JWT](https://github.com/liryoz/backend-fastapi/blob/main/config/settings.py): `config/settings.py`

### Gestión de citas

- [Rutas de citas](https://github.com/liryoz/backend-fastapi/blob/main/routes/citasRoutes.py): `routes/citasRoutes.py`
- [Lógica de citas](https://github.com/liryoz/backend-fastapi/blob/main/services/citasService.py): `services/citasService.py`
- [Citas en memoria](https://github.com/liryoz/backend-fastapi/blob/main/repositories/citasRepository.py): `repositories/citasRepository.py`

### Usuarios y catálogo

- [Usuarios en memoria](https://github.com/liryoz/backend-fastapi/blob/main/repositories/usersRepository.py): `repositories/usersRepository.py`
- [Rutas de productos](https://github.com/liryoz/backend-fastapi/blob/main/routes/productosRoutes.py): `routes/productosRoutes.py`
- [Listado de productos](https://github.com/liryoz/backend-fastapi/blob/main/services/productosService.py): `services/productosService.py`
- [Productos en memoria](https://github.com/liryoz/backend-fastapi/blob/main/repositories/productosRepository.py): `repositories/productosRepository.py`
- [Rutas de usuarios](https://github.com/liryoz/backend-fastapi/blob/main/routes/usersRoutes.py): `routes/usersRoutes.py`

### Other components

- **Cliente UI**

## Connections

- Aplicación FastAPI → Rutas de acceso: registra router (evidence: `main.py`)
- Aplicación FastAPI → Rutas de citas: registra router (evidence: `main.py`)
- Aplicación FastAPI → Rutas de productos: registra router (evidence: `main.py`)
- Aplicación FastAPI → Rutas de usuarios: registra router (evidence: `main.py`)
- Cliente UI → Aplicación FastAPI: envía solicitudes (evidence: `README.md`)
- Rutas de acceso → Inicio de sesión: invoca acceso (evidence: `routes/authRoutes.py`)
- Inicio de sesión → Usuarios en memoria: busca credenciales (evidence: `services/authService.py`)
- Inicio de sesión → Emisión JWT: crea token (evidence: `services/authService.py`)
- Validación JWT → Configuración JWT: lee configuración (evidence: `middlewares/validacion_token.py`)
- Rutas de citas → Validación JWT: exige token (evidence: `routes/citasRoutes.py`)
- Rutas de productos → Validación JWT: exige token (evidence: `routes/productosRoutes.py`)
- Rutas de usuarios → Validación JWT: exige token (evidence: `routes/usersRoutes.py`)
- Rutas de citas → Lógica de citas: invoca operaciones (evidence: `routes/citasRoutes.py`)
- Lógica de citas → Citas en memoria: lee y guarda citas (evidence: `services/citasService.py`)
- Rutas de citas → Modelos de API: valida y responde (evidence: `routes/citasRoutes.py`)
- Rutas de acceso → Modelos de API: valida y responde (evidence: `routes/authRoutes.py`)
- Rutas de productos → Listado de productos: invoca listado (evidence: `routes/productosRoutes.py`)
- Listado de productos → Productos en memoria: consulta productos (evidence: `services/productosService.py`)
- Rutas de productos → Modelos de API: forma respuesta (evidence: `routes/productosRoutes.py`)
- Rutas de usuarios → Usuarios en memoria: consulta usuarios (evidence: `routes/usersRoutes.py`)
- Rutas de usuarios → Modelos de API: forma respuesta (evidence: `routes/usersRoutes.py`)
