Panel de administración

Acceso y permisos

• Comando: /marketadmin.
• Permiso ACE requerido: marketplace.admin.
• Ejemplo para administradores del servidor:

server.cfg

add_ace group.admin marketplace.admin allow

El permiso se valida en el servidor. Ocultar el comando o modificar la NUI no concede acceso a las operaciones administrativas.

Secciones disponibles

Overview

Muestra los indicadores principales: listados totales y activos, reportes pendientes, usuarios baneados, refunds pendientes y operaciones de entrega/trade pendientes. También muestra la última actualización y el estado de sincronización.

Listings

Permite buscar, filtrar y ordenar listados. Cada fila se puede previsualizar y los listados activos se pueden cancelar desde el panel, con confirmación previa.

Reports

Permite revisar el detalle de un reporte pendiente y marcarlo como revisado o descartarlo. Las acciones solicitan confirmación y actualizan el panel al terminar.

Users

Permite buscar y consultar usuarios, además de banearlos o desbanearlos con confirmación. Un administrador no puede banear su propio identificador.

Refunds

Permite consultar los refunds y forzar la devolución de un refund pendiente, siempre con confirmación. El servidor valida que el identificador sea un entero positivo antes de procesarlo.

History

Consulta de historial global en modo solo lectura.

Operations

Consulta de entregas y trades en modo solo lectura. Las operaciones de juego no se ejecutan desde esta vista para evitar alterar flujos activos o introducir inconsistencias.

Sincronización

El panel se actualiza mediante dos mecanismos:

1. Los cambios relevantes del servidor generan una actualización inmediata de la NUI cuando el panel está abierto.
2. Mientras el panel admin permanece abierto se realiza una comprobación periódica cada 10 segundos.

Si una actualización llega durante otra carga, se encola una nueva lectura para evitar dejar datos antiguos. Las previsualizaciones abiertas se reconcilian con los datos nuevos y se cierran si el registro ya no existe.

Límites de consulta

Las cargas administrativas tienen límites deliberados para proteger el servidor y la NUI:

Datos	Máximo cargado
Listings	200
Usuarios	200
Reportes	200
Historial	100
Refunds	100
Entregas	100
Trades	100

La paginación del panel se aplica sobre los registros cargados. Para instalaciones con un volumen superior será necesario implementar paginación server-side antes de ampliar estos límites.

Checklist de entrega

• marketplace.admin configurado en server.cfg.
• Un administrador puede abrir /marketadmin.
• Un usuario sin permiso no puede acceder a datos ni acciones admin.
• Overview carga indicadores y marca la última actualización.
• Listings, reportes, usuarios y refunds permiten abrir previsualizaciones.
• Las acciones destructivas muestran confirmación y refrescan los datos.
• History y Operations aparecen como solo lectura.
• La sincronización funciona con el panel abierto.
• Se ha probado el panel tras reiniciar sl-marketplace.
• Se ha probado en 1280×720, 1366×768 y 1920×1080.

Diagnóstico rápido

Si el panel aparece vacío:

1. Confirmar que el jugador pertenece a un grupo con marketplace.admin.
2. Revisar que el recurso se haya reiniciado después de los cambios.
3. Revisar la consola del servidor y la consola NUI por errores.
4. Confirmar que las tablas de sql/marketplace.sql existen y que oxmysql está iniciado antes del recurso.

Si no aparecen cambios nuevos, cerrar y volver a abrir el panel y comprobar que la conexión de base de datos no esté devolviendo errores.