<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: SOANNY GERALDINE RIVAS GUTIERREZ</title>
    <description>The latest articles on DEV Community by SOANNY GERALDINE RIVAS GUTIERREZ (@soanny_geraldinerivasgu).</description>
    <link>https://dev.to/soanny_geraldinerivasgu</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4160871%2Fa8c6305e-c944-430c-86c3-a81aaa403272.png</url>
      <title>DEV Community: SOANNY GERALDINE RIVAS GUTIERREZ</title>
      <link>https://dev.to/soanny_geraldinerivasgu</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/soanny_geraldinerivasgu"/>
    <language>en</language>
    <item>
      <title>SmartInventory: Sistema de control de inventarios con Couchbase, React y tecnología NoSQL</title>
      <dc:creator>SOANNY GERALDINE RIVAS GUTIERREZ</dc:creator>
      <pubDate>Sun, 15 Nov 2026 03:14:26 +0000</pubDate>
      <link>https://dev.to/soanny_geraldinerivasgu/smartinventory-sistema-de-control-de-inventarios-con-couchbase-react-y-tecnologia-nosql-567k</link>
      <guid>https://dev.to/soanny_geraldinerivasgu/smartinventory-sistema-de-control-de-inventarios-con-couchbase-react-y-tecnologia-nosql-567k</guid>
      <description>&lt;p&gt;&lt;strong&gt;Autor:&lt;/strong&gt; Soanny Geraldine Rivas Gutierrez, Stevie Marca Aguilar&lt;br&gt;
&lt;strong&gt;Fecha:&lt;/strong&gt; 10 noviembre de 2026&lt;/p&gt;
&lt;h2&gt;
  
  
  1. Introducción
&lt;/h2&gt;

&lt;p&gt;Una adecuada administración de inventarios es fundamental para mantener el control de los productos y evitar pérdidas ocasionadas por errores en los registros.&lt;/p&gt;

&lt;p&gt;Con este propósito desarrollamos &lt;strong&gt;SmartInventory&lt;/strong&gt;, una aplicación web que permite gestionar productos, supervisar existencias y registrar movimientos de almacén de manera organizada.&lt;/p&gt;

&lt;p&gt;El sistema utiliza &lt;strong&gt;Couchbase Capella&lt;/strong&gt; como base de datos NoSQL en la nube, junto con React, Node.js y Express. También incorpora herramientas de automatización para facilitar las pruebas y el despliegue de la aplicación.&lt;/p&gt;
&lt;h2&gt;
  
  
  2. Objetivo del proyecto
&lt;/h2&gt;

&lt;p&gt;SmartInventory busca optimizar el seguimiento de inventarios mediante una plataforma que centraliza la información de productos, proveedores y movimientos.&lt;/p&gt;

&lt;p&gt;Entre sus principales objetivos se encuentran:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Administrar productos, categorías y proveedores.&lt;/li&gt;
&lt;li&gt;Registrar entradas, salidas y ajustes de inventario.&lt;/li&gt;
&lt;li&gt;Evitar movimientos que generen existencias negativas.&lt;/li&gt;
&lt;li&gt;Identificar productos con niveles bajos de stock.&lt;/li&gt;
&lt;li&gt;Consultar indicadores y reportes.&lt;/li&gt;
&lt;li&gt;Mantener un historial de los movimientos realizados.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;
  
  
  3. Herramientas y tecnologías utilizadas
&lt;/h2&gt;

&lt;p&gt;Para implementar la aplicación se utilizaron las siguientes tecnologías:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Tecnología&lt;/th&gt;
&lt;th&gt;Utilidad&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;React 18&lt;/td&gt;
&lt;td&gt;Interfaz de usuario&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Tailwind CSS&lt;/td&gt;
&lt;td&gt;Diseño visual&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Node.js y Express&lt;/td&gt;
&lt;td&gt;Desarrollo de la API REST&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Couchbase Capella&lt;/td&gt;
&lt;td&gt;Base de datos NoSQL&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;JWT&lt;/td&gt;
&lt;td&gt;Autenticación&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GitHub Actions&lt;/td&gt;
&lt;td&gt;Automatización CI/CD&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Render&lt;/td&gt;
&lt;td&gt;Despliegue en la nube&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;La combinación de estas herramientas permite separar la interfaz, la lógica de negocio y el almacenamiento de información.&lt;/p&gt;
&lt;h2&gt;
  
  
  4. Funcionamiento de SmartInventory
&lt;/h2&gt;

&lt;p&gt;La plataforma dispone de diferentes módulos para facilitar la gestión del almacén.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Panel principal:&lt;/strong&gt; presenta indicadores sobre productos activos, unidades disponibles, movimientos recientes y alertas.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Productos:&lt;/strong&gt; permite registrar, consultar, modificar y desactivar artículos.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Categorías y proveedores:&lt;/strong&gt; facilita la organización del catálogo y la administración de los proveedores.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Movimientos:&lt;/strong&gt; registra las entradas, salidas y ajustes, manteniendo información sobre las cantidades y los responsables.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Alertas:&lt;/strong&gt; identifica automáticamente productos agotados o con existencias inferiores al mínimo establecido.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Reportes:&lt;/strong&gt; permite consultar información relacionada con las existencias y los movimientos registrados.&lt;/p&gt;

&lt;p&gt;Además, se contemplan los roles de administrador y almacenero, con permisos diferentes según sus responsabilidades.&lt;/p&gt;
&lt;h2&gt;
  
  
  5. Almacenamiento con Couchbase Capella
&lt;/h2&gt;

&lt;p&gt;Uno de los componentes más importantes del proyecto es la implementación de &lt;strong&gt;Couchbase Capella&lt;/strong&gt;, una base de datos NoSQL que almacena información mediante documentos JSON.&lt;/p&gt;

&lt;p&gt;La estructura principal está organizada de la siguiente manera:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Couchbase Capella
│
└── Bucket: smartinventory
    │
    └── Scope: inventario
        │
        ├── usuarios
        ├── productos
        ├── categorias
        ├── proveedores
        └── movimientos
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Cada producto contiene información como nombre, código, precio, cantidad disponible y stock mínimo.&lt;/p&gt;

&lt;p&gt;Por ejemplo:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"PROD-001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"nombre"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Teclado Mecánico"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"precioVenta"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;79.90&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"stockActual"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;15&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"stockMinimo"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"estado"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ACTIVO"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Couchbase también permite utilizar &lt;strong&gt;SQL++&lt;/strong&gt; para consultar y filtrar documentos JSON, facilitando la recuperación de información.&lt;/p&gt;

&lt;h2&gt;
  
  
  6. Control de stock y seguridad
&lt;/h2&gt;

&lt;p&gt;Una característica importante de SmartInventory es la validación de los movimientos de inventario.&lt;/p&gt;

&lt;p&gt;Cuando se registra una salida, el sistema verifica que exista suficiente cantidad disponible.&lt;/p&gt;

&lt;p&gt;Por ejemplo, si un producto tiene 10 unidades y se solicita retirar 15, la operación se rechaza para evitar que el inventario quede en negativo.&lt;/p&gt;

&lt;p&gt;También se utilizan &lt;strong&gt;transacciones ACID&lt;/strong&gt;, que permiten actualizar las existencias y registrar el movimiento como una operación conjunta.&lt;/p&gt;

&lt;p&gt;El proyecto incorpora mecanismos para manejar conflictos cuando varios usuarios intentan modificar simultáneamente el stock de un mismo producto.&lt;/p&gt;

&lt;p&gt;Para la seguridad se utiliza autenticación mediante JWT, contraseñas protegidas con bcrypt y restricciones de acceso según el rol.&lt;/p&gt;

&lt;h2&gt;
  
  
  7. Automatización y publicación en la nube
&lt;/h2&gt;

