[[PageOutline(2)]] 
= Manual de instalación de websafiERP =

Manual para la configuración e instalación del aplicativo websafiERP.

== Instalación esquema Base de Datos ==

* Motor de Base de datos: ORACLE
* Instancia Base de Datos: <nombre del esquema de la base de datos>
* usuario: <nombre del usuario de la base de datos>
* Contraseña: < contraseña de ingreso a la base de datos>

Una vez creado la instancia, es necesario realizar la importación del esquema de la base de 	datos, la cual se encuentra en un archivo .dmp, para el caso en particular: websafiERP.dmp.
 	
El comando para la importación del esquema es el siguiente:

{{{
 ORACLE_HOME/bin$ export ORACLE_SID=websafiERP
 ORACLE_HOME/bin$ ./imp usuario/password file=websafiERP.dmp full=y;
}}}

== Requerimientos del servidor para la instalación ==

El servidor donde se instalara la aplicación debe tener lo siguiente, para su correcto funcionamiento:

1. [http://www.php.net/downloads.php PHP] 5 o superior
1. [http://www.apache.org/dyn/closer.cgi Apache]
1. [http://www.oracle.com/index.html ORACLE] InstantClient
1. Driver oci para configuracion de ORACLE
1. Driver dbase php

== Configuración de la conexión a la base de datos ==

Para la configuración de la base de datos de la aplicación es necesario modificar el archivo databases.yml. En este archivo se configuran los parametros de conexión de la base de datos, la ruta de este archivo en cada modulo es: [nombre_modulo] / config / databases.yml

Se deben cambiar los datos de acuerdo a la conexion de la base de datos: 

'''Modulo presupuesto'''

{{{
 all:
   presup:
     class: sfDoctrineDatabase
     param:
        dsn: 'oracle:dbname=//[ host ]:[ port ]/ [ instancia ];charset=AL32UTF8'
        username: [usuario de la base de datos]
        password: [contraseña para el usuario en la base de datos] 
}}}

'''Modulo tesorería'''

{{{
 all:
   doctrine:
     class: sfDoctrineDatabase
     param:
        dsn: 'oracle:dbname=//[ host ]:[ port ]/ [ instancia ];charset=AL32UTF8'
        username: [usuario de la base de datos]
        password: [contraseña para el usuario en la base de datos] 
}}}

'''Modulo comisiones'''

{{{
 all:  
   propel:  
   class:   sfPropelDatabase  
   param:  
     phptype:  oracle  
     host:   
     database: [nombre de la instancia de la base de datos]
     username: [usuario de la base de datos]
     password: [contraseña para el usuario en la base de datos]
     host: [servidor en el que se encuentra la base de datos ]
}}}

'''Modulo contabilidad'''

{{{
  all:
    doctrine:
      class: sfDoctrineDatabase
      param:
        dsn: 'oracle:dbname=//[ host ]:[ port ]/ [ instancia ];charset=AL32UTF8'
        username: [usuario de la base de datos]
        password: [contraseña para el usuario en la base de datos]
}}}

== Mapa de la aplicación ==

La aplicación websafiERP esta compuesto por los módulos ''presupuesto'', ''tesorería'', ''comisiones'', '' contabilidad'' y ''bienvenida''. El modulo de bienvenida, se encarga de la parte de autentificar y administrar usuarios, perfiles y credenciales para los demás módulos.

'''Carpetas dentro de la aplicación'''

Para cada uno de los modulos,  se describe una organización de carpetas. Cada una de las cuales se encarga de una funcion especifica dentro del modulo al que pertenece.

[[Image(CarpetasProyecto.png)]]

'''apps''' => Se encuentran los modulos que contienen la vista y la logica de la aplicación

[[Image(apps.png)]]

'''config''' => Se encuentran los archivos de configuración de la aplicación

* databases.yml: contiene la configuración de la base de datos
* schema.yml: contiene el esquema generado por symfony para los datos

[[Image(conf.png)]]

'''lib''' => Contiene el modelo y los formularios, generados para la base de datos

[[Image(lib.png)]]

'''web''' => Contiene las carpetas para los archivos subidos dentro de la aplicación

[[Image(web.png)]]

== Configuración del Servidor Web ==

Con la instalación del apache se crea una carpeta /var/www en Ubuntu y para Rethat /var/html en el disco duro, para crear la conexión al aplicativo se debe crear un link al proyecto: 

Se referencia esta carpeta, para la descripción de los pasos como '''root'''.

Los comandos de symfony se ejecutan dentro del directorio del proyecto.
1. Entrar a la carpeta del proyecto:
{{{
cd <directorio del proyecto>
}}}
1. Limpiar cache; comando:
{{{
 php symfony cc
}}}
1. Dar permisos a la carpeta(para esto debe ubicarse en el directorio del proyecto) del proyecto; comando: 
{{{
 Chmod -R 777 .
}}}
1. Utilize el mismo comando para dar permiso a la carpeta de symfony, ubicada en /lib/vendor del proyecto: 
{{{
 cd /<directorio completo del proyecto>/lib/vendor/symfony
}}}
1. Crear enlace dentro de la carpeta root, como usuario administrador, ingresa a la consola de sistema operativo.
Entra al directorio raiz:
{{{
 cd /
}}}
Entrar a la carpeta root:
{{{
 cd root
}}}
Crear link:
{{{
 sudo ln -s /< ubicación proyecto>/<nombre proyecto>/web <nombre de enlace>
}}}

== Modulo visual Contabilidad ==

Debe descomprimir el archivo que se entrega con el aplicativo de GWT en un '''root''' (directorio del equipo).

1. Entra al directorio raiz segun sistema operativo, como en el paso anterior para crear el link:
Entrar a la carpeta, ejemplo en Ubuntu:
{{{
 cd /var/www
}}}
1. Crear link que apunte al archivo Main.html que se encuentra en la carpeta var del archivo descomprimido:
{{{
 sudo ln -s /< ubicación proyecto>/<nombre proyecto>/war/Main.html <nombre de enlace>
}}}
Ejemplo:
{{{
 sudo ln -s /< ubicación proyecto>/<nombre proyecto>/war/Main.html contabg
}}}
Link de ejemplo:
{{{
 http://localhost/contabg/Main.html
}}}
1. Dar permisos a la carpeta (resultado de la descompresión), ubicándose por consola en la carpeta y ejecutando el comando: 
{{{
 Chmod -R 777 .
}}}