Lección 34 de 36 · Proyecto final: CRUD de tareas con SQLite✦ WebMCP implementado
Fase 4: los casos de uso
8 min de lectura3 retos
Un caso de uso es una cosa que la app sabe hacer: crear una tarea, completarla, listarlas. En esta fase escribes el paquete internal/casosdeuso, que junta el dominio y el repositorio sin saber nada de la web ni de SQL.
En 4 ideas
1/4
Cada caso de uso es un struct con el repositorio dentro y un método Ejecutar. En PHP es tu final readonly class CrearTareaHandler con el repositorio en el constructor y un __invoke().
El repositorio entra como interfaz (dominio.RepositorioTareas) por un constructor NuevoCrearTarea(repo). Es la inyección de dependencias de Symfony o Laravel, pero hecha a mano.
Una Tarea es un valor: si la cambias, hay que volver a llamar a Guardar. En PHP con Doctrine el objeto es el mismo y basta un flush().
Para probar los fallos se usa un repositorio falso que devuelve errores. En PHP harías un mock con PHPUnit; en Go basta un struct con los métodos de la interfaz.
1 · Qué es un caso de uso
Piensa en un restaurante. El dominio son las recetas: qué lleva cada plato. El repositorio es la despensa. Un caso de uso es el pedido de un cliente: «una tortilla» hace que alguien mire la receta, coja los huevos de la despensa y sirva el plato. El pedido no sabe si la despensa es una nevera o un almacén, y tampoco sabe si el cliente llamó por teléfono o vino en persona.
Así queda «crear una tarea»: validar con el dominio y guardar con el repositorio.
Los otros casos son igual de cortos. ListarTareas llama a repo.Listar(), VerTarea a repo.BuscarPorID(id) y BorrarTarea a repo.Borrar(id). Parecen poca cosa, pero son el sitio donde crecerán las reglas (permisos, avisos, registros) sin tocar ni la web ni el SQL.
2 · Completar: buscar, cambiar y guardar
Completar una tarea tiene tres pasos: buscarla, pedirle al dominio que se complete (con su regla de «no dos veces») y guardarla.
Gomain.go
func (c *CompletarTarea) Ejecutar(id int) (dominio.Tarea, error) {
t, err := c.repo.BuscarPorID(id)
if err != nil {
// Se añade contexto y se conserva el error original con %w.return dominio.Tarea{}, fmt.Errorf("completar: %w", err)
}
if err := t.Completar(); err != nil {
return dominio.Tarea{}, fmt.Errorf("completar tarea %d: %w", id, err)
}
// Sin esto, el cambio se pierde.return c.repo.Guardar(t)
}
¿Por qué? · En PHP no existe
¿Por qué hay que volver a llamar a Guardar? Con Doctrine o Eloquent no hace falta
En PHP los objetos viajan como un mando a distancia (un handle, módulo 03): el repositorio de Doctrine te da el mismo objeto que tiene vigilado, cambias $tarea->hecha y flush() se entera solo.
En Go, BuscarPorID devuelve una Tareapor valor: una fotocopia. Cambiarla no toca lo que hay en el map ni en SQLite. Puede parecer más trabajo, pero es más claro: los cambios solo llegan al almacén cuando llamas a Guardar, en un único sitio y a la vista. Sin cambios «mágicos» que se guardan sin que nadie lo pida.
Míralo pasar con el repositorio en memoria:
Gomain.go
t, _ := repo.BuscarPorID(1)
t.Completar()
// Olvido: falta repo.Guardar(t)
otra, _ := repo.BuscarPorID(1)
// Imprime false: el almacén tiene la tarea sin cambiar.
fmt.Println(otra.Hecha)
Aquí lo tienes completo. Pulsa Ejecutar y mira cómo la segunda vez sale el error del dominio, envuelto pero reconocible:
¿Cómo pruebas que tu caso de uso se porta bien cuando el disco se llena? No vas a llenar el disco. Te fabricas un repositorio falso que falla a propósito, como un simulacro de incendio.
No hace falta ninguna librería de mocks: basta un tipo con los métodos de la interfaz. Y con embedding (módulo 05) solo reescribes el método que quieres que falle; los demás los hereda del repositorio en memoria:
Para no pasar cinco casos de uso sueltos a la web, se agrupan en un struct y se construyen todos de golpe con el mismo repositorio:
Gomain.go
// Tareas agrupa los casos de uso para pasárselos al controlador.typeTareasstruct {
Crear *CrearTareaListar *ListarTareasVer *VerTareaCompletar *CompletarTareaBorrar *BorrarTarea
}
funcNuevos(repo dominio.RepositorioTareas) Tareas {
returnTareas{
Crear: NuevoCrearTarea(repo),
Listar: NuevoListarTareas(repo),
Ver: NuevoVerTarea(repo),
Completar: NuevoCompletarTarea(repo),
Borrar: NuevoBorrarTarea(repo),
}
}
// En cmd/tareas/main.go:// repo := repositorio.NuevoSQLite(db)// cu := casosdeuso.Nuevos(repo)
Cambiar SQLite por la memoria (o, mañana, por MySQL) es cambiar una línea en main.go. Ningún caso de uso se entera.
Hora de practicar
Retos · 0/3 resueltos
Reto 1 de 3 · ✓ Resuelto
Crear de verdad
Completa Ejecutar(titulo string) (Tarea, error) de CrearTarea: crea la tarea con NuevaTarea (si da error, devuélvelo sin guardar nada) y guárdala con el repositorio, devolviendo la tarea ya con su ID. Es el __invoke() de tu CrearTareaHandler en PHP.
Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.
Gomain.go · editable
Pista. No tires el error con _: si NuevaTarea falla, return Tarea{}, err. Si va bien, devuelve directamente lo que te dé c.repo.Guardar(t), que ya trae el ID.
Reto 2 de 3 · ✓ Resuelto
Completar sin perder el cambio
CompletarTarea.Ejecutar(id) marca la tarea, pero al volver a buscarla sigue pendiente. Arréglalo: busca, completa y guarda. Si la tarea no existe o ya estaba hecha, devuelve el error envuelto con %w para que errors.Is lo reconozca. En PHP sería $tarea->completar(); $this->repo->guardar($tarea);.
Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.
Gomain.go · editable
Pista. Dos olvidos: el error de t.Completar() se ignora y la tarea cambiada nunca vuelve al repositorio. BuscarPorID te dio una copia: termina con return c.repo.Guardar(t).
Reto 3 de 3 · ✓ Resuelto
Resumen que no esconde errores
Completa Ejecutar() (Resumen, error) de ResumenTareas: cuenta el total, las hechas y las pendientes. Si el repositorio falla, devuelve un Resumen{} vacío y el error envuelto con %w. Los tests usan un repositorio falso, repoRoto, que siempre falla. En PHP sería dejar que la excepción del repositorio suba, sin un catch que la esconda.
Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.
Gomain.go · editable
Pista. Cambia el _ por err y, si no es nil, return Resumen{}, fmt.Errorf("resumen de tareas: %w", err). Luego recorre las tareas y suma en Hechas o en Pendientes. Fíjate en que ResumenTareas pide una interfaz pequeña, Lister: solo lo que necesita (módulo 05).
Resumen
Lo que te llevas de esta lección
Un caso de uso = un struct con el repositorio + Ejecutar (en PHP, una clase …Handler con __invoke()).
El repositorio entra como interfaz por NuevoX(repo) (en PHP, el constructor que recibe TareaRepository).
Buscar, cambiar y volver a guardar: la Tarea es una copia (en PHP, Doctrine y flush() lo hacen solos).
Los errores suben envueltos con %w; el caso de uso no decide el código HTTP (en PHP, la excepción sube hasta el controlador).
Repositorios falsos con un struct y embedding, sin librería de mocks (en PHP, createMock()).
Para recordarlo: «Busca, Cambia, Guarda»
BBusca t, err := repo.BuscarPorID(id)
CCambia t.Completar()
GGuarda repo.Guardar(t)
Todo caso de uso que modifica algo sigue estos tres pasos. Si te saltas la G, el cambio se queda en una fotocopia que nadie guarda.