wesitos / ventanita Goto Github PK


#Esta es ventanita

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

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

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

En las 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

Hacer un aplicativo web usando el framework Django. Este aplicativo permitirá que usuarios puedan dar 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/.

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.

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

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;

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"
}

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

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: python ventanita/manage.py import_hojas_de_vida --tsvfile=dummy_data0.tsv --settings=ventanita.settings.local

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.