&lt;p&gt;SmartInventory integra un flujo de &lt;strong&gt;CI/CD mediante GitHub Actions&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Este proceso permite ejecutar pruebas automáticas y compilar el proyecto cuando se realizan cambios en el repositorio.&lt;/p&gt;

&lt;p&gt;Si las verificaciones terminan correctamente, el flujo puede activar el despliegue en Render mediante los mecanismos configurados.&lt;/p&gt;

&lt;p&gt;La plataforma dispone de dos servicios principales:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Frontend:&lt;/strong&gt; aplicación React publicada como sitio web.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Backend:&lt;/strong&gt; API REST desarrollada con Node.js y Express.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;El backend se comunica con Couchbase Capella para consultar y actualizar la información del inventario.&lt;/p&gt;

&lt;h2&gt;
  
  
  8. Resultados y aprendizajes
&lt;/h2&gt;

&lt;p&gt;El desarrollo de SmartInventory permitió aplicar conocimientos sobre bases de datos NoSQL, arquitectura web, consultas SQL++, seguridad y automatización.&lt;/p&gt;

&lt;p&gt;Uno de los aprendizajes más importantes fue comprender cómo mantener la consistencia de las existencias cuando varios usuarios registran movimientos al mismo tiempo.&lt;/p&gt;

&lt;p&gt;Asimismo, la integración con servicios en la nube permitió conocer el proceso de publicación de una aplicación full stack.&lt;/p&gt;

&lt;h2&gt;
  
  
  9. Conclusiones
&lt;/h2&gt;

&lt;p&gt;SmartInventory demuestra cómo las tecnologías NoSQL pueden utilizarse para desarrollar soluciones prácticas de administración de inventarios.&lt;/p&gt;

&lt;p&gt;El uso de Couchbase Capella facilita el almacenamiento documental, mientras que las transacciones contribuyen a mantener la integridad de las operaciones.&lt;/p&gt;

&lt;p&gt;La implementación de React, Node.js, GitHub Actions y Render permitió integrar el desarrollo frontend, backend y despliegue dentro de un mismo proyecto.&lt;/p&gt;

&lt;p&gt;En conjunto, &lt;strong&gt;SmartInventory constituye una solución funcional para gestionar productos, controlar existencias y supervisar movimientos de almacén utilizando tecnologías modernas.&lt;/strong&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  10. Enlaces del proyecto
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Repositorio GitHub:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;a href="https://github.com/Stevien04/SmartInventory" rel="noopener noreferrer"&gt;https://github.com/Stevien04/SmartInventory&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Aplicación desplegada:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;a href="https://smartinventory-app.onrender.com" rel="noopener noreferrer"&gt;https://smartinventory-app.onrender.com&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;API del sistema:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;a href="https://smartinventory-api-29jb.onrender.com/api/health" rel="noopener noreferrer"&gt;https://smartinventory-api-29jb.onrender.com/api/health&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Video demostrativo:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;a href="https://youtu.be/g1ksH2ASxBw" rel="noopener noreferrer"&gt;https://youtu.be/g1ksH2ASxBw&lt;/a&gt;&lt;/p&gt;

</description>
      <category>cloud</category>
      <category>database</category>
      <category>node</category>
      <category>react</category>
    </item>
    <item>
      <title>HelpDesk Cloud: Gestión inteligente de incidencias con Firebase, bases de datos NoSQL y automatización CI/CD</title>
      <dc:creator>SOANNY GERALDINE RIVAS GUTIERREZ</dc:creator>
      <pubDate>Sun, 15 Nov 2026 02:40:07 +0000</pubDate>
      <link>https://dev.to/soanny_geraldinerivasgu/helpdesk-cloud-gestion-inteligente-de-incidencias-con-firebase-bases-de-datos-nosql-y-15h6</link>
      <guid>https://dev.to/soanny_geraldinerivasgu/helpdesk-cloud-gestion-inteligente-de-incidencias-con-firebase-bases-de-datos-nosql-y-15h6</guid>
      <description>&lt;p&gt;&lt;strong&gt;Autor:&lt;/strong&gt; Soanny Geraldine Rivas Gutierrez, Stevie Marca Aguilar&lt;br&gt;
&lt;strong&gt;Fecha:&lt;/strong&gt; 10 noviembre de 2026&lt;/p&gt;
&lt;h2&gt;
  
  
  1. Introducción
&lt;/h2&gt;

&lt;p&gt;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.&lt;/p&gt;

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

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

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;
&lt;h2&gt;
  
  
  2. Problemática identificada
&lt;/h2&gt;

&lt;p&gt;Uno de los principales inconvenientes en la gestión de soporte técnico es la falta de organización y seguimiento de las solicitudes.&lt;/p&gt;

&lt;p&gt;Cuando los incidentes se comunican mediante mensajes, llamadas o correos electrónicos, pueden presentarse dificultades como:&lt;/p&gt;

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

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;
&lt;h2&gt;
  
  
  3. Tecnologías utilizadas
&lt;/h2&gt;

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

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Tecnología&lt;/th&gt;
&lt;th&gt;Función&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;React 19&lt;/td&gt;
&lt;td&gt;Desarrollo de la interfaz web&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Vite&lt;/td&gt;
&lt;td&gt;Entorno de desarrollo y compilación&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Tailwind CSS&lt;/td&gt;
&lt;td&gt;Diseño visual y adaptable&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Cloud Firestore&lt;/td&gt;
&lt;td&gt;Almacenamiento de información NoSQL&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Firebase Authentication&lt;/td&gt;
&lt;td&gt;Autenticación de usuarios&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GitHub&lt;/td&gt;
&lt;td&gt;Repositorio y control de versiones&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GitHub Actions&lt;/td&gt;
&lt;td&gt;Automatización de pruebas y despliegues&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Render&lt;/td&gt;
&lt;td&gt;Publicación de la aplicación&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Vitest&lt;/td&gt;
&lt;td&gt;Ejecución de pruebas unitarias&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;
&lt;h2&gt;
  
  
  4. Arquitectura de HelpDesk Cloud
&lt;/h2&gt;

&lt;p&gt;HelpDesk Cloud utiliza una arquitectura basada en servicios administrados, evitando la necesidad de desarrollar y mantener un servidor backend tradicional.&lt;/p&gt;

&lt;p&gt;La aplicación se divide en tres componentes principales:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Interfaz de usuario:&lt;/strong&gt; desarrollada con React y Tailwind CSS, permite interactuar con los diferentes módulos del sistema desde un navegador.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Servicios de Firebase:&lt;/strong&gt; Firebase Authentication administra el inicio de sesión, mientras que Cloud Firestore almacena los perfiles de los usuarios, los tickets y sus respectivos historiales.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Infraestructura de despliegue:&lt;/strong&gt; GitHub Actions automatiza las verificaciones del código y Render permite publicar la aplicación web.&lt;/p&gt;

&lt;p&gt;El funcionamiento general puede representarse de la siguiente manera:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;       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
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;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.&lt;/p&gt;

&lt;h2&gt;
  
  
  5. Funcionalidades principales del sistema
&lt;/h2&gt;

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

&lt;p&gt;La plataforma contempla tres tipos de perfiles:&lt;/p&gt;

&lt;h3&gt;
  
  
  Usuario
&lt;/h3&gt;

&lt;p&gt;Representa a la persona que necesita asistencia técnica.&lt;/p&gt;

&lt;p&gt;Puede registrarse, iniciar sesión, crear incidencias, consultar sus solicitudes, revisar los cambios realizados y agregar comentarios.&lt;/p&gt;

&lt;p&gt;Al registrar un ticket, debe proporcionar información que permita identificar correctamente el problema.&lt;/p&gt;

&lt;h3&gt;
  
  
  Técnico
&lt;/h3&gt;

