# 🏨 Tutorial Interactivo

Sistema de Reservas para Posadas - Guía Completa

## 🎯 Bienvenido al Tutorial

Este tutorial interactivo te guiará a través de todas las características del Sistema de Reservas para Posadas.

### ¿Qué es este sistema?

Es una plataforma web completa para gestionar reservas de habitaciones, control de huéspedes, consumos, tarifas, promociones y mucho más.

✓ Características Principales

- Reservas en línea 24/7
- Gestión de huéspedes
- Control de gastos y consumos
- Gestión de productos y categorías
- Tarifas y promociones
- Reportes y análisis
- Galería de imágenes
- Pedidos especiales

### ¿Cómo usar este tutorial?

1

#### Explora el contenido

Usa el menú lateral para navegar entre diferentes temas

2

#### Lee las instrucciones

Cada sección contiene guías paso a paso

3

#### Practica en el sistema

Aplica lo aprendido en el sistema real

## 💻 Requisitos del Sistema

### Hardware Mínimo

Componente | Requisito Mínimo | Recomendado
--- | --- | ---
Procesador | Intel Core 2 Duo | Intel Core i5 o superior
Memoria RAM | 2 GB | 4 GB o superior
Disco Duro | 500 MB disponibles | 2 GB disponibles
Conexión | Banda ancha | Fibra óptica

### Software Requerido

ℹ️ Servidor Web

Apache 2.4 o superior

ℹ️ PHP

Versión 7.4 o superior

ℹ️ Base de Datos

MySQL 5.7 o superior

### Navegadores Soportados

- ✓ Google Chrome 90+
- ✓ Mozilla Firefox 88+
- ✓ Safari 14+
- ✓ Microsoft Edge 90+

## 🔐 Acceso al Sistema

### URL de Acceso

http://localhost/posadas-php/

O si está en producción:

https://www.suposada.com/

### Página Principal

La página principal muestra:

- Logo de la posada
- Tarifas de hospedaje
- Galería de imágenes
- Enlaces a los módulos

### Dos Módulos Principales

👥 Módulo de Huéspedes ▼

Para clientes que desean hacer reservas. Permite:

- Registrarse
- Hacer reservas
- Ver historial
- Solicitar servicios especiales

🔧 Módulo de Administrador ▼

Para gestionar la posada. Permite:

- Gestionar reservas
- Controlar huéspedes
- Administrar productos
- Generar reportes

## 📝 Registro de Huéspedes

### ¿Cómo registrarse?

1

#### Ingrese su Cédula o Pasaporte

El sistema verificará automáticamente si ya está registrado. Si es nuevo, continúe.

2

#### Complete sus Datos Personales

Nombre completo, teléfono y email

3

#### Confirme su Registro

Recibirá un correo de confirmación

### Campos Requeridos

Campo | Tipo | Descripción
--- | --- | ---
Cédula/Pasaporte | Texto | Número de identificación (único)
Nombre Completo | Texto | Su nombre y apellido
Teléfono | Teléfono | Número de contacto
Email | Email | Correo electrónico

✓ Autocompletado Automático

Si ya está registrado, el sistema completará automáticamente sus datos basándose en su cédula o pasaporte.

## 📅 Hacer una Reserva

### Pasos para Reservar

1

#### Seleccione Tipo de Habitación

Elija entre Simple, Doble, Familiar o Suite Premium

2

#### Seleccione Fechas

Use el calendario para elegir entrada y salida

3

#### Ingrese Cantidad de Personas

Cuántas personas se hospedarán

4

#### Agregue Comentarios

Solicitudes especiales o notas adicionales

5

#### Confirme y Reciba Comprobante

Se generará un PDF con los detalles

### Tarifas Disponibles

Tipo | Capacidad | Precio/Noche
--- | --- | ---
Habitación Simple | 1-2 personas | Gs. 150.000
Habitación Doble | 2-3 personas | Gs. 200.000
Habitación Familiar | 4-5 personas | Gs. 280.000
Suite Premium | 2-4 personas | Gs. 350.000

### Ejemplo de Cálculo

ℹ️ Cálculo Automático

Tipo: Habitación Doble
Entrada: 15/11/2025
Salida: 18/11/2025
Días: 3 noches
Precio/Noche: Gs. 200.000
TOTAL: Gs. 600.000

## 📊 Mi Dashboard (Huésped)

### ¿Qué puedo ver en mi dashboard?

👤 Datos Personales ▼

- Nombre completo
- Cédula/Pasaporte
- Teléfono
- Email

💰 Resumen de Gastos ▼

- Costo de hospedaje
- Consumos adicionales
- Total a pagar

📅 Próximas Reservas ▼

