Paso 5: Esbozar el modelo de datos
La mayoría de las apps giran en realidad en torno a los datos: qué almacenas y cómo se relacionan las piezas. Un esbozo rápido del modelo de datos te ahorra código confuso e inconsistente más adelante. No necesitas un diagrama de — una lista de campos es suficiente.
Para el rastreador de libros, hay una cosa principal — un Book (libro):
Book
- id: unique string
- title: string
- author: string
- status: "to_read" | "reading" | "finished"
- rating: number 1–5 (only if finished)
- addedAt: date
Incluso este pequeño esbozo hace explícitas las decisiones: las calificaciones solo existen para los libros terminados, el estado es uno de tres valores fijos, y cada libro tiene un id. Cuando le entregas esto a la IA, deja de adivinar los nombres de los campos y construye de forma consistente.
La razón para fijar esto pronto es que los nombres de los campos se filtran por todas partes. En cuanto la IA escribe código que lee book.rating, ese nombre aparece en el formulario, en la vista de lista, en la capa de almacenamiento y en cualquier función posterior que añadas. Si dejas que se desvíe — rating en un lugar, stars en otro, score en un tercero — obtienes errores tediosos de rastrear. Un modelo de datos de seis líneas es el seguro más barato contra eso.
Un bloque de especificación breve y listo para copiar y pegar suele funcionar mejor que la prosa para la IA. Aquí está el mismo modelo escrito como una instrucción que realmente enviarías:
Use this exact data shape for a book. Don't add fields I didn't list,
and don't rename these:
Book {
id — unique string, generated on creation
title — string, required
author — string, required
status — one of: "to_read" | "reading" | "finished"
rating — integer 1–5, present ONLY when status is "finished"
addedAt — ISO date string, set when the book is added
}
If you think a field is missing, ask me before adding it.
Esa última línea — pregúntame antes de añadirlo — está haciendo un trabajo real. Convierte a la IA de adivinadora en colaboradora y mantiene el modelo de datos como tuyo.