Auditoria historica y esquema actual

El snapshot inicial se conserva completo. El esquema vigente es el anexo de DATABASE_CHANGELOG, con 53 tablas y 16 migraciones.

Auditoria completa PostgreSQL y modelo historico

Exportacion para revision: 05/11/2026, Europe/Madrid. Contenido completo de los informes fuente, no resumen. No se alteran los originales. Los nombres personales no imprescindibles se sustituyen por etiquetas; los ejemplos tecnicos y la estructura se conservan. No se exportan credenciales ni evidencias crudas. Las conclusiones, contadores y autorizaciones de cada informe son HISTORICOS: no habilitan operaciones. El encargo actual prioriza exclusivamente enumeracion por fechas. La fecha mas reciente y el suplemento de esta revision prevalecen sobre planes anteriores.

Fuentes completas incluidas

---

Documento fuente: 06_POSTGRESQL_AUDIT.md

Auditoria PostgreSQL real

05/11/2026. SELECT en transacciones read-only; sin DDL, INSERT/UPDATE, migraciones, importaciones ni reconciliaciones de indices documentales.

Inventario

PostgreSQL 15.19 Debian, base transport_hub de 10 MB, esquema de usuario public. 39 tablas, 386 columnas, 59 indices y 103 restricciones catalogadas. 13 migraciones aplicadas, desde 001_phase_0_5_schema hasta 013_iclientes_production. Inventario completo por columna/tipo/null/default, indices y restricciones en el anexo 16; JSON de evidencia estructural sin filas de secretos o datos comerciales en el dossier tecnico.

Los auxiliares puntuales generaron evidencia/API requests sin crear queries del laboratorio: queries=2 no es todo el historial de consultas. Ninguna fila shipments confirma una expedicion porque el repositorio aun no se ingiere.

Relaciones e indices: fortalezas y carencias

Carriers -> shipments/parcels/events/synchronizations; parcels -> shipments; tracking_events -> parcels. Hay FKs y PKs, pero tracking_events no tiene shipment_id directo y las claves carrier son nullable con ON DELETE SET NULL. Eso no basta para historico inmutable con ambito de cuenta/entorno.

Shipments solo tiene id, carrier_id, external_reference, status, source_system y timestamps. No hay cuentas, numero operativo, IDs tipados, cuatro ejes de estado, destinatario, datos comerciales o revisiones. No hay unicidad fuerte carrier/cuenta/entorno/tipo/valor, ni deduplicacion de eventos.

Shipments/tracking_events solo tienen indice PK. api_requests tiene indice provider/product/environment/occurred_at, pero no carrier_account_id. Las cuotas/agregados tampoco discriminan cuenta. No declarar el modelo definitivo ya preparado por existir nombres de tablas.

Documents y knowledge_articles son indices de articulos tecnicos por slug/path, no almacenes de POD/envios. No sobrecargarlos sin distinguir semantica. El catalogo oficial separa originales del proveedor con hashes/procedencia. La KB se descubre en ficheros: 54 articulos antes de esta entrega, frente a 31 en SQL. Es una deuda de indexacion, no perdida de esos ficheros.

Acceso y operacion

Conexion de app por socket local y peer como transport-hub. Rol no superuser, sin CREATEDB ni CREATEROLE. El arranque ejecuta apply_migrations con ese rol; propiedad/permisos DDL deben separarse del rol runtime en fase autorizada. No se han probado permisos destructivos para verificarlo.

Listen localhost, SSL activado para TCP local; puerto 5432 solo loopback. max_connections=100, shared_buffers=128 MiB, autovacuum on, wal_level replica, archive_mode off. Son valores observados, no recomendacion de tuning ni prueba de backup/replicacion. No se midio rendimiento de cargas grandes.

Reutilizacion propuesta

Extender nucleo existente mediante futuras migraciones revisadas; mantener usuarios/config/catalogos/auditoria y evidencias. Anadir solo conceptos que faltan: cuentas, IDs/referencias, snapshots/comercial, observaciones/revisiones, documentos de envio y operaciones/jobs segun diseno. Evitar otro nucleo GLS. Laboratorio no debe convertirse en tabla operativa mediante UPDATEs ad hoc.

Antes de poblar: backup restaurable, reglas de identidad y estados, migracion reversible, pruebas con datos sinteticos e ingesta offline de evidencia autorizada. Ninguna de estas acciones se realiza en esta auditoria.

---

Documento fuente: 08_HISTORICAL_REPOSITORY_DESIGN.md

Repositorio historico persistente: propuesta

No DDL ni implementacion. Evolucionar la unica base transport_hub y el nucleo existente. No limitar a 100 registros ni aplicar purgas automaticas por antiguedad. Conservacion comercial completa, con decisiones explicitas de gobierno de datos/obligaciones aplicables; capacidad indefinida no es una orden de conservar PII eternamente sin revision.

Agrupaciones y relaciones necesarias

No se decide crear 25 tablas por 25 conceptos. El detalle fisico y migracion se revisara tras aprobar identidad, privacidad y consultas principales.

Identidad y unicidad