Reservas confirmadas para los próximos 30 días con información de contacto

🛒 Historial de Consumos ▼

Detalle de todos los productos consumidos, fechas y precios

## 🎁 Pedidos Especiales

### ¿Qué son los pedidos especiales?

Son solicitudes de servicios adicionales que puede hacer durante su hospedaje, como:

- 🍽️ Comidas especiales
- 🎂 Pasteles o postres personalizados
- 🚗 Transporte
- 🧹 Servicios de limpieza extra
- 🎉 Eventos o celebraciones

### Cómo hacer un pedido especial

1

#### Ingrese a Pedidos Especiales

Desde su dashboard

2

#### Describa su Solicitud

Sea lo más detallado posible

3

#### El Administrador Revisará

Recibirá respuesta por correo o teléfono

4

#### Se Agregará a su Factura

Una vez aprobado

### Ejemplo de Pedido

"Necesito un pastel de cumpleaños para 20 personas el próximo sábado. Preferencia: Chocolate con fresas"

## 🔐 Acceso al Panel de Administración

### URL de Acceso

http://localhost/posadas-php/admin/login.php

### Credenciales Iniciales

Campo | Valor
--- | ---
Usuario | Posada
Contraseña | Pgy.2025

⚠️ IMPORTANTE

Cambie la contraseña inmediatamente después del primer acceso por razones de seguridad.

### Cambiar Contraseña

1

#### Acceda al Panel

Ingrese con las credenciales iniciales

2

#### Haga clic en "Mi Perfil"

En la esquina superior derecha

3

#### Seleccione "Cambiar Contraseña"

En el menú de perfil

4

#### Ingrese la Nueva Contraseña

Dos veces para confirmar

## 📊 Dashboard Administrativo

### Información Disponible

📈 Estadísticas Generales ▼

- Total de huéspedes registrados
- Reservas activas
- Ingresos del mes
- Ocupación de habitaciones

📅 Próximas Reservas ▼

Tabla con reservas de los próximos 7 días, estado y acciones rápidas

💰 Resumen Financiero ▼

- Ingresos por hospedaje
- Ingresos por consumos
- Total del mes
- Gráficos de tendencias

## 📅 Gestión de Reservas

### Funcionalidades Disponibles

#### 1. Ver Todas las Reservas

Tabla completa con opciones de filtrado y búsqueda

- Filtrar por estado
- Filtrar por fecha
- Búsqueda por nombre

#### 2. Aprobar Reservas

1

#### Seleccione la reserva

Con estado "Pendiente"

2

#### Haga clic en "Aprobar"

Se enviará correo de confirmación

#### 3. Modificar Reservas

Puede cambiar:

- Fechas de entrada/salida
- Tipo de habitación
- Cantidad de personas
- Comentarios

#### 4. Cancelar Reservas

Ingrese el motivo de cancelación

#### 5. Eliminar Reservas

Eliminación permanente (solo si es necesario)

## 👥 Gestión de Huéspedes

### Funcionalidades Disponibles

#### 1. Ver Todos los Huéspedes

Lista completa con información de contacto y estado

#### 2. Habilitar/Deshabilitar

✓ Habilitar Huésped ▼

- Permite hacer nuevas reservas
- Acceso a su dashboard
- Puede hacer pedidos especiales

✗ Deshabilitar Huésped ▼

- No puede hacer nuevas reservas
- Mantiene acceso a reservas anteriores
- Útil para clientes problemáticos

#### 3. Ver Detalles del Huésped

- Datos personales
- Historial de reservas
- Total gastado
- Consumos realizados

#### 4. Editar Datos

Puede modificar:

- Nombre completo
- Teléfono
- Email
- Dirección

## 🛍️ Gestión de Productos

### ¿Qué son los productos?

Son items que los huéspedes pueden consumir durante su hospedaje, como bebidas, comidas, postres y servicios.

### Funcionalidades

#### 1. Agregar Nuevo Producto

1

#### Haga clic en "Nuevo Producto"

2

#### Complete los campos

Categoría, nombre, descripción, precio

3

#### Haga clic en "Guardar"

### Campos Requeridos

Campo | Tipo | Descripción
--- | --- | ---
Categoría | Selección | Bebidas, Desayunos, Almuerzos, etc.
Nombre | Texto | Nombre del producto
Descripción | Texto largo | Detalles del producto
Precio | Número | Precio en Guaraní

#### 2. Editar Productos

Seleccione el producto y modifique los campos necesarios

#### 3. Eliminar Productos

Confirme la eliminación (no se pueden eliminar productos ya consumidos)

#### 4. Cambiar Disponibilidad

Los productos no disponibles no aparecen en las órdenes

