DEV Community

SOANNY GERALDINE RIVAS GUTIERREZ
SOANNY GERALDINE RIVAS GUTIERREZ

Posted on Edited on

HelpDesk Cloud: Gestión inteligente de incidencias con Firebase, bases de datos NoSQL y automatización CI/CD

Autor: Soanny Geraldine Rivas Gutierrez, Stevie Marca Aguilar
Fecha: 10 noviembre de 2026

1. Introducción

Actualmente, las organizaciones dependen de diferentes herramientas tecnológicas para desarrollar sus actividades. Sin embargo, cuando ocurre una falla informática, es importante contar con un mecanismo que permita registrar el problema, asignar responsables y supervisar su solución.

A partir de esta necesidad surge HelpDesk Cloud, una aplicación web desarrollada para administrar incidencias de soporte técnico utilizando tecnologías modernas y servicios en la nube.

El proyecto integra React, Firebase Authentication, Cloud Firestore, GitHub Actions y Render, permitiendo construir una solución basada en una arquitectura serverless y una base de datos NoSQL documental.

Además de gestionar tickets, se busca garantizar la trazabilidad de las operaciones, establecer permisos según el tipo de usuario y plantear mecanismos de respaldo que contribuyan a proteger la información almacenada.

En este artículo se presenta el funcionamiento de la plataforma, su arquitectura, el almacenamiento de datos, las funcionalidades implementadas y los principales aprendizajes obtenidos durante su desarrollo.

2. Problemática identificada

Uno de los principales inconvenientes en la gestión de soporte técnico es la falta de organización y seguimiento de las solicitudes.

Cuando los incidentes se comunican mediante mensajes, llamadas o correos electrónicos, pueden presentarse dificultades como:

  • Pérdida de información sobre problemas reportados.
  • Falta de responsables para atender las solicitudes.
  • Dificultad para conocer el estado de una incidencia.
  • Ausencia de un historial de las acciones realizadas.
  • Limitaciones para generar reportes y evaluar el trabajo realizado.

Frente a estos problemas, HelpDesk Cloud propone centralizar las solicitudes de soporte en una plataforma que permita administrar cada incidencia desde su registro hasta su cierre.

De esta manera, los usuarios pueden realizar un seguimiento de sus solicitudes, mientras que los técnicos y administradores cuentan con herramientas para organizar y supervisar el proceso de atención.

3. Tecnologías utilizadas

Para desarrollar la plataforma se seleccionaron herramientas que permiten integrar una interfaz moderna con servicios de almacenamiento y autenticación en la nube.

Tecnología Función
React 19 Desarrollo de la interfaz web
Vite Entorno de desarrollo y compilación
Tailwind CSS Diseño visual y adaptable
Cloud Firestore Almacenamiento de información NoSQL
Firebase Authentication Autenticación de usuarios
GitHub Repositorio y control de versiones
GitHub Actions Automatización de pruebas y despliegues
Render Publicación de la aplicación
Vitest Ejecución de pruebas unitarias

Una de las decisiones importantes fue utilizar Cloud Firestore, ya que permite almacenar información mediante documentos y colecciones sin depender de estructuras rígidas de tablas.

Esta característica resulta adecuada para un sistema de incidencias, donde cada solicitud contiene información sobre su categoría, prioridad, responsable, estado e historial.

4. Arquitectura de HelpDesk Cloud

HelpDesk Cloud utiliza una arquitectura basada en servicios administrados, evitando la necesidad de desarrollar y mantener un servidor backend tradicional.

La aplicación se divide en tres componentes principales:

Interfaz de usuario: desarrollada con React y Tailwind CSS, permite interactuar con los diferentes módulos del sistema desde un navegador.

Servicios de Firebase: Firebase Authentication administra el inicio de sesión, mientras que Cloud Firestore almacena los perfiles de los usuarios, los tickets y sus respectivos historiales.

Infraestructura de despliegue: GitHub Actions automatiza las verificaciones del código y Render permite publicar la aplicación web.

El funcionamiento general puede representarse de la siguiente manera:

       USUARIO / TÉCNICO / ADMINISTRADOR
                      |
                      v
            APLICACIÓN WEB REACT
               Vite + Tailwind
                      |
                      v
               FIREBASE SDK
                      |
          +-----------+-----------+
          |                       |
          v                       v
  Firebase Authentication   Cloud Firestore
     Inicio de sesión       Base de datos NoSQL
                                  |
                                  v
                         Tickets e historial
