0. PWA vigente e instalación

Admin Puertos3 ahora es una PWA instalable en https://abbante.online/administracion. Conserva las funciones completas de AdminWeb y no requiere Expo ni una aplicación móvil separada.

Para instalarla, abre el portal en Chrome o Edge y elige Instalar aplicación. En iPhone o iPad usa Safari, abre Compartir y selecciona Agregar a pantalla de inicio. El Service Worker conserva únicamente el shell y la página offline: los datos administrativos autenticados no se guardan para consulta sin conexión.

1. Qué Es Admin Puertos3

Admin Puertos3 es el portal interno que usa TecnoAI para administrar la plataforma completa: alta de empresas transportistas, seguimiento operativo, catálogos, marketplace, membresías, pagos, notificaciones, auditoría, salud de servicios y reportes globales.

No confundir con MonitorWeb. Los clientes transportistas usan https://transporte.abbante.com para operar su empresa. AdminWeb es exclusivo para usuarios AdminGlobal.

URL del portal: https://abbante.online/administracion

Quién entra: sólo usuarios con EsAdminGlobal=true. Si un usuario AdminEmpresa intenta entrar aquí, el portal cierra su sesión y muestra un acceso a MonitorWeb, que es el portal correcto para su rol.

2. Acceso

2.1 Entrar Al Portal

1. Abre https://abbante.online/administracion/login.
2. Captura correo y contraseña.
3. Presiona Entrar al panel.

El portal valida la sesión con Supabase Auth y después consulta mi_perfil_admin_web. Si el perfil no tiene es_admin_global=true, no permite el acceso.

2.2 Acceso De Prueba QA

Para validación, capacitación o demostraciones internas solicita al responsable del proyecto una cuenta QA temporal con rol AdminGlobal. Las credenciales no se publican en este manual ni deben compartirse por correo o canales abiertos.

URL de acceso: https://abbante.online/administracion/login

El usuario se mantiene con:

cd supabase-api
node seed-adminempresa-qa.js

2.3 Salir

En la esquina superior derecha, usa el botón de salida. Cierra la sesión actual y vuelve al login.

3. Dashboard

El dashboard muestra accesos rápidos a las rutas principales:

La vista inicial está organizada por bloques de trabajo. Úsala como atajo cuando ya sabes qué área necesitas abrir:

Lee las tarjetas como atajos, no como módulos separados. Cada una lleva a la misma ruta disponible en el sidebar.

4. Bandeja Operativa

Sidebar → Inicio → Bandeja operativa.

Concentra pendientes para que el AdminGlobal no tenga que buscar en varias pantallas:

Cada bloque muestra la acción recomendada y liga al módulo donde se resuelve.

5. Alta De Nueva Empresa

Sidebar → Onboarding → Alta de nueva empresa.

Este wizard provisiona una empresa transportista nueva y su primer administrador de empresa.

5.1 Datos De La Empresa

5.2 Admin De La Empresa

El usuario capturado aquí será AdminEmpresa, no AdminGlobal.

El acceso inicial tiene dos opciones:

La invitación envía al nuevo administrador a MonitorWeb (NEXT_PUBLIC_MONITOR_URL), porque ahí opera la empresa transportista. El botón Aceptar invitación pasa por https://transporte.abbante.com/auth/aceptar y después redirige a Supabase con destino final https://transporte.abbante.com/cambiar-password. Ahí el usuario define su contraseña inicial; después entra por https://transporte.abbante.com/login con su correo y esa contraseña. Si se usa contraseña temporal, entrega esa contraseña al cliente por un canal seguro. Al iniciar sesión, MonitorWeb lo manda a /cambiar-password antes de permitirle operar.

5.3 Trial Inicial

5.4 Al Confirmar

El portal hace la operación de forma controlada:

1. Crea el acceso del admin en Supabase Auth: invitación o contraseña temporal.
2. Crea EmpresaTransportista.
3. Crea PermissionPolicyUser con EsAdminEmpresa=true.
4. Vincula el usuario a la empresa.
5. Crea la membresía trial de monitoreo.
6. Registra auditoría en MonitorAuditoria.
7. Si se creó contraseña temporal, marca el usuario con must_change_password=true.

