Antigravity | B2B Coal Trading Dashboard

1. Introducción

Antigravity es una plataforma profesional de gestión B2B especializada en el comercio internacional de carbón. Está diseñada para:

📊 Monitorear compradores internacionales de carbón térmico y metalúrgico
💹 Simular escenarios financieros con análisis de márgenes
🚢 Rastrear embarques y cadena logística
📄 Gestionar cotizaciones y negociaciones activas
👥 Administrar el equipo y las integraciones externas

La aplicación funciona 100% en el navegador. No requiere instalación local.

2. Acceso a la Aplicación

Modalidad	URL / Ruta
🌐 Producción (Cloudflare)	antigravity-coal.pages.dev
💻 Local	Abrir `index.html` desde el explorador de archivos

Requisitos

Requisito	Detalle
Navegador	Chrome, Firefox, Edge, Safari (versión reciente)
Conexión	Necesaria para cargar fuentes e íonos
Resolución	Mínimo 1024px de ancho

3. Navegación Principal

La barra lateral izquierda (Sidebar) contiene el menú principal. Siempre es visible.

Ícono	Sección	Descripción
📊	Dashboard	Panel principal con métricas y tabla de compradores
🧮	Simulador	Análisis de escenarios financieros
👥	Compradores	Directorio de clientes con datos de contacto
🚢	Logística	Seguimiento de embarques y estados
📄	Cotizaciones	Historial de ofertas y negociaciones
⚙️	Configuración	Perfil, preferencias, integraciones y personal
📖	Ayuda	Este manual de usuario con descarga en PDF

La app cambia de sección sin recargar la página (Single Page Application).

4. Dashboard — Panel Principal

Métricas (KPIs)

Tarjeta	Qué muestra
👥 Total Compradores	Número total de clientes registrados
📈 Volumen Total (MT)	Suma de toneladas de todos los compradores
📊 Promedio por Cliente	Promedio de MT por cliente
🏆 Clientes Estratégicos	Clientes con volumen ≥ 100,000 MT

Filtros y Búsqueda

Usa la barra de búsqueda superior para filtrar por nombre, puerto o país. Los botones Todos / Térmico / Metalúrgico filtran la tabla.

Registrar Nuevo Comprador

Clic en “+ Nuevo Registro”
Completa el formulario modal
Clic en “Registrar Comprador”

Un cliente se marca como Estratégico automáticamente cuando su volumen supera las 100,000 MT.

5. Simulador Financiero

Analiza el margen de ganancia bajo 3 escenarios financieros simultáneos en tiempo real.

Parámetros

Campo	Descripción	Ejemplo
Precio de Venta ($/MT)	Precio al que vendes el carbón	$120
Costo en Origen ($/MT)	Costo de adquisición	$65
Flete Logístico ($/MT)	Costo de transporte marítimo	$25
Volumen Total (MT)	Cantidad total de la operación	50,000

Escenarios de Resultado

Escenario	Color	Significado
🟢 Optimista	Verde	Mejor caso: precio alto, flete bajo
🔵 Caso Base	Azul	Exactamente los valores ingresados
🔴 Pesimista	Rojo	Peor caso: precio bajo, flete alto

Cada tarjeta muestra: Margen Neto ($), Margen (%) y Distribución de Flujo (Anticipo 30% / Mitad 40% / Final 30%).

6. Compradores — Directorio

Base de datos completa de clientes con información corporativa y de representantes legales.

Panel de Detalle

Haz clic en "👁 Ver" en cualquier fila para abrir el panel lateral con datos de empresa y representante legal. Todos los campos son editables directamente: haz clic en el campo, modifica y guarda con el botón correspondiente.

Los cambios en el panel de detalle se reflejan inmediatamente en la tabla del directorio.

7. Logística — Embarques

Estado	Color	Significado
🔵 En Tránsito	Azul	El buque está navegando hacia destino
🟡 En Puerto	Amarillo	El buque llegó, en proceso de descarga
🟢 Entregado	Verde	Cargamento recibido por el cliente

KPIs de Logística

