Aplicación de Participación Ciudadana y Gobierno Abierto
Este es el repositorio de código abierto de la Aplicación de Participación Ciudadana Consul, creada originariamente por el Ayuntamiento de Madrid.
El desarrollo de esta aplicación comenzó el 15 de Julio de 2015 y el código fue puesto en producción el día 7 de Septiembre de 2015 en decide.madrid.es. Desde entonces se le añaden mejoras y funcionalidades constantemente. Las funcionalidades actuales se pueden consultar en características o en la documentación y las siguientes funcionaliades en la lista de tareas por hacer. Para conocer el estado actual de las próximas caracteristicas, vaya a Roadmap
El backend de esta aplicación se desarrolla con el lenguaje de programación Ruby sobre el framework Ruby on Rails. Las herramientas utilizadas para el frontend no están cerradas aún. Los estilos de la página usan SCSS sobre Foundation
NOTA: para unas instrucciones más detalladas consulta la documentación
Prerequisitos: tener instalado git, Ruby 2.3.2, la gema bundler, ghostscript y PostgreSQL (9.4 o superior).
git clone https://github.com/consul/consul.git
cd consul
bundle install
cp config/database.yml.example config/database.yml
cp config/secrets.yml.example config/secrets.yml
bin/rake db:setup
bin/rake db:dev_seed
RAILS_ENV=test rake db:setup
Para ejecutar la aplicación en local:
bin/rails s
Prerequisitos para los tests: tener instalado PhantomJS >= 2.1.1
Para ejecutar los tests:
bin/rspec
Si añades código SCSS puedes revisarlo con:
scss-lint
Para mantener el nivel de accesibilidad, si añades colores nuevos utiliza un Comprobador de contraste de color (WCAG AA es obligatorio, WCAG AAA es recomendable)
Si trabajas en código coffeescript puedes revisarlo con coffeelint (instalalo con npm install -g coffeelint) :
coffeelint .
Puedes usar el usuario administrador por defecto del fichero seeds:
user: [email protected] pass: 12345678
Pero para ciertas acciones, como apoyar, necesitarás un usuario verificado, el fichero seeds proporciona uno:
user: [email protected] pass: 12345678
Ver fichero CUSTOMIZE_ES.md
Para probar los servicios de autenticación mediante proveedores externos OAuth — en este momento Twitter, Facebook y Google —, necesitas crear una "aplicación" en cada una de las plataformas soportadas y configurar la key y el secret proporcionados en tu secrets.yml
En el caso de Google, comprueba que las APIs Contacts API y Google+ API están habilitadas para la aplicación.
El código de este proyecto está publicado bajo la licencia AFFERO GPL v3 (ver LICENSE-AGPLv3.txt)
Ver fichero CONTRIBUTING_ES.md