L09 · Especificación · 4 min
¿Qué es una base de datos?
En una frase
Una base de datos es un archivador digital organizado donde tu aplicación recuerda información entre visitas —como cuentas de usuario, elementos guardados o pedidos—, almacenada en tablas estructuradas en un servidor para que los datos sigan seguros aunque se cierre el navegador.
Piénsalo así
Piensa en un armario de fichas en la oficina: cada cajón es una tabla (`usuarios`, `recetas`), cada columna es un dato obligatorio (`correo`, `título`, `fecha`) y cada fila es una ficha individual. Cuando alguien guarda una receta, el backend archiva una ficha nueva en el cajón correspondiente.
Cómo funciona
No todas las aplicaciones necesitan una Definiciónbase de datosDonde tu app recuerda cosas entre visitas, como cuentas o recetas guardadas.Abrir en el glosario →. Una página personal, una calculadora o un conversor de unidades no necesitan recordar nada cuando recargas la página: si no se guardan datos, no hace falta base de datos. Solo la añades cuando tu app debe recordar información entre visitas o entre distintas personas.
Dentro de una base de datos relacional (nuestra pila usa Postgres alojado en Neon), la información vive en tablas. Cada tabla tiene columnas que definen qué tipo de dato se permite (texto, número, fecha, sí/no) y filas para cada elemento guardado, de modo que la app nunca almacena datos desordenados o incompletos.
Tu DefiniciónbackendLa parte de una app que funciona en un servidor: guarda datos, comprueba inicios de sesión y habla con otros servicios.Abrir en el glosario → se conecta a Neon mediante una dirección DefiniciónsecretoTodo lo que abre tus cuentas: claves de API, contraseñas, tokens. Solo se guarda en Vercel y en `.env.local`.Abrir en el glosario → guardada en la Definiciónvariable de entornoUn hueco con nombre, como `TOKENTIDE_API_KEY`, que guarda un ajuste o un secreto fuera de tu código.Abrir en el glosario → DATABASE_URL. Cuando conectas Neon desde tu proyecto en DefiniciónVercelEl servicio que convierte tu código de GitHub en una web publicada, con una vista previa para cada cambio.Abrir en el glosario → (Storage → Neon), Vercel configura DATABASE_URL en línea automáticamente, y tu agente descarga una conexión de desarrollo separada en .env.local.
Igual que DefiniciónGitLa herramienta que guarda la memoria de tu repositorio: registra cada commit en tu equipo.Abrir en el glosario → tiene ramas para el código, Neon crea una rama de base de datos separada para el desarrollo local y para cada Definiciónvista previa (Preview)Un enlace privado de prueba que Vercel crea para cada cambio, para probarlo antes de publicarlo.Abrir en el glosario →. Así, cuando pruebas con tu agente a añadir o borrar datos en tu equipo, nunca tocas los datos reales de Definiciónproducción (Production)La versión publicada de tu app, la que ve todo el mundo. Sale de `main`.Abrir en el glosario →.
Cómo se ve en tu proyecto
Durante la etapa ③ Especificación, tu agente te pregunta qué necesita recordar tu app. Si no hay nada que guardar, omite la base de datos por completo. Si la necesita, espera hasta llegar a esa tarea del plan, te guía paso a paso para conectar Neon en Vercel y escribe consultas parametrizadas seguras para que ningún dato externo altere tus tablas.
Copia para tu agente
Según mi archivo SPEC.md, dime si mi app necesita una base de datos. Si la necesita, enumera con palabras sencillas qué tablas y columnas nos hacen falta y confirma cómo separamos los datos de desarrollo de los de producción.
Comprobación rápida · 1 pregunta