# 📋 CRM LOGÍSTICA - GUÍA DE USO

## ✅ NOVEDADES - SOPORTE PARA PDF Y EXCEL

Ahora la CRM puede **extraer datos automáticamente tanto de archivos PDF como de Excel**.

---

## 🚀 INICIO RÁPIDO

### 1. Abre el archivo en tu navegador
- Descarga `CRM_LOGISTICA.html`
- Haz doble clic para abrirlo en tu navegador
- O copia la ruta al navegador

### 2. Login
**Usuarios Demo:**
| Usuario | Contraseña |
|---------|-----------|
| `admin` | `123456` |
| `usuario1` | `123456` |
| `usuario2` | `123456` |

---

## 📊 SECCIONES DE LA CRM

### 🏠 DASHBOARD
- **Estadísticas generales** de operaciones
- **Últimas 5 operaciones** registradas
- Contadores de estado (En Progreso, Completadas, Pendientes)

### 📦 OPERACIONES
- **Crear nueva operación** manualmente
- **Buscar y filtrar** operaciones
- **Editar** información existente
- **Eliminar** operaciones
- **Ver archivos adjuntos** por operación

### 📥 IMPORTAR DATOS
**LO NUEVO:** Soporta tanto **PDF como Excel**

#### 📊 Importar desde EXCEL
1. Haz clic en "Importar Datos"
2. Arrastra o selecciona tu archivo `.xlsx`
3. La CRM extraerá automáticamente:
   - Booking #
   - Cliente
   - Exportador (Shipper)
   - Buque
   - Origen (POL)
   - Destino (POD)
   - Fechas de salida y llegada (ETD/ETA)
   - Equipos
   - Y más...

#### 📄 Importar desde PDF
**NUEVA FUNCIONALIDAD**

1. Haz clic en "Importar Datos"
2. Arrastra o selecciona tu archivo `.pdf`
3. La CRM:
   - Leerá las primeras 5 páginas
   - Extraerá el texto automáticamente
   - Buscará patrones de información
   - Completará los campos disponibles

**¿Qué datos extrae del PDF?**
- Booking #
- Cliente
- Exportador (Shipper)
- Consignatario (Consignee)
- Buque (Vessel)
- Viaje (Voyage)
- Puertos (Origen, Destino)
- Fechas de tránsito (ETD, ETA)
- Equipos (Contenedores)
- Cantidades

**Nota:** Si el PDF tiene formato diferente, completa manualmente los campos.

### 👥 USUARIOS
- Crear nuevos usuarios
- Asignar roles (Usuario, Supervisor, Admin)
- Eliminar usuarios
- Gestionar permisos

---

## 📁 ADJUNTAR DOCUMENTOS

### Guardar archivos en una operación

1. **Abre o crea una operación**
2. En el campo **"Documentos Adjuntos"**, puedes:
   - Hacer clic para seleccionar archivos
   - Arrastrar y soltar archivos
   - Agregar múltiples PDF, Excel, etc.

3. Los archivos se guardan **dentro de la operación**

### Ver archivos guardados

1. **Edita la operación**
2. En la sección **"Archivos Guardados"** verás:
   - Nombre del archivo 📄
   - Tamaño
   - Fecha de carga
   - Opción de eliminar

---

## 🔍 BUSCAR OPERACIONES

1. Ve a **"Operaciones"**
2. Usa el buscador para filtrar por:
   - Booking #
   - Cliente
   - Exportador
   - Buque
   - O cualquier campo visible

**Ejemplo:** Si escribes "BUA0377418", te mostrará solo esa operación.

---

## 📑 ESTADOS DE OPERACIÓN

Cada operación puede estar en:

- **En Progreso** 🟠 (Operación activa)
- **Completada** 🟢 (Operación finalizada)
- **Pendiente** 🔴 (Requiere atención)
- **En Riesgo** 🔴 (Problemas potenciales)

---

## 💾 CÓMO FUNCIONAN LOS DATOS

### Almacenamiento Local
- Los datos se guardan **en el navegador** (localStorage)
- **No se pierden** al cerrar la CRM
- **Se pierden** si borras el historial del navegador

### Sincronización entre usuarios
[Limitación actual] Cada usuario en diferentes navegadores tiene su propia copia de datos.

**Solución:** Para compartir datos reales entre múltiples usuarios simultáneamente, necesitas:
- Un backend (servidor)
- Una base de datos
- Sincronización en tiempo real

---

## 🛠️ CARACTERÍSTICAS TÉCNICAS

### Extracción de datos - EXCEL
- Lee archivos `.xlsx` y `.xls`
- Procesa múltiples hojas
- Extrae valores de celdas específicas
- Convierte fechas automáticamente

### Extracción de datos - PDF
- Soporta PDF de texto (no escaneados)
- Lee las primeras 5 páginas
- Usa expresiones regulares para encontrar patrones
- Soporta múltiples formatos de fecha (DD/MM/AA, MM/DD/AA)
- Identifica campos automáticamente

### Almacenamiento de archivos
- Guarda referencias de archivos
- Tamaño máximo: 20 MB por archivo
- Soporta: PDF, Excel, Word, imágenes, etc.

---

## ❓ PREGUNTAS FRECUENTES

### ¿Puedo usar esto en internet?
**Respuesta:** El HTML se ejecuta en tu navegador. Para usarlo en internet con múltiples usuarios:
1. Súbelo a un hosting
2. Implementa un backend
3. Configura una base de datos

### ¿Los datos se sincronizarán con otros usuarios?
**No en esta versión.** Cada navegador tiene su propia copia. Para sincronización real necesitas backend.

### ¿Qué pasa si cierro la CRM?
**Nada.** Los datos se guardan automáticamente. La próxima vez que abras, estarán ahí.

### ¿Se pierden los datos si borro el historial del navegador?
**Sí.** El localStorage se limpia con el historial. Exporta regularmente.

### ¿Puedo extraer datos de PDFs escaneados?
**No.** Solo funciona con PDFs de texto. Los scaneados necesitan OCR (software externo como Adobe, Tesseract).

### ¿Cuál es el tamaño máximo de archivo?
**20 MB** por archivo. Archivos más grandes pueden ralentizar el navegador.

---

## 🔐 SEGURIDAD

### Contraseñas Demo
- Las contraseñas demo son **SOLO PARA PRUEBA**
- Cambia las contraseñas antes de usar en producción
- No compartas credenciales

### Datos en localStorage
- Los datos están en tu navegador, NO en la nube
- Nadie puede acceder desde afuera
- Son privados en tu máquina

---

## 🚀 PRÓXIMAS MEJORAS SUGERIDAS

1. **Backend + Base de datos** → Multiusuario real
2. **Autenticación segura** → Cambiar contraseña
3. **Exportar a PDF** → Generar reportes
4. **Sincronización en la nube** → Google Drive, Dropbox
5. **OCR para PDFs** → Leer documentos escaneados
6. **Notificaciones** → Alertas de operaciones
7. **Historial de cambios** → Ver quién modificó qué y cuándo

---

## 📞 SOPORTE

Si tienes problemas:
1. Recarga la página (Ctrl+R o Cmd+R)
2. Limpia la caché si los datos no se actualizan
3. Prueba con un archivo diferente
4. Verifica que el PDF/Excel no esté corrupto

---

**Versión:** 1.1 con soporte PDF/Excel  
**Última actualización:** Septiembre 2026  
**Estado:** Producción (uso local)