## 💰 Gestión de Tarifas

### ¿Qué son las tarifas?

Son los diferentes tipos de habitaciones con sus precios por noche.

### Tarifas Predefinidas

Nombre | Capacidad | Precio/Noche
--- | --- | ---
Habitación Simple | 1-2 personas | Gs. 150.000
Habitación Doble | 2-3 personas | Gs. 200.000
Habitación Familiar | 4-5 personas | Gs. 280.000
Suite Premium | 2-4 personas | Gs. 350.000

### Funcionalidades

#### 1. Agregar Nueva Tarifa

Haga clic en "Nueva Tarifa" e ingrese:

- Nombre de la habitación
- Descripción
- Precio por noche
- Marque si está activa

#### 2. Editar Tarifas

Modifique los precios o descripción según sea necesario

#### 3. Cambiar Disponibilidad

Las tarifas inactivas no aparecen en nuevas reservas

#### 4. Eliminar Tarifas

No se pueden eliminar tarifas con reservas activas

## 📊 Reportes y Análisis

### Tipos de Reportes Disponibles

#### 1. Reporte Mensual

Información financiera del mes:

- Total de reservas
- Total de ingresos
- Promedio de ocupación
- Productos más vendidos
- Huéspedes frecuentes

#### 2. Reporte de Gastos por Huésped

Detalles de consumos de un huésped específico

#### 3. Reporte de Ocupación

Análisis de ocupación por mes y tipo de habitación

#### 4. Reporte de Productos

Productos más vendidos e ingresos por categoría

### Cómo Generar un Reporte

1

#### Acceda a "Reportes"

2

#### Seleccione el tipo de reporte

3

#### Ingrese los parámetros

Mes, año, rango de fechas, etc.

4

#### Haga clic en "Generar"

5

#### Descargue en PDF o Excel

## ❓ Preguntas Frecuentes

¿Cómo cambio mi contraseña de administrador? ▼

1. Acceda al panel de administración
2. Haga clic en "Mi Perfil"
3. Seleccione "Cambiar Contraseña"
4. Ingrese la contraseña actual
5. Ingrese la nueva contraseña dos veces
6. Haga clic en "Guardar"

¿Qué pasa si un huésped no se presenta? ▼

1. El administrador puede cambiar el estado a "No presentado"
2. Se puede reembolsar el depósito (si aplica)
3. La habitación se marca como disponible
4. Se registra en el historial del huésped

¿Cómo genero un reporte de ingresos? ▼

1. Acceda a "Reportes"
2. Seleccione "Reporte Mensual"
3. Elija el mes y año
4. Haga clic en "Generar"
5. Seleccione formato (PDF o Excel)
6. El archivo se descargará automáticamente

¿Puedo modificar una reserva ya confirmada? ▼

Sí, puede cambiar:

- Las fechas
- El tipo de habitación
- La cantidad de personas
- Los comentarios

El costo se recalculará automáticamente.

¿Cómo agrego un nuevo tipo de habitación? ▼

1. Acceda a "Tarifas"
2. Haga clic en "Nueva Tarifa"
3. Complete los campos
4. Haga clic en "Guardar"

## 📞 Soporte Técnico

### Información de Contacto

Medio | Contacto
--- | ---
📧 Email | soporte@posada.com
📞 Teléfono | +595 981 234 567
💬 WhatsApp | +595 981 234 567
⏰ Horario | Lunes a Viernes, 8:00 - 18:00

### Problemas Comunes y Soluciones

#### El sistema no carga

1

#### Limpie el caché del navegador

Ctrl+Shift+Del

2

#### Cierre y abra nuevamente el navegador

3

#### Intente con otro navegador

4

#### Verifique su conexión a Internet

#### Olvidé mi contraseña

1

#### Haga clic en "¿Olvidó su contraseña?"

En la página de login

2

#### Ingrese su correo electrónico

3

#### Recibirá un enlace de recuperación

4

#### Haga clic en el enlace

Y establezca una nueva contraseña

#### No puedo subir imágenes

- Verifique el tamaño del archivo (máximo 5 MB)
- Verifique el formato (JPG, PNG, GIF)
- Limpie el caché del navegador
- Intente con otro navegador

#### Los reportes no se generan

- Verifique que haya datos en el rango de fechas
- Intente con un rango de fechas diferente
- Verifique los permisos de la carpeta de descargas
- Contacte al soporte técnico

### Notas Importantes

✓ Recomendaciones

- Realice copias de seguridad regularmente
- Cambie su contraseña cada 90 días
- Mantenga actualizado el navegador web
- No comparta sus credenciales de acceso
- Cierre sesión al terminar de usar el sistema