Si la RPC falla, el endpoint intenta borrar el usuario Auth recién creado para no dejar datos huérfanos.

6. Marketplace

Sidebar → Onboarding → Marketplace.

La consola de marketplace permite gestionar de punta a punta el alta de proveedores de asistencia y dar seguimiento a las solicitudes. Entran:

• AdminGlobal: ve todo (Proveedores, Solicitudes, Soporte) y la supervisión de operadores.
• Capturador (usuario con EsCapturadorProveedores): entra restringido sólo al módulo de proveedores para trabajar su cartera.

Arriba del tablero hay indicadores rápidos: Prospectos abiertos, Sin asignar, Invitados sin descargar, Integrados (7 días), Proveedores activos, Solicitudes abiertas y Tickets abiertos.

6.1 Las Cuatro Etapas Del Proveedor

El tab Proveedores separa la cartera en cuatro etapas (tarjetas con contador en la parte superior; el contador respeta los filtros activos):

Cada negocio se importa/origina y avanza por estos estados: Importado → En contacto → Dado de alta (invitado) → Registrado (integrado), con desvíos a Rechazado o No contactable.

La lista soporta búsqueda (nombre, teléfono, correo o dirección), ordenamiento (Más recientes, Mejor calificados, Sin contactar primero, Próximo seguimiento) y paginación. En la ficha se muestra la calificación de Google (★ y número de reseñas) para priorizar a quién contactar primero.

6.2 Los Dos Flujos De Alta

Hay dos caminos según quién inicia, distinguidos por el origen del prospecto:

Así “Integrado” significa de verdad que el proveedor ya está operando en la app, no sólo que se le envió la invitación.

6.3 Asignación: Que Cada Operador Trabaje Lo Suyo

Cuando varios capturadores trabajan en paralelo, cada prospecto tiene dueño para que no se llamen al mismo negocio.

Sub-vistas de asignación (en En prospección / Solicitudes de alta):

• Tomar: te asigna el prospecto. Si otro lo tomó un instante antes, el sistema te avisa “Ya lo tomó Fulano” en vez de quitárselo.
• Tomar sin asignar: toma de un golpe todos los libres de la vista/ruta actual.
• Soltar: lo devuelve al pool.
• Reasignar (sólo AdminGlobal): cambia el dueño con el selector de operador.
• Candado: sólo el dueño asignado (o AdminGlobal) puede contactar, dar de alta, activar e invitar o rechazar. Si no es tuyo, primero tómalo.
• Auto-liberación: los prospectos En proceso asignados que llevan 7 días sin contacto vuelven solos al pool cada noche (no aplica si tienes un “Volver a llamar” agendado a futuro).

6.3.1 Localizar Una Solicitud Web, App O PWA

Al abrir Marketplace → Proveedores, AdminWeb muestra de forma predeterminada En prospección. Las solicitudes enviadas directamente por un proveedor no aparecen en esa primera lista.

Para encontrarlas:

1. Selecciona Solicitudes de alta.
2. En Asignación, elige Todos cuando no conozcas al operador asignado.
3. Limpia los filtros de ruta, categoría y estado que no sean necesarios.
4. Busca primero por nombre del negocio.
5. Para buscar por teléfono o correo, cambia el campo de búsqueda de Nombre a Todos y captura el dato completo.
6. Abre la ficha y compara nombre, teléfono y correo con la información proporcionada por el negocio.

Importante: la búsqueda no corrige direcciones de correo ni supone que dos correos parecidos son la misma cuenta. Si el proveedor informa un correo distinto al capturado, busca también por nombre o teléfono.

Después de localizar la solicitud:

Al terminar, confirma que la ficha salga de Solicitudes de alta y aparezca en Aceptados. Si continúa pendiente, revisa la respuesta mostrada por AdminWeb antes de repetir la acción.

6.4 Importar Proveedores Por Ruta (Google Places)

