9.5 KiB
9.5 KiB
Database Map - ERP Construccion
Proyecto: ERP Construccion Version: 1.0 Ultima Actualizacion: 2025-12-12 Total Schemas: 7 Total Tablas: 110
NAVEGACION RAPIDA
database/
├── _MAP.md # Este archivo (indice maestro)
├── schemas/ # DDL por schema
│ ├── 01-construction-schema-ddl.sql # 24 tablas
│ ├── 02-hr-schema-ddl.sql # 8 tablas
│ ├── 03-hse-schema-ddl.sql # 58 tablas
│ ├── 04-estimates-schema-ddl.sql # 8 tablas
│ ├── 05-infonavit-schema-ddl.sql # 8 tablas
│ ├── 06-inventory-ext-schema-ddl.sql # 4 tablas
│ └── 07-purchase-ext-schema-ddl.sql # 5 tablas
├── init-scripts/ # Scripts de inicializacion
│ └── 01-init-database.sql
├── migrations/ # Migraciones TypeORM
├── seeds/ # Datos de prueba
└── HERENCIA-ERP-CORE.md # Referencia a ERP-Core
SCHEMAS OVERVIEW
| # | Schema | Tablas | Descripcion | Estado |
|---|---|---|---|---|
| 1 | construction |
24 | Proyectos, estructura, avances | ✅ DDL |
| 2 | hr |
8 | RRHH, asistencias, cuadrillas | ✅ DDL |
| 3 | hse |
58 | Seguridad, incidentes, EPP | ✅ DDL |
| 4 | estimates |
8 | Estimaciones, anticipos | ✅ DDL |
| 5 | infonavit |
8 | INFONAVIT, derechohabientes | ✅ DDL |
| 6 | inventory |
4 | Extension inventario obra | ✅ DDL |
| 7 | purchase |
5 | Extension compras obra | ✅ DDL |
DETALLE POR SCHEMA
1. Schema: construction (24 tablas)
DDL: schemas/01-construction-schema-ddl.sql
Estructura de Proyecto (8 tablas)
| Tabla | Descripcion | FK Principales |
|---|---|---|
proyectos |
Proyectos/obras | auth.tenants, auth.users |
fraccionamientos |
Fraccionamientos | proyectos |
etapas |
Etapas de construccion | fraccionamientos |
manzanas |
Manzanas | etapas |
lotes |
Lotes/unidades | manzanas, prototipos |
torres |
Torres (vertical) | fraccionamientos |
niveles |
Niveles/pisos | torres |
departamentos |
Departamentos | niveles, prototipos |
prototipos |
Tipos de vivienda | fraccionamientos |
Presupuestos (3 tablas)
| Tabla | Descripcion |
|---|---|
conceptos |
Catalogo de conceptos de obra |
presupuestos |
Presupuestos maestros |
presupuesto_partidas |
Partidas presupuestales |
Programacion y Avances (5 tablas)
| Tabla | Descripcion |
|---|---|
programa_obra |
Programa general de obra |
programa_actividades |
Actividades programadas |
avances_obra |
Registro de avances |
fotos_avance |
Evidencias fotograficas |
bitacora_obra |
Bitacora de obra |
Calidad (5 tablas)
| Tabla | Descripcion |
|---|---|
checklists |
Checklists de calidad |
checklist_items |
Items de checklist |
inspecciones |
Inspecciones de calidad |
inspeccion_resultados |
Resultados |
tickets_postventa |
Tickets de postventa |
Contratos (3 tablas)
| Tabla | Descripcion |
|---|---|
subcontratistas |
Catalogo subcontratistas |
contratos |
Contratos de obra |
contrato_partidas |
Partidas contratadas |
2. Schema: hr (8 tablas)
DDL: schemas/02-hr-schema-ddl.sql
| Tabla | Descripcion | Caracteristicas |
|---|---|---|
employees |
Empleados base | Extension de core |
employee_construction |
Extension construccion | Campos especificos |
puestos |
Catalogo de puestos | - |
asistencias |
Registro asistencias | GPS, biometrico |
asistencia_biometrico |
Datos biometricos | - |
geocercas |
Geocercas para GPS | PostGIS |
destajo |
Trabajo a destajo | - |
destajo_detalle |
Mediciones destajo | - |
cuadrillas |
Cuadrillas de trabajo | - |
cuadrilla_miembros |
Miembros de cuadrilla | - |
employee_fraccionamientos |
Asignacion a fracc | - |
3. Schema: hse (58 tablas)
DDL: schemas/03-hse-schema-ddl.sql
Gestion de Incidentes (5 tablas)
incidentes,incidente_involucrados,incidente_accionesincidente_evidencias,incidente_causas
Control de Capacitaciones (6 tablas)
capacitaciones,capacitacion_participantes,capacitacion_materialescertificaciones,certificacion_empleados,plan_capacitacion
Inspecciones de Seguridad (7 tablas)
inspecciones_seguridad,inspeccion_hallazgoschecklist_seguridad,checklist_seguridad_itemsareas_riesgo,rondas_seguridad,ronda_puntos
Control de EPP (7 tablas)
epp_catalogo,epp_asignaciones,epp_entregasepp_devoluciones,epp_inspeccionesepp_vida_util,epp_stock
Cumplimiento STPS (11 tablas)
normas_stps,requisitos_norma,cumplimiento_normaauditorias_stps,auditoria_hallazgosplanes_accion,acciones_correctivascomision_seguridad,comision_miembrosrecorridos_comision,actas_comision
Gestion Ambiental (9 tablas)
impactos_ambientales,residuos,residuo_movimientosmanifiestos_residuos,monitoreo_ambientalpermisos_ambientales,programas_ambientalesindicadores_ambientales,eventos_ambientales
Permisos de Trabajo (8 tablas)
permisos_trabajo,permiso_riesgos,permiso_autorizacionespermisos_altura,permisos_caliente,permisos_confinadopermisos_electrico,permisos_excavacion
Indicadores HSE (7 tablas)
kpi_configuracion,kpi_valores,kpi_metasdashboards_hse,alertas_hsereportes_hse,estadisticas_periodo
4. Schema: estimates (8 tablas)
DDL: schemas/04-estimates-schema-ddl.sql
| Tabla | Descripcion |
|---|---|
estimaciones |
Estimaciones de obra |
estimacion_conceptos |
Conceptos estimados |
generadores |
Numeros generadores |
anticipos |
Anticipos de obra |
amortizaciones |
Amortizacion de anticipos |
retenciones |
Retenciones (garantia, IMSS) |
fondo_garantia |
Fondo de garantia |
estimacion_workflow |
Workflow de aprobacion |
5. Schema: infonavit (8 tablas)
DDL: schemas/05-infonavit-schema-ddl.sql
| Tabla | Descripcion |
|---|---|
registro_infonavit |
Registro RUV |
oferta_vivienda |
Oferta registrada |
derechohabientes |
Derechohabientes |
asignacion_vivienda |
Asignaciones |
actas |
Actas de entrega |
acta_viviendas |
Viviendas en acta |
reportes_infonavit |
Reportes RUV |
historico_puntos |
Historico puntos ecologicos |
6. Schema: inventory Extension (4 tablas)
DDL: schemas/06-inventory-ext-schema-ddl.sql
| Tabla | Descripcion |
|---|---|
almacenes_proyecto |
Almacenes por obra |
requisiciones_obra |
Requisiciones desde obra |
requisicion_lineas |
Lineas de requisicion |
consumos_obra |
Consumos por lote/concepto |
7. Schema: purchase Extension (5 tablas)
DDL: schemas/07-purchase-ext-schema-ddl.sql
| Tabla | Descripcion |
|---|---|
purchase_order_construction |
Extension OC |
supplier_construction |
Extension proveedores |
comparativo_cotizaciones |
Cuadro comparativo |
comparativo_proveedores |
Proveedores en comparativo |
comparativo_productos |
Productos cotizados |
ORDEN DE EJECUCION DDL
# Prerequisito: ERP-Core debe estar instalado
# Schema auth.* y core.* deben existir
# 1. Construction (base)
psql $DATABASE_URL -f schemas/01-construction-schema-ddl.sql
# 2. HR (depende de construction)
psql $DATABASE_URL -f schemas/02-hr-schema-ddl.sql
# 3. HSE (depende de construction y hr)
psql $DATABASE_URL -f schemas/03-hse-schema-ddl.sql
# 4. Estimates (depende de construction)
psql $DATABASE_URL -f schemas/04-estimates-schema-ddl.sql
# 5. INFONAVIT (depende de construction)
psql $DATABASE_URL -f schemas/05-infonavit-schema-ddl.sql
# 6. Inventory Extension (depende de construction)
psql $DATABASE_URL -f schemas/06-inventory-ext-schema-ddl.sql
# 7. Purchase Extension (depende de construction)
psql $DATABASE_URL -f schemas/07-purchase-ext-schema-ddl.sql
RELACIONES PRINCIPALES
auth.tenants
└── construction.proyectos
└── construction.fraccionamientos
├── construction.etapas
│ └── construction.manzanas
│ └── construction.lotes
├── construction.torres (vertical)
│ └── construction.niveles
│ └── construction.departamentos
├── hr.employee_fraccionamientos
│ └── hr.employees
└── hse.incidentes
└── hse.incidente_involucrados
└── hr.employees
ENUMS UTILIZADOS
Ver archivo: backend/src/shared/constants/enums.constants.ts
Los principales enums estan definidos en:
PROJECT_STATUS- Estados de proyectoLOT_STATUS- Estados de loteINCIDENT_SEVERITY- Severidad de incidentesESTIMATION_STATUS- Estados de estimacionINFONAVIT_ASSIGNMENT_STATUS- Estados INFONAVIT
REFERENCIAS
- ERP-Core DDL:
apps/erp-core/database/ddl/ - Herencia:
HERENCIA-ERP-CORE.md - Constantes SSOT:
backend/src/shared/constants/database.constants.ts
Mantenido por: Architecture-Analyst Actualizacion: Manual al agregar/modificar schemas