erp-core-database-v2/ddl/README.md

Database DDL Files - erp-core

Version: 1.0.0 Fecha: 2026-01-24 Total Archivos: 35 Total Schemas: 20

---

Convenciones de Numeracion

Los archivos DDL siguen un esquema de numeracion por rangos segun dominio funcional:

Rango	Dominio	Descripcion
01-09	Foundation	Auth, core, mobile, billing base
10-15	System	Audit, feature-flags, webhooks, storage, AI, WhatsApp
16-19	Partners & Products	Partners, products, warehouses, attributes
20-24	Catalogs & Operations	Core catalogs, inventory, sales, purchases, invoices
25-49	Reserved	Expansiones futuras
50-59	Financial	Contabilidad completa
60-69	Projects	Proyectos y timesheets

---

Archivos DDL por Dominio

Foundation (01-09)

#	Archivo	Schema	Descripcion
01	01-auth-profiles.sql	auth	Usuarios, sesiones, perfiles
02	02-auth-devices.sql	auth	Dispositivos, biometria
03	03-core-branches.sql	core	Sucursales, horarios
04	04-mobile.sql	mobile	Sesiones movil, push, sync
05	05-billing-usage.sql	billing	Suscripciones, planes, uso
06	06-auth-extended.sql	auth	OAuth, MFA extendido
07	07-users-rbac.sql	auth	Roles, permisos, grupos
08	08-plans.sql	billing	Planes detallados, features
09	09-notifications.sql	notifications	Notificaciones multicanal

System (10-15)

#	Archivo	Schema	Descripcion
10	10-audit.sql	audit	Logs de auditoria completos
11	11-feature-flags.sql	feature_flags	Feature toggles por tenant
12	12-webhooks.sql	webhooks	Suscripciones y entregas
13	13-storage.sql	storage	Archivos, buckets, uploads
14	14-ai.sql	ai	Modelos, prompts, completions
15	15-whatsapp.sql	whatsapp	Conversaciones, mensajes

Partners & Products (16-19)

#	Archivo	Schema	Descripcion
16	16-partners.sql	partners	Clientes/proveedores, tax_info, segments
17	17-products.sql	products	Productos comerciales
18	18-warehouses.sql	inventory	Almacenes, zonas, ubicaciones
19	19-product-attributes.sql	products	Atributos, variantes

Catalogs & Operations (20-26)

#	Archivo	Schema	Descripcion
20	20-core-catalogs.sql	core	Paises, monedas, UoM, secuencias
21	21-inventory.sql	inventory	Stock, lots, pickings, transfers
22	22-sales.sql	sales	Ordenes de venta, cotizaciones
23	23-purchases.sql	purchases	Ordenes de compra
24	24-invoices.sql	billing	Facturas operacionales, pagos
26	26-fiscal-catalogs.sql	fiscal	Catalogos SAT (CFDI, regimenes)

Financial (50-57)

#	Archivo	Schema	Descripcion
50	50-financial-schema.sql	financial	Schema y extensiones
51	51-financial-accounts.sql	financial	Plan de cuentas, tipos
52	52-financial-journals.sql	financial	Diarios contables
53	53-financial-entries.sql	financial	Asientos contables
54	54-financial-invoices.sql	financial	Facturas contables
55	55-financial-payments.sql	financial	Pagos contables
56	56-financial-taxes.sql	financial	Impuestos
57	57-financial-bank-reconciliation.sql	financial	Conciliacion bancaria

Projects (60+)

#	Archivo	Schema	Descripcion
60	60-projects-timesheets.sql	projects	Hojas de tiempo

Matching (46)

#	Archivo	Schema	Descripcion
46	46-purchases-matching.sql	purchases	3-way matching PO/Receipt/Invoice

---

Schemas PostgreSQL

Schema	Proposito	DDL Files
auth	Autenticacion y usuarios	01, 02, 06, 07
audit	Logs de auditoria	10
billing	Facturacion SaaS	05, 08, 24
core	Catalogos compartidos	03, 20
feature_flags	Feature toggles	11
financial	Contabilidad	50-57
fiscal	Catalogos SAT	26
inventory	Inventario y stock	18, 21
mobile	App movil	04
notifications	Notificaciones	09
partners	Clientes/proveedores	16
products	Productos	17, 19
projects	Proyectos	60
purchases	Compras	23, 46
sales	Ventas	22
storage	Archivos	13
webhooks	Webhooks	12
whatsapp	WhatsApp	15
ai	Inteligencia artificial	14

---

Orden de Ejecucion

Para una instalacion limpia, ejecutar en orden numerico:

for f in $(ls *.sql | sort -n); do
  psql -d erp_db -f "$f"
done

Dependencias importantes:

1. 01-auth-profiles.sql debe ejecutarse primero (define auth.users, auth.tenants)
2. 50-financial-schema.sql antes del resto de financial
3. 20-core-catalogs.sql antes de inventory/sales/purchases

---

Notas de Sprint 2 (2026-01-24)

Cambios realizados:

1. 21-inventory.sql: Agregadas tablas lots y pickings con ENUMs
2. 16-partners.sql: Agregadas tablas partner_tax_info y partner_segments
3. 26-fiscal-catalogs.sql: Renumerado de 21 a 26 para evitar conflicto

Renumeracion historica:

• 21-fiscal-catalogs.sql -> 26-fiscal-catalogs.sql (Sprint 2, 2026-01-24)
• 25-fiscal-catalogs.sql eliminado (duplicado)

---

Referencias

• Entities: docs/_definitions/ENTITIES-CATALOG.md
• Services: docs/_definitions/SERVICES-CATALOG.md
• Invoices/Payments: docs/_definitions/INVOICES-PAYMENTS-REFERENCE.md

---

Documentacion creada: 2026-01-24 - Sprint 3 Documentacion