¿Qué hace esta skill?

La Patrones FastAPI Producción Skill proporciona un conjunto consolidado de mejores prácticas para construir APIs FastAPI listas para producción. Cubre estructura de proyecto escalable con separación de capas, esquemas Pydantic v2 con validadores, inyección de dependencias tipada mediante Annotated, autenticación JWT defensiva, servicios transaccionales y testing asíncrono end-to-end con httpx y base de datos aislada.

Proyecto nuevo desde cero
Inicia un proyecto FastAPI con estructura sólida, separación de capas y configuración por entorno desde el primer día.
Refactor de API existente
Extrae lógica de negocio de los routers hacia una capa de servicios transaccional y adopta dependencias tipadas.
Autenticación JWT reutilizable
Implementa auth JWT con inyección de dependencias, distinción 401/403 y alias como ActiveUserDep.
Testing asíncrono E2E
Configura fixtures de pytest con httpx.AsyncClient, ASGITransport y base de datos en memoria aislada por test.

Ejemplos de uso

🚀 Estructura inicial
Crea la estructura de proyecto FastAPI para una API de gestión de usuarios con routers, modelos, esquemas y servicios separados.
🔐 Auth JWT
Implementa autenticación JWT en mi API FastAPI con inyección de dependencias tipada y manejo de errores 401 y 403.
🧪 Tests asíncronos
Configura testing asíncrono end-to-end con httpx y pytest para mi API, usando una base de datos en memoria aislada.
🔧 Refactor de router
Refactoriza este router para que delegue toda la lógica de negocio en un servicio transaccional y use dependencias tipadas con Annotated.

Características

Separación de capas estricta Routers delgados sin lógica de negocio, servicios transaccionales y esquemas Pydantic independientes de los modelos ORM.
Inyección de dependencias tipada Uso de Annotated[..., Depends(...)] con alias reutilizables como DbDep y ActiveUserDep en toda la base de código.
Pydantic v2 y SQLAlchemy async Esquemas con model_validator y from_attributes, operaciones de base de datos asíncronas sin llamadas bloqueantes.
Autenticación JWT defensiva Manejo claro de errores con distinción entre 401 (no autenticado) y 403 (no autorizado), sin fugas de información.
Testing E2E aislado Fixtures de pytest con httpx.AsyncClient y ASGITransport, sobrescribiendo get_db para usar base de datos en memoria por test.

Preguntas frecuentes

Necesitas fastapi, uvicorn, sqlalchemy[asyncio], pydantic-settings, python-jose y passlib[bcrypt]. Para testing: httpx y pytest con soporte asíncrono.
Sí. La skill es un conjunto de patrones y referencias que Claude lee para generar código. No requiere ningún MCP externo ni API de pago adicional.
Sí. La skill está diseñada tanto para proyectos nuevos como para refactorizar APIs existentes que carecen de separación de capas o tienen lógica de negocio en los routers.
Pydantic v2. Los esquemas usan model_validator y la configuración from_attributes para mapear modelos ORM, propias de la versión 2.

Skills relacionadas

Mas skills de la misma categoria:

Patrones FastAPI Producción — Backend Escalable con Claude AI

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.