Saltar a contenido

Hisotial de cambios

Historial de cambios, nuevas funcionalidades y correcciones del sistema LogiGho.

Formato de entrada

## [version o fecha] — Descripción corta

### Nuevas funcionalidades
- Descripción de qué se agregó

### Cambios
- Descripción de qué cambió

### Correcciones
- Descripción de bugs corregidos

### Documentación
- Qué se documentó en esta entrega

[2026-11-11] — Comercial: Panel comercial, Seguimiento de clientes y formulario Accesos en LOGI

Nuevas funcionalidades

  • Panel comercial (une RegisterContact, Users y Tienda), formulario Accesos en LOGI obligatorio para Red social y notificación a Comercial y COO.

Cambios

  • Seguimiento de clientes reorganizado; en PreProd las llamadas se reparten entre la API HTTP y la REST.

Documentación

[2026-11-10] — Preferencias de usuario y administración de experiencias: backend del Sistema de Experiencias (PreProd en curso)

Nuevas funcionalidades

  • GET/PUT /preferencias/mia: la experiencia visual de cada usuario y las que puede usar (la decide el servidor).
  • /experiencias: administración del catálogo (solo desarrollo) y Lambda en Native AOT (spec 014).

Documentación

[2026-11-08] — Novedades Inter: reportes v8, dirección del mensajero, imágenes firmadas y front (producción)

Nuevas funcionalidades

  • Distancia por calle = mínimo entre a pie y carro; colores sin cambio (≤250 verde, 251–500 amarillo, >500 rojo).
  • Dirección en texto del mensajero (DireccionMensajero, geocodificación inversa, una vez por punto): 8 112 guías calculadas, ~USD 40 una sola vez.
  • Reporte 1 con filtro de estado en sus 4 hojas; reporte 2 sin guías de AuditoriaCambioEntregaInter; columnas de dirección del mensajero, días desde la primera novedad e «Imagen novedad N» («Ver imagen», máximo 10).
  • Ruta GET /novedades/evidencia con enlaces fijos firmados (HMAC-SHA256) y bucket privado.
  • Front (PR 637): dirección del repartidor desde el backend, mapa sin Routes API, periodo de cerradas 7/30/90/todo con cursor por _id, filtro de distancia múltiple, Estado Logigho e Interrapidísimo.

Documentación

[2026-11-06] — Novedades Inter: distancia a la dirección y reportes por Slack (PreProd)

Nuevas funcionalidades

  • Funciones ApiLambdaNovedadesInterDistancias (metros por calle entre la dirección del pedido y el punto del mensajero, con color) y ApiLambdaNovedadesInterReportes (dos Excel por Slack, martes y viernes 8:00 y comando /reporte-novedades).
  • Vista de novedades con columna de distancia, filtro, etiquetas «Sin dirección» y «Dirección por validar» y pestaña «Comparar con dirección».

Documentación

[2026-10-30] — Métricas de entrega por ciudad y transportadora (producción)

Nuevas funcionalidades

  • Vista Entregas (Mi Tienda) y panel de administración con la mejor transportadora por ciudad, corridas con auditoría y ajuste visual del porcentaje.
  • Lambda ApiLambdaMetricasEntregaCiudad con corrida semanal y manual; primera corrida en producción: 926 476 guías en 1 min 53 s.

Correcciones

  • Verificación de la firma del JWT (antes solo se decodificaba) y arreglo de la corrida manual (evento Tipo/tipo y candado reentrante).

Documentación

[2026-10-26] — Relación de Despacho: histórico completo, buscador de guías, Unir lotes y versión para celular

Nuevas funcionalidades

  • Buscador de guías en el histórico con dos modos: Lote (una o varias guías, muestra los lotes donde están y avisa las no encontradas) y Guía (una guía, abre el detalle de su lote mostrando solo esa). Busca en todo el historial y acepta pegar una columna de Excel.
  • Filtros del histórico: fecha por día o por rango (dos clics en el calendario), ecosistema, tienda y transportadora.
  • Columna Transportadora con etiqueta de color (Inter, Envía, Servientrega, TCC) y fecha con hora.
  • Ver 10 / 25 / 50 / 100 por página en la lista de lotes y en el detalle del lote.
  • Unir lotes: franja con el resumen de los lotes marcados, "Quitar selección" y un aviso de confirmación antes de generar el PDF unido.
  • Versión para celular: tarjetas en vez de tablas, filtros en dos columnas, menús como hoja inferior y la vista a todo el ancho.
  • Tour de 11 pasos que recorre Pendientes e Histórico.

Cambios

  • Las guías de Envía se muestran con su 0 inicial en tablas, PDF y código de barras (la base de datos no cambia).
  • Logo de Envía nuevo (transparente, alta calidad) y logos del PDF más nítidos.
  • Encabezado nuevo: tarjeta con "N guías pendientes" y los pasos ①②③ (solo en computador).
  • Casillas de los filtros con el mismo estilo de las tablas.
  • Estilos del módulo en la carpeta styles/ (computador y celular por separado).
  • Se quitó el pie de página de toda la aplicación.

