Proyecto: API de tareas con FastAPI

Lo que este proyecto integra —el backend de una app real:

1. La capa de datos es el núcleo. Toda la lógica (persistir, validar, reglas de estado) vive aquí, independiente de FastAPI y testeable. Las rutas solo la exponen.
2. Reglas de negocio como validación. Un estado inválido o una prioridad fuera de rango se rechazan ANTES de tocar la base —la integridad se protege en el código, no se espera que los datos lleguen bien—.
3. SQL seguro y CRUD completo. Parámetros ? siempre; crear, leer, filtrar, actualizar, borrar y agregar.

Autoevaluación: ¿el CRUD completo funciona (crear, listar por prioridad, filtrar por estado, cambiar estado, estadísticas)? ¿la validación rechaza un título vacío, una prioridad fuera de 1-3, y un estado inválido? Este RepositorioTareas es el backend REAL de una app de tareas. Envolverlo en FastAPI es directo —cada método un endpoint—:

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel, Field

app = FastAPI()
repo = RepositorioTareas()

class TareaNueva(BaseModel):
  titulo: str = Field(min_length=1)
  prioridad: int = Field(ge=1, le=3)

class CambioEstado(BaseModel):
  estado: str

@app.get("/tareas")
def listar(estado: str | None = None):
  return repo.listar(estado)

@app.post("/tareas", status_code=201)
def crear(tarea: TareaNueva):
  return repo.crear(tarea.titulo, tarea.prioridad)

@app.patch("/tareas/{tarea_id}")
def cambiar(tarea_id: int, cambio: CambioEstado):
  tarea = repo.obtener(tarea_id)
  if tarea is None:
      raise HTTPException(404, "Tarea no encontrada")
  try:
      return repo.cambiar_estado(tarea_id, cambio.estado)
  except ValueError as e:
      raise HTTPException(422, str(e))

@app.get("/tareas/estadisticas")
def stats():
  return repo.estadisticas()

Fíjate cómo la capa de datos que probaste en vivo se vuelve una API REST completa: Pydantic valida la entrada, las excepciones se mapean a códigos HTTP (404, 422), y cada método del repositorio es un endpoint. Has construido el backend de una aplicación real: persistencia, reglas de negocio, validación y una API bien diseñada. Esto, desplegado con lo del módulo 8 (estructura, tests, deploy), es una API de producción.