Enter fullscreen mode Exit fullscreen mode

Gracias a esta arquitectura, la aplicación puede comunicarse directamente con los servicios de Firebase. El acceso a la información se controla mediante las reglas de seguridad de Firestore.

5. Funcionalidades principales del sistema

Una de las características más importantes de HelpDesk Cloud es la organización de sus funcionalidades según el rol del usuario.

La plataforma contempla tres tipos de perfiles:

Usuario

Representa a la persona que necesita asistencia técnica.

Puede registrarse, iniciar sesión, crear incidencias, consultar sus solicitudes, revisar los cambios realizados y agregar comentarios.

Al registrar un ticket, debe proporcionar información que permita identificar correctamente el problema.

Técnico

Es el encargado de atender las incidencias asignadas por el administrador.

Puede consultar sus tickets, actualizar su estado y registrar comentarios relacionados con la atención o solución aplicada.

Su participación permite mantener informados a los usuarios sobre el avance de sus solicitudes.

Administrador

Tiene una visión general de las incidencias registradas en el sistema.

Puede supervisar los tickets, asignarlos a técnicos, gestionar los roles de los usuarios y consultar los reportes disponibles.

Esta separación permite organizar las responsabilidades y controlar el acceso a las diferentes funcionalidades.

6. Ciclo de vida de una incidencia

Cada ticket registrado en HelpDesk Cloud sigue un proceso que permite identificar en qué etapa se encuentra.

Los estados principales son:

Pendiente → En proceso → Resuelto → Cerrado

El funcionamiento puede comprenderse mediante un ejemplo práctico.

Paso 1. Registro del problema

Un usuario detecta una falla en su computadora y crea una incidencia indicando el título, la descripción, la categoría y la prioridad.

El sistema registra el ticket en Firestore con el estado inicial pendiente.

Paso 2. Asignación del responsable

El administrador revisa la solicitud y selecciona al técnico encargado de atenderla.

La asignación también queda registrada en el historial de la incidencia.

Paso 3. Atención técnica

El técnico consulta el ticket y cambia su estado a en_proceso, indicando que ha iniciado las actividades correspondientes.

Paso 4. Resolución

Una vez atendido el problema, el técnico registra la información de la solución y actualiza el estado a resuelto.

Paso 5. Cierre

El usuario puede revisar el resultado y cerrar la incidencia. También se contempla la posibilidad de devolver una solicitud resuelta al estado en_proceso cuando necesita atención adicional.

Este flujo permite tener mayor claridad sobre las responsabilidades y conservar un registro de las acciones efectuadas durante la atención.

7. Implementación de la base de datos NoSQL

El almacenamiento de información constituye una parte fundamental del proyecto.

Para ello se utiliza Google Cloud Firestore, una base de datos NoSQL orientada a documentos.

A diferencia de una base relacional, los datos se organizan mediante colecciones que contienen documentos identificados individualmente.

En HelpDesk Cloud destacan las siguientes estructuras:

Cloud Firestore
|
|-- usuarios
|   |
|   |-- uid_usuario
|       |-- nombre
|       |-- email
|       |-- rol
|       |-- activo
|
|-- tickets
    |
    |-- id_ticket
        |-- titulo
        |-- descripcion
        |-- categoriaId
        |-- prioridad
        |-- estado
        |-- creadoPor
        |-- asignadoA
        |-- fechaCreacion
        |
        |-- historial
            |
            |-- id_evento
                |-- tipo
                |-- autorId
                |-- comentario
                |-- fecha
Enter fullscreen mode Exit fullscreen mode

La colección usuarios permite almacenar los perfiles de las personas que utilizan el sistema.

La colección tickets concentra la información de las incidencias registradas.

Por otro lado, la subcolección historial permite conservar los eventos relacionados con cada ticket, como su creación, asignación, cambio de estado o comentarios.

Importancia del historial

Una ventaja de este diseño es que cada incidencia mantiene su propia secuencia de eventos.

