Skip to content

Latest commit

 

History

History
69 lines (54 loc) · 3.23 KB

README.md

File metadata and controls

69 lines (54 loc) · 3.23 KB
Raw

VisorXML

VisorXML es una aplicación web para la visualización y edición de informes de eficiencia energética en formato electrónico (XML).

La aplicación ha sido desarrollada en el marco del convenio entre el Ministerio de Fomento y el Instituto de Ciencias de la Construcción Eduardo Torroja (IETcc-CSIC), del Consejo Superior de Investigaciones Científicas (CSIC).

El código se distribuye bajo una licencia libre (MIT), que permite el uso, modificación y distribución del código original y modificado, según se especifica en los archivos LICENSE.txt y LICENSE_ES.txt.

Funcionalidad

  • Validación de archivos de eficiencia energética en formato electrónico (XML)
  • Avisos sobre potenciales problemas en el XML suministrado (inconsistencias, valores atípicos, etc)
  • Generación y visualización del certificado de eficiencia energética
  • Generación y visualización de un informe adicional de eficiencia energética
  • Descarga de informes en formato PDF (con XML incrustado) y XML
  • Incorporación de medidas de mejora a partir de un archivo XML base y archivos XML con medidas de mejora aplicadas
  • Edición de campos del XML que no son generados mediante simulación energética
  • Corrección de errores de formato en archivos XML

Instalación

La aplicación está desarrollada en lenguaje Python y Javascript para algunos aspectos del frontend. Se basa en la plataforma Django y PhantomJS para la generación de archivos PDF.

Requisitos de instalación (paquetes de sistema suponiendo Debian/jessie(stable)):

  • pdfdetach ($ sudo apt install poppler-utils)

  • nodejs ($ sudo apt install nodejs)

    • npm ($ sudo apt install npm)
    • grunt ($ npm install -g grunt-cli)

  • python (>= 3.4) ($ sudo apt install python3 python3-pip python3-venv python3-dev)

    • pip
    • venv
    • dev

Pasos de instalación:

  • Instalación de las dependencias de PIP en un entorno virtual (llamado venv):
    • Dependencias para compilación de módulos ($ sudo aptitude install build-essential libxml2-dev libxslt-dev libffi-dev zlib1g-dev libjpeg-dev libopenjp2-7-dev)
    • $ python3 -m venv venv # suponemos usuario usuariovisorxml
    • $ venv/bin/python -m pip install -Ur requirements.txt
  • Crea directorios de contenido de usuario y estático
    • $ mkdir -p visorxml/media/
    • $ mkdir -p visorxml/served-static/
  • Instalar las dependencias de npm:
    • $ npm install
  • Ejecutar grunt (instalada por npm) para construir la aplicación:
    • $ npx grunt
  • Configuración del servidor web para ejecutar la aplicación WSGI
    • apache-mod-wsgi ($ sudo apt install apache2 libapache2-mod-wsgi-py3)
    • Ejemplo de configuración para apache2 bajo la ruta /visorxml de la URL base: 
      # Visor XML
WSGIDaemonProcess visorxml python-path=/var/www/visorxml:/home/usuariovisorxml/venv/lib/python3.4/site-packages user=www-data group=www-data threads=5
WSGIScriptReloading On
WSGIScriptAlias /visorxml /var/www/visorxml/visorxml.wsgi process-group=visorxml

<Directory /var/www/visorxml>
        WSGIProcessGroup visorxml
        WSGIApplicationGroup %{GLOBAL}
        Require all granted
</Directory>
# FIN VisorXML