Files
karibeo_backend_admin/docs/USER-GUIDE.md
2025-10-12 01:00:32 +00:00

12 KiB

📖 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
  2. Para Turistas
  3. Para Hoteles
  4. Para Restaurantes
  5. Para Comercios
  6. Panel de Administración
  7. Preguntas Frecuentes

Primeros Pasos

Registro de Cuenta

  1. Acceder a la Plataforma

    • Visita 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?

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


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

Última actualización: 2025-01-12