Panel interno (backoffice)¶

Panel de administración y operación para el equipo interno de la empresa. El backoffice debe ser una herramienta de trabajo diario, no solo un admin de modelos.

Colas operativas¶

El operador necesita colas de trabajo, no solo formularios. Estas son las vistas operativas prioritarias:

Cola de recepción¶

Lista de paquetes que acaban de llegar al almacén. Cada registro muestra: tracking, identificador (si se leyó), tienda, fecha y operador que recibió.

Permitir registrar paquete manualmente
Permitir escanear o escribir identificador
Foto obligatoria al recibir
Asignar ubicación física en almacén

Cola de conciliación¶

Paquetes que llegaron pero no tienen prealerta asociada, o donde hay conflicto entre el identificador y el tracking.

Casos a resolver:

Caso	Acción
Paquete sin identificador legible	Buscar por tracking → sugerir usuario
Paquete sin prealerta	Notificar al usuario → esperar a que complete datos
Identificador y tracking apuntan a usuarios distintos	Incidencia `tracking_no_coincide` → revisión manual
Paquete para usuario bloqueado/suspendido	Retener → decisión manual

Paquetes sin identificar¶

Paquetes que no se pudieron asociar a ningún usuario por falta de prealerta o por error en la etiqueta.

KYC pendiente de revisión¶

Lista de KYC recibidos, ordenados por fecha de envío. Cada uno muestra: usuario, tipo de documento, fecha de envío y estado.

Servicios adicionales pendientes¶

Lista de servicios solicitados que aún no se completan: inspecciones, reempaques, devoluciones.

Consolidaciones por preparar¶

Consolidaciones confirmadas que esperan ser empacadas y despachadas.

Pagos pendientes de confirmar¶

Pagos registrados que esperan verificación o que fallaron.

Paquetes por vencer en almacén¶

Paquetes próximos a terminar el período de almacenaje gratis. Alerta antes de que se aplique cargo.

Devoluciones activas¶

Devoluciones en curso: en camino al vendedor, recibidas, con reembolso pendiente.

Incidencias escaladas¶

Incidencias que requieren atención de supervisor.

Gestión de usuarios¶

Crear y editar usuarios
Crear y editar remitentes y destinatarios
Asignar y gestionar identificadores
Ver historial de actividad del usuario

Gestión de paquetes¶

Ver compras reportadas
Registrar paquetes recibidos (con foto obligatoria)
Subir fotos de paquetes
Asociar tracking a usuario
Cambiar estados logísticos
Consolidar paquetes manualmente
Ver timeline de eventos del paquete

Almacenamiento¶

Definir tiempos de almacén y alertas
Aplicar cargos por almacenaje
Ver ocupación por zona/estante
Ubicaciones físicas de paquetes

Servicios adicionales¶

Registrar inspección o prueba funcional
Ver resultado y evidencia de inspección
Gestionar devoluciones
Registrar reempaque

Configuración¶

Definir tarifas
Editar textos de aduana
Crear y editar tutoriales
Gestionar categorías de producto
Gestionar estados logísticos
Configurar el porcentaje del pool promocional
Configurar requisitos de niveles (lb mínimas, referidos mínimos)
Activar o pausar el programa de referidos
Definir vencimiento del crédito

Programa de referidos y fidelidad¶

Reportes¶

Exportar reportes de operación
Auditoría de cambios
Reporte de crecimiento de la red (referidos nuevos por período)
Reporte de crédito acreditado vs crédito expirado
Reporte de tarjetas emitidas vs tarjetas usadas vs tarjetas vencidas
Reporte de distribución del pool por nivel
Reporte de usuarios por nivel y tendencia
Reporte de impacto del programa: libras adicionales atribuibles a referidos

Tecnología del panel¶

El panel administrativo se construye sobre Django Admin como base, aprovechando:

Sistema de permisos y roles integrado
Interfaz de gestión de modelos lista para usar
Vistas personalizadas para las colas operativas
Integración directa con PostgreSQL vía el ORM de Django

Fase 1

En el MVP, Django Admin cubre la operación. Las colas operativas se implementan como vistas personalizadas sobre Django Admin. En fases posteriores, el backoffice puede evolucionar hacia una interfaz propia de operación si las necesidades lo requieren.