Uecko_ERP/docs/customer-invoices/sql

SQL Customer Invoices

Estado

Este directorio mezcla SQL vigentes de soporte con SQL historicos/transicionales.

SQL vigentes

• add-proforma-document-series-columns.sql
• add-proforma-tax-config-columns.sql
• fix-proforma-series-semantics.sql
• validate-proforma-tax-config.sql

SQL históricos / transicionales

• dev-split-proformas-issued-invoices.sql
• validate-split-proformas-issued-invoices.sql

Estos archivos no deben tratarse como el camino normal de entornos nuevos salvo que exista un escenario legacy concreto que los requiera.

Orden recomendado en desarrollo para el estado vigente

1. Verificar que la BD objetivo es inequívocamente de desarrollo.
2. Hacer backup o confirmar que los datos son descartables.
3. Ejecutar el DDL vigente que falte para proformas.
4. Ejecutar las validaciones SQL vigentes.
5. Levantar backend V2 y validar flujos funcionales.

Propiedades de los scripts históricos de split

• Crea tablas con CREATE TABLE IF NOT EXISTS.
• Añade verifactu_records.issued_invoice_id con ALTER TABLE ... ADD COLUMN IF NOT EXISTS.
• Conserva UUIDs legacy.
• No borra ni modifica datos legacy.
• Usa NOT EXISTS para evitar duplicados en reejecuciones.
• No usa INSERT IGNORE.

Cuándo no ejecutar

No ejecutar si:

• no existe una configuración de desarrollo clara
• hay duda sobre si la BD es producción
• no existe backup verificable
• el entorno no tiene aún las credenciales/localización confirmadas

Procedimiento preliminar de producción

No ejecutar todavía. Referencia operativa:

1. Backup verificado.
2. Ventana de mantenimiento.
3. Bloquear escrituras del backend.
4. Ejecutar create tables / columnas transicionales.
5. Ejecutar backfill idempotente y conservador.
6. Ejecutar validaciones SQL.
7. Desplegar backend con wiring V2.
8. Monitorizar errores y métricas.
9. Mantener legacy congelado para rollback y auditoría.
10. Ejecutar rollback según punto de corte si alguna validación falla.