Esto permite conocer quién realizó una acción, qué cambio se produjo y cuándo ocurrió.

Además, el proyecto utiliza escrituras agrupadas mediante writeBatch, lo que permite guardar determinadas operaciones relacionadas de manera atómica.

Por ejemplo, al crear un ticket se registra tanto el documento principal como su primer evento de historial:

const batch = writeBatch(db);

const ticketRef = doc(collection(db, 'tickets'));

batch.set(ticketRef, {
  titulo,
  descripcion,
  categoriaId,
  prioridad,
  estado: 'pendiente',
  creadoPor: user.uid,
  asignadoA: null,
  fechaCreacion: serverTimestamp()
});

const historialRef = doc(
  collection(ticketRef, 'historial')
);

batch.set(historialRef, {
  tipo: 'creacion',
  autorId: user.uid,
  nuevo: 'pendiente',
  fecha: serverTimestamp()
});

await batch.commit();
Enter fullscreen mode Exit fullscreen mode

Este ejemplo simplificado muestra cómo ambas escrituras forman parte de un mismo lote.

Así, se busca evitar que un ticket se registre correctamente mientras su evento inicial queda sin almacenar.

8. Autenticación y seguridad

La seguridad también fue considerada durante el desarrollo de HelpDesk Cloud.

Para administrar el acceso a la plataforma se utiliza Firebase Authentication, que permite iniciar sesión mediante correo electrónico y contraseña.

Después de la autenticación, la aplicación consulta el perfil del usuario para identificar su rol y mostrar las funcionalidades correspondientes.

Adicionalmente, se implementaron reglas de seguridad en Cloud Firestore que controlan las operaciones sobre los documentos.

Entre los controles contemplados se encuentran:

  • Los usuarios pueden consultar los tickets que han creado.
  • Los técnicos acceden a las incidencias que tienen asignadas.
  • Los administradores pueden consultar todas las solicitudes.
  • La asignación de técnicos está reservada a los administradores.
  • Los eventos registrados en el historial no pueden modificarse ni eliminarse mediante las operaciones permitidas por las reglas.

Un aspecto técnico importante fue utilizar getAfter() dentro de las reglas de Firestore para validar operaciones en las que se crean documentos relacionados mediante un mismo lote.

Este mecanismo permite evaluar el estado resultante de la escritura y contribuye a mantener la coherencia entre los tickets y su historial.

9. Reportes y seguimiento de incidencias

HelpDesk Cloud también incorpora un módulo de reportes para facilitar la supervisión de las solicitudes registradas.

El sistema permite visualizar indicadores como:

  • Cantidad total de incidencias.
  • Tickets pendientes.
  • Solicitudes en proceso.
  • Incidencias resueltas y cerradas.
  • Distribución de solicitudes por categoría.
  • Clasificación de tickets según su prioridad.

Estas métricas se obtienen a partir de la información consultada en Firestore y permiten presentar un panorama general de las incidencias accesibles para el usuario.

De esta manera, la información almacenada no solo se utiliza para registrar solicitudes, sino también para apoyar el seguimiento y la toma de decisiones.

10. Estrategia de respaldo y recuperación NoSQL

Un sistema que almacena incidencias debe considerar qué sucedería si se producen eliminaciones accidentales, errores de configuración o problemas que afecten la disponibilidad de la información.

Por esta razón, el proyecto incluye una estrategia de respaldo y recuperación orientada a Cloud Firestore.

El diseño contempla dos mecanismos complementarios.

Recuperación a un punto en el tiempo (PITR)

Point-in-Time Recovery es una funcionalidad de Firestore que permite recuperar información correspondiente a un momento anterior, dentro de una ventana de retención configurada.

La estrategia documentada en el proyecto considera una ventana de siete días para proteger la información frente a modificaciones o eliminaciones accidentales.

Exportaciones hacia Cloud Storage

El segundo mecanismo consiste en generar copias de las colecciones mediante exportaciones administradas de Firestore hacia Google Cloud Storage.

El repositorio incorpora el script scripts/firestore-backup.js, preparado para ejecutar una exportación a través de Google Cloud CLI.

Un ejemplo de ejecución es:

node scripts/firestore-backup.js \
  --bucket=gs://mi-bucket-backup
Enter fullscreen mode Exit fullscreen mode