Correcciones

  • La hora del histórico ya no aparece 5 horas antes.
  • El selector de cantidad por página ya no se sale de la pantalla en celular.
  • Las pruebas should create del módulo pasan con un repositorio falso.

Documentación

  • Relación de Despacho: histórico (filtros, buscador Lote/Guía, Unir lotes), 0 de Envía, encabezado, tour, celular, estructura de carpetas, pruebas (58) y diagrama de flujo al día.

[2026-10-26] — Servicio Público: CI/CD de ConsultarPedidos + tiendas desde base de datos

Nuevas funcionalidades

  • CI/CD propio del sub-dominio ServicioPublico/ConsultarPedidos en Azure DevOps: un pipeline CI (compila las 2 lambdas, corre los 11 tests, empaqueta los zips) y dos pipelines CD (PreProd por push a release/*, Prod por merge a main con aprobación del Environment produccion). Las plantillas son propias del sub-dominio (servicio-publico-ci.yml, servicio-publico-cd.yml), no dependen de las de pedidos.
  • Roles de despliegue por Terraform: azdo-servicio-publico-preprod (cuenta 376313750428) y azdo-servicio-publico-prod (cuenta 522814697657), asumidos vía OIDC desde los service connections aws-{preprod,prod}-servicio-publico-consultar-pedidos. Permiso acotado a UpdateFunctionCode + variables de las lambdas APILambdaConsultarPedidos y APILambdaObtenerToken, y a sus carpetas S3 de artefactos.

Cambios

  • ConsultarPedidos ya no confía en el token para las tiendas. El JWT ahora solo aporta identidad (sub, email, username); las tiendas del usuario se consultan en la colección ApiUsuariosTiendas por sub. Soporta AccesoATodas (comodín *) y responde 403 si el usuario no existe o está inactivo. El cambio llegó de la rama feature/mejora-api-pedidos del repo PreProd y se integró conservando el refactor de PoliticaFechas.
  • COLECCION_PEDIDOS por defecto pasa a PedidosInter.
  • El function-name de ConsultarPedidos se corrigió del typo ApiLambaConsultarPedidos al correcto APILambdaConsultarPedidos; los aws-lambda-tools-defaults.json quedaron con environment-variables vacío (secretos fuera del repo, en variable groups de Azure Library).

Correcciones

  • Estreno de pipelines (3 fallos reales, resueltos):
    1. ci.yml apuntaba a ../../templates/lambda-dotnet-ci-varias.yml, que no existe ahí (está 3 niveles arriba y es local de pedidos). Se creó la plantilla de CI propia del sub-dominio.
    2. Azure rechazaba gt(length(lambda.claves), 0) dentro de un each (ve Object, no lista). Se quitó el guard innecesario (ambas lambdas siempre tienen claves).
    3. El CD asumía el rol de guías (azdo-guias-preprod) por apuntar al service connection viejo aws-preprod-servicio-publico. Se corrigió al service connection propio -consultar-pedidos.

Documentación

  • Página Backend → Servicio Público → ApiLambdaConsultarPedidos actualizada a v3: flujo de autorización desde ApiUsuariosTiendas, authorizer de Cognito en API Gateway (CognitoUsuariosExternos, header Authorization: Bearer), COLECCION_PEDIDOS default PedidosInter, historial de cambios de Oct 26.
  • Nueva página CI/CD y despliegue del sub-dominio: pipelines, qué hace el CD paso a paso, roles/service connections, y la bitácora del estreno con los 3 fallos y sus arreglos.
  • Nueva página Novedades Inter (MotivoNovedadInter): diseño del array de novedades, cómo activarlo en ConfiguracionCamposApi, y por qué no requiere cambio de código (evaluación de serialización descartada).

[2026-10-22] — Dashboard Sin Despacho: fecha de creación, varios días y versión para celular

Nuevas funcionalidades

  • Varios días a la vez: en la tabla por mes y transportadora se marcan días con clic, Ctrl + clic y Shift + clic (en celular, cada toque suma o quita). La fila "Seleccionados (N días)" muestra la suma por transportadora, y los indicadores, el ranking, el detalle y los Excel cuentan solo esos días.
  • Botón Limpiar al lado de "Actualizar": quita todos los filtros y selecciones.
  • Versión para celular: filtros en una hoja que abre el botón "Filtros", indicadores en una fila, tabla por mes con scroll propio, tarjetas compactas en el detalle y 5 pedidos por página.

Cambios

  • El tablero agrupa y muestra los pedidos por fecha de creación (antes, fecha de carga) en la tabla, el filtro, el detalle y el Excel.
  • El resumen de filtros queda plegado en una línea y se despliega con un botón.
  • Las listas de filtros abren más rápido: máximo 150 opciones visibles (buscando se encuentran todas) y las marcadas aparecen primero. El selector no cambia de color al elegir y ocupa una sola línea.
  • Mientras carga, se recalcula como máximo cada 300 ms en vez de con cada página, y los pedidos nuevos se agregan sin copiar la lista completa.
  • Encabezado más compacto en computador e ícono en azul.

Correcciones

  • Al marcar un día, el mes abierto ya no se cierra solo.
  • Los clics muy seguidos ya no dejan los indicadores con la selección anterior.
  • Dar varios clics en un filtro ya no selecciona el texto de la lista.
  • En celular, el ancho de la vista ya no cambia al aplicar un filtro.

Documentación

  • Dashboard Sin Despacho: filtros, selección de varios días, versión para celular, modelos, store, data.worker y agregacion.worker al día.

[2026-10-21] — Nuevo sistema de Inventario (ApiLambdaInventario)

Nuevas funcionalidades

  • Reemplazo de las lambdas gemelas de inventario por un sistema de 8 funciones con escritura idempotente, un cierre por guía, fórmula v2, filtro de activación, trazabilidad, barrido de cierre y alertas diarias por Slack. Validado en PreProd; producción pendiente. Detalle: Liberación de Inventario.

Documentación

[2026-10-15] — Layout: menú lateral con teclado y arreglos del menú

Nuevas funcionalidades

  • Menú con el teclado: con el menú abierto (mouse encima o Ctrl + B) se recorre con las flechas, empezando desde el buscador. ↓ / ↑ pasan entre las opciones que se ven, ↑ desde la primera vuelve al buscador, Enter abre el submenú o va a la página y Escape cierra el grupo, el submenú o la barra. No hace falta hacer clic: con la barra abierta ↓ va a la primera opción desde cualquier parte de la página (salvo escribiendo en un campo).
  • La opción con el foco lleva un borde morado; al mover el mouse la marca se quita para que no se vean dos opciones marcadas y, si el mouse está fuera del menú, la barra se cierra.

Cambios

  • La directiva SidebarInteraccionDirective pasó a default-layout/directives/ y los estilos del layout de estilos/ a styles/.
  • El atajo Ctrl + B y las flechas se escuchan con un solo @HostListener('document:keydown').

Correcciones

  • Arrastrar la barrita del scroll del menú lo cerraba si el mouse salía de la barra. Ahora sigue abierto mientras se arrastra y se cierra al soltar afuera.
  • Con la barra cerrada y algo escrito en el buscador solo se veían unas rayitas: ahora se ven los iconos del menú completo y al abrirla vuelven los resultados.

Documentación

  • Nueva sección Frontend → Layout con Menú lateral (Default Layout): estructura, directiva, uso con el teclado, buscador, diseño, flujo y las 33 pruebas.
  • Estructura de módulos: enlace a la página del menú lateral.

[2026-10-21] — Exportación de datos: límites por formato, varias guías, resumen y celular

Nuevas funcionalidades

  • Límites por formato en Pedidos (PedidosInter) y Liquidaciones (LiquidacionesLogigho): CSV 300.000, Excel 130.000, JSON 150.000 y PDF 150.000 registros con máximo 10 columnas. Debajo de cada rango de fecha sale cuántos registros trae y solo se pueden elegir los que caben; en las fechas personalizadas los días que se pasan salen tachados.
  • Rangos nuevos: "Este mes" (del día 1 a hoy, por defecto) y "Último mes" (mes anterior completo).
  • Varias guías en un filtro: los campos numéricos enteros aceptan valores separados por coma o pegados de una columna de Excel (máximo 400). Buscando por guía se exporta todo el historial y sin límite de registros.
  • Filtro Ecosistema en Pedidos y Liquidaciones, con varios ecosistemas a la vez: se envía como la lista de tiendas de esos ecosistemas que el usuario tiene asignadas. Solo salen los ecosistemas con tiendas del usuario y se controla que las tiendas quepan en la dirección de la exportación.
  • Revisión de guías y preenvíos: al agregarlos se revisa cuáles existen en las tiendas del usuario; si faltan, se puede seguir solo con los que sí existen o corregir. Buscando por preenvío también se exporta todo el historial y sin límite.
  • Ayudas al pasar el mouse (directiva appAyuda) en lugar del title del navegador; los rangos de fecha muestran sus fechas exactas.
  • Teclado en Filtros avanzados: flechas y Enter para elegir el campo, Enter en el valor agrega el filtro y Ctrl+Z deshace el pegado de guías.
  • Permisos por rol en colecciones (ListaColecciones.Roles) y en campos (ConfiguracionCamposColeccion.Roles).
  • Resumen "Así queda tu exportación" con el panel "Registros a exportar" (número, barra de capacidad verde/naranja/roja, Columnas, Celdas, Aún caben y estado) en todas las colecciones.
  • Buscador de columnas (sin mayúsculas, tildes ni espacios, con la coincidencia marcada) y lista de formatos con nivel ALTO / MEDIO / BAJO.
  • Accesos "Ir directo a" en el encabezado, pastilla "Ir a exportar", aviso "Primero selecciona una colección" y pregunta al exportar si quedó un filtro sin agregar.
  • Mensaje al equipo de desarrollo cuando se necesita más del límite: llega como notificación de la campana con lo que se intentaba exportar, y la respuesta del equipo le llega a quien lo envió.
  • Campana de notificaciones en el header (reemplaza la campana fija con el "1"): contador de nuevas, pestañas Pendientes / Historial (últimas 20), detalle con el contexto, respuesta obligatoria al atender una solicitud y "Entendido" para las respuestas. Revisa cada 2 min (rol Desarrollador) o 5 min (los demás), solo con la pestaña visible. Colección nueva NotificacionesPlataforma.
  • Aviso de notificaciones (AvisoNotificacionService): tarjeta arriba a la derecha con icono de color, X para cerrar y barra de tiempo.
  • Celular: listas como paneles desde abajo, calendario del teléfono, columnas en 2 por fila e información de uso plegable.
  • Tour guiado de la pantalla (14 pasos, incluida la campana de notificaciones), con botón que late la primera vez.

Cambios

  • Se quitó "Exportar Servidor" (botón y flujo en export-runner): el backend exportReportes respondía 504 a los 29 segundos aun con pocos registros.
  • Tour guiado (componente compartido): no deja mover la página mientras está abierto, oscurecido de una sola pieza y tarjeta centrada en celular. Afecta también a los tours de Pautas y Bodegas.

Correcciones

  • Buscar por guía daba "No hay datos" porque se aplicaba el rango "Este mes"; ahora se busca en todo el historial.
  • localStorage de exportaciones viejas nunca se borraba (no leía bien la hora del exportId); ahora se borra a los 30 minutos.

Documentación

  • Export data actualizada: partes de la pantalla, límites, rangos, panel de registros, varias guías, Ecosistema, roles, mensaje al equipo, celular, tour y pruebas.
  • Export runner sin el flujo de "Exportar Servidor".
  • Tour guiado: nueva fila en el historial de cambios.
  • Nuevas páginas: Core → Servicio de Notificaciones, components → Campana de Notificaciones y Gestion de datos → Directiva ayuda flotante.

[2026-10-15] — Estandarización de dirección: tipos de dirección, manzana, barrio o vereda

Nuevas funcionalidades

  • Dos tarjetas en el Constructor para elegir cómo es la dirección, cada una con ejemplos: Dirección numerada (lleva #, ej. Calle 45 # 7 - 20) y Manzana, barrio o vereda (no lleva #, ej. Mz 8 Lt 2 Casa 4, Vereda La Esperanza). Siguen los dos tipos de la guía del formulario de Base Ventas.
  • Dirección por lugar: tipo de lugar (barrio, urbanización, conjunto, sector, vereda, corregimiento, finca, parcelación, batallón), nombre del lugar obligatorio, manzana, lote, casa, km, calle de referencia y referencia. Arma, por ejemplo, MZ 8 LT 2 CASA 4 BARRIO BELÉN o VEREDA LA ESPERANZA CASA 5, y avisa si falta el lugar o un número.
  • Tour guiado (botón ?) con los pasos de los dos modos y de las dos tarjetas.
  • Aviso al salir con datos escritos (X, Cancelar, clic fuera o Escape), con flechas entre "Salir" y "Seguir editando".

Cambios

  • Manzana en texto libre: CL 3 MZ 1 LT 4 CS 6 ya no pide distanciador y sale con confianza alta; MZ 8 LT 2 CS 4, EL POZON toma el barrio después de la coma y, sin barrio, avisa que es obligatorio y baja la confianza.
  • Los complementos salen de mayor a menor unidad (MZ → LT → TO → BL → CS → PI → AP…); antes la casa podía quedar antes que la manzana.
  • Se quitan los # y - sueltos que dejaba el formulario viejo (MZ 05 # LOTE 5 - ETAPA 4 → MZ 5 LT 5 ETAPA 4).
  • Escape cierra una ventana a la vez: tour, aviso y por último el modal.
  • Nuevo diseño del modal: fila de la vía con etiquetas encima, letras más grandes, ventana de 880 px y diseño celular (tarjetas una debajo de otra, campos a 16 px, pantalla completa en celulares pequeños).

Documentación

  • Estandarizacion de direcciones (componente) y Estandarizador de direcciones (servicio) actualizados.

[2026-10-09] — Layout: rediseño del menú lateral y la barra superior

Nuevas funcionalidades

  • Buscador del menú con atajo Ctrl + B (Cmd + B en Mac): abre la barra con el cursor en el buscador, los resultados salen agrupados por sección (ej. "Mi Tienda › Pedidos Masivos") y Escape borra y cierra.
  • Celular: el menú es un cajón completo (300 px u 85 % de la pantalla) que se cierra al elegir una opción o deslizando el dedo a la izquierda. La barra superior muestra ☰, logo y acciones sin descuadrarse.

Cambios

  • El menú se abre con la clase abierta en vez de :hover: solo si el mouse se queda encima 150 ms, con 120 ms de margen antes de cerrarse. Ya no parpadea.
  • Apertura por capas (logo con máscara, buscador y textos en cascada, flechas al final), barrita azul en la sección actual, opción activa en morado y subgrupos con línea de árbol.
  • Barra superior blanca de 56 px, botones redondos lila y píldora de usuario con avatar.
  • El comportamiento del menú pasó a la nueva directiva SidebarInteraccionDirective y los estilos del layout a la carpeta estilos/ (7 archivos por tema).
  • Seguridad: AuthGuard solo deja pasar sin sesión la ruta exacta /export-runner; antes bastaba con que apareciera en cualquier parte de la URL, incluido el hash.

Correcciones

  • Clics perdidos: si el menú se mueve mientras se hace clic, la opción igual se abre.
  • "Primer clic gastado" al abrir un grupo después de cerrar la barra.
  • En celular había que tocar dos veces para ver el menú completo.

Documentación

  • Nueva sección Frontend → Layout con Menú lateral (Default Layout) y Barra superior (Default Header).
  • Rutas y navegación: nueva sección sobre AuthGuard y /export-runner.
  • Estructura de módulos: enlaces a las páginas del layout.

[2026-10-09] — Header: buscador de guía de transportadora ("Consultar guía")

Nuevas funcionalidades

  • Botón "Consultar guía" en el header, antes de los avisos y separado por una línea. Abre el nuevo modal ConsultaGuiaModalComponent: el usuario escribe o pega el número de la guía y ve los datos del pedido (transportadora, tienda, estado con color y fecha), el link del PDF con Abrir y Copiar, y la vista previa del PDF en computador.
  • Búsqueda por Numeropreenvio en PedidosInter con el índice Numeropreenvio_1, pidiendo solo los 8 campos que usa el modal: 113 ms y ~1 KB de respuesta.
  • Solo guías de mis tiendas: la búsqueda se filtra por tiendas_asignadas, como en la pantalla de Pedidos. Si la guía es de otra tienda, una segunda consulta que solo pide el número confirma que existe y se muestra "Esta guía no pertenece a tus tiendas", sin ningún dato de ella. Los usuarios con Todas ven cualquier guía.
  • Recientes: las últimas 5 guías encontradas, por usuario y solo durante la sesión (sessionStorage), con botón Limpiar.
  • Mensajes distintos para guía inexistente, guía sin PDF, guía de otra tienda, búsqueda que tarda (504 / TimeoutError) y tiendas todavía sin cargar.

Cambios

  • Enter busca y, con la guía ya mostrada, un segundo Enter abre el PDF.
  • El número se limpia de espacios, saltos de línea y guiones antes de buscar.
  • La vista previa del PDF no se muestra en celular (Chrome de Android no tiene visor) ni en pantallas táctiles angostas; queda el botón Abrir.
  • Accesibilidad: Escape cierra, el foco no se sale del modal con Tab y se respeta prefers-reduced-motion.

Documentación

  • Nueva página Frontend → Componentes → Consultar Guía (modal del header), con el flujo, los estados, el filtro por tiendas (y su nota de seguridad), Recientes, la vista previa y las 31 pruebas unitarias.
  • Agregada una referencia al modal en Logística → Consultar Guía.

[2026-10-02] — Facturas transportadoras: validación de encabezados en la importación

Nuevas funcionalidades

  • Validación de encabezados en uploadFile() de los tres componentes de importación de facturas (Envía, Inter y genérico — Servientrega y D2E), antes de mapear las columnas. Dos validaciones: (1) la primera fila debe ser de encabezados (texto, sin celdas vacías) → alerta Archivo sin encabezados; (2) los encabezados deben existir en el columnMapping y venir los obligatorios → alerta Encabezados incorrectos con las listas No reconocidos y Faltan obligatorios. Si falla, no se guarda nada y se deja un console.warn para diagnóstico.
  • Nuevo campo opcional columnasOpcionales?: string[] en TransportadoraStrategy: cada transportadora declara qué columnas no son obligatorias. ServientregaStrategy lo usa para CODIGOCENTROCOSTO y NOMBRECENTROCOSTO (las otras 29 son obligatorias). D2E no lo define, así que sus 9 columnas siguen siendo obligatorias.

Cambios

  • X-Cargo fuera de servicio (ya no se usa en la empresa): se comentó, con la nota FUERA DE SERVICIO POR EL MOMENTO, el bloque HTML "FACTURACIÓN X-CARGO", el import de ImportacionFacturasXcargoComponent, su entrada en imports y la llamada a fetchTableDataXcargo() en ngOnInit (evita una consulta inútil a FacturacionXcargo). La carpeta del componente no se tocó.
  • En el componente genérico, la validación anterior (mensaje genérico Documento no válido) se reemplazó por la Validación 2 con mensaje detallado. La comparación sigue siendo exacta (distingue mayúsculas).
  • Un archivo con columnas fuera del columnMapping ahora se rechaza; antes se aceptaba y se guardaba con el nombre que trajera el Excel.
  • Se eliminó un bloque de código comentado de manejo de fechas (ADM_FechaGrabacion) en el componente de Envía: estaba copiado de otro módulo y nunca se ejecutaba.

Correcciones

  • Error toLowerCase is not a function al importar el Excel de Envía: el archivo no tenía fila de encabezados, la primera fila eran datos con números y el código la trataba como títulos.
  • Agregado ValorComercial al columnMapping de Inter: existía en la base de datos y faltaba en el mapeo.

Documentación

  • Nuevas páginas Frontend → Componentes → Importación Facturas Inter e Importación Facturas Envía, con las validaciones y las columnas obligatorias.
  • Actualizadas Importación Facturas Genérico (validaciones y columnasOpcionales), Facturas Transportadoras (X-Cargo fuera de servicio y cómo reactivarlo) y su ADR.

[2026-10-17] — Propuesta: Sistema de Experiencias y seguridad de accesos

Documentación

  • Sistema de Experiencias (propuesta, pendiente de aprobación): qué es, ADR-001, estructura del proyecto, crear una vista, crear una experiencia, reglas de cambio entre experiencias, tokens y estilos, seguridad por diseño, buenas prácticas, migración de vistas, ejemplo con tienda/pedidos y plan de implementación.
  • Seguridad y accesos (propuesta): modelo objetivo de autorización en el servidor.
  • Plantilla nueva: documentación de vista del Sistema de Experiencias.
  • Estilos y SCSS: ahora enlaza al estándar de tokens.

[2026-10-14] — Pauta: validaciones de la vista y nueva importación con previsualización

Nuevas funcionalidades

  • Previsualización editable al importar: antes de guardar se ven todas las filas del Excel; cada celda se valida mientras se escribe y los errores salen en rojo con un mensaje corto ("Solo números", "Obligatorio"). Solo se deja importar cuando no queda ningún error.
  • Corregir automáticamente: deja solo los dígitos en los montos e Idtienda (1.500.000 → 1500000); las celdas corregidas quedan en verde con "Antes: …".
  • Verificación de tiendas: el nombre de la tienda se llena solo con el Idtienda (una sola consulta para todo el archivo) y se marca "Tienda no existe", "Tienda inactiva" o "No es tu tienda".
  • Filtro Solo errores, Eliminar fila con Deshacer, Agregar fila y confirmación al cerrar con cambios sin importar.
  • Zona para arrastrar y soltar el Excel y errores del archivo dentro del modal con temblor.
  • Tour guiado en la vista y en el modal.
  • Celular: la tabla de Pauta se ve como tarjetas con el total de cada registro, el calendario y el modal salen como hoja desde abajo.

Cambios

  • La vista carga todas las páginas de pauta (8 en paralelo, Zstd y solo los campos de la tabla), con barra "Cargando registros… X de N" y aviso con Reintentar si alguna no llega. El contador, los totales, el filtro y la descarga usan todos los registros.
  • Los montos solo aceptan números enteros, al editar y al importar (nueva directiva appCampoSoloNumeros con aviso toast).
  • Encabezados exactos de la plantilla: se rechazan columnas faltantes, no permitidas, repetidas o con datos sin nombre.
  • Organización del módulo: llamadas al backend en PautaRepository, lectura y validación del Excel en servicios, modelos en models/ y estilos partidos en estilos/.

Correcciones

  • El campo Otros se leía como Otro: la columna, el total y la descarga salían vacíos.
  • Los totales ya no se vuelven NaN con montos viejos mal guardados (ej. 1.500.000); esos valores se ven en rojo para corregirlos.
  • Al guardar una fila con un monto inválido ya no queda NaN en la tabla.

Documentación

  • Vista Pauta y Importacion Pauta actualizadas.
  • Nuevas páginas en Frontend → Vistas → Tienda → Pauta: Modelos, Repositorio, Lectura de Excel, Validacion de filas, Aviso toast y Directiva solo numeros.

[2026-09-21] — Dominio Datos: API backend para publicar/versionar reportes analíticos

Nuevas funcionalidades

  • Nueva Lambda ApiLambdaPublicarReporteAnalytics (dominio Datos): mueve al backend el flujo de publicar/versionar reportes analíticos, que hasta ahora corría 100% en el cliente (Angular subía directo a S3/Mongo, sin control server-side). Presigned URL de S3 en 2 pasos (solicitar-carga → PUT directo a S3 → confirmar-carga) para evitar el límite de payload de API Gateway con reportes de hasta 15 MB. Port literal de las 8 reglas de validación de contenido del sanitizador Angular (endurecerHtml), 8/8 verificadas idénticas contra el archivo fuente.
  • Nuevo dominio Datos en PreProd: CloudFormation (datos-infra-preprod.yaml) + pipeline GitHub Actions (deploy-datos-preprod.yml) desde cero, siguiendo la receta estándar del repo. Primera lambda del repo que crea su propio rol IAM por CFN (los demás dominios reusan roles pre-creados a mano).
  • Nuevo campo Autor en CargasReportesAnalytics, para auditoría legible (email/username) sin tener que cruzar el sub contra Users.

Cambios

  • Modelo de autenticación rediseñado durante la construcción: de un diseño con Cognito Authorizer + colección IntegracionesExternas propia, a decodificar el sub del JWT sin verificar firma y exigir rol (Jefe Datos/Desarrollador/CEO) en Users — consistente con cómo funciona el resto de la plataforma hoy (ningún endpoint tiene Authorizer nativo). Ver ADR-001.
  • MONGODB_CONNECTION_STRING migrado a cifrado AES256-ECB (Seguridad.Encripcion.EncripcionAES), estándar ya usado en el resto del repo para secretos en variables de entorno.
  • Respuestas de error migradas de objetos anónimos a records tipados (ErrorResponse, ValidacionRechazadaResponse), consistente con el resto de lambdas del repo.

Correcciones

  • Bug crítico de despliegue: el handler usaba tipos de evento API Gateway V1 (APIGatewayProxyRequest) contra una integración real V2 (PayloadFormatVersion: "2.0") — request.HttpMethod quedaba siempre vacío y toda petición real caía en 405 RUTA_NO_ADMITIDA, aunque los 96 tests unitarios (con eventos V1 simulados) pasaban en verde. Detectado en la primera prueba real contra PreProd con Postman. Migrado a APIGatewayHttpApiV2ProxyRequest/Response.
  • ApiLambdaGetObjectMetadataAOT (necesaria para que Angular lea el HTML ya publicado) no existía en la cuenta AWS de PreProd — replicada manualmente desde Producción (mismo paquete dotnet8) con ruta POST /getObject en el Gateway de PreProd. Pendiente formalizar en IaC.

Documentación

  • Nueva sección Backend → Lambdas .NET → LogiGho → ApiLambdaPublicarReporteAnalytics: visión general con contrato completo de los 2 endpoints, flujo punta a punta, las 8 reglas de validación, casos de uso (Solicitar Carga, Confirmar Carga), modelos de dominio, repositorios, servicios de infraestructura, y ADR-001 (autenticación).

[2026-09-16] — Liquidaciones: motor Dinámico (TCC) conviviendo con el motor Legacy

Nuevas funcionalidades

  • Motor Dinámico de liquidaciones, dentro de la misma Lambda ApiLambdaLiquidacionesLogighoAOT (patrón Strangler Fig, ver ADR-001): dominio limpio (modelos, calculadoras, políticas de peso, validadores), configurable por transportadora vía ConfiguracionLiquidacionTransportadora (Dinamica/Legacy/Sombra/Deshabilitado). Liquida hoy TCC; el motor Legacy sigue intacto para Interrapidísimo, Envía y Servientrega.
  • Módulo frontend "Costos Transportadora" (director-de-operaciones): Hub de transportadoras + panel de 5 pestañas (Configuración General, Trayectos, Tarifas por Tienda, Simulador de Liquidación, Auditoría de Excepciones) para configurar el motor Dinámico sin desplegar código.
  • Dominio AWS financiero en PreProd: Lambda + Step Function Financiero-PreProd, para ejecutar liquidaciones de prueba (todas las pendientes, o una lista puntual de guías) sin tocar producción.

Correcciones

  • TarifaTransportadoraTienda.Trayectos e IncrementosPeso cambiados de IReadOnlyList<T> a List<T> — Newtonsoft no puede poblar una ReadOnlyCollection al deserializar directo desde Mongo (JsonSerializationException real visto en CloudWatch). Se agregaron 3 tests de regresión que deserializan JSON con forma real, cerrando el hueco de cobertura que dejó pasar el bug.
  • URL_SERVICIO_AWS agregada al template de financiero-infra-preprod.yaml — faltaba para que el camino legacy no-TCC (Generico.consumoGenerico) pudiera actualizar inventario cuando se mezclan pedidos legacy y TCC en la misma ejecución.

Documentación

  • Nueva sección Backend → Lambdas .NET → LogiGho → ApiLambdaLiquidacionesLogighoAOT: visión general con diagrama de flujo estilo BPMN, motor Legacy, motor Dinámico completo (orquestador, modelos, calculadoras, políticas de peso, validación, infraestructura), despliegue y operación en PreProd, ADR-001.
  • Nueva sección Frontend → Director de Operaciones → Costos Transportadora: componente principal, las 5 pestañas, modelos, servicio de estado, ADR-001.
  • Nueva página Frontend → Analytics → Liquidaciones (Power BI).

[2026-09-09] — Cotizador con/sin recaudo: Envía real + Strategy + reglas de forma de pago

Nuevas funcionalidades

  • Envía ahora cotiza real en ApiLambdaCotizarEnvia — antes el orquestador estimaba geográfico porque el request no traía los campos de cuenta requeridos y no se distinguía el error de negocio del éxito.
  • Con/sin recaudo en las 3 transportadoras (Common.ConRecaudo): antes solo existía visualmente para Envía y ni siquiera se aplicaba de verdad.
  • Backend: patrón Strategy (ICotizadorProveedor + RegistroCotizadores) para desacoplar cada transportadora del orquestador. DirectFunction bajó de ~200 a ~55 líneas.
  • Backend: EnviaCuentaResolver resuelve la cuenta de Envía (2 cuentas globales) según ConRecaudo — con la semántica invertida de Envía (Crédito = con recaudo, Contraentrega = sin recaudo).
  • Front: paso 3 del modal de creación de pedidos extraído a PasoCotizacionComponent, con badge de tarifa más económica y botón de desglose crudo (gateado por rol, no por backend).
  • Front: nuevo módulo reglas-modalidad-pago.ts — single source of truth de cómo el switch de recaudo se traduce a "Forma de pago" por transportadora en el paso 4 (Guía).

Correcciones

  • Envía respondía 200 OK con error de negocio (peso fuera de rango, etc.) y el orquestador lo leía como cotización válida con flete $0 — nueva EnviaLiquidacionException.
  • Interrapidísimo: el cliente HTTP mandaba ValorContraPago en el campo que debía llevar ValorDeclarado — separados en el DTO y el mapeo. Eliminado IdFormaPago (campo muerto).
  • Bug de producción: guía de Envía quedaba forzada a FORMA DE PAGO = CREDITO / APLICA CONTRA PAGO = NO sin importar el switch del usuario, por un bloque de cálculo duplicado en generarGuia(). Corregido centralizando la regla en reglas-modalidad-pago.ts.

Documentación

[2026-09-02] — DevolucionesMasivo: confiabilidad de Inter (token real, reintentos, fallback cruzado)

Correcciones

  • Token de Inter vencía en 20 minutos según el código, en 30 segundos según Inter real (confirmado decodificando el JWT que devuelve GenerarTokenTemporal) — causaba 401 masivos en cargas de más de 30s de duración. _tokenVence bajado a 20s.
  • Fallos HTTP de ClienteInter (rastreo y estados) no dejaban ningún rastro en logs cuando Inter respondía distinto de 2xx — ahora se loguea statusCode y cuerpo de la respuesta en cada intento fallido.
  • Sin reintentos ante 429/5xx de Inter: ahora hasta 4 intentos con backoff exponencial + jitter, respetando Retry-After.
  • Tráfico sostenido sin pausas entre tandas (SemaphoreSlim sin cortes) podía seguir gatillando 429 con lotes de 200+ guías — ahora hay pausa configurable entre tanda y tanda (PAUSA_ENTRE_PETICIONES_INTER_MS).
  • Guías rechazadas por la transportadora asignada (ErrorConsultaExterna, ej. 400 explícito) o sin ningún formato reconocido (GuiaNoExisteEnSistema) no se reintentaban contra otra transportadora — solo cubría SinGuiaOriginalEnRespuesta. Ahora los 3 motivos disparan el fallback cruzado, con Inter primero por volumen.

Cambios

  • CONCURRENCIA_INTER por defecto bajada de 10 a 5 en código y en ambos entornos (prod/preprod).

Documentación

  • ADR-005 con el diagnóstico completo. Actualizados clientes-transportadora.md, worker-handler.md y la tabla de variables de entorno del módulo.

[2026-07-27] — Pancake: doble escritura de páginas, fix de ventana y endpoint on-demand

Nuevas funcionalidades

  • Endpoint on-demand ApiLambdaConsultarEstadisticasPagina (API Gateway POST): trae estadísticas frescas de una página (hoy / ayer / rango personalizado) sin persistir, con fallback de token de página.
  • ApiLambdaListarPaginasPancake ahora hace doble escritura Mongo + Aurora MySQL.

Correcciones

  • Ventana cierre_dia_anterior: until corregido de 00:00:00 del día siguiente a **23:59:59** del mismo día — Pancake ya no arrastra gasto del otro día.

Documentación

  • Nueva página Endpoint on-demand (API) en Backend → Integración Pancake; actualizadas las páginas de ListarPaginasPancake (SQL) y CalcularVentanaTiempo (fix until).

[2026-07-13] — Integración Pancake (estadísticas de campañas)

Nuevas funcionalidades

  • Pipeline serverless de 5 lambdas .NET 8 que recolecta las estadísticas de campañas de Pancake (pages.fm) 4 veces al día (7am/9am/2pm/5pm hora Colombia), orquestado con AWS Step Functions y agendado con EventBridge Scheduler.
  • Doble escritura de estadísticas por campaña: MongoDB + RDS Aurora MySQL (patrón Composite, best-effort, UPSERT idempotente, modo inerte plug-and-play).

Documentación

  • Nueva sección Backend → Integración Pancake: visión general con diagrama de arquitectura, una página por lambda, orquestación (Step Functions + ASL + EventBridge) y guía de operación (ejecución manual, agregar franjas, monitoreo y troubleshooting).