This README is available in English

Gobierto comparador de presupuestos

Gobierto es una aplicación Rails que proporciona una serie de herramientas a las administraciones públicas para facilitar la transparencia y la participación ciudadana, para que se comuniquen mejor con los ciudadanos y para facilitar la explotación de los datos públicos.

Gobierto comparador de presupuestos es una herramienta de exploración, comparación y visualización de los presupuestos municipales. Utilizamos datos abiertos del Ministerio de Hacienda (tenemos un repositorio donde publicamos los datos ya limpios y procesados) y del INE.

Puedes ver una instancia de este proyecto funcionando en https://presupuestos.gobierto.es.

Gobierto es un proyecto abierto de Populate, un estudio que diseña desde Madrid productos digitales alrededor de la Participación Ciudadana. Además de trabajar en Gobierto, también ofrecemos servicios en torno a datos abiertos, periodismo de datos, sostenibilidad, etc.

• #todo Por qué Gobierto y nuestra filosofía de Diseño

Más información:

• Website de Gobierto: gobierto.es
• Blog: gobierto.es/blog

Sugerencias de Mejora

Crea un issue.

Arquitectura de la aplicación

La aplicación está escrita en Ruby y usa el framework Ruby on Rails. Para la Base de Datos usa PostgreSQL y también usa ElasticSearch para almacenar toda la información de presupuestos y otros datos de terceros.

Desarrollo

Requerimientos de Software

• Git
• Ruby 2.7.4
• Rubygems
• PostgreSQL
• Elastic Search
• Pow or another subdomains tool

Prepara la base de datos y el archivo secrets.yml

Una vez tengas PostgreSQL corriendo y hayas clonado este repo, haz lo siguiente en el terminal:

$ git clone git@github.com:PopulateTools/gobierto-comparador-presupuestos.git
$ cd gobierto-comparador-presupuestos
$ cp config/database.yml.example config/database.yml
$ cp config/secrets.yml.example config/secrets.yml
$ cp .env.example .env
$ ln -s .env .rbenv-vars # if you use Rbenv
$ bundle install
$ bin/rails db:setup

Monta una instancia de Elastic Search

Aquí puedes ver cómo

Una vez esté corriendo, asegúrate de configurar la URL correcta para tu instancia de Elastic Search en el archivo config/secrets.yml bajo la clave elastic_url

Carga algunos datos

Si simplemente quieres cargar unos cuantos datos para empezar a trabajar, haz lo siguiente:

1. Clona este repo y sigue las instrucciones para que tengas todos los datos de los municipios españoles disponibles para importar.
2. Después, ejecuta bin/rake gobierto_budgets:setup:sample_site

Esto cargará los datos para Madrid, Barcelona y Bilbao y activará el Site de Municipio de prueba para Madrigal de la vera.

Alternativamente, aquí puedes ver cómo cargar los datos para más municipios de España.

Crea el subdominio y lanza la aplicación

Cuando trabajes en local, al servidor de aplicaciones se debería acceder a través del dominio .gobierto.dev. Para configurar esto en tu entorno, la manera más sencilla es usando POW. Para instalarlo:

curl get.pow.cx | sh

Después, configura el servidor así:

cd ~/.pow
ln -s DIRECTORIO/gobierto-comparador-presupuestos gobierto-comparador-presupuestos

Y simplemente navega a http://gobierto-comparador-presupuestos.test/ para cargar la aplicación.

Montando el site para una sóla entidad pública

Ejecuta lo siguiente:

bin/rake gobierto_budgets:setup:create_site['<Place ID>','<URL OF INSTITUTION>']

Donde <Place ID> es el ID del municipio que quieres montar y <URL OF INSTITUTION> es la URL opcional del posible site oficial de ese municipio.

Trae tus propios datos

ToDo: Documentar el formato de datos para importar

Contribuir

Claro! Mira cómo contribuir

Librerías/gemas

• Gemas: Echa un vistazo a Gemfile para una referencia completa
• Otras (CSS, JS): #ToDo (explora el código de momento;)

Licencia

Software publicado bajo la licencia de código abierto AFFERO GPL v3 (ver LICENSE-AGPLv3.txt)