Panel Importar proveedores por ruta: elige una ruta y pulsa Importar de esta ruta. El sistema busca negocios de asistencia a lo largo del trazado y los agrega como candidatos (estado Importado) con teléfono y sitio web. Re-importar la misma ruta es seguro: rellena teléfonos faltantes sin pisar los datos que ya hayas editado a mano.

6.5 Trabajar Un Prospecto (Flujo 2)

1. Tómalo desde Sin asignar.
2. Registrar llamada: abre un formulario con el resultado (Volver a llamar / No contestó / Interesado / No interesado), la fecha de próximo seguimiento y una nota. Aparece el badge “Volver a llamar: fecha” (en rojo si ya venció). No interesado lo descarta.
3. Editar contacto: captura o corrige correo y teléfono (Google Places no siempre trae correo).
4. Activar e invitar: un solo botón convierte el prospecto, crea el acceso y envía la invitación en un paso. Puedes mandarla por correo o elegir WhatsApp.
   • Por WhatsApp se abre el chat con el mensaje y el link de activación listos.
   • Si el negocio no tiene correo, WhatsApp igual funciona (se genera un acceso sin correo; el proveedor fija su contraseña con el link).
   • Tras invitar, queda “Invitado · sin descargar”. La ficha muestra “Invitado hace N días · correo confirmado/sin confirmar · ya entró / no ha entrado”. Si tarda, usa Reenviar correo o Reenviar WhatsApp.
   • En MonitorWeb → Captura de proveedores el botón equivalente se llama Activar proveedor e invitar, con la misma opción de WhatsApp.
5. Cuando el proveedor descarga la app y entra, pasa solo a Integrado (etapa Aceptados) y suma al KPI Integrados (7 días).

6.5.1 Corregir Una Llamada Registrada Por Error

Si acabas de guardar una llamada equivocada, abre la ficha del prospecto y pulsa Eliminar última llamada. Lee el aviso de confirmación y selecciona Aceptar sólo si corresponde eliminar ese registro.

La acción está disponible únicamente para el último registro creado con Registrar llamada, por el operador asignado al prospecto o por un AdminGlobal. Al confirmarla, el sistema elimina esa primera línea de la bitácora y quita el recordatorio Volver a llamar asociado.

No se eliminan notas anteriores ni llamadas más antiguas. Tampoco se cambia el estado del prospecto ni su fecha de último contacto, pues podrían provenir de otra acción posterior. Si el error no está en la última llamada, registra una nueva nota aclaratoria y solicita apoyo a un AdminGlobal antes de modificar el historial.

6.6 Autorizar Un Proveedor Registrado Desde Abbante M O La PWA (Flujo 1B)

Cuando el origen es Abbante M, ya sea desde la aplicación móvil o desde la PWA publicada en https://abbante.online, la solicitud ya trae una cuenta Auth y aparece en Solicitudes de alta con la marca Usuario app pendiente.

1. En Solicitudes de alta, ubica el negocio.
2. Revisa teléfono, correo, dirección, categoría y notas.
3. Si algún dato está mal, usa Corregir datos y vuelve a verificarlo.
4. Si los datos son válidos, usa Autorizar proveedor.

Al autorizar: AdminWeb ejecuta admin_autorizar_proveedor_app, crea/actualiza ProveedorServicios, vincula su SupabaseUserId con el usuario Auth de la app y el proveedor queda autorizado (la siguiente consulta de Abbante M móvil o PWA devuelve autorizado=true). Los registros del formulario público sin cuenta usan Activar e invitar (que crea el acceso y envía la invitación). Si no debe operar, usa Rechazar; no borres el usuario desde Supabase para conservar trazabilidad.

6.7 Supervisión: Carga De Operadores Y Reparto (AdminGlobal)

Panel Carga de operadores (sólo AdminGlobal): tabla con cuántos prospectos tiene cada operador, desglosados por etapa (En proceso / Invitados / Aceptados / Descartados / Total), filtrable por ruta. El botón Repartir sin asignar distribuye los prospectos sin dueño en partes iguales (round-robin) entre los capturadores; no toca los que ya tienen operador.

