Andalucía COVID Dashboard

Índice

• 1. Introducción

• 2. Objetivos

• 3. Tecnologías escogidas y justificación

• 3.1. Frameworks seleccionados

• 3.2. Motor de bases de datos

• 3.3. Librerías

• 4. Instalación en docker

• 6. Fuentes

• 7. Work in Progress

✨ Introducción

Aplicación web realizada para el trabajo de fin de ciclo de Desarrollo de Aplicaciones Web sobre la evolución del COVID en Andalucía.

Capturas

El diagrama de clases utilizado es el siguiente:

🏁 Objetivos

El objetivo es desarrollar una aplicación web donde se puedan consultar los datos epidemiológicos de la pandemia del SARS-CoV19 en Andalucía para consultar la situación de cada territorio y/o consultar el estado de la pandemia.

💻 Tecnologías utilizadas y justificación

La aplicación se desarrolla en su mayor parte usando lenguaje python 🐍

Framework

El framework escogido es Django framework por diversas razones:

Los motivos principales para usar Django son:

• Es muy rápido: Si tenéis una startup, tenéis prisa por terminar vuestro proyecto o, simplemente, queréis reducir costes, con Django se puede construir una aplicación muy buena en poco tiempo.

• Viene bien cargado de funcionalidades: Cualquier cosa que se necesite realizar, ya estará implementada, sólo hay que adaptarla a las necesidades del proyecto.

• Es seguro: Implementa por defecto algunas medidas de seguridad, las más clásicas, para que no haya SQL Injection, no haya Cross site request forgery (CSRF) o no haya Clickjacking por JavaScript. Django se encarga de manejar todo esto de una manera realmente sencilla.

• Es muy escalable: Podemos pasar desde muy poco a una aplicación enorme perfectamente, una aplicación que sea modular, que funcione rápido y sea estable.

• Es increíblemente versátil: Se puede utilizar para aplicaciones multipropósito.

• Tiene una documentación muy completa y una gran comunidad muy colaborativa.

Motor de base de datos

El motor de base de datos elegido es PostgreSQL:

• Instalación ilimitada y gratuita

• Es multiplataforma para Windows, Linux y Mac (los sistemas operativos más extendidos) con lo cual se podrá disponer él en cualquiera de estos.

• Es un motor con un uso muy extendido en la comunidad de desarrolladores, con lo que conseguir ayuda es muy sencillo.

• Potencia y Robustez

• Es escalable, lo cual nos da una ventaja con vistas al futuro.

📖 Librerías

• [Twitter Bootstrap] - Bootstrap es una biblioteca multiplataforma o conjunto de herramientas de código abierto para diseño de sitios y aplicaciones web

• [Pandas] - Es una librería de Python especializada en el manejo y análisis de estructuras de datos.

• [Charts.js] - Chart.js es una biblioteca JavaScript gratuita de código abierto para la visualización de datos, que admite 8 tipos de gráficos: barra línea área circular burbuja radar polar dispersión

• [jQuery] - jQuery es una biblioteca multiplataforma de JavaScript, creada inicialmente por John Resig, que permite simplificar la manera de interactuar con los documentos HTML.

🐳 Instrucciones para instalar el proyecto

Una vez clonado el proyecto nos posicionamos en la raíz del repositorio y desplegamos los contenedores:

docker-compose up -d --build

Hacer las migraciones necesarias

Una vez el proceso anterior haya finalizamos hacemos las operaciones pertinentes para recopilar archivos estáticos de cada una de sus aplicaciones (y cualquier otro lugar que especifique) en una única ubicación que se pueda servir fácilmente en producción.

# Recopilar ficheros estáticos
docker-compose exec web python3 manage.py collectstatic
# Añadimos los territorios de Andalucía
docker-compose exec web python3 manage.py set_territories
# Añadimos los históricos
docker-compose exec web python3 manage.py get_historic
# Añadimos los acumulados de provincias
docker-compose exec web python3 manage.py get_acumulated --territorio -pro
# Añadimos los acumulados de toda la región
docker-compose exec web python3 manage.py get_acumulated --territorio -all

Tras la primera migración no hará falta volver a ejecutar los comandos, ya que el docker-compose trae un fichero cron_job donde están dichos comandos configurados para su ejecución periódica y que la aplicación actualice los datos del SarsCOv2 en Andalucía.

0 14,18 * * * python3 manage.py set_territories
0 14,18 * * * python3 manage.py get_acumulated --territorio all
0 14,18 * * * python3 manage.py get_acumulated --territorio pro
0 14,18 * * * python3 manage.py
# EOF

Este cron_job ejecuta dichos comandos todos los días a las 14:00 y a las 18:00 de la tarde, teniendo en cuenta que los datos de la Junta de Andalucía se actualizan sobre las 12:30 - 13:30 de la tarde y teniendo en cuenta atrasos o problemas informáticos del organismo correspondiente.

Ir a http://localhost:1337/app/general/

También es posible utilizar el script [despliegue.sh] para hacer el despliegue automático una vez creados los contenedores.

📈 Fuentes de los datos

Los datos recogidos en esta aplicación web son de uso público y de fuentes oficiales.

• Datos de @Pakillo19 - https://github.com/Pakillo/COVID19-Andalucia/blob/master/datos/

• IECA - https://www.juntadeandalucia.es/institutodeestadisticaycartografia/salud/

📝 WIP

• Añadir modo oscuro

• Corregir diseño responsive

• Añadir propuestas de mejoras de diseño

• Añadir tarea cron para actualización automática

• Añadir animaciones, transiciones e iconos

License

MIT