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.
- 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.
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.
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.
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.
Clientes y API
El cliente Streamlit consume la API versionada de FastAPI. Una interfaz independiente con Next.js está en desarrollo.
Flujos de aplicación
Los módulos de autenticación, usuarios e ítems coordinan operaciones y autorización mediante casos de uso.
Dominio y puertos
Los límites de aplicación describen la persistencia y los servicios que necesita cada flujo.
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.
01Organizar 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.
02Usar 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.
03Consultar 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