6.8 Comisiones De La Plataforma

Panel Comisiones de la plataforma (sólo AdminGlobal), dentro de Marketplace. Tiene dos campos, uno por método de pago:

• En pago con tarjeta, el cliente paga el precio ofertado más el porcentaje de servicio; la plataforma transfiere el neto al proveedor al liquidar su factura B2B.
• En pago directo, el cliente paga exactamente el precio ofertado y el proveedor no debe nada a la plataforma.
• Cada oferta congela los porcentajes vigentes al emitirse: cambiar la comisión aquí no afecta ofertas ya enviadas.

7. Personas

7.1 Flota Global

Sidebar → Personas → Flota global.

Permite revisar la operación de flota desde la administración general.

Las altas y ediciones detalladas de flota siguen disponibles en MonitorWeb para el administrador de cada empresa.

7.2 Usuarios Y Roles

Sidebar → Personas → Usuarios y roles.

Lista usuarios XAF (PermissionPolicyUser) y combina su estado en Supabase Auth. Desde esta pantalla se puede administrar el ciclo completo del usuario sin entrar al XAF para tareas operativas comunes.

Funciones principales:

Matriz De Alta Por Tipo De Usuario

Usa esta matriz antes de crear o editar un usuario. La columna Empresa define si el campo Empresa debe ir vacío o seleccionado.

Regla práctica: los roles globales (Admin Global, Operador global y Operador de comunidad) deben crearse sin empresa asignada. Los roles de operación de transportista (Admin Empresa y Supervisor) deben tener empresa seleccionada. El Operador de comunidad tampoco lleva sindicato y no puede combinarse con otro rol.

Filtros Y Acciones Masivas

La franja superior del módulo permite reducir la lista antes de operar:

Si marcas uno o más usuarios con el checkbox de la tabla, aparece una barra de acciones masivas. Úsala para:

• Confirmar email.
• Enviar correo de recuperación.
• Forzar cambio de contraseña.
• Suspender.
• Reactivar.

El botón de descarga exporta la selección marcada. Si no hay selección, exporta los usuarios visibles después de aplicar filtros.

7.2.1 Crear Usuario Manual

1. Presiona Nuevo.
2. En Tipo de alta, elige la opción que corresponde a la persona: Admin global, Operador global, Admin empresa, Supervisor, Capturador, Operador de comunidad, Fiscal o Personalizado.
3. Captura nombre y correo.
4. Define la empresa:
   • Déjala vacía para Admin Global, Operador global, Capturador u Operador de comunidad.
   • Selecciónala para Admin Empresa o Supervisor.
5. Revisa los roles iniciales que el wizard marcó automáticamente. Si eliges Personalizado o cambias un checkbox manualmente, confirma la combinación antes de crear.
6. Elige Invitación o Temporal.
7. Presiona Crear usuario.

Si usas contraseña temporal, AdminWeb muestra la contraseña sólo al terminar la operación. Cópiala y entrégala por un canal seguro.

Validación importante: si marcas Admin Empresa o Supervisor sin empresa, AdminWeb bloquea el alta con empresa_requerida. Si asignas una empresa a Admin Global u Operador global, la pantalla lo muestra como alerta de conflicto para que lo revises.

Al elegir Operador de comunidad, el wizard limpia empresa, sindicato y todos los demás roles. La API vuelve a validar esta exclusividad antes de crear el usuario.

7.2.2 Editar Datos Y Transferir Empresa

Al seleccionar un usuario, en Datos básicos puedes actualizar nombre, correo, empresa, sindicato y estado activo. Cambiar la empresa asignada sirve como transferencia administrativa y queda auditado.

7.2.3 Plantillas De Rol

Usa plantillas para evitar combinaciones manuales repetitivas:

La pantalla también muestra alertas de conflicto, por ejemplo AdminEmpresa sin empresa, AdminGlobal con empresa asignada u Operador global con empresa asignada.