Numero completo GLS es la primera columna operativa y campo de API, no la PK. Si GLS lo devuelve se preserva literal; no construir agencia+CODEXP para cualquier envio sin regla validada. Codigos como cadenas, ceros intactos. Clave fuerte: carrier/cuenta/entorno/tipo/valor; CODEXP no globalmente unico. GUID, barcode y numero de bulto se tipan y correlacionan con evidencia.

No fusionar por nombre, direccion, albaran o referencia no unica. Devoluciones pueden heredar referencias y tener ID propio. Relacion padre/hija tipada, no sobrescribir el original. Conflictos de identificadores van a revision, no upsert silencioso. Cuenta anterior nunca comparte UID por suposicion.

Campos funcionales y comerciales

Shipment: fecha original expedicion y observaciones, servicio/horario/portes, bultos/peso/moneda, pais, centro remitente, origen transport_hub/gls_extranet/ imported/unknown y grado de confianza. Lookup API no demuestra canal de alta.

Snapshot de destinatario: nombre, direccion, CP, poblacion, provincia, pais, telefono, movil, correo y observaciones, todos con fuente y campos presentes. Null/desconocido/no devuelto no equivale a cadena vacia o cero. Nunca inventar contactos que no entregue GLS/intranet. Direccion snapshot no cambia al editar despues un centro o cliente en intranet.

Referencias pedido/factura/ERP no crean facturas ni conciliacion; intranet conserva autoridad sobre sus datos comerciales. Prioridad de fuentes configurable por campo, sin sobreescribir ERP con una respuesta parcial GLS. Reembolso declarado con decimal exacto y moneda original; estado de cobro, importe cobrado y conciliacion desconocidos hasta evidencia especifica.

Cuatro dimensiones de estado

TH-P-001 valida: admin aceptada por Anula0; logistica API inmediata grabada; resultado anulada y ciclo cerrado comunicados desde Extranet despues. Almacenar cada observacion y su nivel de evidencia, no fabricar evento API5. La reduccion de bultos/peso a 0 comunicada de Extranet es snapshot posterior, no borrado del valor declarado original 1/1 ni prueba de ausencia de costes.

Acontecimientos y correcciones

Conservar tipo, codigo y descripcion originales, API/catalogo/namespace, fecha literal y timezone conocida o incertidumbre, agencia/instalacion, atributos complementarios, fecha de recuperacion e ID externo si existe. ESTADO, ENTREGA, POD, INCIDENCIA, SOLUCION, FACTURA y demas tipos no comparten un espacio numerico. LocationCode no es estado. Evento administrativo posterior no devuelve una entregada a pendiente por ser el mas reciente.

ID externo estable permite enlazar revisiones. Si falta, huella canonica por envio/tipo/codigo/fecha/instalacion identifica ocurrencia candidata y hash de contenido distingue cambios. No deduplicar solo por codigo. Una correccion genera revision/supersedes y nueva observacion, no UPDATE destructivo del acontecimiento historico. Si dos ocurrencias pueden coincidir sin ID estable, conservar incertidumbre/original y evitar fusion automatica.

Los primeros/ultimos vistos, fecha efectiva, fecha carrier y fecha de ingesta son distintos. Versionar parser/mapeo y reprocesar originales localmente sin volver a gastar llamadas. Desconocidos conservan datos, no se descartan.

Una recuperacion nueva de un evento antiguo no reabre automaticamente un envio cerrado: ordenar por evidencia/fecha efectiva, no solo fecha de HTTP. TH-P-001 exige conservar Anula0 y el cierre Extranet posterior aunque una respuesta inmediata aun repita el evento GRABADO del dia anterior. Prioridad entre fuentes y resolucion de conflictos debe ser explicita y versionada.

Captura, ingesta e integridad

HTTP real -> captura original cifrada duradera -> auditoria -> validacion/ parser tipado -> transaccion de agregado/eventos/referencias/snapshot. Si falla BD/parser, inbox duradera para reprocesado LOCAL; no repetir HTTP para obtener de nuevo una respuesta ya conservada. Registrar recibido, procesado, aplicado y error por separado. Toda respuesta util autorizada alimenta el repositorio, incluidas altas/consultas manuales, con completitud.

No ingestar desde la copia sanitizada: el sanitizador actual limita listas y oculta PII/fechas que si son necesarias al modelo. Original cifrado es la evidencia autorizada; log/copia tecnica no es fuente completa de negocio. Vacio de lookup no prueba borrado; no eliminar una observacion positiva previa.

Activos privados

Original bytes inmutable, SHA-256, MIME detectado, tamano, cuenta/envio, operacion/fuente, fechas, formato, numero de paginas/dimensiones cuando aplica, estado de integridad, clave/version de cifrado y ruta privada. Nunca ruta arbitraria proporcionada por cliente ni descarga publica del filesystem.

Deduplicar binarios por hash dentro de dominio autorizado; multiples vinculos metadata al mismo activo sin filtrar existencia entre cuentas. Version nueva de POD/etiqueta crea activo nuevo, no reemplaza original. Referencias URL privadas/firmadas no se confunden con POD descargado/verificado.

Indices, privacidad y retencion

