Refactor: Analyze project documentation
This commit is contained in:
gpt-engineer-app[bot]
588
docs/USER-GUIDE.md
Normal file
588
docs/USER-GUIDE.md
Normal file
@@ -0,0 +1,588 @@
|
||||
# 📖 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
|
||||
Reference in New Issue
Block a user