TRANSPORT HUBRevision documental

IMPLEMENTATION_PLAN

Plan vigente despues de etapa D

Implementado: adaptador de creacion conectado pero bloqueado, centros remitentes, trabajador acotado de GetExpCli, importador revisable y pausado, cuotas, evidencia, conciliacion y nueva navegacion administrativa. Todo probado con mocks.

Orden siguiente, sujeto a autorizacion: 1. Revision humana del puerto 80, remitente/cuenta y confirmacion de datos. 2. Autorizar una prueba real y activar de forma controlada los bloqueos y permisos minimos del servicio, sin alterar contratos ni secretos. 3. Una llamada de creacion y revision de respuesta, sin acciones auxiliares. 4. Autorizar un lote pequeno de conocidas/importacion, con cuota y resultados revisados antes de ampliar. Meses recientes primero, objetivo agosto de 2025. 5. Validar proyeccion de estados/incidencias y calidad de busqueda local. 6. Preparar sincronizacion regular solo tras delimitar cobertura y costes. 7. POD progresivo bajo autorizacion separada, nunca descarga indiscriminada. 8. Cerrar dia solo cuando exista contrato suficientemente validado.

La enumeracion por fechas sigue pendiente de GLS. El importador no es un sustituto completo ni demuestra cobertura de toda la cuenta.

Plan historico previo

Etapa C entregada

1. JSON documental disponible sobre copias sanitizadas, con limites y hashes. 2. Interfaz local 80: borradores, validacion, revision y resultado simulado. 3. Busqueda PostgreSQL, filtros combinables, paginacion y ficha documental. 4. Administracion 88 inventariada, menu preservado, preparacion de importacion, sincronizacion y POD; edicion de cuotas con permisos y auditoria. 5. Migracion 017, backup restaurado y pruebas sinteticas sin GLS.

Revision humana inmediata

No compartir passwords ni cookies para esa revision. El puerto 80 usa las cuentas existentes, pero requiere su propia sesion. No hay cuenta nueva.

Siguiente incremento: preparacion real controlada

El bloqueo real sigue activo. Antes de levantarlo, con nueva autorizacion:

1. Revisar datos y casos habituales, incluyendo centros remitentes persistentes configurables; no convertir destinatarios de pruebas en configuracion. 2. Implementar el adaptador de sender sobre IClientesSoapClient existente, conservando timeout, TLS, una llamada, sin redirecciones ni retry. 3. Mapear SoapCapture a recibo duradero y normalizador; no duplicar protocolos. 4. Resolver UID solo internamente por cuenta/entorno, nunca en borrador/HTML. 5. Asociar ambitos de cuota correctos para proveedor/API/credencial/cuenta. 6. Exigir permiso, CSRF, revision vigente y confirmacion EXPEDICION REAL. 7. Mantener intento unico y conciliacion de resultados ambiguos sin reenvio. 8. Primera prueba real independiente, autorizada, con contador y evidencia.

La tabla y el coordinador no requieren redisenarse para conectar ese sender. No se promete activar la produccion mediante un checkbox de esta entrega.

Importacion y sincronizacion

Continuar con lotes recientes pequenos previamente revisados. Implementar el worker de lecturas solo tras autorizar su consumo, con pausa/reanudacion, presupuesto, prioridad interactiva y checkpoints idempotentes. GetExpCli recupera conocidos; no demuestra enumeracion ni integridad de un periodo.

Actualizar acontecimientos de activos/incidencias, conservar revisiones, fechas y fuente, y mostrar ultima sincronizacion y cobertura. Usar PostgreSQL al buscar, incluso sin conexion GLS. No ocultar fallos parciales.

POD: solo conocidos entregados, sin copia existente vigente y con permiso/ cuota. Mantener original cifrado y metadatos, sin descarga masiva automatica.

La investigacion de GetEnvios sigue paralela: pedir contrato IN/OUT y garantia de lectura, filtros, paginacion, cobertura e historico. No lanzar payloads inventados ni detener por ello el desarrollo local.

Administracion

Tras revisar el inventario, reagrupar navegacion sin eliminar rutas ni capacidades: Panel, Transportistas, Sincronizacion, Administracion, Diagnostico y Documentacion. Homogeneizar permisos legacy antes de ampliar usuarios de lectura. No crear una segunda administracion.

Cerrar dia

