# 📖 Guía de Usuario - Karibeo

## Introducción

Bienvenido a Karibeo, tu plataforma integral para gestión turística y comercial. Esta guía te ayudará a aprovechar al máximo todas las funcionalidades del sistema.

## Índice

1. [Primeros Pasos](#primeros-pasos)
2. [Para Turistas](#para-turistas)
3. [Para Hoteles](#para-hoteles)
4. [Para Restaurantes](#para-restaurantes)
5. [Para Comercios](#para-comercios)
6. [Panel de Administración](#panel-de-administración)
7. [Preguntas Frecuentes](#preguntas-frecuentes)

---

## Primeros Pasos

### Registro de Cuenta

1. **Acceder a la Plataforma**
   - Visita [karibeo.com](https://karibeo.com)
   - Click en "Registrarse" en la esquina superior derecha

2. **Completar Formulario**
   - Nombre completo
   - Email válido
   - Contraseña segura (mínimo 8 caracteres, incluir mayúsculas, minúsculas y números)
   - Tipo de cuenta: Turista o Comercio

3. **Verificar Email**
   - Revisa tu bandeja de entrada
   - Click en el enlace de verificación
   - Tu cuenta estará activa

### Iniciar Sesión

1. Click en "Iniciar Sesión"
2. Ingresa tu email y contraseña
3. Opcional: Marca "Recordarme" para mantener la sesión

### Recuperar Contraseña

1. En la página de login, click en "Olvidé mi contraseña"
2. Ingresa tu email
3. Revisa tu correo y sigue las instrucciones

---

## Para Turistas

### Explorar Destinos

#### Buscar Destinos
1. Desde la página principal, usa el buscador
2. Filtra por:
   - País/Región
   - Tipo de actividad
   - Rango de precios
   - Calificación

#### Ver Detalles
- Click en cualquier destino para ver:
  - Descripción completa
  - Galería de fotos
  - Actividades populares
  - Mejor época para visitar
  - Reseñas de otros viajeros

### Hacer Reservas

#### Hoteles
1. **Buscar Hotel**
   - Ingresa ciudad o nombre del hotel
   - Selecciona fechas (check-in / check-out)
   - Número de huéspedes

2. **Comparar Opciones**
   - Ver precios y disponibilidad
   - Comparar amenidades
   - Leer reseñas

3. **Reservar**
   - Selecciona tipo de habitación
   - Ingresa datos de contacto
   - Solicitudes especiales (opcional)
   - Proceder al pago

#### Restaurantes
1. **Buscar Restaurante**
   - Por ubicación o nombre
   - Filtrar por tipo de cocina
   - Ver menús y precios

2. **Hacer Reserva**
   - Selecciona fecha y hora
   - Número de comensales
   - Preferencias especiales

### Gestionar Reservas

Accede a "Mi Dashboard" → "Reservas"

#### Ver Reservas
- Todas tus reservas en un solo lugar
- Estado: Confirmada, Pendiente, Completada
- Detalles completos de cada reserva

#### Modificar Reserva
- Click en la reserva
- "Modificar" → Cambiar fechas o detalles
- Confirmar cambios

#### Cancelar Reserva
- Ver política de cancelación
- Solicitar cancelación
- Reembolso según políticas

### Billetera Digital

#### Cargar Saldo
1. Ve a "Billetera"
2. "Agregar Fondos"
3. Ingresa monto
4. Selecciona método de pago
5. Confirmar transacción

#### Ver Transacciones
- Historial completo
- Exportar a PDF/Excel
- Filtrar por fecha o tipo

### Reseñas

#### Escribir Reseña
1. Ve a "Mis Reservas" → Reservas completadas
2. Click en "Escribir Reseña"
3. Calificación (1-5 estrellas)
4. Comentario detallado
5. Subir fotos (opcional)
6. Publicar

#### Gestionar Reseñas
- Ver tus reseñas publicadas
- Editar o eliminar reseñas
- Respuestas de negocios

### Mapa Interactivo

#### Usar el Mapa
- Activar geolocalización
- Ver servicios cercanos
- Filtrar por categoría
- Obtener direcciones

---

## Para Hoteles

### Dashboard Hotelero

Accede a "Dashboard" → "Hotel Management"

### Gestión de Habitaciones

#### Agregar Nueva Habitación
1. "Habitaciones" → "Agregar"
2. Completar información:
   - Tipo de habitación (Sencilla, Doble, Suite)
   - Precio por noche
   - Capacidad
   - Amenidades
   - Fotos de alta calidad
3. Guardar

#### Gestionar Inventario
- Ver disponibilidad en calendario
- Bloquear fechas (mantenimiento, eventos)
- Ajustar precios por temporada

### Sistema de Reservas

#### Ver Reservas
- Calendario de reservas
- Lista detallada
- Filtrar por estado o fecha

#### Procesar Reserva
1. Nueva reserva aparece como "Pendiente"
2. Revisar detalles
3. Confirmar o rechazar
4. Notificación automática al cliente

#### Check-in / Check-out
1. Buscar reserva por nombre o ID
2. Verificar identidad del huésped
3. Procesar check-in
4. Al finalizar estadía: Check-out
5. Solicitar reseña

### Room Service

#### Gestionar Pedidos
1. Ver pedidos activos
2. Estado: Recibido → En preparación → Entregado
3. Asignar a personal
4. Marcar como completado

### Gestión de Personal

#### Agregar Empleado
1. "Personal" → "Agregar"
2. Datos del empleado
3. Asignar rol y permisos
4. Turnos de trabajo

---

## Para Restaurantes

### Dashboard Restaurante

Accede a "Dashboard" → "Restaurant POS"

### Terminal POS

#### Crear Orden
1. Seleccionar mesa o llevar
2. Agregar items del menú
3. Aplicar descuentos (si aplica)
4. Enviar a cocina

#### Procesar Pago
1. Revisar total
2. Seleccionar método: Efectivo, Tarjeta, Digital
3. Procesar pago
4. Imprimir/enviar recibo

### Gestión de Menú

#### Agregar Platillo
1. "Menú" → "Agregar Item"
2. Información:
   - Nombre
   - Descripción
   - Precio
   - Categoría
   - Foto
   - Alérgenos
3. Guardar

#### Organizar Menú
- Crear categorías (Entradas, Platos Fuertes, Postres)
- Reordenar items
- Marcar items no disponibles temporalmente

### Gestión de Mesas

#### Configurar Mesas
1. "Mesas" → "Configurar"
2. Número de mesa
3. Capacidad
4. Ubicación (Interior/Terraza)

#### Estado de Mesas
- Disponible (verde)
- Ocupada (rojo)
- Reservada (amarillo)
- En limpieza (gris)

### Sistema de Cocina

#### Vista de Cocina
1. Órdenes llegan automáticamente
2. Estados:
   - Pendiente
   - En preparación
   - Lista para servir
   - Entregada

#### Gestionar Tiempos
- Ver tiempo desde que se ordenó
- Alertas de órdenes tardías
- Priorizar órdenes

### Reservaciones

#### Ver Reservaciones
- Calendario de reservas
- Lista del día
- Detalles de cada reserva

#### Gestionar Reservación
- Confirmar/Modificar
- Asignar mesa
- Notas especiales

---

## Para Comercios

### Dashboard Comercio

Accede a "Dashboard" → "Commerce"

### Mi Tienda

#### Configurar Tienda
1. "Mi Tienda" → "Configuración"
2. Información básica:
   - Nombre del negocio
   - Logo
   - Descripción
   - Horarios
   - Ubicación

#### Personalizar
- Colores de marca
- Banner principal
- Secciones destacadas

### Gestión de Productos

#### Agregar Producto
1. "Inventario" → "Nuevo Producto"
2. Información:
   - Nombre
   - SKU/Código
   - Descripción
   - Precio
   - Stock inicial
   - Categoría
   - Imágenes
3. Publicar

#### Gestionar Stock
- Ver niveles de inventario
- Alertas de stock bajo
- Actualizar cantidades
- Historial de movimientos

### Terminal POS

#### Proceso de Venta
1. Buscar productos por nombre o escanear código
2. Agregar al carrito
3. Ajustar cantidades
4. Aplicar descuentos
5. Procesar pago
6. Imprimir ticket

### Clientes

#### Base de Datos de Clientes
- Lista de clientes registrados
- Historial de compras
- Datos de contacto

#### Programa de Fidelidad
- Puntos acumulados
- Niveles de membresía
- Promociones exclusivas

### Reportes

#### Ver Reportes
1. "Reportes" → Seleccionar tipo
2. Opciones:
   - Ventas por día/mes
   - Productos más vendidos
   - Análisis de clientes
   - Inventario
3. Exportar a PDF/Excel

---

## Panel de Administración

### Acceso

Solo para usuarios con rol de Administrador o Super Admin.

### Dashboard Ejecutivo

#### Métricas Principales
- Total de usuarios
- Ingresos totales
- Reservas activas
- Servicios registrados
- Crecimiento mensual

#### Gráficos y Analytics
- Ingresos por mes
- Reservas por tipo
- Usuarios activos
- Destinos populares

### Gestión de Usuarios

#### Ver Usuarios
1. "Admin Panel" → "Usuarios"
2. Lista completa con filtros
3. Buscar por nombre, email, rol

#### Acciones
- Crear nuevo usuario
- Editar perfil
- Cambiar rol
- Suspender/Activar cuenta
- Eliminar usuario

### Roles y Permisos

#### Gestionar Roles
1. "Admin Panel" → "Usuarios" → "Roles & Permisos"
2. Ver roles por entidad:
   - Admin
   - Hotel
   - Restaurant
   - Commerce

#### Crear Rol Personalizado
1. "Crear Rol"
2. Nombre y descripción
3. Seleccionar permisos específicos
4. Asignar a usuarios

### Gestión de Contenido

#### Destinos
- Agregar/Editar destinos
- Información turística
- Puntos de interés
- Guías

#### Lugares
- Restaurantes
- Atracciones
- Shopping
- Servicios

### CRM

#### Gestión de Contactos
- Base de datos de clientes
- Segmentación
- Tags y categorías
- Historial de interacciones

#### Campañas de Marketing
1. "CRM" → "Campañas"
2. Crear nueva campaña
3. Seleccionar segmento
4. Diseñar mensaje
5. Programar envío
6. Ver resultados

### Channel Manager

#### Canales Conectados
- Booking.com
- Airbnb
- Expedia
- Otros OTAs

#### Sincronización
- Ver estado de sincronización
- Sincronizar manualmente
- Resolver conflictos
- Ver reservas por canal

### Sistema de Comisiones

#### Configurar Reglas
1. "Comisiones" → "Reglas"
2. Crear nueva regla
3. Definir:
   - Tipo (porcentaje o fijo)
   - Entidad (hotel, restaurant)
   - Condiciones
4. Activar

#### Ver Pagos
- Historial de comisiones
- Comisiones pendientes
- Procesar pagos
- Exportar reportes

### Configuración Global

#### APIs Externas
- Google Maps API
- Stripe/PayPal
- Servicios de email
- Analytics

#### Integraciones
- Ver integraciones activas
- Configurar webhooks
- Logs de integración

#### Parámetros del Sistema
- Monedas disponibles
- Idiomas soportados
- Configuraciones generales

### Security Center

#### Monitoreo
- Intentos de login fallidos
- Actividad sospechosa
- Accesos no autorizados

#### Auditoría
- Logs de sistema
- Cambios en configuración
- Acciones de usuarios

---

## Preguntas Frecuentes

### General

**¿Karibeo es gratis?**
Karibeo ofrece planes gratuitos y de pago según el tipo de usuario. Los turistas pueden usar la plataforma sin costo. Los negocios tienen planes según sus necesidades.

**¿En qué países está disponible?**
Actualmente, Karibeo opera principalmente en el Caribe y América Latina, con expansión continua.

**¿Cómo contacto soporte?**
- Email: soporte@karibeo.com
- Chat en vivo: Disponible 24/7
- Teléfono: +1-809-555-KARIB

### Pagos

**¿Qué métodos de pago aceptan?**
- Tarjetas de crédito/débito (Visa, Mastercard, AmEx)
- PayPal
- Transferencias bancarias
- Billetera digital Karibeo

**¿Los pagos son seguros?**
Sí, usamos encriptación SSL y cumplimos con estándares PCI DSS para proteger tu información.

**¿Cuándo se procesa el reembolso?**
Según la política del establecimiento, generalmente de 5-10 días hábiles.

### Reservas

**¿Puedo modificar mi reserva?**
Sí, según disponibilidad y política del establecimiento. Ve a "Mis Reservas" y selecciona "Modificar".

**¿Qué pasa si cancelo?**
Las políticas de cancelación varían. Revisa los términos antes de reservar. Algunas reservas ofrecen cancelación gratuita.

**¿Cómo sé si mi reserva fue confirmada?**
Recibirás una confirmación por email y notificación en la app. También puedes verificar en "Mis Reservas".

### Técnico

**¿Hay app móvil?**
Actualmente, Karibeo es una aplicación web responsive que funciona en todos los dispositivos. App móvil nativa próximamente.

**¿Funciona sin internet?**
Algunas funciones básicas están disponibles offline, pero se requiere conexión para reservas y pagos.

**Mi cuenta está bloqueada, ¿qué hago?**
Contacta a soporte@karibeo.com con tu información para desbloquearla.

---

## Recursos Adicionales

- **Video Tutoriales**: [youtube.com/karibeo](https://youtube.com/karibeo)
- **Blog**: [blog.karibeo.com](https://blog.karibeo.com)
- **Centro de Ayuda**: [help.karibeo.com](https://help.karibeo.com)
- **Comunidad**: [community.karibeo.com](https://community.karibeo.com)

---

**¿Necesitas más ayuda?**  
Contacta a nuestro equipo de soporte en cualquier momento.

**Última actualización**: 2025-01-12