Datos de prueba
El perfil seed puebla la base de datos dev-migration con datos realistas para desarrollo y demos. El proceso tiene dos fases: datos manuales fijos (una tienda de ejemplo con productos y outfits concretos) y datos aleatorios configurables generados a partir de ficheros de texto.
Los datos estáticos de referencia (redes sociales, tipos/colores/tallas de productos, etiquetas de outfits) se insertan mediante la migración Liquibase 007, por lo que también están presentes en los entornos de test y prod.
Qué genera el seeder
- 1 tienda manual ("La Boutique de Sevilla") con 2 redes sociales, 4 productos con variantes y 2 outfits
- 5 tiendas aleatorias (configurable) con redes sociales, productos con variantes y outfits
- 10 clientes (configurable)
Prerequisitos
La base de datos dev-migration debe estar levantada:
docker compose up -d
Comando
./mvnw spring-boot:run -Dspring-boot.run.profiles=dev-migration,seed
# Si se sabe que las imágenes ya están subidas a Cloudinary, que en el entorno de desarrollo ya lo están, se puede saltar:
./mvnw clean spring-boot:run -Dspring-boot.run.profiles=dev-migration,seed -Dspring-boot.run.arguments="--seed.uploadImages=false"
Al arrancar, Liquibase aplica las migraciones (incluida la 007 con los datos de referencia) y después el seeder inserta los datos. La aplicación termina sola al acabar porque el perfil seed deshabilita el servidor web.
También se puede seedear el perfil de desarrollo, para poder tener datos de prueba durante el desarrollo. Sin embargo,
un cambio al seeder o a las migraciones ha de ser probado contra dev-migration.
./mvnw clean spring-boot:run -Dspring-boot.run.profiles=dev,seed
# O, si ya se han subido las imágenes (casi siempre es así)
./mvnw clean spring-boot:run -Dspring-boot.run.profiles=dev,seed -Dspring-boot.run.arguments="--seed.uploadImages=false"
Parámetros configurables
Los parámetros se pueden cambiar en src/main/resources/application-seed.yaml o sobreescribir con -D:
| Parámetro | Por defecto | Descripción |
|---|---|---|
seed.random-seed | 42 | Semilla aleatoria (misma semilla → mismos datos) |
seed.client-count | 10 | Número de clientes aleatorios |
seed.uploadImages | true | Si hace falta subir las imágenes |
Ejemplo con parámetros distintos:
./mvnw spring-boot:run \
-Dspring-boot.run.profiles=dev-migration,seed \
-Dspring-boot.run.arguments="--seed.client-count=20 --seed.random-seed=50"
Idempotencia
El seeder comprueba al inicio si ya hay tiendas en la base de datos. Si las hay, termina sin hacer nada:
Database already seeded, skipping.
Cómo re-sembrar
Para volver a sembrar desde cero, hay que limpiar la base de datos primero. La forma más sencilla es recrear el contenedor:
docker compose down postgres-devmigrations
docker volume rm dondesiempre-backend_pgdata-devmigr # El nombre exacto del volumen puede variar
docker compose up -d postgres-devmigrations
./mvnw spring-boot:run -Dspring-boot.run.profiles=dev-migration,seed
Verificación
docker compose exec postgres-devmigrations \
psql -U devmigruser -d devmigrdb \
-c "SELECT COUNT(*) FROM stores; SELECT COUNT(*) FROM products; SELECT COUNT(*) FROM clients;"