&lt;p&gt;Es el encargado de atender las incidencias asignadas por el administrador.&lt;/p&gt;

&lt;p&gt;Puede consultar sus tickets, actualizar su estado y registrar comentarios relacionados con la atención o solución aplicada.&lt;/p&gt;

&lt;p&gt;Su participación permite mantener informados a los usuarios sobre el avance de sus solicitudes.&lt;/p&gt;

&lt;h3&gt;
  
  
  Administrador
&lt;/h3&gt;

&lt;p&gt;Tiene una visión general de las incidencias registradas en el sistema.&lt;/p&gt;

&lt;p&gt;Puede supervisar los tickets, asignarlos a técnicos, gestionar los roles de los usuarios y consultar los reportes disponibles.&lt;/p&gt;

&lt;p&gt;Esta separación permite organizar las responsabilidades y controlar el acceso a las diferentes funcionalidades.&lt;/p&gt;

&lt;h2&gt;
  
  
  6. Ciclo de vida de una incidencia
&lt;/h2&gt;

&lt;p&gt;Cada ticket registrado en HelpDesk Cloud sigue un proceso que permite identificar en qué etapa se encuentra.&lt;/p&gt;

&lt;p&gt;Los estados principales son:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Pendiente → En proceso → Resuelto → Cerrado&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;El funcionamiento puede comprenderse mediante un ejemplo práctico.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Paso 1. Registro del problema&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;El sistema registra el ticket en Firestore con el estado inicial &lt;code&gt;pendiente&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Paso 2. Asignación del responsable&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;El administrador revisa la solicitud y selecciona al técnico encargado de atenderla.&lt;/p&gt;

&lt;p&gt;La asignación también queda registrada en el historial de la incidencia.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Paso 3. Atención técnica&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;El técnico consulta el ticket y cambia su estado a &lt;code&gt;en_proceso&lt;/code&gt;, indicando que ha iniciado las actividades correspondientes.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Paso 4. Resolución&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Una vez atendido el problema, el técnico registra la información de la solución y actualiza el estado a &lt;code&gt;resuelto&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Paso 5. Cierre&lt;/strong&gt;&lt;/p&gt;

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

&lt;p&gt;Este flujo permite tener mayor claridad sobre las responsabilidades y conservar un registro de las acciones efectuadas durante la atención.&lt;/p&gt;

&lt;h2&gt;
  
  
  7. Implementación de la base de datos NoSQL
&lt;/h2&gt;

&lt;p&gt;El almacenamiento de información constituye una parte fundamental del proyecto.&lt;/p&gt;

&lt;p&gt;Para ello se utiliza &lt;strong&gt;Google Cloud Firestore&lt;/strong&gt;, una base de datos NoSQL orientada a documentos.&lt;/p&gt;

&lt;p&gt;A diferencia de una base relacional, los datos se organizan mediante colecciones que contienen documentos identificados individualmente.&lt;/p&gt;

&lt;p&gt;En HelpDesk Cloud destacan las siguientes estructuras:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;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
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La colección &lt;code&gt;usuarios&lt;/code&gt; permite almacenar los perfiles de las personas que utilizan el sistema.&lt;/p&gt;

&lt;p&gt;La colección &lt;code&gt;tickets&lt;/code&gt; concentra la información de las incidencias registradas.&lt;/p&gt;

&lt;p&gt;Por otro lado, la subcolección &lt;code&gt;historial&lt;/code&gt; permite conservar los eventos relacionados con cada ticket, como su creación, asignación, cambio de estado o comentarios.&lt;/p&gt;

&lt;h3&gt;
  
  
  Importancia del historial
&lt;/h3&gt;

&lt;p&gt;Una ventaja de este diseño es que cada incidencia mantiene su propia secuencia de eventos.&lt;/p&gt;

&lt;p&gt;Esto permite conocer quién realizó una acción, qué cambio se produjo y cuándo ocurrió.&lt;/p&gt;

&lt;p&gt;Además, el proyecto utiliza escrituras agrupadas mediante &lt;code&gt;writeBatch&lt;/code&gt;, lo que permite guardar determinadas operaciones relacionadas de manera atómica.&lt;/p&gt;

&lt;p&gt;Por ejemplo, al crear un ticket se registra tanto el documento principal como su primer evento de historial:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;batch&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;writeBatch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;ticketRef&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;collection&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'tickets'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;batch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;set&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;ticketRef&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;titulo&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;descripcion&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;categoriaId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;prioridad&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;estado&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'pendiente'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;creadoPor&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;user&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;uid&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;asignadoA&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;fechaCreacion&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;serverTimestamp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;historialRef&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
  &lt;span class="nf"&gt;collection&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;ticketRef&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'historial'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;batch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;set&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;historialRef&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;tipo&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'creacion'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;autorId&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;user&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;uid&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;nuevo&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'pendiente'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;fecha&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;serverTimestamp&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;batch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;commit&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Este ejemplo simplificado muestra cómo ambas escrituras forman parte de un mismo lote.&lt;/p&gt;

&lt;p&gt;Así, se busca evitar que un ticket se registre correctamente mientras su evento inicial queda sin almacenar.&lt;/p&gt;

&lt;h2&gt;
  
  
  8. Autenticación y seguridad
&lt;/h2&gt;

&lt;p&gt;La seguridad también fue considerada durante el desarrollo de HelpDesk Cloud.&lt;/p&gt;

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

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

&lt;p&gt;Adicionalmente, se implementaron reglas de seguridad en Cloud Firestore que controlan las operaciones sobre los documentos.&lt;/p&gt;

&lt;p&gt;Entre los controles contemplados se encuentran:&lt;/p&gt;

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

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

&lt;p&gt;Este mecanismo permite evaluar el estado resultante de la escritura y contribuye a mantener la coherencia entre los tickets y su historial.&lt;/p&gt;

&lt;h2&gt;
  
  
  9. Reportes y seguimiento de incidencias
&lt;/h2&gt;

&lt;p&gt;HelpDesk Cloud también incorpora un módulo de reportes para facilitar la supervisión de las solicitudes registradas.&lt;/p&gt;

&lt;p&gt;El sistema permite visualizar indicadores como:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Cantidad total de incidencias.&lt;/li&gt;
&lt;li&gt;Tickets pendientes.&lt;/li&gt;
&lt;li&gt;Solicitudes en proceso.&lt;/li&gt;
&lt;li&gt;Incidencias resueltas y cerradas.&lt;/li&gt;
&lt;li&gt;Distribución de solicitudes por categoría.&lt;/li&gt;
&lt;li&gt;Clasificación de tickets según su prioridad.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;h2&gt;
  
  
  10. Estrategia de respaldo y recuperación NoSQL
&lt;/h2&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;Por esta razón, el proyecto incluye una estrategia de respaldo y recuperación orientada a Cloud Firestore.&lt;/p&gt;

&lt;p&gt;El diseño contempla dos mecanismos complementarios.&lt;/p&gt;

&lt;h3&gt;
  
  
  Recuperación a un punto en el tiempo (PITR)
&lt;/h3&gt;

&lt;p&gt;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.&lt;/p&gt;

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

&lt;h3&gt;
  
  
  Exportaciones hacia Cloud Storage
&lt;/h3&gt;

&lt;p&gt;El segundo mecanismo consiste en generar copias de las colecciones mediante exportaciones administradas de Firestore hacia Google Cloud Storage.&lt;/p&gt;

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

&lt;p&gt;Un ejemplo de ejecución es:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;node scripts/firestore-backup.js \
  --bucket=gs://mi-bucket-backup
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La estrategia propone realizar exportaciones periódicas y conservar copias históricas para disponer de alternativas de recuperación.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;h2&gt;
  
  
  11. Integración y despliegue continuo con CI/CD
&lt;/h2&gt;

