* ------------------------------------------------------*
* Sistema de Tarificación para Hoteles con Asterisk PBX *
* ------------------------------------------------------*

(c) 2007 Servitux Servicios Informáticos S.L. <info@servitux.es>
http://www.servitux.es

Este sistema se distribuye bajo licencia GPL (ver fichero COPYING)

Este sistema web sirve para poder cobrar a los clientes de un hotel las llamadas que hagan
desde las habitaciones. Este programa no sirve para facturación pre-pago.

ServiTux ha creado este programa desde cero debido a la falta de un programa 
extremadamente sencillo, tanto de usar como de configurar.

***** ATENCION *****
ESTE PROGRAMA ESTA EN FASE BETA. ES MAS QUE POSIBLE QUE TENGA FALLOS, POR LO QUE ES
RESPONSABILIDAD DEL INSTALADOR DECIDIR SI DEBE SER PUESTO EN PRODUCCION.
********************

1.- Requisitos:

- Un sistema Asterisk, corriendo sobre Linux, y con el CDR en base de
  datos MySQL.

- Apache
- PHP (solo ha sido probado con la versión 4)
- PEAR (En debian, php4-pear)
- Los siguientes módulos de pear:
    * DB (version 1.6.2)
    * HTML_Form (version 1.3.0)
    * HTML_Table (1.5)
    * Pager (2.4.2)

    - Para instalar los módulos pear, se debe ejecutar como root:

    pear install -o DB-1.6.2
    pear install -o HTML_Form-1.3.0
    pear install -o HTML_Table-1.5
    pear install -o Pager-2.4.2

2.- Instalar y configurar

Descomprima el tgz en un subdirectorio accesible desde web, y modifique el fichero config.php:

$dbhost="127.0.0.1"; // host donde está la base de datos
$dbname="asteriskcdrdb"; // nombre de la base de datos
$dbuser="asteriskcdr"; // usuario
$dbpass="xxxxxxxxxxx"; // contraseña

El directorio invoices debe tener permisos de escritura para el usuario que ejecute el servidor web.

3.- Base de datos

Conectese por línea de comandos o mediante PHPmyAdmin a la base de datos del CDR de asterisk, y cree 
las tablas que encontrará en el fichero "tables.sql". RECUERDE: NO debe crear ninguna base de datos
nueva, debe usar la que ya existe.

Ahora puede importar el contenido de la tabla "destinations", que se encuentra en el fichero "destinations.sql.gz"
, en esa tabla están reflejados los prefijos numéricos a distintos paises, con su precio de tarificación, etc... 
Una vez importada, puede modificarla a su gusto. Los campos son los siguientes:

- id -> numero unico para identificar esta linea
- prefix -> Prefijo del numero destino (teniendo en cuenta que se llama desde España)
- name -> nombre del destino
- sellprice -> precio que se le debe cobrar al cliente de una habitación EN EUROS
- block -> bloque de tarificacion, en segundos // AHORA MISMO NO SE USA
- connection -> precio del establecimiento de llamada // AHORA MISMO NO SE USA
- firstblock -> duracion del primer bloque // AHORA MISMO NO SE USA
- billfirstblock -> si se debe cobrar el primer bloque // AHORA MISMO NO SE USA
- minduration -> duracion minima de una llamada para ser cobrada

4.- Configuración de Asterisk

Asterisk debe estar configurado para que las extensiones deban marcar el "0" (cero) para efectuar una llamada
externa. Todas las llamadas que empiecen por "0" serán tarificadas a los clientes del hotel. 

Si usas "FreePBX" como interfaz gráfico, debes crear un "OutBound Route" que sea así "0|."

5.- Usando el programa

Una vez instalado y configurado, acceda a la interfaz web del entorno:

http://ip_servidor_asterisk/hotel/gestion.php

(suponiendo que instaló la aplicación en el directorio "hotel")

En la opción "Gestión de Habitaciones", introduzca el número de las habitaciones que desea que sean tarificadas.

Ahora visite la página:

http://ip_servidor_asterisk/hotel/index.php

y verá como aparecen en color verde las habitaciones que no tienen llamadas, y en color rojo las habitaciones
que tienen llamadas para facturar. Esta página se refresca cada 10 minutos, por lo que el usuario (la persona
de recepción del hotel), puede tenerla abierta y verá como cambian a rojo las habitaciones. Los colores
se pueden cambiar (ver directorio "img")

Pulsando en una habitación que esté en rojo, se accede a la página de facturación:

- Botón "FACTURAR": generar una factura y dejar la habitación lista para el siguiente cliente
- Botón "NUEVO": NO generar factura, y dejar la habitación lista para el siguiente cliente

Las facturas se generan en formato PDF, y se guardan en el directorio "invoices"

En la parte de abajo tiene un historico de facturas.

6.- Lo que queda por hacer

- Ahora mismo la aplicación no funciona con extensiones tipo Zap
- Implementar los campos de facturacion de la base de datos "destinations"
- Una apariencia mejor
- Lo que se te ocurra (pero ojo, no se trata de complicar la aplicación)

7.- Contacto, sugerencias, bugs, mejoras, etc...

Servitux no ofrece soporte técnico de esta aplicación, por lo que cualquier error que no se deba a la propia
plataforma (por ejemplo, durante la instalación) no será atendida. Si descubre un fallo en el programa, o
ha añadido alguna mejora, puede informar a:

pbxhotel@servitux.es

Gracias.

Servitux Servicios Informáticos S.L.
info@servitux.es
http://www.servitux.es
Tel: 966 160 600