7.2.4 Asignar Contraseña Temporal

1. Busca y selecciona el usuario.
2. En Acceso y contraseña, captura una contraseña o presiona Generar.
3. Presiona Asignar temporal.
4. Copia la contraseña mostrada y entrégala al usuario por un canal seguro.

El usuario queda marcado para cambiar contraseña al entrar. Los usuarios de empresa la cambian en MonitorWeb; los operadores de comunidad la cambian en AdminWeb y después son enviados directamente a Conversaciones.

Cuando se asigna una contraseña temporal, AdminWeb también confirma el correo en Supabase Auth. Esto evita que un usuario con acceso perdido al buzón quede detenido por el mensaje Email not confirmed.

Usa esta acción sólo cuando el usuario ya exista en Supabase Auth. Si es un usuario nuevo dentro del alta de empresa, usa la opción Contraseña temporal del wizard de onboarding.

7.2.5 Reset, Invitación Y Sesiones

Después de Cerrar sesiones, entrega la contraseña temporal mostrada. El usuario entrará a MonitorWeb y deberá completar /cambiar-password.

Los correos de invitación y recuperación no salen por el envío nativo de Supabase Auth. AdminWeb genera el link seguro con Supabase y lo entrega a la outbox NotificacionEmail; la Edge Function email-despachar lo manda por Resend.

7.2.6 Diagnóstico Auth

El panel Diagnóstico Auth muestra datos útiles para soporte:

Si el usuario aparece bloqueado, usa Desbloquear Auth para quitar el ban y reactivar el registro operativo. Si aparece sin Auth, el caso debe corregirse revisando la vinculación SupabaseUserId.

7.2.7 Suspensión Y Baja Lógica

Suspender bloquea el acceso pero conserva roles y datos. Reactivar restaura el acceso. Baja lógica desactiva el usuario, quita roles y bloquea Auth sin borrar historial.

7.2.8 Auditoría Y Exportación

La sección Auditoría reciente muestra eventos administrativos del usuario seleccionado. El botón de descarga exporta la lista visible a CSV con usuario, empresa, roles, estado Auth y último acceso.

8. Empresas

8.1 Empresas Transportistas

Sidebar → Empresas → Empresas transportistas.

Muestra las empresas y su estado de membresía de monitoreo: slots, vigencia, pagos pendientes y estado. Desde el detalle puedes revisar pagos pendientes y acciones administrativas relacionadas con esa empresa.

8.2 Viajes Por Ruta

Sidebar → Empresas → Viajes por ruta.

Agrupa viajes por empresa, ruta, corredor o itinerario. Sirve para ver qué rutas usa cada empresa y cómo se distribuyen sus viajes por estado.

8.3 Sindicatos

Sidebar → Empresas → Sindicatos.

Catálogo global de sindicatos o agrupaciones transportistas.

9. Catálogos

9.1 Palabras Y Planes

Sidebar → Catálogos → Palabras y planes.

Incluye palabras prohibidas para moderación del chat y planes de membresía.

9.2 Licencias Y Tarifas

Sidebar → Catálogos → Licencias y tarifas.

Administra paquetes de licencias y precios por volumen para contratos de monitoreo.

Esquema comercial vigente

Abbante maneja dos productos comerciales separados:

Para cotización y capacitación de vendedores, usa precio real y precio de arranque:

Para app chofer, los tramos de compra y venta son:

El precio real de referencia queda 50% arriba del precio propuesto para mostrar el descuento de arranque. La utilidad se calcula contra el costo base final del tramo contratado.

La app del chofer conserva datos en el celular y en el centro de datos por 1 semana. Si se ofrece retención extendida de 3 meses, suma $10 MXN al costo base por chofer. En el portal empresa, la información se conserva por 5 años o hasta la terminación del contrato.

Reglas de margen comercial:

• Chofer: utilidad = precio cerrado - costo base final. La utilidad se reparte 50/50 entre empresa y vendedor, incluso si el vendedor logra cerrar por arriba del precio propuesto.
• Camión: si el precio cerrado supera el recomendado, el margen adicional se reparte 50/50.
• Portal empresa: comisión de referencia para vendedor = 5% del contrato.