&lt;p&gt;Para facilitar el mantenimiento de la aplicación se configuró un flujo de integración y despliegue continuo utilizando GitHub Actions.&lt;/p&gt;

&lt;p&gt;El archivo &lt;code&gt;.github/workflows/deploy.yml&lt;/code&gt; contiene las instrucciones que permiten automatizar diferentes tareas.&lt;/p&gt;

&lt;p&gt;El proceso contempla las siguientes etapas:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Obtener el código actualizado del repositorio.&lt;/li&gt;
&lt;li&gt;Preparar el entorno de ejecución con Node.js 22.&lt;/li&gt;
&lt;li&gt;Instalar las dependencias del proyecto.&lt;/li&gt;
&lt;li&gt;Ejecutar las pruebas unitarias utilizando Vitest.&lt;/li&gt;
&lt;li&gt;Compilar la aplicación mediante Vite.&lt;/li&gt;
&lt;li&gt;Solicitar el despliegue en Render cuando corresponde y está configurado el mecanismo de publicación.&lt;/li&gt;
&lt;/ol&gt;

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

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

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F459aqt08ayk7ghn80cv8.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F459aqt08ayk7ghn80cv8.png" alt="Ejecuciones del pipeline CI/CD en GitHub Actions" width="800" height="500"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;La publicación de la aplicación se realiza mediante Render, utilizando la configuración establecida en &lt;code&gt;render.yaml&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Como resultado, el sistema puede consultarse públicamente a través de internet.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Aplicación web:&lt;/strong&gt; &lt;a href="https://helpdesk-cloud.onrender.com" rel="noopener noreferrer"&gt;https://helpdesk-cloud.onrender.com&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  12. Pruebas y aprendizajes obtenidos
&lt;/h2&gt;

&lt;p&gt;Durante el desarrollo del proyecto se incorporaron pruebas unitarias con Vitest para comprobar diferentes reglas de funcionamiento.&lt;/p&gt;

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

&lt;p&gt;También se definieron comprobaciones sobre parámetros de la estrategia de respaldo.&lt;/p&gt;

&lt;p&gt;Entre los principales aprendizajes destacan los siguientes:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Modelado de datos:&lt;/strong&gt; comprender la organización documental de Firestore permitió representar las incidencias y sus historiales mediante colecciones y subcolecciones.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Control de acceso:&lt;/strong&gt; se identificó la importancia de implementar reglas de seguridad en la base de datos, además de las restricciones de la interfaz.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Consistencia de información:&lt;/strong&gt; las escrituras por lotes ayudaron a relacionar los cambios realizados en los tickets con sus eventos de auditoría.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Automatización:&lt;/strong&gt; GitHub Actions permitió integrar verificaciones del código dentro del proceso de desarrollo y publicación.&lt;/p&gt;

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

&lt;p&gt;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.&lt;/p&gt;

&lt;h2&gt;
  
  
  13. Conclusiones
&lt;/h2&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;Asimismo, la integración de GitHub Actions y Render permitió establecer un procedimiento de verificación y publicación de la aplicación.&lt;/p&gt;

&lt;p&gt;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.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;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.&lt;/strong&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  14. Enlaces del proyecto
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Repositorio de GitHub:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;a href="https://github.com/Stevien04/HelpDesk-Cloud" rel="noopener noreferrer"&gt;https://github.com/Stevien04/HelpDesk-Cloud&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Aplicación desplegada:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;a href="https://helpdesk-cloud.onrender.com" rel="noopener noreferrer"&gt;https://helpdesk-cloud.onrender.com&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Video demostrativo:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;a href="https://www.youtube.com/watch?v=ChbUKJrGsBg" rel="noopener noreferrer"&gt;https://www.youtube.com/watch?v=ChbUKJrGsBg&lt;/a&gt;&lt;/p&gt;

</description>
      <category>nosql</category>
      <category>firebase</category>
      <category>devops</category>
      <category>githubactions</category>
    </item>
    <item>
      <title>[Boost]</title>
      <dc:creator>SOANNY GERALDINE RIVAS GUTIERREZ</dc:creator>
      <pubDate>Sun, 15 Nov 2026 02:21:03 +0000</pubDate>
      <link>https://dev.to/soanny_geraldinerivasgu/-4n5p</link>
      <guid>https://dev.to/soanny_geraldinerivasgu/-4n5p</guid>
      <description></description>
    </item>
    <item>
      <title>Respaldo y recuperación de MySQL con Railway, Aiven y GitHub Actions</title>
      <dc:creator>SOANNY GERALDINE RIVAS GUTIERREZ</dc:creator>
      <pubDate>Sun, 04 Oct 2026 06:38:57 +0000</pubDate>
      <link>https://dev.to/soanny_geraldinerivasgu/respaldo-y-recuperacion-de-mysql-con-railway-aiven-y-github-actions-ngi</link>
      <guid>https://dev.to/soanny_geraldinerivasgu/respaldo-y-recuperacion-de-mysql-con-railway-aiven-y-github-actions-ngi</guid>
      <description>&lt;p&gt;#mysql #database #githubactions #backup&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Creado por:&lt;/strong&gt;&lt;br&gt;
Soanny Geraldine Rivas Gutierrez&lt;/p&gt;

&lt;p&gt;En una aplicación de inventario, perder un registro puede alterar el stock disponible y el valor de los productos. Para recuperar esa información hace falta conservar el estado de la base en un momento anterior y comprobar que la copia puede importarse correctamente.&lt;/p&gt;

&lt;p&gt;El repositorio del código permite reconstruir la aplicación; el respaldo permite recuperar sus datos.&lt;/p&gt;

&lt;p&gt;En este proyecto desarrollé un inventario con Node.js, Express y MySQL, junto con scripts de exportación y recuperación. La solución configura copias completas con &lt;code&gt;mysqldump&lt;/code&gt;, las comprime, las cifra y prepara su ejecución diaria con GitHub Actions.&lt;/p&gt;

&lt;p&gt;Para la publicación se plantea alojar la aplicación en Railway y utilizar MySQL administrado en Aiven.&lt;/p&gt;

&lt;p&gt;La validación realizada es local: se utilizó un servidor MySQL real y se recuperaron los registros en una base independiente.&lt;/p&gt;

&lt;p&gt;La configuración del repositorio público, el despliegue en Railway, la conexión a Aiven y las ejecuciones remotas deben completarse desde las cuentas del estudiante antes de presentar sus enlaces como evidencia.&lt;/p&gt;


&lt;h2&gt;
  
  
  Diseño de la solución
&lt;/h2&gt;

&lt;p&gt;La aplicación permite consultar productos, agregar registros y eliminarlos.&lt;/p&gt;

&lt;p&gt;Cada producto tiene:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Identificador&lt;/li&gt;
&lt;li&gt;Nombre&lt;/li&gt;
&lt;li&gt;Precio&lt;/li&gt;
&lt;li&gt;Stock&lt;/li&gt;
&lt;li&gt;Fecha de creación&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Esta información proporciona un conjunto pequeño y verificable para estudiar el comportamiento de un respaldo.&lt;/p&gt;

&lt;p&gt;La siguiente tabla presenta los componentes y responsabilidades de la solución.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fgrc9kbgf4u84ok9na6os.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fgrc9kbgf4u84ok9na6os.png" alt=" " width="636" height="318"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tabla 1. Componentes y responsabilidades de la solución.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;El entorno local sirve para desarrollar y verificar la recuperación.&lt;/p&gt;

&lt;p&gt;En el entorno de nube, la API de Railway se conecta a MySQL en Aiven. GitHub Actions puede conectarse al mismo servicio para generar el respaldo y conservar un artefacto cifrado.&lt;/p&gt;

