Ventanita


#Esta es ventanita

Proyecto de periodismo de datos con miras a las elecciones presidenciales, congresales 2016.

Ventanita es un proyecto desarrollado por voluntarios. Tus contribuciones y mejoras al código son bienvenidas.

Contenido

• Antecedentes.
• Objetivo principal.
• Cómo instalar Ventanita?
• Configurar Ventanita.
• Ejecutar la aplicación.
• Scripts para importar datos.
• Licencia.

Antecedentes

En la pasada campaña de Elecciones Regionales y Municipales 2014 ejecutamos el proyecto Verita http://utero.pe/tag/verita/.

• Vale la pena hacer algo similar?
• Algo mejor?

Necesitamos ideas. Aporte y discusión de ideas aquí: https://github.com/aniversarioperu/ventanita/issues

Objetivo principal

Hacer un aplicativo web usando el framework Django. Este aplicativo permitirá que usuarios puedan evaluar rápidamente la idoneidad de los candidatos y partidos políticos que se presenten a las Elecciones 2016.

Idealmente algo parecido al aplicativo uterino http://www.selallevanfacil.info/home/. Mirror

Cómo instalar Ventanita?

Sigue estos pasos para instalar Ventanita en tu computadora y así poder modificar, corregir y agregar funciones y herramientas al software. Estas instrucciones asumen que tienes una computadora con Ubuntu Linux.

Instalar Ventanita

Es buena idea crear un virtual environment para que sea tu área de trabajo. Ver más info sobre la instalación de virtualenvwrapper aquí.

sudo apt-get install python-pip
sudo pip install virtualenvwrapper
source /usr/local/bin/virtualenvwrapper.sh
mkvirtualenv -p /usr/bin/python3 ventanita
workon ventanita

Es necesario que hagas un fork a este repositorio para tenerlo en tu cuenta de Github. Luego puedes clonar el respositorio en tu computadora (para eso debes tener instalado el software git).

sudo apt-get install git

Usa el siguiente comando para clonar el repo en tu computadora (reemplaza aniversarioperu con tu username en Github:

git clone https://github.com/aniversarioperu/ventanita.git

Ventanita depende de varias "librerías" en Python. Para instalarlas en tu virtual environment:

sudo apt-get install libpq-dev python3-dev
cd ventanita
pip install -r requirements/testing.txt

Instalar PostgreSQL

Ventanita almacena todos sus datos en una base de datos PostgreSQL. Para instalar PostgreSQL (más info aquí):

sudo apt-get install postgresql postgresql-contrib
sudo mkdir -p /usr/local/pgsql/data
sudo chown postgres:postgres /usr/local/pgsql/data
sudo -i -u postgres
PATH=/usr/lib/postgresql/9.3/bin:$PATH
export PATH
pg_ctl -D /usr/local/pgsql/data initdb
postgres -D /usr/local/pgsql/data > logfile 2>&1 &

Crea una database para Ventanita:

psql
postgres=# ALTER ROLE postgres WITH PASSWORD 'ljoiu234';
postgres=# CREATE DATABASE ventanita;

Configurar Ventanita

Luego de salir del usuario postgres (luego de tipear exit), puedes poner tus datos de desarrollo local en un archivo config.json, asegurándote que haya sido incluido en tu .gitignore.

touch config.json
echo "config.json" >> .gitignore

Este debe ser el contenido de tu archivo config.json:

{
    "SECRET_KEY": "crear una clave secreta",
    "DB_USER": "postgres",
    "DB_PASS": "ljoiu234",
    "DB_NAME": "ventanita",
    "DB_PORT": "5432",
    "DB_HOST": "localhost"
}

Ejecutar la aplicación

Puede usar el Makefile de ventanita:

make migrations
make serve

Podrás ver la Ventanita en todo su esplendor apuntado tu navegador web a esta dirección: http://localhost:8000

Scripts para importar datos

Van en el folder scripts_for_imports:

• Puedes importar el dummy_data a una base de datos MSSQL usando el script import_to_mssql.py.
• Importar registros del REDAM:

python ventanita/manage.py import_redam --jsonfile=redam.jl --settings=ventanita.settings.local

• Importar hojas_de_vida (datos generales del candidato):

python ventanita/manage.py import_hojas_de_vida --tsvfile=dummy_data0.tsv  --sheet=0 --settings=ventanita.settings.local

• Importar hojas_de_vida (educación primaria - secundaria):

python ventanita/manage.py import_hojas_de_vida --tsvfile=dummy_data1.tsv  --sheet=1 --settings=ventanita.settings.local

Licencia

Este es un proyecto open source con una licencia permisiva (WTFPL, ver archivos COPYING y LICENSE). El derecho de autor (copyright) en este proyecto corresponde a varias personas. El copyright para cada módulo está indicado al inicio de cada archivo, el cual corresponde al autor inicial y personas que contribuyeron con adiciones y modificaciones.