Indices futuros sobre cuenta/entorno/numero, IDs fuertes, fecha, estado, terminalidad, next_sync_at y eventos envio/fecha. Referencias tipadas con indice de busqueda, no unicidad universal. Paginacion local estable por fecha+ID. Particionar solo con volumen/medicion, no una tabla por mes ahora.

Telefonos/movil/email y direccion sensible requieren cifrado/acceso por campo; nombre/CP/poblacion para busqueda parcial necesitan una decision explicita: propuesta de columnas operativas minimas indexables con roles restringidos, cifrado de volumen/backups, resto sensible cifrado. Fernet no permite ILIKE sobre su ciphertext. No prometer busqueda parcial cifrada sin diseno aparte.

Historico sin purga automatica. TTL de frescura no borra registros ni prueba retencion de GLS. Gobierno de datos define revisiones, anonimizar/eliminar si corresponde y evidencia de la decision, sin ocultar trazabilidad tecnica.

---

Documento fuente: 16_POSTGRESQL_SCHEMA_INVENTORY.md

Inventario completo PostgreSQL observado

05/11/2026. Solo lectura de information_schema/pg_catalog. 39 tablas,386 columnas,59 indices,103 restricciones; definiciones documentales, NO script de migracion.

admin_users

Filas observadas: 2.

Indices:

• admin_users_pkey: CREATE UNIQUE INDEX admin_users_pkey ON public.admin_users USING btree (id)
• admin_users_username_key: CREATE UNIQUE INDEX admin_users_username_key ON public.admin_users USING btree (username)
• idx_admin_users_active_role: CREATE INDEX idx_admin_users_active_role ON public.admin_users USING btree (active, role)

Restricciones:

• admin_users_pkey [p]: PRIMARY KEY (id)
• admin_users_username_key [u]: UNIQUE (username)

alerts

Filas observadas: 0.

Indices:

• alerts_pkey: CREATE UNIQUE INDEX alerts_pkey ON public.alerts USING btree (id)

Restricciones:

• alerts_pkey [p]: PRIMARY KEY (id)

api_quota_policies

Filas observadas: 1.

Indices:

• api_quota_policies_pkey: CREATE UNIQUE INDEX api_quota_policies_pkey ON public.api_quota_policies USING btree (product, environment, period)

Restricciones:

• api_quota_policies_pkey [p]: PRIMARY KEY (product, environment, period)

api_requests

Filas observadas: 21.

Indices:

• api_requests_pkey: CREATE UNIQUE INDEX api_requests_pkey ON public.api_requests USING btree (id)
• idx_api_requests_usage: CREATE INDEX idx_api_requests_usage ON public.api_requests USING btree (provider, product, environment, occurred_at DESC)

Restricciones:

• api_requests_pkey [p]: PRIMARY KEY (id)

api_usage_daily

Filas observadas: 7.

Indices:

• api_usage_daily_pkey: CREATE UNIQUE INDEX api_usage_daily_pkey ON public.api_usage_daily USING btree (usage_date, product, environment)

Restricciones:

• api_usage_daily_pkey [p]: PRIMARY KEY (usage_date, product, environment)

app_config

Filas observadas: 26.

Indices:

• app_config_pkey: CREATE UNIQUE INDEX app_config_pkey ON public.app_config USING btree (key)

Restricciones:

• app_config_pkey [p]: PRIMARY KEY (key)

app_logs

Filas observadas: 2.

Indices:

• app_logs_pkey: CREATE UNIQUE INDEX app_logs_pkey ON public.app_logs USING btree (id)

Restricciones:

• app_logs_pkey [p]: PRIMARY KEY (id)
• app_logs_user_id_fkey [f]: FOREIGN KEY (user_id) REFERENCES admin_users(id) ON DELETE SET NULL

app_migrations

Filas observadas: 13.

Indices:

• app_migrations_pkey: CREATE UNIQUE INDEX app_migrations_pkey ON public.app_migrations USING btree (version)

Restricciones:

• app_migrations_pkey [p]: PRIMARY KEY (version)

bank_movements

Filas observadas: 0.

Indices:

• bank_movements_pkey: CREATE UNIQUE INDEX bank_movements_pkey ON public.bank_movements USING btree (id)

Restricciones:

• bank_movements_pkey [p]: PRIMARY KEY (id)

cache_resources

Filas observadas: 7.

Indices:

• cache_resources_pkey: CREATE UNIQUE INDEX cache_resources_pkey ON public.cache_resources USING btree (id)
• cache_resources_resource_key_key: CREATE UNIQUE INDEX cache_resources_resource_key_key ON public.cache_resources USING btree (resource_key)

Restricciones:

• cache_resources_pkey [p]: PRIMARY KEY (id)
• cache_resources_resource_key_key [u]: UNIQUE (resource_key)

carrier_capabilities

Filas observadas: 8.

Indices:

• carrier_capabilities_carrier_id_capability_key: CREATE UNIQUE INDEX carrier_capabilities_carrier_id_capability_key ON public.carrier_capabilities USING btree (carrier_id, capability)
• carrier_capabilities_pkey: CREATE UNIQUE INDEX carrier_capabilities_pkey ON public.carrier_capabilities USING btree (id)

