MANUAL DE USUARIO DE FACTURALUX - *** OBSOLETO ***
  
  **************************
  VISITE WWW.FACTURALUX.ORG PARA OBTENER LA ULTIMA DOCUMENTACION
  DEL PROYECTO 
  **************************
Para instalar el software bsicamente hay que hacer :

configure

make

make install  (como root)

Crear la base de datos:

su postgres
createdb -E UNICODE facturalux

Y crear usuario para la base de datos

createuser nobody (o el usuario que se quiera)
passwd nobody

  ****** 
	OBSOLETO, SOLO SIRVE PARA LA VERSION 0.2 DE FACTURALUX O INFERIORES Y
        PARCIALMENTE PARA SUPERIORES
  ****** 
  Federico Albujer Zornoza,  -mail@infosial.com-
  Daniel Rodrguez Calafat, -danirc@users.sourceforge.net-
  Version 0.1, 25 de Febrero de 2002

  Este manual es una gua para el usuario de FacturaLUX Version 0.1
  ______________________________________________________________________

  ndice general


  1. Introduccin

  2. Participar en el proyecto

     2.1 Informar de fallos o bugs
     2.2 Proponer nuevas caractersticas
     2.3 Subscripcin en las listas de correo
     2.4 Formar parte del equipo de desarrollo

  3. Instalacin

     3.1 Como obtener FacturaLUX
     3.2 Prerrequisitos
        3.2.1 - Sistema de gestin de bases de datos PostgreSQL
        3.2.2 - Librera Qt 3.0
     3.3 Compilacin e instalacin
        3.3.1 - Compilacin e instalacin a partir de un paquete .TGZ
        3.3.2 - Instalacin a partir de un paquete .RPM
     3.4 Postinstalacin
        3.4.1 - Crear la base de datos facturalux
        3.4.2 - Crear un usuario para la base de datos facturalux

  4. Uso

  5. FAQ's, Preguntas y Repuestas Frecuentes

  6. Copyright



  ______________________________________________________________________

  1.  Introduccin

  FacturaLUX es un proyecto con licencia GPL que nace con la intencin
  de crear una serie de aplicaciones,bajo licencia GPL, capaces de
  gestionar la problemtica de la pequea y mediana empresa. Nos
  centraremos en el sistema GNU/Linux, el cual apenas dispone de este
  tipo de aplicaciones, pero persiguiendo en todo momento la
  portabilidad del sistema a cualquier otra plataforma.

  FacturaLUX se encarga de la parte de gestin empresarial (almacn,
  clientes, proveedores, facturacin, cartera de cobros y pagos, etc..),
  es decir, un programa indispensable para el funcionamiento de
  cualquier empresa.

  La construccin de la aplicacin se basar en herramientas de
  desarrollo rpido, utilizando el lenguaje C++ con el toolkit QT , y
  las herramientas, entre otras, QTDesigner, QTLinguist y KDevelop. Es
  intencin sentar las bases de una plataforma seria, eficaz y de fcil
  manejo para el desarrollo, de tal manera que dicha plataforma brinde
  la oportunidad de trabajar en el proyecto a desarrolladores poco
  expertos y en general facilite el trabajo de todos. Al mismo tiempo
  utilizando dicha plataforma y la misma filosofa se podrn construir
  otras aplicaciones que complemeten a FacturaLUX (ContaLUX, NominaLUX,
  etc..). Adems se asegurar la internacionalizacin de las
  aplicaciones al utilizar QTLinguist.

  El sistema de acceso a los datos va a ser a travs de la librera Qt
  3.0, la cual implementa drivers para PostgreSQL, Oracle, MySQL y ODBC,
  dando la posibilidad de implementar nuestros propios drivers.
  Actualmente FacturaLUX slo soporta la base de datos PostgreSQL 7.1 y
  superiores, este sistema de base de datos ofrece rapidez y
  estabilidad, adems de  permitir transacciones.

  Toda la infraestructura del proyecto, listas de correo, lista de bugs,
  CVS, etc..,  reside en Sourceforge.net, y la pgina principal se puede
  encontrar en facturalux.sourceforge.net.

  Este proyecto ha sido impulsado por SiAL Informtica, empresa
  consultora experta en sistemas UNIX y expecialmente en GNU/Linux, en
  un afn de solventar las carencias que este tipo de sistemas tienen en
  cuanto a software de gestin y finanzas.


  2.  Participar en el proyecto

  FacturaLUX es un proyecto con licencia GPL, en el que se puede
  participar de muchas maneras. El trabajo es mucho y cualquier ayuda es
  importante para el proyecto. No es necesario programar para
  participar, tambin se puede ayudar con tareas de testeo,
  documentacin, traducciones o simplemente aportando ideas de nuevas
  caractersticas. Si le interesa que FacturaLUX llegue a buen puerto,
  entonces debera plantearse la opcin de participar y ayudar con su
  inestimable aportacin.

  El equipo actual de FacturaLUX realiza con gran entusiasmo su trabajo
  siguiendo en todo momento el espritu GNU y la licencia GPL, con el
  afn de que todos nos podamos beneficiar de las ventajas del software
  libre. Si todava no ha experimentado la satisfaccin de participar en
  un proyecto de software libre, puede ser que esta sea su oportunidad.

  En las secciones que siguen se muestran todos los mecanismo y formas
  disponibles para que su participacin le resulte cmoda y sencilla.

  2.1.  Informar de fallos o bugs

  Una de las tareas ms importantes y no muy complicada es el testeo de
  la apliacin. Si durante sus pruebas detecta algn fallo o
  funcionamiento incorrecto del programa, puede informar del fallo en la
  pgina del proyecto entrando en la seccin Lista de Bugs y haciendo
  clic en -Submit New-. En esta seccin  podr ver los fallos
  introducidos hasta el momento, esto le permite comprobar si el fallo
  que va a introducir ya existe o simplemente echar un vistazo de como
  evoluciona la correccin de fallos.

  2.2.  Proponer nuevas caractersticas

  Tal vez usted tenga ideas para aadir nuevas caractersticas a
  FacturaLUX, en tal caso puede proponer sus ideas al resto del equipo
  de desarrollo en la pgina del proyecto en la seccin Peticin de
  caractersticas  y haciendo clic en -Submit New-. Es esta seccin
  tambin podr visualizar otras propuestas y peticiones de otros
  usuarios y desarroladores.

  2.3.  Subscripcin en las listas de correo   

  Puede apuntarse a alguna de las listas de correo, para participar o
  seguir mas activamente el desarrollo del proyecto, en la pgina del
  proyecto en la seccin Listas de Correo podr registrase o ver los
  mensajes en el archivo via web.

  2.4.  Formar parte del equipo de desarrollo

  Si desea formar parte del equipo de desarrollo del proyecto, deber
  primero estar registrado, si no lo est ya, como usuario en
  http://sourceforge.net, en este sitio reside toda la infraestructura
  del proyecto. El registro en sourceforge.net es gratuito y bsicamente
  basta con dar un nombre de usuario, una contrasea y una direccin de
  correo electrnico.

  Una vez sea usuario de sourceforge.net deber enviar un correo
  electrnico al administrador del proyecto; Federico Albujer Zornoza,
  este correo deber contener el nombre de su usuario en
  sourceforge.net, y una pequea presentacin de lo que usted puede
  hacer o desea realizar en el proyecto. En el menor plazo de tiempo
  posible recibir contestacin, con instrucciones y tareas disponibles
  para ser realizadas.

  La lista de tareas es pblica por lo que en cualquier momento podr
  consultarla en la pgina del proyecto en la seccin Lista de Tareas,
  aunque slo se podr asignar una tarea a usted si es miembro del
  equipo de desarrollo.

  3.  Instalacin

  En esta seccin se describe todo lo necesario para instalar y hacer
  funcionar FacturaLUX, se muestran todos los pasos desde la descarga
  hasta la compilacin, en el caso que hallamos descargado los fuentes.
  Es necesario cumplir con los prerrequisitos para no tener ningn
  problema en el proceso de compilacin. Para poder cumplir los
  prerrequisitos tambin se incluyen explicaciones de como hacer
  funcionar las libreras y aplicaciones de terceras partes que son
  utilizadas por FacturaLUX.


  3.1.  Cmo obtener FacturaLUX

  En la seccin de descarga de la pgina del proyecto, se pueden
  encontrar todas las instrucciones para la descarga de los paquetes
  disponibles.

  Se puede descargar el cdigo fuente en un paquete .TGZ ( facturalux-
  X.X.tar.gz ) o un paquete .RPM disponible para algunas distribuciones
  ( facturalux-X.X.distribucion.rpm ).


  3.2.  Prerrequisitos

  El sistema fundamental para el funcionamiento de la aplicacin es:

  - Sistema operativo GNU/Linux ( kernel 2.2.x o superior )

  - Compilador de C++ (GNU g++)

  Adems FacturaLUX necesita de ciertas libreras y aplicaciones de
  terceras partes para funcionar, en las secciones siguientes se
  detallan estos componentes necesarios, as como unos pasos bsicos
  para que funcionen el la mayora de los casos:

  3.2.1.  - Sistema de gestin de bases de datos PostgreSQL

  Sistema gestor de base de datos de avanzadas caractersticas.
  FacturaLUX ha sido diseado sobre una versin 7.1.x de este gestor de
  bases de datos.  FacturaLUX no funcionar con versiones anteriores
  debido a que usamos caractersticas que no haban sido aadidas hasta
  esta ltima versin. La compatibilidad con versiones superiores se
  considera garantizada, aunque siempre recae en las decisiones de la
  propia compaa desarrolladora de PostgreSQL.

  Puede encontrar PostgreSQL en el CDROM de su propia distribucin, en
  internet en formato RPM en sitios como:

  http://www.rpmfind.net

  en debian debera bastarle con el comando:

  -apt-get postgres-

  y en formato .TGZ encontrar este sistema en:

  http://www.postgresql.org

  Lo mejor para instalar PostgreSQL es obtenerla empaquetada y dejar a
  los scripts de instalacin hacer su trabajo. En caso de no encontrarlo
  empaquetado para nuestro sistema, lo mejor es acudir al propio manual
  de instalacin de PostgreSQL que cubrir todos los aspectos oscuros de
  la instalacin.

  Sin embargo es muy habitual que existan ciertos problemas posteriores
  a la instalacin. Variables mal establecidas o instalaciones que
  quedan bloqueadas por un cierre forzoso del sistema. La mayora de
  estos problemas se solucionan en los articulos de http://bulmalug.net
  dedicados a la instalacin del weblog de Bulma en una mquina local.
  El seccin ``Postinstalacin'' hay algunas indicaciones sobre
  incidencias tpicas que suceden al crear una base de datos o iniciar
  el servidor de PostgreSQL, que pueden serle de utilidad para
  solucionar algunos problemas.


  3.2.2.  - Librera Qt 3.0

  Las libreras grficas Qt3.0.x son utilizadas por KDE 3.0. Si su
  sistema ya posee un KDE 3.0 posiblemente tenga usted ya instaladas
  estas libreras, aunque deber asegurarse que las libreras estn
  instaladas con el driver para PostgreSQL. En otro caso deber
  descargarlas de la pagina web de la compaa que las ha creado y
  cedido amablemente a la comunidad:

  http://www.trolltech.com

  - Nota: En el momento de escribir este documento la version era
  Qt-3.0.2 y FacturaLUX funcionaba perfectamente con ellas.-

  Las librerias Qt vienen acompaadas por varias utilidades. Desde un
  diseador de formularios hasta una utilidad de gestin de idioma en un
  proyecto. Todo ello junto a una excelente documentacin y multitud de
  ejemplos. Es frecuente que las Qt no compilen bien o se bloquee la
  compilacin en mquinas con menos de 64Mg de RAM en el sistema.

  Para compilar las Qt con soporte para PostgresQL -cosa imprescindible
  para que funcione FacturaLUX- hay que seguir el siguiente proceso:



       Supongamos que hemos bajado Qt3.0 y lo hemos descomprimido en
       /usr/lib/qt3, es importante compilar con el driver pgsql, supongamos
       tambin que tenemos los archivos de cabeceras de PostgreSQL en
       /usr/include/pgsql - PostgreSQL debe estar instalado antes de compilar Qt -
       estas seran las rdenes como usuario root para compilar las libreras y
       utilidades de Qt 3.0:



  ______________________________________________________________________

          [/usr/lib/qt3] # export QTDIR=/usr/lib/qt3

          [/usr/lib/qt3] # ./configure -prefix /usr/lib/qt3 -I/usr/include/pgsql -qt-sql-psql

          [/usr/lib/qt3] # make
  ______________________________________________________________________





       Estos pasos son triviales, si alguno de ellos no funciona es que no estn
       instaladas las libreras de desarrollo del kernel o gmake. Pasadas unas horas
       estarn las libreras Qt compiladas en el sistema junto a todas sus
       utilidades. En este momento es conveniente poner una serie de variables de
       entorno nuevas en un fichero de inicio, el cual depender de la distribucin,
       generalmente se pueden utilizar.bashrc, .bash_profile o /etc/profile





  ______________________________________________________________________

          Editar el /etc/profile y escribir alli.

          export QTDIR=/usr/lib/qt3

          export PATH=$PATH:/usr/lib/qt3/bin

          export LD_LIBRARY_PATH=/usr/lib/qt3/lib
  ______________________________________________________________________



  3.3.  Compilacin e instalacin

  En esta seccin se describe como compilar e instalar FacturaLUX
  utilizando un paquete .TGZ con el cdigo fuente, o como instalar el
  paquete .RPM con los binarios compilados de FacturaLUX para algunas
  distribuciones de GNU/Linux.

  3.3.1.  - Compilacin e instalacin a partir de un paquete .TGZ

  El nombre de los paquetes .TGZ son de la forma -facturalux-
  X.X.tar.gz-, donde -X-X- es la versin.  Una vez descargado el paquete
  .TGZ, ver seccin ``Como obtener FacturaLUX'', hay que descomprimirlo,
  con el comando :


  ______________________________________________________________________

          tar xzvf facturalux-X.X.tar.gz
  ______________________________________________________________________



  Al finalizar la descompresin se habr creado un directorio dentro del
  actual llamado -facturalux-.  Para compilar e instalar FacturaLUX
  primero hay que asegurar que la variable de entorno -$QTDIR- contiene
  el directorio donde est instalada la librera Qt -p.e. /usr/lib/qt3-,
  para comprobar esto bastar con ejecutar el comando -echo $QTDIR- para
  mostar el contenido de dicha variable, una vez realizada esta
  comprobacin hay que entrar en el directorio -facturalux- recin
  creado y teclear lo siguiente :


  ______________________________________________________________________

          ./configure  --with-qt-dir=$QTDIR

          make

          y como usuario root..

          make install
  ______________________________________________________________________



  Por defecto FacturaLUX se instalar en el directorio
  -/usr/local/facturalux-, para iniciar la aplicacin hay que ejecutar
  -/usr/local/facturalux/bin/facturalux-. El script -configure- acepta
  varios parmetros que usted podr establecer para ajustar la
  instalacin o para corregir problemas, si desea visualizar una lista
  completa con todos los parmetros aceptados, ejecute :


  ______________________________________________________________________

          ./configure --help
  ______________________________________________________________________




  Como FacturaLUX usa la herramienta 'autoconf',  no debera tener
  problemas al compilarlo, siempre y cuando se cumplan las condiciones
  de la seccin ``Prerrequisitos''.  Sin embargo si encuentra algun
  fallo por favor informe de ste en la pgina del proyecto entrando en
  la seccin Lista de Bugs y haciendo clic en -Submit New-.


  3.3.2.  - Instalacin a partir de un paquete .RPM

  El nombre de los paquetes .RPM son de la forma -facturalux-X.X-
  distribucion.rpm-, donde -X-X- es la versin y -distribucion-, es el
  nombre de la distribucin de Linux  para la que se ha preparado el
  paquete.  Una vez descargado el paquete .RPM, ver seccin ``Como
  obtener FacturaLUX'', hay que instalarlo como usuario root con el
  comando :


  ______________________________________________________________________

          rpm -i facturalux-X.X-distribucion.rpm
  ______________________________________________________________________



  Si no se ha instalado la librera Qt 3.0 mediante paquetes .RPM, el
  comando dar un fallo de dependencias y no instalar FacturaLUX. Si
  est seguro que tiene la librera Qt 3.0 ( con el driver de PostgreSQL
  ) porque la ha instalado mediante la compilacin del cdigo fuente a
  partir de un paquete .TGZ, como indica en la seccin ``Librera Qt
  3.0'', deber utilizar este otro comando, para no comprobar la
  dependencia con Qt 3.0 :



  ______________________________________________________________________

          rpm -i --nodeps facturalux-X.X-distribucion.rpm
  ______________________________________________________________________



  Por defecto FacturaLUX se instalar en el directorio
  -/usr/local/facturalux-, para iniciar la aplicacin hay que ejecutar
  -/usr/local/facturalux/bin/facturalux-.

  3.4.  Postinstalacin

  Las acciones a realizar despus de la instalacin se reducen a crear
  la base de datos y un usuario para esta.  No hace falta crear a priori
  tablas en la base de datos, ya que FacturaLUX crea automticamente las
  tablas necesarias en el momento que se van a usar por primera vez.

  Actualmente FacturaLUX slo trabaja con PostgreSQL, por lo que se debe
  tener correctamente instalado este sistema de gestin de bases de
  datos y funcionando. Una vez que tenemos la base de datos
  correctamente funcionado, los dos pasos que se deben dar -crear la
  base de datos y crear un usuario- se detallan en las secciones
  siguientes:


  3.4.1.  - Crear la base de datos facturalux

  Estando como usuario root, ejecutar :

  ______________________________________________________________________

          #su postgres

          $createdb -E UNICODE facturalux
  ______________________________________________________________________



  Esto bastara para crar la base de datos, pero en este punto podemos
  encontrarnos con el tpico problema que muestra el mensaje:

  -Connectionto database "template1" failed.-

  -ConnectDB () failed: Is the postmaster running and accepting
  connections at 'UNIX socket' on Port '5432'-

  -Createdb : database creation failed on bulma-


  La solucin suele pasar por ejecutar:


  ______________________________________________________________________

          $ initdb --pglib=/usr/lib/pgsql --pgdata=/var/lib/pgsql
  ______________________________________________________________________



  Si esto no soluciona el problema, tambien es posible que no exista
  -initdb- en el sistema, en ese caso hay que instalar el paquete de la
  parte servidor y luego arrancar el demonio servidor e intentar crear
  de nuevo la base de datos:


  ______________________________________________________________________

          # /etc/rc.d/init.d/postgres start

          $ createdb facturalux
  ______________________________________________________________________



  Puede salir algn mesaje de aviso o "warning" a los que no debemos
  prestar atencin.  Con esto se habr superado uno de los mayores
  inconvenientes y la base de datos de facturalux estar creada.


  3.4.2.  - Crear un usuario para la base de datos facturalux

  Crear el usuario (para el caso de ejemplo se utiliza el usuario
  -nobody-, aunque quizs fuera mas lgico usar el usuario facturador o
  algo similar) -nobody- como usuario de la base de datos:


  ______________________________________________________________________

          $ createuser nobody
  ______________________________________________________________________



  Ahora somos consultados sobre los permisos de creacin de bases de
  datos y los permisos de crear usuarios por parte del usuario nobody.
  Lo mas lgico es responder que no a ambas preguntas, pero eso
  depender de si se quiere usar ese usuario para otras cosas adems de
  para iniciar sesin en FacturaLUX o no. Para asignarle un password a
  este usuario usaremos la utilidad de asignacin de passwords de toda
  la vida.


  ______________________________________________________________________

          $ passwd nobody
  ______________________________________________________________________



  Asignamos el password a este usuario y asunto arreglado.  Este usuario
  y password seran los del usuario que tenga acceso a la base de datos.
  Para mas detalles sobre los permisos y usuarios de PostgreSQL tenemos
  2 opciones. Bien el manual de PostgresQL, bien el weblog
  http://bulmalug.net el que algunos compaeros y yo mismo escribimos
  articulos de ayuda al respecto.

  4.  Uso

  POR HACER

  5.  FAQ's, Preguntas y Respuestas Frecuentes

  En esta seccin hay una serie de preguntas o cuestiones y sus
  repuestas, sobre FacturaLUX, recogidas la mayor parte de las lista de
  correo y de las experiencias que nos han enviado usuarios de la
  aplicacin.


  -Pregunta :- Al ejecutar el script ./configure finaliza con el error


  -"configure: error: You have Qt version 2.3.0, but I need Qt version
  >=3.0.0 .  Please upgrade it (http://www.troll.no)..."-,

  pero tengo instalada la librera Qt 3.0  Qu sucece ?.

  -Repuesta :-- Tienes instaladas las libreras Qt 3.0,  pero tambin
  las libreras Qt 2.3.0. Debes localizar en que directorio tienes
  instaladas las Qt 3.0 y entonces hay dos opciones:-

  -A) export $QTDIR=/directorio/qt3.0 ; configure-

  -B) configure --with-qt-dir=/directorio/qt3.0-


  -Pregunta :- Hago un ./configure y le aado en las opciones --with-qt-
  dir=/usr/lib/qt-x11-free-3.0.1/ para que me utilice las qt3. Con esto
  consigo que compile pero al ir a ejecutar me dice

  -lt-facturalux: error while loading shared libraries: libqui.so.1:
  cannot open shared object file: No such file or directory-

  -Repuesta :-- Hay que colocar en la ruta de bsqueda de libreras la
  librera Qt 3.0, la manera mas sencilla es ejecutando;  export
  LD_LIBRARY_PATH=/usr/lib/qt-x11-free-3.0.1 .  Este comando ser
  recomedable incluirlo en los fichero de inicio como puede ser .bashrc
  o /etc/profile para no tener que repetirlo cada vez que se quiera
  iniciar FacturaLUX.-

  6.  Copyright


  FacturaLux version 0.1 Copyright 2001,2002 Federico Albujer Zornoza ,
  mail@infosial.com


  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or (at
  your option) any later version.

  This program is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.