Skip to content

Latest commit

 

History

History
130 lines (85 loc) · 5.6 KB

INSTALL.md

File metadata and controls

130 lines (85 loc) · 5.6 KB

Instalación aplicación web LibreDTE

La aplicación web está soportada oficialmente en Debian GNU/Linux 8. Es posible usarla en otros sistemas GNU/Linux, como Arch Linux o Ubuntu, pero no se soportan de manera oficial por el momento.

Requisitos

  • Apache 2.x y PHP 5.5 o superior (no usar PHP 7, problemas con PDF417)
  • Base de datos PostgreSQL 9.x
  • Memcached con PHP usándolo como backend para las sesiones
  • Otros requisitos de SowerPHP
  • Tener SowerPHP instalado con las extensiones app y general

Instalación del framework

Usando SowerPKG se instala en el directorio por defecto /usr/share/sowerphp:

$ wget -c https://github.com/SowerPHP/sowerpkg/raw/master/sowerpkg.sh
$ chmod +x sowerpkg.sh
$ ./sowerpkg.sh install -e "empresa app general" -W

Esto instalará el framework SowerPHP, y las extensiones obligatorias general y app. Adicionalmente se instalará la extensión empresa, esto se realiza porque es necesario obtener schemas SQL y datos desde ella (pero no se usa la extensión en si en la aplicación web).

SowerPKG requiere que esté instalado curl, git y mercurial (hg).

Adicionalmente SowerPKG dejará composer en el directorio ~/bin por lo cual se recomienda agregarlo al PATH del usuario para evitar tener que escribir la ruta completa al momento de usar composer.

Instalación aplicación web

  1. Clonar código de la aplicación al directorio del servidor web:

    $ cd DIRECTORIO_SERVIDOR_WEB
    $ git clone --recursive https://github.com/LibreDTE/libredte-webapp.git libredte
    

    Esto instalará la aplicación web de LibreDTE dentro del directorio libredte en DIRECTORIO_SERVIDOR_WEB y se asume que se accederá vía navegador a través de http://example.com/libredte

    La instalación por defecto asume que SowerPHP está instalado en /usr/share/sowerphp, si esto no es así se deberá editar el archivo libredte/website/webroot/index.php con la ruta correcta al framework.

  2. Instalar dependencias de composer:

    $ cd libredte/website
    $ composer install
    
  3. Crear archivo de configuración:

    $ cd Config
    $ cp core-dist.php core.php
    
  4. Editar configuración de la aplicación en el archivo website/Config/core.php, obligatoriamente se deberá configurar:

    • Configuración para la base de datos
    • Configuración para el correo electrónico
    • Contraseña que se usará para encriptar datos sensibles en la BD

    Si se ofrecerán las utilidades y/o los servicios web se deberá configurar:

    • Configuración para firma electrónica
    • Configuración para autenticación en API a usuarios no logueados

    Adicionalmente se recomienda configurar, por razones de seguridad:

    • Configuración para autorización secundaria
    • Configuración para reCAPTCHA
  5. Crear base de datos (debe coincidir con configuración en core.php):

    $ createdb libredte
    
  6. Cargar schema y datos del módulo Sistema.Usuarios de la extensión app:

    $ psql libredte < /usr/share/sowerphp/extensions/sowerphp/app/Module/Sistema/Module/Usuarios/Model/Sql/PostgreSQL/usuarios.sql
    
  7. Cargar schema para cambios de moneda:

    $ psql libredte < /usr/share/sowerphp/extensions/sowerphp/app/Module/Sistema/Module/General/Model/Sql/moneda.sql
    
  8. Cargar schema para actividades económicas del módulo Sistema.General de la extensión empresa:

    $ psql libredte < /usr/share/sowerphp/extensions/sowerphp/empresa/Module/Sistema/Module/General/Model/Sql/PostgreSQL/actividad_economica.sql
    

    Cargar datos de actividades económicas: se deberán cargar desde el archivo /usr/share/sowerphp/extensions/sowerphp/empresa/Module/Sistema/Module/General/Model/Sql/actividad_economica.ods, esto se puede realizar utilizando el módulo Dev y la opción disponible en http://example.com/libredte/dev/bd/poblar (se debe habilitar el módulo Dev en Config/core.php).

  9. Cargar schema para división geopolítica (regiones, provincias y comunas) del módulo Sistema.General.DivisionGeopolitica de la extensión app:

    $ psql libredte < /usr/share/sowerphp/extensions/sowerphp/app/Module/Sistema/Module/General/Module/DivisionGeopolitica/Model/Sql/PostgreSQL/division_geopolitica.sql
    

    Cargar datos de división geopolítica: se deberán cargar desde el archivo /usr/share/sowerphp/extensions/sowerphp/app/Module/Sistema/Module/General/Module/DivisionGeopolitica/Model/Sql/division_geopolitica.ods, esto se puede realizar utilizando el módulo Dev y la opción disponible en http://example.com/libredte/dev/bd/poblar (se debe habilitar el módulo Dev en Config/core.php).

  10. Cargar schema del módulo Dte:

    $ psql libredte < libredte/website/Module/Dte/Model/Sql/PostgreSQL.sql
    
  11. Cargar datos del módulo Dte del archivo libredte/website/Module/Dte/Model/Sql/datos.ods a través de la página de carga de datos.

  12. Cargar schema del módulo Lce:

    $ psql libredte < libredte/website/Module/Lce/Model/Sql/PostgreSQL.sql
    
  13. Cargar datos del módulo Lce del archivo libredte/website/Module/Lce/Model/Sql/datos.ods a través de la página de carga de datos.

  14. Crear directorio data/logos y permitir que el usuario del servidor web pueda escribir en ellos.

  15. ¡Listo! Ahora puede ingresar a la aplicación web de LibreDTE a través de http://example.com/libredte.

    El usuario por defecto es admin con contraseña admin. Se recomienda cambiar el nombre de usuario, contraseña y hash del mismo en http://example.com/libredte/usuarios/perfil.