david
45200284ed
- Implemented API for updating company Verifactu profile. - Created entities for company Verifactu profile and defaults. - Developed hooks for querying and updating the company Verifactu profile. - Added UI components for displaying and editing company Verifactu settings. - Introduced validation and error handling for profile updates. - Created utility functions for building form data and handling feedback states. - Added tests for utility functions and error handling.
73 lines
2.7 KiB
Markdown
73 lines
2.7 KiB
Markdown
# SQL Customer Invoices
|
|
|
|
## Estado
|
|
|
|
Este directorio mezcla SQL vigentes de soporte con SQL historicos/transicionales.
|
|
|
|
Las tablas legacy `customer_invoices`, `customer_invoice_items` y
|
|
`customer_invoice_taxes` no forman parte del runtime actual. Solo pueden aparecer
|
|
en SQL historico de migracion o validacion.
|
|
|
|
## SQL vigentes
|
|
|
|
- `add-company-verifactu-profiles.sql`
|
|
- `add-issued-invoice-verifactu-snapshots.sql`
|
|
- `add-proforma-document-series-columns.sql`
|
|
- `add-proforma-tax-config-columns.sql`
|
|
- `add-issued-invoice-reference.sql`
|
|
- `normalize-document-series-snapshots.sql`
|
|
- `fix-proforma-series-semantics.sql`
|
|
- `validate-proforma-tax-config.sql`
|
|
- `validate-proforma-soft-delete.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 `add-company-verifactu-profiles.sql` si el entorno aún no tiene el perfil VeriFactu empresarial.
|
|
4. Ejecutar `add-issued-invoice-verifactu-snapshots.sql` si el entorno aún no tiene los snapshots fiscales/política en `issued_invoices`.
|
|
5. Ejecutar el DDL vigente que falte para `proformas`.
|
|
6. Ejecutar `normalize-document-series-snapshots.sql` para completar snapshots y validaciones de seriado.
|
|
7. Ejecutar las validaciones SQL vigentes.
|
|
8. 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.
|