9.3 Rutas E Itinerarios

Sidebar → Catálogos → Rutas e itinerarios.

Administra nodos, corredores, tramos, opciones de tramo, checkpoints plantilla e itinerarios. Estos datos alimentan la creación de viajes en MonitorWeb.

Flujo recomendado:

1. Validar o crear nodos.
2. Crear corredor.
3. Capturar tramos y opciones.
4. Agregar checkpoints plantilla.
5. Crear itinerario.
6. Probar desde MonitorWeb creando un viaje.

9.4 Aduanal

Sidebar → Catálogos → Aduanal.

Administra agentes aduanales, documentos y ventanas de recolección.

9.5 Parámetros Del Sistema

Sidebar → Catálogos → Parámetros del sistema.

Permite administrar claves de configuración globales. Usa el flag sensible para ocultar valores en pantalla; no equivale a cifrado. Los secretos reales deben vivir en variables de entorno o secrets de Supabase/Vercel.

9.6 Club Del Chofer

Sidebar → Catálogos → Club del chofer.

Administra el catálogo de beneficios y descuentos que los choferes ven en la app Abbante (Perfil → Club del Chofer). Desde aquí das de alta, editas y das de baja cada beneficio que ofrecen los aliados (diésel, llantas, casetas, talleres, salud, etc.).

Alta y edición de un beneficio

Cada beneficio se compone de:

Dar de baja un beneficio

La baja es lógica: desactiva el switch Activo para que el beneficio deje de mostrarse en la app sin borrar el registro. Así conservas el historial y puedes reactivarlo después si el aliado renueva el convenio.

El nivel requerido se relaciona con la reputación del chofer (Bronce / Plata / Oro / Platino). Un beneficio con nivel Oro, por ejemplo, solo se mostrará desbloqueado a choferes que hayan alcanzado ese nivel.

10. Plataforma

La sección Plataforma concentra tareas transversales que antes se resolvían en XAF o en procesos separados: operación comercial, comunicación masiva, soporte sensible, salud técnica, configuración y auditoría. Todas estas pantallas requieren usuario AdminGlobal.

10.1 Membresías Y Pagos

Sidebar → Plataforma → Membresías y pagos.

Consolida la operación comercial de membresías. La parte superior muestra conteos de empresas, pagos de empresa, pagos de chofer y trials. Debajo hay un panel con pestañas para revisar cada cola.

En Pagos empresa, la columna Detalle muestra el snapshot del cobro: concepto, cantidad, días cuando aplica, descuento y subtotal por línea. Ese snapshot queda guardado en PagoMembresiaEmpresa.DetalleCalculo, por lo que el histórico del cobro no cambia aunque después la empresa modifique su paquete.

En el detalle de empresa, además del estado de la membresía actual, verás:

Cuando el paquete incluya portal empresa, recuerda que el valor comercial no es solo “acceso a la app”: incluye seguimiento operativo, historial y resguardo de información empresarial por 5 años o hasta fin de contrato. Si el paquete suma licencias de chofer con retención de 3 meses, valida que el costo base aumente $10 MXN por chofer antes de revisar la utilidad.

Al rechazar un pago o trial, captura el motivo para dejar evidencia operativa.

10.2 Liquidaciones

Sidebar → Plataforma → Liquidaciones.

Muestra facturas B2B de proveedores y su ciclo operativo:

Si los documentos están guardados en bucket privado, la pantalla genera un enlace firmado temporal para descargar XML o PDF.

10.3 Soporte

Sidebar → Plataforma → Soporte.

Consolida tickets y solicitudes sensibles. La pantalla inicia con tres indicadores: tickets abiertos, privacidad pendiente y asistencias abiertas. El panel principal se opera por pestañas.

10.4 Reportes Ejecutivos

Sidebar → Plataforma → Reportes ejecutivos.

Muestra KPIs globales para tomar decisiones rápidas:

10.5 Notificaciones

