erp-construccion-database-v2/seeds/dev/README.md

Seeds de Desarrollo - ERP Construcción

Descripción

Este directorio contiene los seeds de desarrollo para el proyecto ERP Construcción. Los seeds crean datos de demostración que permiten probar todas las funcionalidades del sistema.

Archivos de Seeds

#	Archivo	Descripción	Registros Aprox.
01	01-core-catalogs.sql	Unidades, monedas, impuestos, bancos, estados	~100
02	02-users-profiles.sql	Roles, permisos, usuarios demo	~250
03	03-empresa-tenant.sql	Tenant, sucursales, almacenes	~25
04	04-proyectos-obras.sql	Proyectos, etapas, lotes, deptos, subcontratistas	~100
05	05-presupuestos.sql	Conceptos, presupuestos, partidas	~250
06	06-estimaciones.sql	Contratos, estimaciones, anticipos	~30
07	07-avances-calidad.sql	Avances, bitácora, inspecciones, tickets	~50
08	08-hse.sql	EPP, capacitaciones, incidentes	~40
09	09-finanzas.sql	Cuentas, bancos, CxP, CxC, pólizas	~60
10	10-activos-documentos.sql	Equipos, mantenimiento, documentos	~35

Total aproximado: ~940 registros

Requisitos Previos

1. Base de datos PostgreSQL 15+ creada
2. DDL ejecutado (schemas creados)
3. Credenciales configuradas

Cómo Ejecutar

Opción 1: Script Automatizado (Recomendado)

# Desde Linux/WSL
cd /path/to/erp-construccion/database/seeds/dev
chmod +x load-dev-seeds.sh
./load-dev-seeds.sh

Opción 2: Manual (Uno por uno)

# Orden de ejecución obligatorio
psql -U erp_admin -d erp_construccion_db -f 01-core-catalogs.sql
psql -U erp_admin -d erp_construccion_db -f 02-users-profiles.sql
psql -U erp_admin -d erp_construccion_db -f 03-empresa-tenant.sql
psql -U erp_admin -d erp_construccion_db -f 04-proyectos-obras.sql
psql -U erp_admin -d erp_construccion_db -f 05-presupuestos.sql
psql -U erp_admin -d erp_construccion_db -f 06-estimaciones.sql
psql -U erp_admin -d erp_construccion_db -f 07-avances-calidad.sql
psql -U erp_admin -d erp_construccion_db -f 08-hse.sql
psql -U erp_admin -d erp_construccion_db -f 09-finanzas.sql
psql -U erp_admin -d erp_construccion_db -f 10-activos-documentos.sql

Opción 3: Desde Windows (PowerShell)

$env:PGPASSWORD="erp_dev_2026"
Get-ChildItem *.sql | Sort-Object Name | ForEach-Object {
    Write-Host "Cargando: $($_.Name)"
    psql -h localhost -U erp_admin -d erp_construccion_db -f $_.FullName
}

Usuarios Demo

Rol	Email	Password	Descripción
Super Admin	admin@demo.com	Demo2026!	Acceso total
Director	director@demo.com	Demo2026!	Reportes y aprobaciones
Gerente Obra	gerente1@demo.com	Demo2026!	Gestión de proyectos
Residente	residente1@demo.com	Demo2026!	Operación diaria
Supervisor	supervisor1@demo.com	Demo2026!	Control de campo
Almacenista	almacen1@demo.com	Demo2026!	Inventarios
Contador	contador1@demo.com	Demo2026!	Finanzas
RRHH	rrhh1@demo.com	Demo2026!	Personal
HSE	hse1@demo.com	Demo2026!	Seguridad
Calidad	calidad1@demo.com	Demo2026!	Control calidad
Comprador	comprador1@demo.com	Demo2026!	Compras
Cliente	visor1@demo.com	Demo2026!	Solo lectura

Proyectos Demo

1. Residencial Las Palmas (Horizontal)

• Tipo: Fraccionamiento horizontal
• Unidades: 120 lotes planificados
• Etapas: 3 (E1 en construcción)
• Estado: En progreso

2. Torre Diamante (Vertical)

• Tipo: Edificio de departamentos
• Unidades: 48 departamentos
• Pisos: 12 niveles
• Estado: En progreso

3. Plaza Central (Comercial)

• Tipo: Centro comercial
• Unidades: 24 locales
• Etapas: 2
• Estado: En planeación

Empresa Demo

• Nombre: Constructora Demo S.A. de C.V.
• RFC: CDM010101ABC
• Ubicación: Aguascalientes, México
• Sucursales: 2 (Matriz + Obra Norte)
• Almacenes: 4

Dependencias de Seeds

01-core-catalogs.sql (base)
    ↓
02-users-profiles.sql
    ↓
03-empresa-tenant.sql
    ↓
04-proyectos-obras.sql
    ↓
05-presupuestos.sql ←┬→ 07-avances-calidad.sql ←┬→ 08-hse.sql
    ↓                │                          │
06-estimaciones.sql ←┘                          │
    ↓                                           │
09-finanzas.sql ←───────────────────────────────┘
    ↓
10-activos-documentos.sql

Notas Técnicas

• Todos los UUIDs son determinísticos para reproducibilidad
• Los seeds usan ON CONFLICT DO NOTHING para ser idempotentes
• Cada seed incluye verificación de registros creados
• Password hash es bcrypt con salt 10

Soporte

Para reportar problemas o sugerencias, crear issue en el repositorio o contactar al equipo de desarrollo.