Documentación

Inicio Rápido

Comienza a usar HotelMax en minutos siguiendo estos pasos:

Instalación

Requisitos del Sistema

• PHP 7.4 o superior
• MySQL 5.7 o superior
• Apache o Nginx
• Módulo mod_rewrite habilitado
• Extensión PDO MySQL
• Extensión GD para imágenes
• SSL Certificate (recomendado)

Pasos de Instalación

1. Descarga el paquete de HotelMax desde tu panel de cliente
2. Descomprime los archivos en tu servidor web
3. Crea una base de datos MySQL
4. Importa el archivo database.sql
5. Configura el archivo config.php con tus credenciales
6. Asigna permisos 755 a las carpetas de uploads
7. Accede a http://tudominio.com/install

Configuración

Configuración de Base de Datos

Edita el archivo config/database.php:

<?php
// Configuración de ADOdb
$db_host = 'localhost';
$db_name = 'hotelmax_db';
$db_user = 'tu_usuario';
$db_pass = 'tu_contraseña';
$db_type = 'mysqli';

// Inicializar conexión ADOdb
require_once('adodb/adodb.inc.php');
$db = ADONewConnection($db_type);
$db->Connect($db_host, $db_user, $db_pass, $db_name);
?>

Configuración de Dominios

Para configurar dominios personalizados por hotel, edita config/domains.php:

<?php
$domain_config = [
    'hotel1.tudominio.com' => [
        'hotel_id' => 1,
        'theme' => 'default',
        'logo' => 'uploads/hotel1/logo.png'
    ],
    'hotel2.tudominio.com' => [
        'hotel_id' => 2,
        'theme' => 'luxury',
        'logo' => 'uploads/hotel2/logo.png'
    ]
];
?>

Gestión de Hoteles

Crear un Nuevo Hotel

1. Accede al panel de administración
2. Ve a Hoteles > Nuevo Hotel
3. Completa la información básica (nombre, dirección, contacto)
4. Asigna un dominio o subdominio
5. Configura las políticas del hotel
6. Sube el logo y galería de imágenes

Sistema de Reservas

Tipos de Reserva

Crear una Reserva Manual

// Ejemplo de código PHP para crear reserva
$reserva = [
    'hotel_id' => 1,
    'habitacion_id' => 5,
    'cliente_id' => 123,
    'tipo_reserva' => 'horas', // 'horas' o 'dias'
    'fecha_entrada' => '2024-03-15 14:00:00',
    'fecha_salida' => '2024-03-15 18:00:00',
    'total' => 50.00,
    'estado' => 'confirmada'
];

$result = $db->Execute(
    "INSERT INTO reservas (hotel_id, habitacion_id, cliente_id,
     tipo_reserva, fecha_entrada, fecha_salida, total, estado)
     VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
    array_values($reserva)
);

Gestión de Habitaciones

Categorías de Habitaciones

• Simple: Una cama individual
• Doble: Dos camas o cama matrimonial
• Suite: Habitación amplia con sala
• Familiar: Para grupos familiares
• Ejecutiva: Con servicios premium

Precios Dinámicos

Configura precios diferentes según:

Gestión de Clientes

Base de Datos de Clientes

El sistema CRM incluye:

• Información de contacto completa
• Historial de reservas
• Preferencias de habitación
• Notas especiales
• Programa de fidelización
• Comunicación automatizada

Reportes y Análisis

Reportes Disponibles

Uso de DataTables

// Inicializar DataTable para reportes
$('#reporteTable').DataTable({
    language: {
        url: '//cdn.datatables.net/plug-ins/1.13.6/i18n/es-ES.json'
    },
    ajax: 'api/reportes.php?tipo=ocupacion',
    columns: [
        { data: 'fecha' },
        { data: 'habitaciones_ocupadas' },
        { data: 'habitaciones_disponibles' },
        { data: 'porcentaje_ocupacion' }
    ],
    buttons: ['copy', 'excel', 'pdf']
});

API Reference

Autenticación

POST /api/auth/login
Content-Type: application/json

{
    "email": "usuario@ejemplo.com",
    "password": "tu_contraseña"
}

Response:
{
    "success": true,
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user": {
        "id": 1,
        "name": "Usuario"
    }
}

Endpoints Principales

Preguntas Frecuentes