Sidebar → Plataforma → Notificaciones.

Es un hub de accesos a las consolas que emiten o configuran mensajes:

Para campañas masivas, primero valida audiencia y canal. Las acciones quedan disponibles para revisión en Auditoría global.

10.6 Herramientas

Sidebar → Plataforma → Herramientas.

Concentra accesos de diagnóstico y corrección controlada:

También muestra contexto de sesión: usuario, si tiene AdminGlobal y el scope de empresa. Para el usuario global el scope debe aparecer como Global.

10.7 Salud Operativa

Sidebar → Plataforma → Salud operativa.

Ejecuta checks rápidos contra RPCs y servicios críticos usados por AdminWeb. Muestra conteo de checks correctos, estado general, peor latencia y detalle por servicio.

Servicios revisados actualmente:

10.8 Configuración Global

Sidebar → Plataforma → Configuración global.

Gestiona tres bloques:

Cambiar a Producción muestra advertencia porque los cobros son reales. Antes de activarlo, confirma KYC y secretos live.

10.9 Noticias Y Fuentes

Sidebar → Plataforma → Noticias y fuentes.

Administra fuentes RSS/Google News y publicaciones manuales:

10.10 Destinos Telegram

Sidebar → Plataforma → Destinos Telegram.

Mapea canales de notificación a grupos o chats de Telegram. Los canales actuales son: emergencias, operación, administración, onboarding y técnico.

Cada destino permite:

Usa default como chat ID sólo cuando el grupo base esté configurado en TELEGRAM_CHAT_ID.

10.11 Moderación

Sidebar → Plataforma → Moderación.

Revisa dos colas de moderación:

Acciones disponibles para chat:

Acciones disponibles para reportes carreteros:

10.12 Privacidad

Sidebar → Plataforma → Privacidad.

Consola especializada para solicitudes relacionadas con privacidad y datos personales. Permite filtrar por todas, pendientes, en proceso, completadas y cerradas.

Cada solicitud muestra nombre, correo, tipo de cuenta, supabase_user_id, motivo, respuesta previa y un campo para nota administrativa. Los estados operativos disponibles son: En proceso, Completada y Cerrar.

10.13 Broadcast Push

Sidebar → Plataforma → Broadcast push.

Envía notificaciones push a choferes activos. El alcance puede ser:

El formulario exige título y mensaje. Antes de enviar, confirma el alcance porque el push puede llegar a muchos dispositivos. El resultado indica cuántas notificaciones se encolaron.

10.14 Auditoría Global

Sidebar → Plataforma → Auditoría global.

Bitácora de acciones administrativas. Permite buscar por acción, usuario o metadatos, filtrar por tipo de acción y limitar la consulta. Cada registro se puede expandir para ver los metadatos en formato JSON cuando estén disponibles.

10.15 Agente De Comunidad

Sidebar → Plataforma → Agente de comunidad.

Supervisa el servicio de X, Telegram y WhatsApp. La pantalla resume el estado de canales, presenta borradores de X para aprobación, conserva las conversaciones escaladas, permite responder como operador por el mismo canal, actualiza los prospectos capturados y administra conocimiento, turnos y SLA.

Un AdminGlobal ve las seis pestañas: Resumen, Publicaciones, Conversaciones, Prospectos, Conocimiento y Operación. El perfil Operador de comunidad sólo ve Conversaciones; se crea y edita desde Personas -> Usuarios y roles.

Reglas principales:

• X nunca publica un borrador sin aprobación explícita.
• Telegram sólo responde mensajes privados, comandos, menciones o respuestas dirigidas al bot.
• WhatsApp atiende conversaciones individuales iniciadas por la persona.
• Al tomar una conversación, el robot deja de responder hasta su liberación.
• Los handoffs se asignan por canal, turno, capacidad y menor carga; el SLA de primera respuesta se muestra en la conversación y genera una alerta al vencer.
• Una respuesta resuelta puede convertirse en candidata de conocimiento. Sólo una versión aprobada y vigente queda disponible para el robot.
• Llama/OpenRouter sólo selecciona evidencia aprobada y el robot publica el texto controlado de esa evidencia; sin evidencia conserva el handoff humano.
• Los datos operativos y secretos no se comparten en redes sociales.