&lt;p&gt;El código y las copias tienen ciclos de vida diferentes: el código permanece en Git y los artefactos expiran según la retención configurada.&lt;/p&gt;


&lt;h2&gt;
  
  
  Política de respaldo
&lt;/h2&gt;

&lt;p&gt;Se eligió un respaldo lógico completo porque la base es pequeña y su contenido puede revisarse mediante SQL.&lt;/p&gt;

&lt;p&gt;Cada copia incluye la estructura y las filas de la base de demostración.&lt;/p&gt;

&lt;p&gt;No se implementaron respaldos incrementales ni recuperación a un instante arbitrario mediante binlogs.&lt;/p&gt;

&lt;p&gt;La siguiente tabla presenta la política de respaldo y recuperación.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F385fmzu8um2mxqc5wir5.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F385fmzu8um2mxqc5wir5.png" alt=" " width="641" height="290"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tabla 2. Política de respaldo y recuperación.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;La configuración contempla:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Una ejecución diaria.&lt;/li&gt;
&lt;li&gt;Ejecuciones manuales para validación.&lt;/li&gt;
&lt;li&gt;Horario previsto de &lt;code&gt;06:00 UTC&lt;/code&gt;, equivalente a &lt;code&gt;01:00&lt;/code&gt; en Lima.&lt;/li&gt;
&lt;li&gt;Retención de siete días.&lt;/li&gt;
&lt;li&gt;Archivos comprimidos y cifrados con extensión &lt;code&gt;.sql.gz.enc&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Verificación mediante SHA-256.&lt;/li&gt;
&lt;li&gt;Restauración en una base vacía distinta de la original.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Si las ejecuciones diarias terminan correctamente, la pérdida potencial corresponde aproximadamente a los cambios desde la última copia, que puede rondar un día.&lt;/p&gt;

&lt;p&gt;Una ejecución fallida o retrasada amplía ese intervalo.&lt;/p&gt;

&lt;p&gt;El tiempo de recuperación debe medirse con el volumen real de información; no se establece una garantía de RTO para esta demostración.&lt;/p&gt;


&lt;h2&gt;
  
  
  Archivos del proyecto y configuración local
&lt;/h2&gt;

&lt;p&gt;El repositorio &lt;code&gt;mysql-backup-strategy&lt;/code&gt; reúne la aplicación, el esquema SQL y los mecanismos de automatización.&lt;/p&gt;

&lt;p&gt;Los principales archivos del proyecto se presentan en la siguiente tabla.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqder7jejn4fl8zg99afm.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqder7jejn4fl8zg99afm.png" alt=" " width="641" height="349"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tabla 3. Archivos principales del proyecto.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Entre los archivos principales se encuentran:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;src&lt;/code&gt; y &lt;code&gt;public&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;&lt;code&gt;database/database.sql&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;scripts/backup.sh&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;scripts/restore.sh&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;scripts/crypto.js&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;.github/workflows&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Dockerfile&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;docker-compose.yml&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;.env.example&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Para utilizar la ruta de Docker en Windows, se copia la plantilla de variables, se reemplazan las claves y se inicia Docker Desktop con contenedores Linux.&lt;/p&gt;

&lt;p&gt;Los comandos se ejecutan desde la carpeta del proyecto.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="n"&gt;Copy-Item&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;example&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nx"&gt;notepad&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="nx"&gt;docker&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;compose&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;up&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;--build&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-d&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;docker&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;compose&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;ps&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Invoke-RestMethod&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;http://localhost:3000/health&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;MySQL conserva la información en un volumen.&lt;/p&gt;

&lt;p&gt;Las variables:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;MYSQL_DATABASE
MYSQL_USER
MYSQL_PASSWORD
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;inicializan un volumen nuevo.&lt;/p&gt;

&lt;p&gt;Modificar el archivo de variables después no cambia automáticamente las cuentas ya creadas.&lt;/p&gt;

&lt;p&gt;La aplicación utiliza las variables:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;DB_HOST
DB_PORT
DB_USER
DB_PASSWORD
DB_NAME
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;para establecer la conexión.&lt;/p&gt;

&lt;p&gt;En el laboratorio se permite:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;DB_SSL=false
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;dentro del entorno local.&lt;/p&gt;

&lt;p&gt;Para conectar con Aiven se utiliza:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;DB_SSL=true
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;junto con el certificado CA del servicio.&lt;/p&gt;

&lt;p&gt;El proyecto verifica tanto la confianza del certificado como la identidad del servidor.&lt;/p&gt;




&lt;h2&gt;
  
  
  Modelo de datos y aplicación Node
&lt;/h2&gt;

&lt;p&gt;La tabla de demostración utiliza InnoDB, precios decimales y valores de stock no negativos.&lt;/p&gt;

&lt;p&gt;El script se ejecuta dentro de una base existente, por lo que no fija el nombre de la base mediante &lt;code&gt;USE&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Esto facilita recuperar la información en un destino distinto.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight sql"&gt;&lt;code&gt;&lt;span class="k"&gt;CREATE&lt;/span&gt; &lt;span class="k"&gt;TABLE&lt;/span&gt; &lt;span class="n"&gt;IF&lt;/span&gt; &lt;span class="k"&gt;NOT&lt;/span&gt; &lt;span class="k"&gt;EXISTS&lt;/span&gt; &lt;span class="n"&gt;productos&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
  &lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="nb"&gt;INT&lt;/span&gt; &lt;span class="nb"&gt;UNSIGNED&lt;/span&gt; &lt;span class="k"&gt;NOT&lt;/span&gt; &lt;span class="k"&gt;NULL&lt;/span&gt; &lt;span class="n"&gt;AUTO_INCREMENT&lt;/span&gt; &lt;span class="k"&gt;PRIMARY&lt;/span&gt; &lt;span class="k"&gt;KEY&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;nombre&lt;/span&gt; &lt;span class="nb"&gt;VARCHAR&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;100&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;NOT&lt;/span&gt; &lt;span class="k"&gt;NULL&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;precio&lt;/span&gt; &lt;span class="nb"&gt;DECIMAL&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;NOT&lt;/span&gt; &lt;span class="k"&gt;NULL&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;stock&lt;/span&gt; &lt;span class="nb"&gt;INT&lt;/span&gt; &lt;span class="nb"&gt;UNSIGNED&lt;/span&gt; &lt;span class="k"&gt;NOT&lt;/span&gt; &lt;span class="k"&gt;NULL&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;fecha_creacion&lt;/span&gt; &lt;span class="nb"&gt;TIMESTAMP&lt;/span&gt; &lt;span class="k"&gt;NOT&lt;/span&gt; &lt;span class="k"&gt;NULL&lt;/span&gt; &lt;span class="k"&gt;DEFAULT&lt;/span&gt; &lt;span class="k"&gt;CURRENT_TIMESTAMP&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="k"&gt;CONSTRAINT&lt;/span&gt; &lt;span class="n"&gt;precio_no_negativo&lt;/span&gt; &lt;span class="k"&gt;CHECK&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;precio&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="n"&gt;ENGINE&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;InnoDB&lt;/span&gt; &lt;span class="k"&gt;DEFAULT&lt;/span&gt; &lt;span class="n"&gt;CHARSET&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;utf8mb4&lt;/span&gt;
  &lt;span class="k"&gt;COLLATE&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="n"&gt;utf8mb4_unicode_ci&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;INSERT&lt;/span&gt; &lt;span class="k"&gt;IGNORE&lt;/span&gt; &lt;span class="k"&gt;INTO&lt;/span&gt; &lt;span class="n"&gt;productos&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;nombre&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;precio&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stock&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;VALUES&lt;/span&gt;
  &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'Cuaderno'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="mi"&gt;50&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;30&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
  &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'Lapicero'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="mi"&gt;00&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;50&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
  &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'Carpeta'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;8&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="mi"&gt;00&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;15&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Express expone las operaciones del inventario y un endpoint de salud.&lt;/p&gt;