No implementado. Requiere contrato oficial y efectos validados. No equiparar GetManifiesto con un cierre ni inferir semantica por nombre del WSDL. No se ejecuta una operacion desconocida para descubrirla.

Referencia historica

IMPLEMENTATION_PLAN

Etapa C entregada

1. JSON documental disponible sobre copias sanitizadas, con limites y hashes. 2. Interfaz local 80: borradores, validacion, revision y resultado simulado. 3. Busqueda PostgreSQL, filtros combinables, paginacion y ficha documental. 4. Administracion 88 inventariada, menu preservado, preparacion de importacion, sincronizacion y POD; edicion de cuotas con permisos y auditoria. 5. Migracion 017, backup restaurado y pruebas sinteticas sin GLS.

Revision humana inmediata

No compartir passwords ni cookies para esa revision. El puerto 80 usa las cuentas existentes, pero requiere su propia sesion. No hay cuenta nueva.

Siguiente incremento: preparacion real controlada

El bloqueo real sigue activo. Antes de levantarlo, con nueva autorizacion:

1. Revisar datos y casos habituales, incluyendo centros remitentes persistentes configurables; no convertir destinatarios de pruebas en configuracion. 2. Implementar el adaptador de sender sobre IClientesSoapClient existente, conservando timeout, TLS, una llamada, sin redirecciones ni retry. 3. Mapear SoapCapture a recibo duradero y normalizador; no duplicar protocolos. 4. Resolver UID solo internamente por cuenta/entorno, nunca en borrador/HTML. 5. Asociar ambitos de cuota correctos para proveedor/API/credencial/cuenta. 6. Exigir permiso, CSRF, revision vigente y confirmacion EXPEDICION REAL. 7. Mantener intento unico y conciliacion de resultados ambiguos sin reenvio. 8. Primera prueba real independiente, autorizada, con contador y evidencia.

La tabla y el coordinador no requieren redisenarse para conectar ese sender. No se promete activar la produccion mediante un checkbox de esta entrega.

Importacion y sincronizacion

Continuar con lotes recientes pequenos previamente revisados. Implementar el worker de lecturas solo tras autorizar su consumo, con pausa/reanudacion, presupuesto, prioridad interactiva y checkpoints idempotentes. GetExpCli recupera conocidos; no demuestra enumeracion ni integridad de un periodo.

Actualizar acontecimientos de activos/incidencias, conservar revisiones, fechas y fuente, y mostrar ultima sincronizacion y cobertura. Usar PostgreSQL al buscar, incluso sin conexion GLS. No ocultar fallos parciales.

POD: solo conocidos entregados, sin copia existente vigente y con permiso/ cuota. Mantener original cifrado y metadatos, sin descarga masiva automatica.

La investigacion de GetEnvios sigue paralela: pedir contrato IN/OUT y garantia de lectura, filtros, paginacion, cobertura e historico. No lanzar payloads inventados ni detener por ello el desarrollo local.

Administracion

Tras revisar el inventario, reagrupar navegacion sin eliminar rutas ni capacidades: Panel, Transportistas, Sincronizacion, Administracion, Diagnostico y Documentacion. Homogeneizar permisos legacy antes de ampliar usuarios de lectura. No crear una segunda administracion.

Cerrar dia

No implementado. Requiere contrato oficial y efectos validados. No equiparar GetManifiesto con un cierre ni inferir semantica por nombre del WSDL. No se ejecuta una operacion desconocida para descubrirla.

Referencia historica de preparacion

Preparacion de etapa C: Grabar envios

Estado: preparada para implementar, no activada. No se ha iniciado el servicio operativo 80 ni se ha creado ninguna expedicion en esta etapa.

Secuencia tecnica propuesta

