* ------------------------------------------------------*
* Sistema de Tarificacin para Hoteles con Asterisk PBX *
* ------------------------------------------------------*

(c) 2007 Servitux Servicios Informticos 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 facturacin 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 versin 4)
- PEAR (En debian, php4-pear)
- Los siguientes mdulos de pear:
    * DB (version 1.6.2)
    * HTML_Form (version 1.3.0)
    * HTML_Table (1.5)
    * Pager (2.4.2)

    - Para instalar los mdulos 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"; // contrasea

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

3.- Base de datos

Conectese por lnea 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 estn reflejados los prefijos numricos a distintos paises, con su precio de tarificacin, 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 Espaa)
- name -> nombre del destino
- sellprice -> precio que se le debe cobrar al cliente de una habitacin 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.- Configuracin 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" sern tarificadas a los clientes del hotel. 

Si usas "FreePBX" como interfaz grfico, 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 aplicacin en el directorio "hotel")

En la opcin "Gestin de Habitaciones", introduzca el nmero de las habitaciones que desea que sean tarificadas.

Ahora visite la pgina:

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 pgina se refresca cada 10 minutos, por lo que el usuario (la persona
de recepcin del hotel), puede tenerla abierta y ver como cambian a rojo las habitaciones. Los colores
se pueden cambiar (ver directorio "img")

Pulsando en una habitacin que est en rojo, se accede a la pgina de facturacin:

- Botn "FACTURAR": generar una factura y dejar la habitacin lista para el siguiente cliente
- Botn "NUEVO": NO generar factura, y dejar la habitacin 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 aplicacin 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 aplicacin)

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

Servitux no ofrece soporte tcnico de esta aplicacin, por lo que cualquier error que no se deba a la propia
plataforma (por ejemplo, durante la instalacin) no ser atendida. Si descubre un fallo en el programa, o
ha aadido alguna mejora, puede informar a:

pbxhotel@servitux.es

Gracias.

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

