Endpoints CRUD en FastAPI con Pydantic v2, Alembic y tests con pytest

Prompt

Actúa como desarrollador backend senior especializado en Python, FastAPI y SQLAlchemy.

Quiero añadir a una API FastAPI existente un módulo completo para gestionar {{recurso}}.
- Campos y tipos: {{campos}}
- Reglas de negocio: {{reglas}}
- Base de datos: {{base_datos}}
- Acceso a datos: {{acceso}}

Entregables, en este orden:
1. Estructura de archivos (router, esquemas, modelo, servicio o repositorio, tests) y una frase que justifique la separación.
2. Esquemas Pydantic v2 separados para crear, actualizar parcialmente y responder, con validaciones (`Field`, `field_validator`, `model_validator`) que apliquen las reglas de negocio.
3. Modelo de base de datos y la migración Alembic correspondiente, con índices y restricciones de unicidad donde tengan sentido.
4. Router con listado paginado y filtrable, detalle, creación, actualización parcial (PATCH) y borrado. Usa los códigos correctos (201, 204, 404, 409, 422) y `response_model` en todos los endpoints.
5. Sesión de base de datos inyectada con `Depends`, sin estado global, y transacciones bien delimitadas.
6. Tests con pytest y `httpx.AsyncClient` (o `TestClient` si el acceso es síncrono): caso feliz, validación, recurso inexistente y conflicto con las reglas de negocio, sobre una base de datos de test aislada.
7. Comandos para arrancar la app, aplicar la migración y ejecutar los tests.

Restricciones:
- Python 3.11 o superior, todo tipado, sin dependencias innecesarias.
- No inventes campos ni reglas: si algo es ambiguo, pregúntame antes de escribir código o márcalo como [COMPLETAR].
- Indica qué decisiones dependen de cómo está montado el resto de mi proyecto (autenticación, configuración, nombres de tablas).

Formato: un bloque de código por archivo con su ruta como título y, al final, una lista de supuestos.

Cómo usarlo

Ejemplo de uso

Resultado de ejemplo

from datetime import datetime, timedelta, timezone
from enum import Enum
from pydantic import BaseModel, Field, field_validator

class EstadoReserva(str, Enum):
    pendiente = "pendiente"
    confirmada = "confirmada"
    cancelada = "cancelada"

class ReservaCreate(BaseModel):
    nombre_cliente: str = Field(min_length=1, max_length=120)
    telefono: str = Field(pattern=r"^\+?[0-9 ]{7,20}$")
    fecha_hora: datetime
    comensales: int = Field(ge=1, le=12)

    @field_validator("fecha_hora")
    @classmethod
    def dentro_de_ventana(cls, v: datetime) -> datetime:
        if v.tzinfo is None:
            raise ValueError("la fecha debe incluir zona horaria")
        ahora = datetime.now(timezone.utc)
        if v < ahora or v > ahora + timedelta(days=60):
            raise ValueError("solo se admiten reservas entre hoy y 60 días")
        return v

class ReservaUpdate(BaseModel):
    fecha_hora: datetime | None = None
    comensales: int | None = Field(default=None, ge=1, le=12)
    estado: EstadoReserva | None = None

Datos clave

Categoría

Programación y desarrollo · Python

Tipo de resultado

Código

Nivel

Intermedio

Pensado para

ChatGPT, Claude, Gemini y Microsoft Copilot

Verificado en

Pendiente de verificación editorial

Variables

Recurso, Campos y tipos, Reglas de negocio, Base de datos y Acceso a datos

Idioma

Español

Precio

Gratis, sin registro

Actualizado

07/11/2026

Preguntas frecuentes