Restricciones:

• carrier_capabilities_carrier_id_capability_key [u]: UNIQUE (carrier_id, capability)
• carrier_capabilities_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE CASCADE
• carrier_capabilities_pkey [p]: PRIMARY KEY (id)

carriers

Filas observadas: 6.

Indices:

• carriers_code_key: CREATE UNIQUE INDEX carriers_code_key ON public.carriers USING btree (code)
• carriers_pkey: CREATE UNIQUE INDEX carriers_pkey ON public.carriers USING btree (id)

Restricciones:

• carriers_code_key [u]: UNIQUE (code)
• carriers_pkey [p]: PRIMARY KEY (id)

cod_records

Filas observadas: 0.

Indices:

• cod_records_pkey: CREATE UNIQUE INDEX cod_records_pkey ON public.cod_records USING btree (id)

Restricciones:

• cod_records_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE SET NULL
• cod_records_parcel_id_fkey [f]: FOREIGN KEY (parcel_id) REFERENCES parcels(id) ON DELETE SET NULL
• cod_records_pkey [p]: PRIMARY KEY (id)
• cod_records_shipment_id_fkey [f]: FOREIGN KEY (shipment_id) REFERENCES shipments(id) ON DELETE SET NULL

cod_settlements

Filas observadas: 0.

Indices:

• cod_settlements_pkey: CREATE UNIQUE INDEX cod_settlements_pkey ON public.cod_settlements USING btree (id)

Restricciones:

• cod_settlements_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE SET NULL
• cod_settlements_pkey [p]: PRIMARY KEY (id)

connection_tests

Filas observadas: 23.

Indices:

• connection_tests_pkey: CREATE UNIQUE INDEX connection_tests_pkey ON public.connection_tests USING btree (id)
• idx_connection_tests_recent: CREATE INDEX idx_connection_tests_recent ON public.connection_tests USING btree (provider, environment, started_at DESC)

Restricciones:

• connection_tests_launched_by_fkey [f]: FOREIGN KEY (launched_by) REFERENCES admin_users(id) ON DELETE SET NULL
• connection_tests_pkey [p]: PRIMARY KEY (id)

connector_credentials

Filas observadas: 1.

Indices:

• connector_credentials_pkey: CREATE UNIQUE INDEX connector_credentials_pkey ON public.connector_credentials USING btree (provider, environment)

Restricciones:

• connector_credentials_pkey [p]: PRIMARY KEY (provider, environment)

documents

Filas observadas: 31.

Indices:

• documents_pkey: CREATE UNIQUE INDEX documents_pkey ON public.documents USING btree (id)
• documents_slug_key: CREATE UNIQUE INDEX documents_slug_key ON public.documents USING btree (slug)

Restricciones:

• documents_pkey [p]: PRIMARY KEY (id)
• documents_slug_key [u]: UNIQUE (slug)

enrichment_profiles

Filas observadas: 4.

Indices:

• enrichment_profiles_carrier_code_level_key: CREATE UNIQUE INDEX enrichment_profiles_carrier_code_level_key ON public.enrichment_profiles USING btree (carrier_code, level)
• enrichment_profiles_pkey: CREATE UNIQUE INDEX enrichment_profiles_pkey ON public.enrichment_profiles USING btree (id)

Restricciones:

• enrichment_profiles_carrier_code_level_key [u]: UNIQUE (carrier_code, level)
• enrichment_profiles_pkey [p]: PRIMARY KEY (id)

gls_allowed_services_cache

Filas observadas: 0.

Indices:

• gls_allowed_services_cache_origin_destination_contact_id_pr_key: CREATE UNIQUE INDEX gls_allowed_services_cache_origin_destination_contact_id_pr_key ON public.gls_allowed_services_cache USING btree (origin, destination, contact_id, product, service)
• gls_allowed_services_cache_pkey: CREATE UNIQUE INDEX gls_allowed_services_cache_pkey ON public.gls_allowed_services_cache USING btree (id)

Restricciones:

• gls_allowed_services_cache_origin_destination_contact_id_pr_key [u]: UNIQUE (origin, destination, contact_id, product, service)
• gls_allowed_services_cache_pkey [p]: PRIMARY KEY (id)

gls_environments

Filas observadas: 3.

Indices:

• gls_environments_pkey: CREATE UNIQUE INDEX gls_environments_pkey ON public.gls_environments USING btree (code)

Restricciones:

• gls_environments_pkey [p]: PRIMARY KEY (code)

gls_event_codes

Filas observadas: 336.

Indices:

• gls_event_codes_pkey: CREATE UNIQUE INDEX gls_event_codes_pkey ON public.gls_event_codes USING btree (code, language)

Restricciones:

• gls_event_codes_pkey [p]: PRIMARY KEY (code, language)

gls_product_matrix

Filas observadas: 24.

Indices:

• gls_product_matrix_pkey: CREATE UNIQUE INDEX gls_product_matrix_pkey ON public.gls_product_matrix USING btree (product, environment)

Restricciones:

• gls_product_matrix_environment_fkey [f]: FOREIGN KEY (environment) REFERENCES gls_environments(code)
• gls_product_matrix_last_test_id_fkey [f]: FOREIGN KEY (last_test_id) REFERENCES connection_tests(id) ON DELETE SET NULL
• gls_product_matrix_pkey [p]: PRIMARY KEY (product, environment)

iclientes_credentials

Filas observadas: 2.

Indices:

• iclientes_credentials_pkey: CREATE UNIQUE INDEX iclientes_credentials_pkey ON public.iclientes_credentials USING btree (environment)
• iclientes_credentials_secret_ref_key: CREATE UNIQUE INDEX iclientes_credentials_secret_ref_key ON public.iclientes_credentials USING btree (secret_ref)

Restricciones:

• iclientes_credentials_environment_check [c]: CHECK ((environment = ANY (ARRAY['test'::text, 'production'::text])))
• iclientes_credentials_pkey [p]: PRIMARY KEY (environment)
• iclientes_credentials_secret_ref_key [u]: UNIQUE (secret_ref)

iclientes_lab_labels

Filas observadas: 4.

Indices:

• iclientes_lab_labels_pkey: CREATE UNIQUE INDEX iclientes_lab_labels_pkey ON public.iclientes_lab_labels USING btree (id)

Restricciones:

• iclientes_lab_labels_pkey [p]: PRIMARY KEY (id)
• iclientes_lab_labels_trial_id_fkey [f]: FOREIGN KEY (trial_id) REFERENCES iclientes_lab_trials(id)

iclientes_lab_queries

Filas observadas: 2.

Indices:

• iclientes_lab_queries_pkey: CREATE UNIQUE INDEX iclientes_lab_queries_pkey ON public.iclientes_lab_queries USING btree (id)
• iclientes_lab_queries_trial_id_nonce_hash_key: CREATE UNIQUE INDEX iclientes_lab_queries_trial_id_nonce_hash_key ON public.iclientes_lab_queries USING btree (trial_id, nonce_hash)

Restricciones:

• iclientes_lab_queries_api_request_id_fkey [f]: FOREIGN KEY (api_request_id) REFERENCES api_requests(id)
• iclientes_lab_queries_created_by_fkey [f]: FOREIGN KEY (created_by) REFERENCES admin_users(id)
• iclientes_lab_queries_operation_check [c]: CHECK ((operation = ANY (ARRAY['GetExpCli'::text, 'EtiquetaEnvioV2'::text])))
• iclientes_lab_queries_pkey [p]: PRIMARY KEY (id)
• iclientes_lab_queries_state_check [c]: CHECK ((state = ANY (ARRAY['sending'::text, 'complete'::text, 'unknown'::text, 'not_sent'::text])))
• iclientes_lab_queries_trial_id_fkey [f]: FOREIGN KEY (trial_id) REFERENCES iclientes_lab_trials(id)
• iclientes_lab_queries_trial_id_nonce_hash_key [u]: UNIQUE (trial_id, nonce_hash)

iclientes_lab_trials

Filas observadas: 3.

Indices:

• iclientes_lab_trials_pkey: CREATE UNIQUE INDEX iclientes_lab_trials_pkey ON public.iclientes_lab_trials USING btree (id)
• idx_iclientes_lab_environment: CREATE INDEX idx_iclientes_lab_environment ON public.iclientes_lab_trials USING btree (environment, created_at DESC)
• idx_iclientes_lab_reference: CREATE UNIQUE INDEX idx_iclientes_lab_reference ON public.iclientes_lab_trials USING btree (lower(reference))

Restricciones:

• iclientes_lab_trials_api_request_id_fkey [f]: FOREIGN KEY (api_request_id) REFERENCES api_requests(id)
• iclientes_lab_trials_created_by_fkey [f]: FOREIGN KEY (created_by) REFERENCES admin_users(id)
• iclientes_lab_trials_environment_check [c]: CHECK ((environment = ANY (ARRAY['test'::text, 'production'::text])))
• iclientes_lab_trials_pkey [p]: PRIMARY KEY (id)
• iclientes_lab_trials_state_check [c]: CHECK ((state = ANY (ARRAY['draft'::text, 'sending'::text, 'accepted'::text, 'rejected'::text, 'unknown'::text, 'not_sent'::text])))

invoice_lines

Filas observadas: 0.

Indices:

• invoice_lines_pkey: CREATE UNIQUE INDEX invoice_lines_pkey ON public.invoice_lines USING btree (id)

Restricciones:

• invoice_lines_invoice_id_fkey [f]: FOREIGN KEY (invoice_id) REFERENCES invoices(id) ON DELETE CASCADE
• invoice_lines_pkey [p]: PRIMARY KEY (id)
• invoice_lines_shipment_id_fkey [f]: FOREIGN KEY (shipment_id) REFERENCES shipments(id) ON DELETE SET NULL

invoices

Filas observadas: 0.

Indices:

• invoices_pkey: CREATE UNIQUE INDEX invoices_pkey ON public.invoices USING btree (id)

Restricciones:

• invoices_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE SET NULL
• invoices_pkey [p]: PRIMARY KEY (id)

knowledge_articles

Filas observadas: 31.

Indices:

• knowledge_articles_pkey: CREATE UNIQUE INDEX knowledge_articles_pkey ON public.knowledge_articles USING btree (id)
• knowledge_articles_slug_key: CREATE UNIQUE INDEX knowledge_articles_slug_key ON public.knowledge_articles USING btree (slug)

Restricciones:

• knowledge_articles_pkey [p]: PRIMARY KEY (id)
• knowledge_articles_slug_key [u]: UNIQUE (slug)

known_api_endpoints

Filas observadas: 9.

Indices:

• known_api_endpoints_carrier_code_endpoint_key_environment_key: CREATE UNIQUE INDEX known_api_endpoints_carrier_code_endpoint_key_environment_key ON public.known_api_endpoints USING btree (carrier_code, endpoint_key, environment)
• known_api_endpoints_pkey: CREATE UNIQUE INDEX known_api_endpoints_pkey ON public.known_api_endpoints USING btree (id)

Restricciones:

• known_api_endpoints_carrier_code_endpoint_key_environment_key [u]: UNIQUE (carrier_code, endpoint_key, environment)
• known_api_endpoints_last_test_id_fkey [f]: FOREIGN KEY (last_test_id) REFERENCES connection_tests(id) ON DELETE SET NULL
• known_api_endpoints_pkey [p]: PRIMARY KEY (id)

official_documents

Filas observadas: 16.

Indices:

• idx_official_documents_carrier_family: CREATE INDEX idx_official_documents_carrier_family ON public.official_documents USING btree (carrier_code, integration_family, original_or_derivative)
• official_documents_physical_path_key: CREATE UNIQUE INDEX official_documents_physical_path_key ON public.official_documents USING btree (physical_path)
• official_documents_pkey: CREATE UNIQUE INDEX official_documents_pkey ON public.official_documents USING btree (id)

Restricciones:

• official_documents_derivative_of_id_fkey [f]: FOREIGN KEY (derivative_of_id) REFERENCES official_documents(id) ON DELETE SET NULL
• official_documents_physical_path_key [u]: UNIQUE (physical_path)
• official_documents_pkey [p]: PRIMARY KEY (id)

parcels

Filas observadas: 0.

Indices:

• parcels_pkey: CREATE UNIQUE INDEX parcels_pkey ON public.parcels USING btree (id)

Restricciones:

• parcels_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE SET NULL
• parcels_pkey [p]: PRIMARY KEY (id)
• parcels_shipment_id_fkey [f]: FOREIGN KEY (shipment_id) REFERENCES shipments(id) ON DELETE CASCADE

print_derivatives

Filas observadas: 5.

Indices:

• print_derivatives_pkey: CREATE UNIQUE INDEX print_derivatives_pkey ON public.print_derivatives USING btree (id)

Restricciones:

• print_derivatives_label_id_fkey [f]: FOREIGN KEY (label_id) REFERENCES iclientes_lab_labels(id)
• print_derivatives_method_check [c]: CHECK ((method = ANY (ARRAY['cups'::text, 'epl2'::text])))
• print_derivatives_pkey [p]: PRIMARY KEY (id)

print_jobs

Filas observadas: 6.

Indices:

• print_jobs_nonce_hash_key: CREATE UNIQUE INDEX print_jobs_nonce_hash_key ON public.print_jobs USING btree (nonce_hash)
• print_jobs_pkey: CREATE UNIQUE INDEX print_jobs_pkey ON public.print_jobs USING btree (id)

Restricciones:

• print_jobs_copies_check [c]: CHECK (((copies >= 1) AND (copies <= 5)))
• print_jobs_created_by_fkey [f]: FOREIGN KEY (created_by) REFERENCES admin_users(id)
• print_jobs_derivative_id_fkey [f]: FOREIGN KEY (derivative_id) REFERENCES print_derivatives(id)
• print_jobs_label_id_fkey [f]: FOREIGN KEY (label_id) REFERENCES iclientes_lab_labels(id)
• print_jobs_method_check [c]: CHECK ((method = ANY (ARRAY['cups'::text, 'epl2'::text])))
• print_jobs_nonce_hash_key [u]: UNIQUE (nonce_hash)
• print_jobs_physical_result_check [c]: CHECK ((physical_result = ANY (ARRAY['unreviewed'::text, 'good'::text, 'bad'::text])))
• print_jobs_pkey [p]: PRIMARY KEY (id)
• print_jobs_printer_id_fkey [f]: FOREIGN KEY (printer_id) REFERENCES print_printers(id)
• print_jobs_reviewed_by_fkey [f]: FOREIGN KEY (reviewed_by) REFERENCES admin_users(id)
• print_jobs_state_check [c]: CHECK ((state = ANY (ARRAY['preparing'::text, 'sending'::text, 'submitted'::text, 'transmitted'::text, 'error'::text, 'unknown'::text])))
• print_jobs_trial_id_fkey [f]: FOREIGN KEY (trial_id) REFERENCES iclientes_lab_trials(id)

print_printers

Filas observadas: 1.

Indices:

• print_printers_pkey: CREATE UNIQUE INDEX print_printers_pkey ON public.print_printers USING btree (id)

Restricciones:

• print_printers_default_method_check [c]: CHECK ((default_method = ANY (ARRAY['cups'::text, 'epl2'::text])))
• print_printers_host_check [c]: CHECK ((host = '[IP INTERNA OMITIDA]'::text))
• print_printers_max_copies_check [c]: CHECK (((max_copies >= 1) AND (max_copies <= 5)))
• print_printers_pkey [p]: PRIMARY KEY (id)
• print_printers_port_check [c]: CHECK ((port = 9100))
• print_printers_queue_check [c]: CHECK ((queue = 'Zebra_LP2844'::text))
• print_printers_threshold_check [c]: CHECK (((threshold >= 1) AND (threshold <= 254)))

shipments

Filas observadas: 0.

Indices:

• shipments_pkey: CREATE UNIQUE INDEX shipments_pkey ON public.shipments USING btree (id)

Restricciones:

• shipments_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE SET NULL
• shipments_pkey [p]: PRIMARY KEY (id)

synchronizations

Filas observadas: 0.

Indices:

• synchronizations_pkey: CREATE UNIQUE INDEX synchronizations_pkey ON public.synchronizations USING btree (id)

Restricciones:

• synchronizations_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE SET NULL
• synchronizations_pkey [p]: PRIMARY KEY (id)

technical_lessons

Filas observadas: 8.

Indices:

• technical_lessons_lesson_key_key: CREATE UNIQUE INDEX technical_lessons_lesson_key_key ON public.technical_lessons USING btree (lesson_key)
• technical_lessons_pkey: CREATE UNIQUE INDEX technical_lessons_pkey ON public.technical_lessons USING btree (id)

Restricciones:

• technical_lessons_evidence_test_id_fkey [f]: FOREIGN KEY (evidence_test_id) REFERENCES connection_tests(id) ON DELETE SET NULL
• technical_lessons_lesson_key_key [u]: UNIQUE (lesson_key)
• technical_lessons_pkey [p]: PRIMARY KEY (id)

tracking_events

Filas observadas: 0.

Indices:

• tracking_events_pkey: CREATE UNIQUE INDEX tracking_events_pkey ON public.tracking_events USING btree (id)

Restricciones:

• tracking_events_carrier_id_fkey [f]: FOREIGN KEY (carrier_id) REFERENCES carriers(id) ON DELETE SET NULL
• tracking_events_parcel_id_fkey [f]: FOREIGN KEY (parcel_id) REFERENCES parcels(id) ON DELETE CASCADE
• tracking_events_pkey [p]: PRIMARY KEY (id)

Migraciones aplicadas

• 001_phase_0_5_schema; 2026-07-15 11:29:35.809436+00:00
• 002_default_config; 2026-07-15 11:29:35.809436+00:00
• 003_phase_0_6_gls_diagnostics; 2026-07-15 14:16:51.137166+00:00
• 004_phase_0_7_gls_explorer; 2026-07-16 06:18:46.913838+00:00
• 005_phase_1_platform_base; 2026-07-16 07:29:43.721628+00:00
• 006_phase_1_documents_metadata; 2026-07-16 07:37:37.716754+00:00
• 007_official_provider_documents; 2026-09-01 15:30:41.931247+00:00
• 008_user_management; 2026-09-01 15:37:24.826622+00:00
• 009_iclientes_secret_reference; 2026-10-19 15:33:25.817489+00:00
• 010_iclientes_test_laboratory; 2026-11-02 13:09:27.891434+00:00
• 011_label_printing; 2026-11-02 19:41:20.867136+00:00
• 012_native_epl_labels; 2026-11-03 07:42:54.416640+00:00
• 013_iclientes_production; 2026-11-03 11:17:10.698983+00:00

No hay DDL ejecutado. Para reutilizacion/carencias ver informe06; para modelo futuro informe08.

---

Suplemento: aptitud para fechas y conciliacion

05/11/2026. Diseno, no implementacion ni DDL. El anexo anterior contiene el esquema REAL completo, no el modelo propuesto. 39 tablas / 386 columnas / 59 indices / 103 restricciones / 13 migraciones. Ninguna migracion nueva.

Evaluacion por necesidad

No cabe afirmar que las tablas existentes ya soporten la busqueda operativa completa. Si se comienza despues de autorizacion, reutilizar identidad/core y ampliar sin dependencia de un nombre SOAP concreto: el adapter produce resultados/cobertura.

Fechas que deben distinguirse

Cada dato lleva fuente, campo original, observacion, precision y timezone/calidad. Un campo sin dato permanece NULL/desconocido, no se rellena con now() ni con otra fecha. Guardar instantes como timestamptz UTC y presentar Europe/Madrid; si solo hay fecha sin hora no inventar medianoche como instante real. Una hora sin zona requiere politica explicita y conservar incertidumbre, incluidos cambios de horario.

Filtro por defecto propuesto: Fecha de expedicion, si GLS acredita su campo; alternativa de grabacion si esa es la semantica real del contrato. La UI debe nombrar el criterio y mostrar origen/ausencias, nunca un COALESCE silencioso entre fechas. Permitir criterios explicitos de grabacion, recogida, entrega, ultimo evento o alta TH. Para datos sin fecha operativa ofrecer vista separada, no esconderlos como si no existieran.

