DEV Community

ANA CECILIA ESTEBAN RAMOS
ANA CECILIA ESTEBAN RAMOS

Posted on

Desarrollo de una Biblioteca NoSQL con Firebase Firestore y despliegue automatizado mediante GitHub Actions Copiar

Introducción

En el desarrollo de aplicaciones web modernas, una de las necesidades más importantes es almacenar, consultar y actualizar información de manera eficiente. Tradicionalmente, estas operaciones se realizan mediante bases de datos relacionales y servidores encargados de procesar las solicitudes. Sin embargo, las tecnologías NoSQL ofrecen alternativas que permiten construir soluciones flexibles y adaptadas a aplicaciones conectadas a la nube.

Como parte del curso de Base de Datos II de la Universidad Privada de Tacna, desarrollamos en equipo Biblioteca NoSQL, una aplicación web que permite gestionar un catálogo de libros mediante Cloud Firestore, la base de datos documental de Firebase.

El propósito fue integrar una base de datos NoSQL con una interfaz web, implementar operaciones CRUD, utilizar actualizaciones en tiempo real y automatizar la publicación mediante GitHub Actions.

En este artículo presentaré el funcionamiento de nuestra aplicación, las tecnologías utilizadas, las decisiones técnicas más importantes y los aprendizajes obtenidos durante su implementación.

Enlaces del proyecto


1. ¿Por qué elegimos una base de datos NoSQL?

Al comenzar el proyecto, consideramos la importancia de utilizar una tecnología que facilitara la administración de información sin depender de una infraestructura compleja.

Las bases de datos NoSQL permiten almacenar información mediante diferentes modelos, como documentos, clave-valor o grafos. Para nuestra aplicación seleccionamos Cloud Firestore, una base de datos orientada a documentos que forma parte del ecosistema de Firebase.

A diferencia del modelo relacional, donde los registros se organizan en tablas, Firestore utiliza colecciones que contienen documentos compuestos por campos y valores.

Esta característica resultó adecuada para nuestro catálogo, porque cada libro puede representarse como un documento independiente.

Entre los beneficios más importantes encontramos:

  • Almacenamiento flexible mediante documentos.
  • Sincronización de información en tiempo real.
  • Integración directa con aplicaciones web.
  • Infraestructura administrada por Firebase.
  • Compatibilidad con reglas de seguridad y consultas mediante índices.

Gracias a estas características, pudimos concentrarnos en el funcionamiento de la aplicación y en su integración con la nube.


2. Presentación de Biblioteca NoSQL

Nuestra aplicación consiste en un sistema web de administración de libros. Su interfaz fue diseñada para permitir que los usuarios realicen operaciones básicas sobre los registros almacenados en Firestore.

Funcionalidades implementadas

Registro de libros

El usuario puede ingresar el título, autor, género y año de publicación. Al guardar, la información se almacena en Cloud Firestore.

Visualización del catálogo

Los documentos registrados se muestran en la interfaz, permitiendo consultar los datos de cada libro.

Filtrado por género

La aplicación permite seleccionar una categoría literaria para visualizar únicamente los libros correspondientes.

Actualización del estado de lectura

Cada libro dispone de un estado que permite identificar si ha sido leído.

Eliminación de registros

Los libros pueden eliminarse del catálogo mediante una operación sobre el documento correspondiente.

Sincronización en tiempo real

Una de las características principales es que los cambios realizados en la base de datos pueden reflejarse automáticamente en las sesiones conectadas, sin necesidad de actualizar manualmente la página.

Estas funcionalidades nos permitieron demostrar cómo las operaciones CRUD pueden implementarse utilizando una base de datos NoSQL alojada en la nube.


3. Arquitectura de la aplicación

Para desarrollar Biblioteca NoSQL utilizamos una arquitectura sencilla basada en tecnologías web y servicios administrados.

Componente Tecnología
Interfaz web HTML, CSS y JavaScript
Base de datos Cloud Firestore
Conexión con Firebase Firebase Web SDK
Alojamiento Firebase Hosting
Control de versiones Git y GitHub
Pruebas automatizadas Node.js
Integración y despliegue GitHub Actions

El funcionamiento inicia cuando el usuario accede a la aplicación mediante su navegador. Firebase Hosting entrega los archivos de la interfaz y el SDK de Firebase permite establecer la comunicación con Cloud Firestore.

Cuando se registra, consulta o modifica un libro, la operación correspondiente se realiza sobre los documentos de la base de datos.

Una particularidad de nuestra solución es que no necesitamos desarrollar un servidor backend propio. Las operaciones se realizan mediante el SDK de Firebase, mientras que las reglas de seguridad de Firestore controlan las solicitudes permitidas.

Esta arquitectura demuestra cómo los servicios administrados pueden simplificar el desarrollo y despliegue de aplicaciones web.


4. Organización de los datos en Firestore

El diseño del almacenamiento fue una parte importante del proyecto.

Creamos una colección denominada libros, donde cada documento representa un libro registrado en la aplicación.

