wiki/Settings y Admin/La caja de herramientas Admin: forzar finalización, suplantación y soluciones de flujo atascado
13Settings y AdminLectura mínima 4

La caja de herramientas Admin: forzar finalización, suplantación y soluciones de flujo atascado

Botones con auditoría, motivos y radio de acción reducido para depósitos en garantía atascados, completadores forzados, registros varados y suplantación de solo lectura.

La caja de herramientas Admin es la ruta de escape controlada para problemas de inquilinos que la interfaz de usuario normal no puede resolver: un inquilino, una fila, un flujo atascado, con auditoría, un motivo requerido y el radio de explosión más pequeño posible.

Forzar puntos finales completos

Los flujos operativos específicos tienen una trampilla de escape forzada completa que aparece en la interfaz de usuario del administrador de la plataforma: una sesión de recepción que no se cierra debido a un bloqueo obsoleto, una etapa del flujo de trabajo que necesita avanzar aunque falte un criterio, una ejecución de liquidación que abortó a mitad de camino. Cada finalización forzada escribe su propio evento de auditoría con el motivo, el actor y las filas afectadas. Los puntos finales no existen para uso general; son el camino de “alguien necesita romper el cristal”.

Tres trampillas de escape para depósitos en garantía atascados

ELos depósitos en garantía pueden bloquearse de tres maneras específicas: depósito confirmado pero los fondos no llegaron (desajuste del lado del pago), mercancías recibidas pero la guardia del barco no se levantó (desajuste del lado del evento del barco), liberación lista pero la fila de liquidación no se escribió (desajuste del lado de la liquidación). Cada uno tiene su propio botón de administración en /admin/escrow con un mensaje de confirmación que explica exactamente qué se cambiará: no hay acciones compuestas escondidas detrás de un clic.

Disparador de sincronización manual Blancco

La sincronización por inquilino Blancco se ejecuta en un cron, pero si un inquilino acaba de configurar la integración o acaba de realizar una importación masiva que necesita atención inmediata, un botón de administrador activa la sincronización a pedido. El disparador respeta el mismo límite de velocidad y procesamiento por lotes que el cron: es la misma ruta de código, antes de la siguiente ejecución programada.

Everificación de correo + recuperación de registro bloqueado

Cuando un administrador de inquilinos se registra pero nunca recibe el correo electrónico de verificación, /admin/users muestra el estado de verificación y ofrece un reenvío. Los registros bloqueados (iniciados pero nunca completados) aparecen en /admin/onboarding con la opción de borrar manualmente o reenviar el flujo de bienvenida.

Anulación del estado de suscripción

Cuando el estado_de_suscripción de un inquilino se desvía del estado informado por el proveedor de facturación (poco común, pero sucede: webhook perdido, cancelación manual), /admin/billing tiene un campo de anulación directa con una nota de motivo obligatoria; la anulación se registra en la auditoría y el proveedor de facturación se concilia en el siguiente webhook.

Suplantación con bloque de escritura

La herramienta más grande. /admin/impersonate permite al personal de la plataforma iniciar sesión como usuario inquilino (solo lectura) para investigar lo que ven sin rebote de correos electrónicos. El middleware intercepta métodos HTTP mutantes (POST, PUT, PATCH, DELETE) en sesiones suplantadas y devuelve un 403 con un error de "la suplantación es de solo lectura". El seguimiento de sesiones escribe cada página que visita el imitador en el registro de actividad, por lo que un inquilino que pregunta "¿alguien de la plataforma miró nuestros datos?" obtiene una fila, no una suposición.

audit_events solo se agrega en el nivel de activación

La tabla audit_events tiene activadores de base de datos que rechazan ACTUALIZAR y ELIMINAR. Incluso un administrador con acceso elevado a la base de datos no puede reescribir el historial silenciosamente. Se pueden insertar nuevas filas (una corrección con referencia al evento original), pero la fila original permanece. La caja de herramientas Admin puede arreglar lo que está roto; no puede ordenar lo que se grabó.