1. Formulario autenticado del puerto 80, transportista/cuenta explicitos, remitente seleccionado y datos revisables de destinatario y servicio. 2. Validacion local con el contrato GLS preservado. No inventar campos ni hacer llamadas para validar un borrador al abrir una pagina. 3. Guardar borrador de negocio cifrado mediante prepare_operation; generar clave idempotente y referencia unica por cuenta. Nunca incluir UID en ese borrador. Separar permiso de grabacion del de consulta/auditoria. 4. Pantalla de confirmacion: PRODUCCION - EXPEDICION REAL, cuenta, servicio, bultos, peso, reembolso, seguro y cualquier adicional. CSRF y nonce. 5. Resolucion de secreto solo dentro del adaptador de transporte. Comprobar entorno de cuenta y referencias TEST/PRODUCCION, sin devolver secreto. 6. Seleccionar todos los ambitos de cuota y actor. La cuenta no puede elegir ambitos ajenos para evitar limites. Operacion interactiva P0. 7. Confirmar flags explicitos y reservar; escribir diario/dispatch cifrado. 8. Enviar GrabaServicios exactamente una vez, timeout y TLS verificados, sin redirecciones ni retry. Reutilizar cliente SOAP validado, no otro. 9. Convertir la captura HTTP completa existente a RemoteReceipt, conservando request_sent, complete, errores de lectura, timestamp y headers. 10. Guardar original cifrado, contabilizar una vez y normalizar en un adaptador GLS con codigos y fechas de su contrato, no en el nucleo. 11. Ingestar expedicion, identificadores, referencias, bultos, partes, eventos y etiquetas de la misma respuesta en la transaccion local. 12. Si la persistencia falla, mostrar conciliacion requerida. Replay local del recibo conservado, sin invocar GLS. Si no existe recibo recuperable, revisar manualmente la consulta contractual por identificador/referencia y solicitar permiso para una lectura separada. Nunca repetir el alta.

Validaciones antes de activar

Etapas paralelas y posteriores

Buscar envios: leer PostgreSQL, sin GLS al buscar; paginacion y filtros combinables de fechas, estado, incidencias, COD, cuenta y transportista. El nucleo ya ofrece una consulta acotada por fecha/estado/destinatario, pero no sustituye todavia el buscador operativo completo.

Importador temporal 88: texto pegado de Extranet, candidatos validados, revision de ambiguedades, lotes pequenos, recientes a antiguos. Jobs y checkpoints disponibles; no hay importacion completa sin una fuente de descubrimiento que demuestre cobertura. Un GetExpCli de conocido no lista.

POD: almacenar documento original cifrado y metadatos; descargar solo si procede, falta o caduca, con cuota y permiso. No descargar masivamente.

Cerrar dia: bloqueado hasta disponer del contrato oficial y efectos operativos acreditados. No sustituir por GetManifiesto ni inventar XML.

Dependencias abiertas

Contrato de enumeracion por fechas, profundidad historica, cierre y cuotas iClientes siguen pendientes de GLS. No impiden construir el repositorio, pero si afirmar sincronizacion completa o cierre operativo validado.

Plan historico completo

Plan de implementacion, pendiente de aprobacion

No ejecutar al terminar la auditoria. Cada fase requiere alcance, backup, tests, documentacion, configuracion externa, rollback y criterios de salida. No nuevos transportistas, banca, facturacion o SMS en este plan inicial.

FaseDependencias y trabajo propuestoCriterio de aceptacion
0. Cerrar incertidumbresRecibir IN/OUT listado, alcance historico, POD y limites; aprobar R1 y luego bloques historicos si procede.Capacidad documentada y prueba minima real por autorizacion, o limitacion/fallback oficial claramente aceptados.
1. Proteccion y releaseBackup consistente BD+activos+claves, restauracion de prueba autorizada, dependencias inventariadas y migraciones separadas del arranque.Recuperacion verificada y rol/runtime definido sin cambiar otras VMs sin permiso.
2. Modelo historicoExtender nucleo existente con cuentas, IDs, referencias, snapshots, eventos/revisiones, operaciones y documentos privados minimos.Migraciones aprobadas/testadas, aislamiento cuenta/entorno, sin destruir laboratorio/originales.
3. Ingesta offlineReprocesar evidencias existentes autorizadas con parser versionado y cuatro ejes; no llamadas externas para reimportar.Sin duplicados, PII autorizada completa, replay tras fallo BD, historial inmutable; TH-P-001 no termina ENTREGADA.
4. Ejecutor y consumoCuenta/API/entorno, reservas P0-P3, captura de cada HTTP, errores y lease/backoff controlado.No exceso de reserva, OAuth contado, fallo parcial sin retry de escritura, estado desconocido conciliable.
5. Lectura/importacion inicialContrato/semillas oficiales; primer job20 configurable solo datos/referencias, sin POD.Datos y todos los eventos persistidos, checkpoint/reanudacion, informe de cobertura y consumo real.
6. API intranet y busqueda80Contratos v1/RBAC/contactos, API de lectura y UI PC sobre mismo repositorio; desplegar80 solo con aprobacion de red/HTTP/seguridad.88 intacto, ninguna ruta tecnica expuesta80, sin GLS al filtrar/paginar, funciona sin Internet con DB disponible.
7. Seguimiento continuoCadencias/ventanas acordadas, activos/incidencias/incompletos, terminales y refresh manual.Sincronizacion presupuestada, circuit breaker, sin perdida ni reinicio de contador.
8. POD progresivoPrimera pasada completada, formato y alcance probados, politicas privadas y cuota aprobadas.Descarga gradual, hash/validacion, sin duplicar verificados, control de enlaces y todos los HTTP auditados.
9. Escritura operativaGrabar envios/CrearExpedicion intranet, centros remitentes, revision/confirmacion e idempotencia; Anula reusable solo en subfase autorizada.Un solo envio ante doble POST, respuesta ambigua no reintentada, produccion inequívoca y credenciales aisladas.
10. Cerrar dia complementarioContrato domestico de cierre/manifiesto y necesidad de negocio expresamente confirmados.Ultimo modulo, no dependencia normal de alta/seguimiento; ninguna prueba de cierre sin permiso especifico.

