Trade Intelligence
Monitoreo de compradores internacionales de carbón
Total Compradores
0
+12% vs mes anterior
Volumen Total (MT)
0
+8.4% demanda global
Promedio por Cliente
0 MT
Estable
Clientes Estratégicos
0
Top TierProyección de Demanda Global
Distribución Regional
Registro Detallado de Compradores
| Cliente | Producto | Cantidad (MT) | Puerto Destino | Frecuencia | Estado |
|---|
Advanced Simulator
Análisis financiero de escenarios multi-variable para Antigravity
Parámetros de Operación
Variaciones Proyectadas
Define el impacto porcentual para los escenarios optimistas y pesimistas.
Maximize
Optimista
Margen Neto:
$0
Margen (%):
0%
Distribución de Flujo
Referencia
Caso Base
Margen Neto:
$0
Margen (%):
0%
Distribución de Flujo
Risk
Pesimista
Margen Neto:
$0
Margen (%):
0%
Distribución de Flujo
Análisis Comparativo de Margen
Directorio de Compradores
Base de datos centralizada de clientes y relaciones comerciales
| Fecha Reg. | Cliente | Producto | Volumen (MT) | Puerto Destino | Frecuencia | Estado | Acción |
|---|
Operación Logística
Seguimiento de embarques y estados de puerto en tiempo real
Embarques Activos
0
En tránsito
Toneladas en Ruta
0 MT
Carga viva
Entregados (Mes)
0
CompletadosRegistro de Embarques
| ID | Cliente | Origen | Destino | Volumen | Fecha Salida | ETA | Estado |
|---|
Gestión de Cotizaciones
Histórico de ofertas y negociaciones activas
Cotizaciones Activas
0
Pendientes
Aprobadas
0
Cerradas
Valor Total Activo
$0
En negociaciónRegistro de Cotizaciones
| Fecha | Cliente | Producto | Volumen | Precio ($/MT) | Valor Total | Validez | Estado |
|---|
Panel de Configuración
Ajustes de sistema y preferencias de usuario
Idioma de la Aplicación
Selecciona el idioma de la interfaz
Perfil de Usuario
Preferencias del Sistema
Modo Oscuro
Notificaciones por Email
Alertas de Precio
Integraciones
Firebase Firestore
Base de datos en la nube
Pendiente
API MarineTraffic
Rastreo de buques en tiempo real
Pendiente
Google Sheets Export
Exportación automática de reportes
Pendiente
CDN, seguridad y servicios de red global
Pendiente
Personal Registrado
0
Total Personal
0
Activos
0
Vacantes
| Nombre Completo | Cargo | Departamento | Fecha de Ingreso | Fecha de Baja | Estado | Acción |
|---|
Manual de Usuario
Guía completa de uso de la plataforma Antigravity
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 |