Cada registro contiene información como:

  • titulo: nombre del libro.
  • autor: escritor de la obra.
  • genero: categoría literaria.
  • anio: año de publicación.
  • leido: valor booleano que representa el estado de lectura.
  • creadoEn: fecha y hora de creación generadas por el servidor.

Por ejemplo, un documento puede representar el libro Cien años de soledad, de Gabriel García Márquez, publicado en 1967, clasificado como novela y con estado de lectura pendiente.

Esta estructura permite almacenar los libros de manera independiente y consultar únicamente los documentos que cumplen determinadas condiciones.

Además, utilizamos un índice compuesto que combina los campos genero y creadoEn, permitiendo realizar consultas filtradas por categoría y ordenadas por fecha de creación.

De esta manera, comprendimos que el modelado en NoSQL debe considerar las consultas que realizará la aplicación, no solamente los datos que necesita almacenar.


5. Implementación de las operaciones CRUD

Las operaciones CRUD representan las cuatro acciones fundamentales de administración de información: crear, leer, actualizar y eliminar.

En nuestra aplicación, estas operaciones se implementaron mediante las funciones proporcionadas por el SDK de Cloud Firestore.

Creación de registros

Para insertar un nuevo libro se utiliza la función addDoc(), que permite agregar un documento a una colección.

Un ejemplo simplificado es:

await addDoc(librosRef, {
  titulo,
  autor,
  genero,
  anio,
  leido: false,
  creadoEn: serverTimestamp()
});
Enter fullscreen mode Exit fullscreen mode

En este procedimiento, Firestore genera un identificador para el nuevo documento. También se utiliza serverTimestamp() para registrar la fecha de creación desde el servidor.

Lectura de datos en tiempo real

Una característica especialmente interesante es la función onSnapshot(), que permite escuchar los cambios realizados en una consulta.

onSnapshot(consultaLibros, (snapshot) => {
  snapshot.forEach((documento) => {
    console.log(documento.id, documento.data());
  });
});
Enter fullscreen mode Exit fullscreen mode

A diferencia de una consulta ejecutada una sola vez, este mecanismo permite recibir actualizaciones cuando cambia el resultado de la consulta.

Esto es útil cuando la aplicación está abierta en diferentes navegadores, ya que los nuevos registros y las modificaciones pueden visualizarse automáticamente.

Actualización y eliminación

Para modificar el estado de lectura utilizamos updateDoc(), mientras que para eliminar un registro se utiliza deleteDoc().

Estas operaciones permiten mantener actualizado el catálogo sin tener que reconstruir manualmente la información almacenada.


6. Seguridad y validación de los documentos

Al trabajar con una aplicación conectada directamente a Firestore, uno de los aspectos más importantes es controlar qué operaciones están permitidas.

Para ello utilizamos el archivo firestore.rules, que contiene las reglas de seguridad de la base de datos.

En nuestro proyecto, estas reglas permiten validar características como el tipo de información recibida, los campos autorizados y determinadas condiciones de actualización.

Por ejemplo, el campo correspondiente al año debe contener un número entero, mientras que el estado de lectura debe representarse mediante un valor booleano.

También se restringen las actualizaciones para que únicamente puedan modificarse campos autorizados, como el estado leido.

Esto evita depender exclusivamente de las validaciones de JavaScript, que pueden ser modificadas desde el navegador.

Es importante señalar que nuestra aplicación es un prototipo académico con determinadas operaciones públicas. Como mejora para un entorno de producción con usuarios reales, sería conveniente integrar Firebase Authentication y restringir la modificación y eliminación de documentos según los permisos de cada usuario.

Esta experiencia nos permitió comprender que la seguridad de una base de datos NoSQL debe considerarse desde su diseño.


7. Pruebas locales antes de publicar

Antes de realizar el despliegue, es importante comprobar que el proyecto funcione correctamente.

Firebase dispone de herramientas de emulación que permiten ejecutar determinados servicios de manera local y realizar pruebas sin modificar los datos de producción.

En nuestro proyecto utilizamos herramientas de Node.js y Firebase para verificar el funcionamiento de la aplicación.

Los comandos principales son:

npm install -g firebase-tools
npm test
npm run dev
Enter fullscreen mode Exit fullscreen mode

El primer comando instala las herramientas de Firebase.

El segundo ejecuta las pruebas automatizadas disponibles en el repositorio.

Finalmente, npm run dev inicia el entorno local configurado para el proyecto.

El uso de pruebas permite detectar problemas antes de publicar una nueva versión y reduce el riesgo de incorporar cambios incorrectos.


8. Automatización del despliegue con GitHub Actions

Una parte fundamental del trabajo fue automatizar el proceso de publicación de la aplicación.

Para ello utilizamos GitHub Actions, una herramienta que permite ejecutar flujos de trabajo a partir de eventos ocurridos en un repositorio.

En nuestro caso, configuramos un workflow ubicado en:

.github/workflows/deploy.yml

Este archivo define las actividades necesarias para comprobar el proyecto y realizar su despliegue.