Fases 0 y preparacion de contratos/modelo pueden avanzar documentalmente en paralelo. No bloquear todo el producto esperando ShipIT: queda fuera de la ruta principal. El repositorio y la ingesta offline no inventan enumeracion; el importador historico completo necesita realmente IDs o listado oficial.

Que implementar primero, tras aprobar

Primero proteccion recuperable y diseno de identidad/estados/ingesta local, mientras se obtiene el contrato de descubrimiento. No empezar por una UI que llame GLS en cada filtro ni por descargas masivas de POD. El primer incremento operativo debe demostrar persistencia de conocidos y consumo correcto antes de automatizar historico o ampliar escrituras.

Calidad transversal

Tests sinteticos para cifrado/permisos, parser robusto/500/Fault, scope de cuenta, dedup/revisiones, referencias heredadas, estados cruzados, idempotencia, backoff/cuota, doble worker, documentos inmutables, cookies por interfaz, API consumidor y restauracion. Pruebas externas separadas y contadas.

No reutilizar UID real en unit tests ni versiones crudas de documentos con credenciales. Validar datos completos en parser privado y solo vistas sanitizadas en logs. Changelog/README y runbooks se actualizan al implementar, no mediante afirmaciones de funcionalidades aun no construidas.

Aprobaciones pendientes antes de actuar

Elegir bloque de pruebas (recomendado R1: una GetExpCli reciente), aprobar politica de datos/contactos y autenticacion intranet, contrato historico, plan backup/restore, schema y criterios de roles/puertos. Esta auditoria no autoriza esas actuaciones ni genera tareas programadas.

PROJECT_STATUS

Fecha: 06/11/2026. Etapa A: canal documental de auditoria.

Alcance

Se prepara un servicio independiente en puerto 85 y su control administrativo en puerto 88. Publicacion anonima autorizada expresamente para copias tecnicas revisadas. No es un acceso anonimo a TRANSPORT HUB ni una cuenta de ChatGPT.

El canal estara deshabilitado al entregar. La habilitacion no solicita datos a GLS. La publicacion externa th85.aeizoon.com corresponde al responsable del proxy. No se ha modificado el proxy ni se han creado expediciones o descargado POD.

Funciones de etapas posteriores

El puerto 80 no se considera implementado con este hito. El importador no se ha ejecutado y no existe aun enumeracion API por cuenta/fechas acreditada. La busqueda futura sera local y diferenciara cobertura completa de parcial.

Entrega incremental

El resultado de tests y las verificaciones reales de despliegue se registran en TEST_RESULTS e IMPLEMENTATION_LOG antes de dar por aceptada esta etapa. No se avanzara a llamadas GLS reales por el mero hecho de aprobar el desarrollo.

Resultado tecnico del despliegue

Servicio documental activo en 85, deshabilitado al terminar. Panel 88 con health/ready HTTP 200. Doce documentos completos, 26 representaciones y 29 archivos permitidos contando indice, manifiesto y CSS.

Activacion/desactivacion del motor comun comprobada realmente por HTTP; el control web tiene pruebas de administradores, CSRF y renderizado. La validacion con una sesion humana normal del 88 corresponde a Juan; no se ha suplantado una sesion ni creado una cuenta para la prueba.

Preparado para configurar la publicacion externa por el responsable del proxy. Esa publicacion HTTPS y la ausencia de cache intermedia todavia deben comprobarse desde fuera; no se presentan como realizadas.