Con esta aplicación esperamos facilitar la manipulación de los datos publicamente disponibles en el Congreso de los Diputados de España para su transformación en información util promoviendo, como consecuencia, el surgimiento de nuevos proyectos de seguimiento y análisis político basados en hechos, es decir, en la actividad parlamentaria.

Agradeceremos cualquier aportación para la mejora de la aplicación. Por favor, no dudes en colaborar creando "pull requests", Issues o aportando ideas en Discussions.

Esto es un proyecto 100% código abierto, sin ánimo de lucro y queremos que sea tanto desarrollado como mantenido colaborativamente por ciudadanos/as normales en su tiempo libre.

Esta aplicación nace de la necesidad de ampliar la funcionalidad de Seguimiento-Político, el proyecto matriz y que en la actualidad es un simple prototipo.

Aunque la web del congreso cuenta con una zona de "Datos Abiertos" los datos disponibles por medio de los archivos JSON, XML o CSV no son completos. Lo mismo ocurre si se emplean los "end points" disponibles en la web (ej: busqueda de iniciativas, busqueda de diputados, organos, etc...). Hay datos relevantes que no se devuelven como objetos JSON, sino que se requiere de un "webscrapper" para capturar los datos faltantes que si se muentran en el html resultante.

Con "congreso-scrapper" pretendemos eliminar estas lagunas. Por eso, la app no se limita a devolver los datos publicados en cada unos de los "end points", sino que los combina (tras obtenerlos de distintas partes de la web del congreso) y los almacena de manera estructurada en una base de datos propia.

Aplicación escrita en JavaScript usando como framework Node.js. Para la gestión de dependencias hemos usado NPM y MongoDB como base de datos.

Dada la ingente cantidad de información, hemos descartado la opción inicialmente implementada de guardar los datos en archivos JSON. Ahora únicamente se registran en la BBDD.

• Web scrapping y registro en BBDD:
  • Legislaturas.
  • Iniciativas.
  • Tipos de iniciativas.
  • Composición de las legislaturas
    • diputados/as.
    • grupos parlamentarios y partidos
    • comisiones
    • subcomisiones
  • Composición de las comisiones y subcomisiones
  • Tipos de tramitación
  • Información relevante de cada iniciativa
    • Iniciativas relacionadas
    • Votaciones
    • Intervenciones
    • Publicaciones (Diarios de sesión, BOCGs y BOEs)
    • Ponentes
• Desarrollar y publicar una API REST (opción descartada, será parte de otro repositorio distinto)

Antes de ejecutar 'app.js' asegurate de haber instalado las dependencias correctamente mediante el comando: "npm install".

Al ejecutar "node app.js", aparecerá un menú contextual con cinco (3) opciones, pulsando el número o letra de cada una de ellas se ejecutará la subrutina correspondiente. Cada opción de scrapping te permitirá elegir una legislatura concreta o todas "ALL".

Las opciones en cuestión son:

1. Basic Scrapping: Se encarga de registrar todos los datos básicos de cada legislatura, es decir:

   • Legislaturas y su composición en términos de "Diputados/as", "Grupos parlamentarios" y "Formaciones políticas".
   • Óganos de las legislaturas y su composición en términos de "Comisiones", "subcomisiones" y "diputados/as que los componen".
   • Registro de todas las iniciativas desde la "Legislatura constituyente" hasta la actualidad.
   • Topolología de iniciativas (el catálogo de todos los tipos de iniciativas)

2. Detailed Scrapping: Tras el paso anterior esta rutina se encarga de adjuntar a cada iniciativa existente su información relevante como:

   • Votaciones
   • Intervenciones
   • Publicaciones
   • Otras Iniciativas relacionadas

3. Complete (Basic + Detailed) Scrapping: Esta opción realiza en un solo paso todo el "scrapping". Ojo, esta opción puede tomar mucho tiempo si se aplica a todas las legislaturas. Es recomendable usarla para una legislatura determinada.

x. Salir: Sin comentarios.

NOTA: Para legislaturas pasadas solo será necesario ejecutar el scrapping (básico y detallado) una vez. Para la legislatura activa habrá que ejecutar ambas opciones de manera periódica para mantener la BBDD actualizada.