¿Cómo funciona nuestro proceso CI/CD?

Primera etapa: actualización del repositorio

Cuando se realizan cambios y se envían a la rama main, GitHub Actions inicia automáticamente el flujo configurado.

Segunda etapa: ejecución de pruebas

El sistema prepara el entorno de Node.js y ejecuta las pruebas mediante npm test.

Tercera etapa: validación

Si las pruebas finalizan correctamente, el flujo puede continuar con la publicación. Si fallan, no se ejecuta el despliegue de producción.

Cuarta etapa: despliegue en Firebase

El workflow utiliza Firebase CLI para publicar la aplicación, junto con las reglas e índices de Firestore.

El comando central es:

firebase deploy --only hosting,firestore
Enter fullscreen mode Exit fullscreen mode

Para realizar la autenticación del proceso se utilizan un secreto de GitHub que contiene las credenciales de la cuenta de servicio y una variable con el identificador del proyecto Firebase.

Este procedimiento permite automatizar las publicaciones y evita realizar manualmente todos los pasos cada vez que se modifica el código.

Además, demuestra cómo las prácticas de integración y despliegue continuos pueden aplicarse incluso en proyectos académicos de pequeña escala.


9. Resultados obtenidos

Una vez implementada la aplicación y configurado el despliegue automatizado, conseguimos publicar Biblioteca NoSQL mediante Firebase Hosting.

La aplicación se encuentra disponible en:

https://biblioteca-nosql-upt.web.app

Desde esta dirección se puede acceder a la interfaz y utilizar las funcionalidades implementadas.

Los principales resultados del proyecto fueron:

  • Integración funcional de una aplicación web con Cloud Firestore.
  • Implementación de operaciones CRUD sobre documentos NoSQL.
  • Consultas filtradas y sincronización de información en tiempo real.
  • Incorporación de reglas de validación e índices.
  • Ejecución de pruebas automatizadas.
  • Publicación en Firebase Hosting mediante un flujo CI/CD de GitHub Actions.

Consideramos especialmente valioso haber integrado varias tecnologías dentro de una sola solución, desde el almacenamiento hasta su publicación automatizada.


10. Dificultades y aprendizajes

Durante el desarrollo encontramos diferentes aspectos que requirieron investigación y ajustes.

Uno de ellos fue la configuración de Firebase y sus permisos de acceso. Aprendimos que es importante distinguir entre la configuración del frontend y las credenciales utilizadas para desplegar los recursos desde GitHub Actions.

También trabajamos con índices compuestos de Firestore, necesarios para determinadas combinaciones de filtros y ordenamiento.

Otra experiencia importante fue la configuración del workflow, porque nos permitió comprender cómo verificar cambios antes de enviarlos a producción.

Estos desafíos reforzaron nuestros conocimientos sobre bases de datos NoSQL, seguridad, automatización e integración de servicios en la nube.

Como posibles mejoras futuras, consideramos incorporar autenticación de usuarios, funciones adicionales de búsqueda y mecanismos de control de acceso más específicos.


11. Conclusiones

El desarrollo de Biblioteca NoSQL nos permitió aplicar conocimientos de bases de datos no relacionales en un proyecto funcional, accesible desde internet y conectado a servicios de Google Firebase.

En primer lugar, comprobamos que Cloud Firestore facilita el almacenamiento de documentos y la implementación de consultas en tiempo real, ofreciendo una alternativa al modelo tradicional de bases de datos relacionales para determinadas aplicaciones.

En segundo lugar, comprendimos la importancia de definir correctamente la estructura de los documentos, los índices y las reglas de seguridad, ya que estos componentes influyen directamente en el funcionamiento y protección de los datos.

Finalmente, la implementación de GitHub Actions nos permitió conocer el valor de la automatización dentro del desarrollo de software. La ejecución de pruebas y el despliegue continuo contribuyen a mantener un proceso de publicación más ordenado y reproducible.

Este proyecto representó una experiencia práctica de integración entre desarrollo web, bases de datos NoSQL y servicios en la nube.


Créditos del proyecto

Artículo elaborado por: Ana Cecilia Esteban Ramos.

Proyecto desarrollado en equipo por:

  • Ana Cecilia Esteban Ramos.
  • Saúl José Alvarado Urbano.

Curso: Base de Datos II.

Institución: Universidad Privada de Tacna.

Repositorio del proyecto: https://github.com/saulalvarado1/NoSQL-App-development

Demostración en línea: https://biblioteca-nosql-upt.web.app

También puedes consultar el artículo técnico de mi compañero Saúl José Alvarado Urbano, en el que presenta el proceso de construcción y despliegue desde otra perspectiva:

https://dev.to/saul_josealvaradourbano/construye-y-despliega-una-app-con-cloud-firestore-nosql-en-firebase-usando-github-actions-3986

Gracias por leer. Espero que esta experiencia sirva como referencia para estudiantes y desarrolladores interesados en explorar las posibilidades de Firebase, Cloud Firestore y la automatización mediante GitHub Actions.

Top comments (0)