&lt;p&gt;Las consultas de lectura son públicas.&lt;/p&gt;

&lt;p&gt;Para crear o eliminar productos se requiere:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;X-API-Key
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La clave se configura mediante:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ADMIN_API_KEY
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El precio debe ser numérico, tener como máximo dos decimales y no ser negativo.&lt;/p&gt;

&lt;p&gt;El stock debe ser un entero no negativo.&lt;/p&gt;

&lt;p&gt;Las rutas disponibles en la aplicación se presentan en la siguiente tabla.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjtdzvoh2c0zcczpl6jg8.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjtdzvoh2c0zcczpl6jg8.png" alt=" " width="630" height="264"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tabla 4. Rutas de la aplicación de inventario.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Las principales rutas son:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;GET /
GET /health
GET /productos
POST /productos
DELETE /productos/:id
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Las inserciones y eliminaciones utilizan consultas parametrizadas.&lt;/p&gt;

&lt;p&gt;Las credenciales de MySQL se mantienen en el servidor y nunca forman parte de la respuesta al navegador.&lt;/p&gt;

&lt;p&gt;La siguiente figura muestra la interfaz propia del inventario conectada al servidor MySQL local.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fduaqdporsu8nhmp5c6pl.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fduaqdporsu8nhmp5c6pl.png" alt=" " width="658" height="312"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Figura 1. Interfaz propia del inventario conectada al servidor MySQL local.&lt;/strong&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  Exportación del respaldo con mysqldump
&lt;/h2&gt;

&lt;p&gt;El script &lt;code&gt;backup.sh&lt;/code&gt; verifica las variables, prepara un directorio temporal privado y ejecuta la exportación.&lt;/p&gt;

&lt;p&gt;La contraseña se escribe en un archivo temporal de opciones del cliente y no se coloca como argumento visible del comando.&lt;/p&gt;

&lt;p&gt;El archivo temporal se elimina al terminar.&lt;/p&gt;

&lt;p&gt;El núcleo de la exportación utiliza las siguientes opciones:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;mysqldump &lt;span class="nt"&gt;--defaults-extra-file&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="nv"&gt;$WORK_DIR&lt;/span&gt;&lt;span class="s2"&gt;/client.cnf"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;--single-transaction&lt;/span&gt; &lt;span class="nt"&gt;--quick&lt;/span&gt; &lt;span class="nt"&gt;--no-tablespaces&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;--set-gtid-purged&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;OFF &lt;span class="nt"&gt;--column-statistics&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;0 &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="nt"&gt;--hex-blob&lt;/span&gt; &lt;span class="nt"&gt;--default-character-set&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;utf8mb4 &lt;span class="se"&gt;\&lt;/span&gt;
  &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="nv"&gt;$DB_NAME&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt; | &lt;span class="nb"&gt;gzip&lt;/span&gt; &lt;span class="nt"&gt;-c&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="nv"&gt;$WORK_DIR&lt;/span&gt;&lt;span class="s2"&gt;/dump.sql.gz"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La opción:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;--single-transaction
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;proporciona una instantánea consistente para tablas transaccionales como InnoDB.&lt;/p&gt;

&lt;p&gt;Durante el dump deben evitarse modificaciones de estructura como:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ALTER
DROP
TRUNCATE
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La demostración exporta la base utilizada por la aplicación.&lt;/p&gt;

&lt;p&gt;No conserva las cuentas y permisos del servidor ni incorpora procedimientos o eventos.&lt;/p&gt;

&lt;p&gt;Después de verificar el archivo comprimido, &lt;code&gt;crypto.js&lt;/code&gt; deriva una clave con &lt;code&gt;scrypt&lt;/code&gt; y una sal aleatoria.&lt;/p&gt;

&lt;p&gt;El cifrado utiliza:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;AES 256 GCM
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;junto con un nonce aleatorio y una etiqueta de autenticación.&lt;/p&gt;

&lt;p&gt;El resultado se guarda con fecha y un identificador aleatorio, acompañado de un checksum SHA-256.&lt;/p&gt;

&lt;p&gt;La frase secreta debe conservarse por separado durante todo el periodo de retención.&lt;/p&gt;

&lt;p&gt;Desde PowerShell, la ejecución utiliza el contenedor de herramientas del proyecto.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="n"&gt;docker&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;compose&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;--profile&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;tools&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;run&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;--rm&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;tools&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;scripts/backup.sh&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="n"&gt;Get-ChildItem&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;backups&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Los archivos:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;.sql.gz.enc
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;no deben abrirse como si fueran archivos SQL sin cifrar.&lt;/p&gt;

&lt;p&gt;El archivo cifrado y su checksum deben conservarse juntos.&lt;/p&gt;

&lt;p&gt;La política de siete días se refiere a antigüedad, no a una cantidad exacta de archivos.&lt;/p&gt;

&lt;p&gt;Varias ejecuciones manuales pueden producir varias copias durante el mismo día.&lt;/p&gt;




&lt;h2&gt;
  
  
  Recuperación en una base independiente
&lt;/h2&gt;

&lt;p&gt;La recuperación se diseñó para revisar la copia sin sobrescribir el inventario activo.&lt;/p&gt;

&lt;p&gt;El script &lt;code&gt;restore.sh&lt;/code&gt; exige un nombre de destino diferente de &lt;code&gt;DB_NAME&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Además:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Verifica el checksum.&lt;/li&gt;
&lt;li&gt;Autentica el descifrado.&lt;/li&gt;
&lt;li&gt;Comprueba la compresión.&lt;/li&gt;
&lt;li&gt;Confirma que el destino exista.&lt;/li&gt;
&lt;li&gt;Confirma que el destino no contenga tablas.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;En el laboratorio, una cuenta con permisos de administración crea la base de recuperación y concede acceso al usuario de la aplicación.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight sql"&gt;&lt;code&gt;&lt;span class="k"&gt;CREATE&lt;/span&gt; &lt;span class="k"&gt;DATABASE&lt;/span&gt; &lt;span class="n"&gt;backup_demo_restore&lt;/span&gt;
  &lt;span class="nb"&gt;CHARACTER&lt;/span&gt; &lt;span class="k"&gt;SET&lt;/span&gt; &lt;span class="n"&gt;utf8mb4&lt;/span&gt;
  &lt;span class="k"&gt;COLLATE&lt;/span&gt; &lt;span class="n"&gt;utf8mb4_unicode_ci&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;GRANT&lt;/span&gt; &lt;span class="k"&gt;ALL&lt;/span&gt; &lt;span class="k"&gt;PRIVILEGES&lt;/span&gt;