La estrategia propone realizar exportaciones periódicas y conservar copias históricas para disponer de alternativas de recuperación.

Es importante distinguir que el repositorio documenta la estrategia y proporciona el script de exportación; su ejecución real requiere configurar las credenciales, permisos y recursos correspondientes en Google Cloud.

De esta forma, el proyecto incorpora criterios de protección de datos y recuperación ante incidentes como parte de su diseño técnico.

11. Integración y despliegue continuo con CI/CD

Para facilitar el mantenimiento de la aplicación se configuró un flujo de integración y despliegue continuo utilizando GitHub Actions.

El archivo .github/workflows/deploy.yml contiene las instrucciones que permiten automatizar diferentes tareas.

El proceso contempla las siguientes etapas:

  1. Obtener el código actualizado del repositorio.
  2. Preparar el entorno de ejecución con Node.js 22.
  3. Instalar las dependencias del proyecto.
  4. Ejecutar las pruebas unitarias utilizando Vitest.
  5. Compilar la aplicación mediante Vite.
  6. Solicitar el despliegue en Render cuando corresponde y está configurado el mecanismo de publicación.

El flujo se activa al realizar cambios en la rama principal y también ejecuta verificaciones ante solicitudes de integración hacia dicha rama.

Esto permite detectar problemas durante el desarrollo y evitar que se continúe con la publicación cuando una etapa anterior presenta errores.

Ejecuciones del pipeline CI/CD en GitHub Actions

La publicación de la aplicación se realiza mediante Render, utilizando la configuración establecida en render.yaml.

Como resultado, el sistema puede consultarse públicamente a través de internet.

Aplicación web: https://helpdesk-cloud.onrender.com

12. Pruebas y aprendizajes obtenidos

Durante el desarrollo del proyecto se incorporaron pruebas unitarias con Vitest para comprobar diferentes reglas de funcionamiento.

Las pruebas incluyen validaciones de correo electrónico, contraseñas, formularios de incidencias y cambios de estado según el rol del usuario.

También se definieron comprobaciones sobre parámetros de la estrategia de respaldo.

Entre los principales aprendizajes destacan los siguientes:

Modelado de datos: comprender la organización documental de Firestore permitió representar las incidencias y sus historiales mediante colecciones y subcolecciones.

Control de acceso: se identificó la importancia de implementar reglas de seguridad en la base de datos, además de las restricciones de la interfaz.

Consistencia de información: las escrituras por lotes ayudaron a relacionar los cambios realizados en los tickets con sus eventos de auditoría.

Automatización: GitHub Actions permitió integrar verificaciones del código dentro del proceso de desarrollo y publicación.

Protección de información: el diseño de la estrategia de respaldo permitió considerar escenarios de pérdida de datos y procedimientos de recuperación.

Estos aspectos contribuyeron a comprender que una aplicación no solo debe ofrecer funcionalidades, sino también mecanismos para administrar sus datos de manera organizada y segura.

13. Conclusiones

El desarrollo de HelpDesk Cloud permitió aplicar conocimientos relacionados con bases de datos NoSQL, aplicaciones web, servicios en la nube y automatización de procesos.

La utilización de Cloud Firestore facilitó la construcción de un modelo documental para gestionar incidencias, mientras que Firebase Authentication permitió incorporar autenticación de usuarios.

La implementación de diferentes roles y el registro de eventos proporcionaron una estructura para organizar el trabajo de soporte y conservar la trazabilidad de los tickets.

Asimismo, la integración de GitHub Actions y Render permitió establecer un procedimiento de verificación y publicación de la aplicación.

Finalmente, el proyecto demuestra la importancia de considerar la seguridad, la consistencia de los datos y las estrategias de recuperación desde las primeras etapas del desarrollo.

HelpDesk Cloud representa una aplicación práctica de tecnologías cloud y NoSQL para resolver necesidades de seguimiento y administración de incidencias de soporte técnico.


14. Enlaces del proyecto

Repositorio de GitHub:

https://github.com/Stevien04/HelpDesk-Cloud

Aplicación desplegada:

https://helpdesk-cloud.onrender.com

Video demostrativo:

https://www.youtube.com/watch?v=ChbUKJrGsBg

Top comments (0)