Consulta el manual dedicado Agente de comunidad en la biblioteca de manuales para configuración, consentimiento, pruebas e incidentes.

11. Qué Sigue Viviendo En MonitorWeb

Estas tareas corresponden al administrador o supervisor de una empresa transportista:

12. Errores Frecuentes

“No Es Admin Global”

El usuario no tiene EsAdminGlobal=true. Si es AdminEmpresa, debe entrar a https://transporte.abbante.com. Si debería ser global, revisa Usuarios y roles o el registro PermissionPolicyUser.

“Creé Una Empresa Y El Admin Entró Al Portal Equivocado”

La invitación debe apuntar a NEXT_PUBLIC_MONITOR_URL/cambiar-password; en producción debe resolver a https://transporte.abbante.com/cambiar-password. Si llega a AdminWeb, a localhost o al login directo, revisa la variable NEXT_PUBLIC_MONITOR_URL del deploy de AdminWeb y vuelve a enviar la invitación desde Usuarios y roles o desde el alta de empresa.

Los correos enviados antes de este ajuste pueden conservar un redirect_to viejo. En ese caso, reenvía la invitación para generar un link nuevo.

“El Usuario No Ve El Menú Después De Cambiarle Roles”

Pide al usuario cerrar sesión y volver a entrar. Algunas vistas leen el perfil al iniciar sesión o al cargar el layout.

“El Admin De Empresa No Recibió La Invitación”

Revisa spam. Si no aparece, tienes dos opciones desde AdminWeb:

1. Si el correo sí funciona, usa Usuarios y roles → Reenviar invite. El nuevo correo llevará al usuario a definir contraseña en /cambiar-password.
2. Si todavía estás creando la empresa y el correo no llega, vuelve al paso Admin de la empresa y selecciona Contraseña temporal.
3. Si el usuario ya existe, entra a Usuarios y roles, selecciona el usuario y usa Acceso y contraseña → Asignar temporal.

El usuario podrá iniciar sesión en https://transporte.abbante.com/login con esa contraseña y el portal le pedirá cambiarla antes de operar.

“El Usuario Tiene Contraseña Temporal Y No Puede Operar”

Es esperado. MonitorWeb lo envía a /cambiar-password hasta que defina su contraseña definitiva. Si no recuerda la temporal, genera una nueva desde Usuarios y roles.

“Liquidaciones No Permite Aprobar Facturas”

La vista muestra el estado global. Las acciones fiscales requieren habilitar el permiso EsAdminFiscal y activar el flujo de aprobación correspondiente.

Administración del flujo portuario y multiempresa

Nuevos objetos de administración portuaria

El backoffice XAF incorpora objetos para soporte y conciliación:

• OrganizacionLogistica, UsuarioOrganizacion y ParticipanteViaje para navieras, agencias, terminales, clientes y depósitos opcionales.
• AcuerdoSubcontratacion, AsignacionRecursoSubcontratado, DelegacionLicenciaEmpresa y CoberturaLicenciaViaje para separar empresa contratante, operadora y titular de licencia.
• CicloContenedor, ObjetivoViaje, EventoCustodiaContenedor y OrdenRetornoContenedor para seguimiento de punta a punta.
• IncidenciaDanioContenedor para revisión, impugnación y deducción documentada.
• LogroSostenibilidadEmpresa para revisar evidencias y marcar como verificado únicamente lo que deba participar en búsquedas preferentes.

Antes de cambiar una cobertura o deducción, verifica el viaje, empresa titular, empresa operadora, evidencia y bitácora. No reasignes la propiedad del camión al compartirlo y no contabilices una licencia patrocinada como licencia propia de la empresa beneficiaria.

Apéndice A. Glosario

Apéndice B. Soporte

Última actualización: 2026-07-22 · Versión del portal: AdminWeb 1.2.5