Saltar al caso de estudio
Todos los proyectos
Proyectos seleccionados02 / 04 · 2 min de lectura

Caso de estudio ↘

FastAPI Ecosystem Lab

Un backend, varios clientes y límites explícitos.

El proyecto explora cómo conectar autenticación, cuentas y operaciones sobre ítems manteniendo la lógica de aplicación separada de bases de datos, caché y servicios externos.

Esquema conceptual del sistema · no es una captura del producto
Mi rol
Desarrollador · proyecto personal de aprendizaje
Contexto
Práctica de arquitectura backend e integración full stack
Estado del proyecto
Backend en evolución · interfaz Next.js en desarrollo
Período
Mar 2026 – Actualidad

El reto

Todo empieza con un problema.

El problema

Un backend que sirve a distintos clientes necesita reglas coherentes de autenticación, propiedad y acceso a datos. Mezclarlas en las rutas dificulta entenderlas a medida que aumentan las integraciones.

El enfoque

Organizar autenticación, usuarios e ítems en módulos. Situar los flujos de aplicación detrás de las rutas y conectar persistencia, caché, archivos y eventos mediante adaptadores.

Mi aporte

De la idea a la implementación.

01 /

Autenticación y cuentas

Conexión de una API versionada con autenticación, renovación de tokens, cierre de sesión y gestión de cuentas.

02 /

Operaciones con control de propiedad

Implementación de flujos que resuelven el propietario autorizado antes de consultar o modificar ítems, junto con lecturas de listas mediante caché bajo demanda.

03 /

Adaptadores e integración de clientes

Composición de adaptadores SQLAlchemy, Redis, Cloudinary y eventos del servidor, con un cliente Streamlit y una interfaz Next.js en desarrollo.

Arquitectura

Cómo se conectan las piezas.

Un backend modular dentro de un monorepo de aprendizaje. La presentación llama a los flujos de aplicación; las reglas de dominio y los puertos separan esos flujos de la infraestructura.

  1. Clientes y API

    El cliente Streamlit consume la API versionada de FastAPI. Una interfaz independiente con Next.js está en desarrollo.

  2. Flujos de aplicación

    Los módulos de autenticación, usuarios e ítems coordinan operaciones y autorización mediante casos de uso.

  3. Dominio y puertos

    Los límites de aplicación describen la persistencia y los servicios que necesita cada flujo.

  4. Adaptadores de infraestructura

    La composición de dependencias conecta SQLAlchemy, caché Redis, archivos en Cloudinary y eventos SSE.

Herramientas del proyecto

  • Python
  • FastAPI
  • SQLAlchemy
  • PostgreSQL
  • Redis
  • Streamlit
  • Next.js

Decisiones

El razonamiento detrás del código.

01

Organizar por funcionalidad y responsabilidad

Separar autenticación, usuarios e ítems, con responsabilidades de presentación, aplicación, dominio e infraestructura.

Por qué esta decisión / compromiso

Más módulos y configuración explícita a cambio de ubicaciones claras para modificar un flujo o una integración.

02

Usar puertos para servicios externos

Componer los adaptadores concretos de persistencia, caché, archivos y eventos en el límite de dependencias.

Por qué esta decisión / compromiso

Los contratos de adaptadores requieren trabajo inicial y mantienen los detalles de cada servicio fuera de los flujos de aplicación.

03

Consultar listas mediante caché

Aplicar caché bajo demanda a las listas de ítems después de resolver el alcance autorizado del usuario.

Por qué esta decisión / compromiso

La caché añade necesidades de invalidación y coherencia junto al acceso a la base de datos.

El resultado

Qué ofrece el proyecto.

  • API versionada para autenticación, cuentas y operaciones sobre ítems con control de propiedad.

  • Flujos de aplicación conectados con persistencia, caché, carga de archivos y adaptadores SSE.

  • Cliente Streamlit implementado e interfaz Next.js en desarrollo dentro del mismo monorepo.

Qué aprendí

Separar reglas de aplicación e infraestructura hace visibles las dependencias. El proyecto permite estudiar el alcance de autorización, la coherencia de caché y cómo distintos clientes comparten una API.

Explora la implementación

Profundiza en los detalles consultando el código fuente.

Sigue explorando

Construyamos algo útil.

Hablemos