Para un intervalo de fechas inclusivas en la UI, convertir localmente al rango [inicio del primer dia, inicio del dia siguiente al ultimo) en Europe/Madrid. Ejemplo de contraste: 04/11/2025-04/12/2025 seria [2025-11-04T00:00+01:00, 2025-12-05T00:00+01:00). Esto es una propuesta SQL local, NO un payload GLS ni afirmacion de que Extranet o GetEnvios utilicen esos extremos. Para agosto el offset cambia; calcular con zona IANA, no restar 24 horas fijas.

Indices y consultas futuras

• Btree cuenta/entorno/fecha_expedicion/id para periodo con paginacion estable.
• Btree cuenta/estado/fecha y next_sync_at para activos/incidencias; separar resultado de ciclo.
• Indice de IDs scoped y referencias tipadas; no hacer unico el albaran/referencia libre sin prueba.
• Indice envio/event_at e identidad revisable del evento, preservando codigo y namespace originales.
• Busqueda de nombre normalizado/CP/poblacion con indices apropiados (trigram solo si se aprueba

la extension); datos minimizados, roles y decision de cifrado, no ILIKE sobre Fernet.

No se ejecuta CREATE INDEX/EXTENSION ni se optimiza una carga inexistente.

Conciliacion de conjuntos sin duplicados

Crear en una fase futura un concepto de ejecucion/ventana: cuenta, entorno, fuente, criterio temporal, inicio/fin, timezone, filtros de estados/canales, timestamp, numero de paginas, cursor/total, hash de IDs, version de contrato y grado de cobertura. Cobertura = desconocida / parcial / completa / fallo; un HTTP 200 no implica completa.

R = IDs de GLS de una ventana completamente recuperada; L = IDs locales del mismo ambito y criterio. R-L = pendientes de importar; R interseccion L = candidatos a refresco/verificacion; L-R = discrepancias que deben investigarse, NO bajas automaticas. Si R es parcial/desconocido, L-R no permite afirmar ausencia remota. No usar un limite de pagina o una cache vencida como conjunto completo. Los 61 de Extranet son referencia de contraste, no contenido de R hasta recibir los IDs por una fuente autorizada.

Clasificar tambien registro incompleto (faltan ficha/eventos/fechas), estado obsoleto (segun politica SLA y ultima sync correcta), documento pendiente y conflicto de identidad. Deduplicar por ID fuerte scoped; relacionar devoluciones, sin fusion por nombre/referencia. Toda ingesta atomica e idempotente; parser aplicable a originales cifrados, no copias sanitizadas truncadas. Un fallo posterior a la captura se reejecuta localmente sin HTTP.

Un checkpoint se avanza solo al consolidar una ventana completa. Distinguir watermark de descubrimiento, de refresco y de POD. Reservar solape retrospectivo configurable para publicaciones tardias/cambios, sin fijar arbitrariamente cuantos dias bastan. Si GLS solo filtra fecha de expedicion, refrescar tambien activos antiguos fuera de ayer; no confiar en ese filtro como feed de modificaciones ni omitir incidencias antiguas.

Condiciones para comenzar sin redisenar despues

Modelo, consultas PostgreSQL, deduplicacion, parser offline, capturas/replay y estados de completitud pueden desarrollarse tras otra aprobacion. Antes: backup/restauracion probados, migracion revisada, semantica de identidad/fechas, datos sinteticos y privacidad. El adapter debe distinguir discover(window) (capacidad pendiente) de refresh_known(ids) (capacidad documentada), con resultado y cobertura explicitos. No habilitar discover ni prometer historico completo hasta contrato/prueba GLS. No implementar ahora; la peticion actual se limita a evaluar y documentar.

Actualizacion aplicada de etapa D

DATABASE_CHANGELOG

Etapa D - migracion 018_carrier_execution

Esquema aditivo, sin borrar ni duplicar el repositorio existente.

• sender_centers: codigo unico, etiqueta, datos cifrados, revision, activo y auditoria.
• carrier_account_senders: relacion N:M, claves foraneas y un habitual por cuenta.
• shipment_drafts: sender_center_id y sender_revision, snapshot dentro del cifrado.
• shipments: provider_acknowledged_at, distinto de grabacion/recogida GLS.
• synchronizations: pause_requested y run_count, independientes del presupuesto

de fallos/leases ya existente.

• synchronization_items: execution_id, receipt_ciphertext, evidence_ref, HTTP y

duracion. Reutiliza los checkpoints previos, sin otro repositorio de trabajos.

• app_config: flags nuevos de creacion operativa y trabajador conocidos a false.

17 a 18 probado con cuatro migradores concurrentes y filas anteriores intactas. Backup previo restaurado en base temporal: 54 tablas, 111 indices, hashes y recuentos coincidentes. Tras la migracion se han verificado 56 tablas y 115 indices. El resultado aplicado se comprueba en STAGE_D_REPORT y evidencia privada. Rollback de aplicacion al codigo anterior, conservando el esquema aditivo. No ejecutar DOWN ni restaurar la BD activa sin revision y autorizacion.