&lt;span class="k"&gt;ON&lt;/span&gt; &lt;span class="n"&gt;backup_demo_restore&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="o"&gt;*&lt;/span&gt;
&lt;span class="k"&gt;TO&lt;/span&gt; &lt;span class="s1"&gt;'demo'&lt;/span&gt;&lt;span class="o"&gt;@&lt;/span&gt;&lt;span class="s1"&gt;'%'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Después se configura:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;RESTORE_DB_NAME=backup_demo_restore
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A continuación se selecciona una copia de seguridad.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="nv"&gt;$backup&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Get-ChildItem&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;backups/&lt;/span&gt;&lt;span class="o"&gt;*.&lt;/span&gt;&lt;span class="nf"&gt;sql&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;gz&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;enc&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="n"&gt;Sort-Object&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;LastWriteTime&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-Descending&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="n"&gt;Select-Object&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;-First&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;1&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Finalmente se ejecuta la restauración.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight powershell"&gt;&lt;code&gt;&lt;span class="n"&gt;docker&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;compose&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;--profile&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;tools&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;run&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;--rm&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;tools&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nx"&gt;scripts/restore.sh&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="se"&gt;`
&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="s2"&gt;"backups/&lt;/span&gt;&lt;span class="si"&gt;$(&lt;/span&gt;&lt;span class="nv"&gt;$backup&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;Name&lt;/span&gt;&lt;span class="si"&gt;)&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La prueba realizada con MySQL 8.0.46 creó un cuarto producto antes de respaldar.&lt;/p&gt;

&lt;p&gt;La recuperación importó las cuatro filas y comprobó la coincidencia de:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Identificador&lt;/li&gt;
&lt;li&gt;Nombre&lt;/li&gt;
&lt;li&gt;Precio&lt;/li&gt;
&lt;li&gt;Stock&lt;/li&gt;
&lt;li&gt;Fecha&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Posteriormente se eliminó el producto de prueba desde la API y se verificó que siguiera presente en la copia restaurada.&lt;/p&gt;

&lt;p&gt;Los productos recuperados se muestran en la siguiente tabla.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjwlyiuznz6zyg8hzwtfm.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjwlyiuznz6zyg8hzwtfm.png" alt=" " width="643" height="232"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tabla 5. Productos recuperados en la prueba local.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Los registros recuperados fueron:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ID 1 - Cuaderno - 12.50 - Stock 30
ID 2 - Lapicero - 2.00 - Stock 50
ID 3 - Carpeta - 8.00 - Stock 10
ID 4 - Prueba recuperación - 25.50 - Stock 15
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La prueba también confirmó el rechazo de:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Un archivo modificado.&lt;/li&gt;
&lt;li&gt;Una base de destino con tablas.&lt;/li&gt;
&lt;li&gt;Un destino con el mismo nombre de la base original.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;La importación de una base completa no es atómica.&lt;/p&gt;

&lt;p&gt;Si falla después de crear objetos, debe revisarse el destino antes de repetir la operación.&lt;/p&gt;




&lt;h2&gt;
  
  
  MySQL en Aiven y aplicación en Railway
&lt;/h2&gt;

&lt;p&gt;Aiven proporciona el servicio de MySQL.&lt;/p&gt;

&lt;p&gt;Desde su consola se obtienen:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Host&lt;/li&gt;
&lt;li&gt;Puerto&lt;/li&gt;
&lt;li&gt;Usuario&lt;/li&gt;
&lt;li&gt;Contraseña&lt;/li&gt;
&lt;li&gt;Nombre de base&lt;/li&gt;
&lt;li&gt;Certificado CA&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Puede utilizarse una base creada para el proyecto o la base disponible en el servicio, como &lt;code&gt;defaultdb&lt;/code&gt; si ese es su nombre real.&lt;/p&gt;

&lt;p&gt;No se debe asumir que el puerto remoto sea &lt;code&gt;3306&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Railway aloja la aplicación Node.js.&lt;/p&gt;

&lt;p&gt;El servicio utiliza el &lt;code&gt;Dockerfile&lt;/code&gt; y las variables de conexión para llegar a Aiven.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;railway.json&lt;/code&gt; prepara la inicialización de la tabla antes del despliegue y define:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/health
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;como comprobación de funcionamiento.&lt;/p&gt;

&lt;p&gt;Si la tabla ya existe, un nuevo despliegue conserva sus datos.&lt;/p&gt;

&lt;p&gt;Las variables necesarias para Railway se presentan en la siguiente tabla.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fztreghy5jysepw16n68l.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fztreghy5jysepw16n68l.png" alt=" " width="647" height="296"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tabla 6. Variables de conexión del servicio Railway.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Las variables utilizadas son:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;DB_HOST
DB_PORT
DB_USER
DB_PASSWORD
DB_NAME
DB_SSL
DB_SSL_CA
ADMIN_API_KEY
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Para la conexión externa:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;DB_SSL=true
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Después de crear el servicio se genera un dominio público y se comprueban:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/
 /health
 /productos
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La aplicación escucha en:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;0.0.0.0
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;y utiliza el puerto proporcionado por el entorno.&lt;/p&gt;

&lt;p&gt;La conexión desde GitHub Actions también necesita alcanzar Aiven.&lt;/p&gt;

&lt;p&gt;Si el servicio limita las direcciones de acceso, debe autorizarse el origen del runner o utilizarse un runner con salida permitida.&lt;/p&gt;

&lt;p&gt;Las claves se guardan como Secrets y el certificado se configura sin desactivar la verificación TLS.&lt;/p&gt;




&lt;h2&gt;
  
  
  Pruebas y despliegue automatizado
&lt;/h2&gt;

&lt;p&gt;El proyecto separa el ciclo de publicación del proceso que respalda los datos.&lt;/p&gt;

&lt;p&gt;El archivo:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;ci.yml
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;está configurado para:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Ejecutar pruebas de API.&lt;/li&gt;
&lt;li&gt;Ejecutar pruebas de cifrado.&lt;/li&gt;
&lt;li&gt;Iniciar MySQL 8.4.&lt;/li&gt;
&lt;li&gt;Comprobar una recuperación de laboratorio.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;El archivo:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;deploy.yml
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;escucha la finalización de CI para la rama principal y despliega el commit que terminó correctamente.&lt;/p&gt;

&lt;p&gt;El evento se define de esta manera:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;workflow_run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;workflows&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;CI&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;-&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;MySQL&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;y&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;recuperación"&lt;/span&gt;&lt;span class="pi"&gt;]&lt;/span&gt;
    &lt;span class="na"&gt;types&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;completed&lt;/span&gt;&lt;span class="pi"&gt;]&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;main&lt;/span&gt;&lt;span class="pi"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El job comprueba:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Que CI haya concluido correctamente.&lt;/li&gt;
&lt;li&gt;Que proceda de un push del mismo repositorio.&lt;/li&gt;
&lt;li&gt;Que &lt;code&gt;DEPLOY_ENABLED&lt;/code&gt; sea &lt;code&gt;true&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Posteriormente utiliza un Project Token de Railway y el ID del servicio.&lt;/p&gt;

&lt;p&gt;El despliegue se ejecuta mediante:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;railway up &lt;span class="nt"&gt;--service&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="nv"&gt;$RAILWAY_SERVICE_ID&lt;/span&gt;&lt;span class="s2"&gt;"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El comando espera el resultado del despliegue.&lt;/p&gt;

&lt;p&gt;Después se consulta la URL pública de:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;/health
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Para demostrar la automatización, se debe:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Cambiar un texto de la interfaz.&lt;/li&gt;
&lt;li&gt;Hacer commit.&lt;/li&gt;
&lt;li&gt;Hacer push a &lt;code&gt;main&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Observar la ejecución de CI.&lt;/li&gt;
&lt;li&gt;Observar el despliegue posterior.&lt;/li&gt;
&lt;li&gt;Comprobar el cambio en la aplicación pública.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Conviene mantener un solo mecanismo de despliegue y desactivar el autodeploy nativo de Railway para evitar publicaciones duplicadas.&lt;/p&gt;




&lt;h2&gt;
  
  
  Backup remoto programado con GitHub Actions
&lt;/h2&gt;

&lt;p&gt;El archivo:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;backup.yml
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;prepara un contenedor con cliente MySQL 8.4 y ejecuta el mismo procedimiento de exportación, compresión y cifrado utilizado en el laboratorio.&lt;/p&gt;

&lt;p&gt;Los parámetros de Aiven y la frase de cifrado se obtienen mediante Secrets.&lt;/p&gt;

&lt;p&gt;No se imprime la contraseña ni se sube un dump sin cifrar.&lt;/p&gt;

&lt;p&gt;La programación utiliza:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;schedule&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;cron&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;0&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;6&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;*&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;*&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;*"&lt;/span&gt;
  &lt;span class="na"&gt;workflow_dispatch&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Esto configura una ejecución diaria a las 06:00 UTC y también permite ejecutarla manualmente.&lt;/p&gt;

&lt;p&gt;Los artefactos se guardan mediante:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/upload-artifact@v4&lt;/span&gt;
  &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;mysql-backup-${{ github.run_id }}&lt;/span&gt;
    &lt;span class="na"&gt;path&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;|&lt;/span&gt;
      &lt;span class="s"&gt;backups/*.sql.gz.enc&lt;/span&gt;
      &lt;span class="s"&gt;backups/*.sql.gz.enc.sha256&lt;/span&gt;
    &lt;span class="na"&gt;retention-days&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="m"&gt;7&lt;/span&gt;
    &lt;span class="na"&gt;if-no-files-found&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;error&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La condición del job requiere:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;BACKUP_ENABLED=true
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Los Secrets incluyen:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;DB_HOST
DB_PORT
DB_USER
DB_PASSWORD
DB_NAME
DB_SSL_CA
BACKUP_PASSPHRASE
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Para Aiven también se utiliza:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;BACKUP_DB_SSL=true
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El usuario del dump necesita los permisos de lectura y de los objetos que exporta el procedimiento.&lt;/p&gt;

&lt;p&gt;Para validar la configuración se ejecuta primero:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Run workflow
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Después se descarga el artefacto cifrado y se restaura en una base vacía compatible utilizando la misma frase del respaldo.&lt;/p&gt;

&lt;p&gt;El historial también deberá revisarse para confirmar una ejecución:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Scheduled
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Una prueba manual exitosa no demuestra por sí sola que se haya ejecutado el cron.&lt;/p&gt;

&lt;p&gt;GitHub puede retrasar las ejecuciones programadas.&lt;/p&gt;




&lt;h2&gt;
  
  
  Evidencia y estado de los resultados
&lt;/h2&gt;

&lt;p&gt;La interfaz también se probó en navegador mediante el registro de un producto.&lt;/p&gt;

&lt;p&gt;La siguiente figura muestra ese producto dentro del inventario local.&lt;/p&gt;

&lt;p&gt;No representa una aplicación ya publicada en Railway.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fwixsfx2y1x126xm3y58f.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fwixsfx2y1x126xm3y58f.png" alt=" " width="641" height="342"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Figura 2. Registro de un producto desde la interfaz del proyecto local.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Las validaciones realizadas y las actividades pendientes se presentan en la siguiente tabla.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F172o7ywrx6nn2gys74uk.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F172o7ywrx6nn2gys74uk.png" alt=" " width="800" height="600"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Tabla 7. Validaciones realizadas y actividades pendientes.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Los principales resultados fueron:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;API, validación y cifrado: cuatro pruebas automáticas aprobadas.&lt;/li&gt;
&lt;li&gt;Respaldo y recuperación MySQL local: cuatro filas recuperadas con todos los campos iguales.&lt;/li&gt;
&lt;li&gt;Protecciones de restauración: archivo alterado, destino ocupado y destino original rechazados.&lt;/li&gt;
&lt;li&gt;Navegador: registro de producto y vista móvil comprobados.&lt;/li&gt;
&lt;li&gt;Docker y CI MySQL 8.4: configurados, pendientes de ejecución en la cuenta.&lt;/li&gt;
&lt;li&gt;GitHub público, Aiven y Railway: publicación y configuración externa pendientes.&lt;/li&gt;
&lt;li&gt;Backup remoto manual y Scheduled: pendientes de ejecutar y documentar.&lt;/li&gt;
&lt;li&gt;Video: archivo local de 4 minutos 58 segundos, publicación pendiente.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Los resultados de MySQL corresponden a una prueba real con la versión:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;MySQL 8.0.46
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Las imágenes de Docker y los workflows están configurados para MySQL 8.4, pero no se atribuyen ejecuciones remotas a esa configuración.&lt;/p&gt;

&lt;p&gt;Al terminar la publicación deberán añadirse capturas propias de:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Repositorio.&lt;/li&gt;
&lt;li&gt;CI.&lt;/li&gt;
&lt;li&gt;Railway.&lt;/li&gt;
&lt;li&gt;URL pública.&lt;/li&gt;
&lt;li&gt;Historial de backups de Aiven.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Conclusiones
&lt;/h2&gt;

&lt;p&gt;La recuperación comprobó que el archivo producido conserva información utilizable y permite revisar un estado anterior del inventario. El destino separado hizo posible validar las filas recuperadas sin importar el dump sobre la base activa.&lt;br&gt;
La solución reúne tres tareas diferentes: probar la aplicación, publicar sus cambios y respaldar los datos. GitHub Actions permite describir cada una por separado. Railway ejecuta la API y Aiven proporciona el MySQL remoto al que deben conectarse tanto la aplicación como el proceso de respaldo.&lt;br&gt;
Esta estrategia resulta adecuada para una base pequeña de demostración. Para producción se necesitarían alertas de fallos, simulacros periódicos, permisos mínimos y otra copia en almacenamiento independiente.&lt;/p&gt;


&lt;h2&gt;
  
  
  Enlaces del proyecto
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Repositorio público del proyecto:&lt;/strong&gt;&lt;br&gt;
&lt;a href="https://github.com/Soanny/mysql-backup-strategy_Stevie-Marca_Soanny-Rivas.git" rel="noopener noreferrer"&gt;https://github.com/Soanny/mysql-backup-strategy_Stevie-Marca_Soanny-Rivas.git&lt;/a&gt; &lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Aplicación pública en Railway:&lt;/strong&gt;&lt;br&gt;
&lt;a href="https://mysql-backup-strategystevie-marcasoanny-rivas-production.up.railway.app/" rel="noopener noreferrer"&gt;https://mysql-backup-strategystevie-marcasoanny-rivas-production.up.railway.app/&lt;/a&gt; &lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Video público:&lt;/strong&gt;&lt;br&gt;
&lt;a href="https://youtu.be/ViPQl8gZ20U" rel="noopener noreferrer"&gt;https://youtu.be/ViPQl8gZ20U&lt;/a&gt;&lt;/p&gt;


&lt;h2&gt;
  
  
  Referencias
&lt;/h2&gt;

&lt;p&gt;Aiven. (s. f.-a). &lt;em&gt;Connect to Aiven for MySQL® from the command line&lt;/em&gt;. Recuperado el 3 de octubre de 2026.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;https://aiven.io/docs/products/mysql/howto/connect-from-cli
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Aiven. (s. f.-b). &lt;em&gt;Connect to Aiven for MySQL® with MySQL Workbench&lt;/em&gt;. Recuperado el 3 de octubre de 2026.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;https://aiven.io/docs/products/mysql/howto/connect-from-mysql-workbench
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;GitHub. (s. f.). &lt;em&gt;Downloading workflow artifacts&lt;/em&gt;. Recuperado el 3 de octubre de 2026.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;https://docs.github.com/en/actions/how-tos/manage-workflow-runs/download-workflow-artifacts
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Oracle. (s. f.). &lt;em&gt;6.5.4 mysqldump — A database backup program&lt;/em&gt;. Recuperado el 3 de octubre de 2026.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;https://dev.mysql.com/doc/refman/8.4/en/mysqldump.html
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Railway. (s. f.-a). &lt;em&gt;Deploying with the CLI&lt;/em&gt;. Recuperado el 3 de octubre de 2026.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;https://docs.railway.com/cli/deploying
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Railway. (s. f.-b). &lt;em&gt;railway up&lt;/em&gt;. Recuperado el 3 de octubre de 2026.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;https://docs.railway.com/cli/up
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



</description>
      <category>automation</category>
      <category>database</category>
      <category>devops</category>
      <category>githubactions</category>
    </item>
  </channel>
</rss>