Embarques Activos: total de embarques en curso
Toneladas en Ruta: volumen total actualmente en tránsito
Entregados (Mes): embarques completados en el mes actual

8. Cotizaciones

Filtro	Descripción
Todos	Muestra toda la lista de cotizaciones
Pendiente	Ofertas en espera de respuesta del cliente
Aprobada	Cotizaciones aceptadas por el cliente
Rechazada	Ofertas descartadas

KPIs de Cotizaciones

Cotizaciones Activas: ofertas pendientes de respuesta
Aprobadas: cotizaciones aceptadas
Valor Total Activo: suma en USD de las vigentes

9. Configuración

Perfil de Usuario

Edita tu nombre, correo y rol. Guarda con el botón “Guardar Perfil”.

Preferencias del Sistema

Preferencia	Tipo
Modo Oscuro	Toggle ON/OFF
Notificaciones por Email	Toggle ON/OFF
Alertas de Precio	Toggle ON/OFF
Moneda por Defecto	Selector (USD, EUR, COP…)
Umbral Estratégico (MT)	Número editable

Personal Registrado

Gestiona el equipo con “+ Nuevo Personal”. Activa o da de baja miembros con los botones de acción en la tabla.

10. Cambio de Idioma

La app soporta 4 idiomas. Para cambiar el idioma:

Ve a ⚙️ Configuración
Busca la tarjeta “Idioma de la Aplicación”
Haz clic en uno de los 4 botones de bandera

Bandera	Idioma
🇪🇸	Español (predeterminado)
🇺🇸	English
🇫🇷	Français
🇧🇷	Português

El cambio de idioma es inmediato y cubre todos los textos de la interfaz sin recargar la página.

11. Integraciones

Servicio	Descripción
🔥 Firebase Firestore	Base de datos en la nube para persistir datos
🚢 API MarineTraffic	Rastreo de buques en tiempo real
📊 Google Sheets Export	Exportación automática de reportes
🟠 Cloudflare	CDN, seguridad y red global (ya en producción)

Cómo activar

Ve a ⚙️ Configuración → Integraciones
Haz clic en “Activar” en el servicio deseado
El badge cambia a 🟢 ACTIVO con animación

Las integraciones con API keys (Firebase, MarineTraffic) requieren configuración adicional en el backend para conexión real en producción.

12. Glosario

Término	Definición
MT	Métric Ton / Tonelada Métrica (1,000 kg)
Carbón Térmico	Usado en plantas generadoras de electricidad
Carbón Metalúrgico	Usado en la producción de acero (coque)
B2B	Business-to-Business — comercio entre empresas
ETA	Estimated Time of Arrival — Hora estimada de llegada
Margen Neto	Ganancia después de restar todos los costos
Cliente Estratégico	Comprador con volumen ≥ 100,000 MT
SPA	Single Page Application — sin recargas de página
CDN	Content Delivery Network (Cloudflare)
KPI	Key Performance Indicator — indicador clave

0

0

0 MT

0

Proyección de Demanda Global

Distribución Regional

Registro Detallado de Compradores

Parámetros de Operación

Variaciones Proyectadas

Optimista

Caso Base

Pesimista

Análisis Comparativo de Margen

—

Datos de la Empresa

Representante Legal

0

0 MT

0

Registro de Embarques

0

0

$0

Registro de Cotizaciones

Idioma de la Aplicación

Perfil de Usuario

Preferencias del Sistema

Integraciones

Personal Registrado

Nuevo Registro de Comprador

Registrar Nuevo Personal

1. Introducción

2. Acceso a la Aplicación

Requisitos

3. Navegación Principal

4. Dashboard — Panel Principal

Métricas (KPIs)

Filtros y Búsqueda

Registrar Nuevo Comprador

5. Simulador Financiero

Parámetros

Escenarios de Resultado

6. Compradores — Directorio

Panel de Detalle

7. Logística — Embarques

KPIs de Logística

8. Cotizaciones

KPIs de Cotizaciones

9. Configuración

Perfil de Usuario

Preferencias del Sistema

Personal Registrado

10. Cambio de Idioma

11. Integraciones

Cómo activar

12. Glosario