<?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: STEVIE GERALD MARCA AGUILAR</title>
    <description>The latest articles on DEV Community by STEVIE GERALD MARCA AGUILAR (@stevie_geraldmarcaaguil).</description>
    <link>https://dev.to/stevie_geraldmarcaaguil</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%2F4160751%2F6d286810-ded3-4722-8f06-a740f0492310.png</url>
      <title>DEV Community: STEVIE GERALD MARCA AGUILAR</title>
      <link>https://dev.to/stevie_geraldmarcaaguil</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/stevie_geraldmarcaaguil"/>
    <language>en</language>
    <item>
      <title>DAST y escaneo de contenedores en CI/CD: auditando una app Flask con Wapiti y Trivy</title>
      <dc:creator>STEVIE GERALD MARCA AGUILAR</dc:creator>
      <pubDate>Sun, 15 Nov 2026 04:15:59 +0000</pubDate>
      <link>https://dev.to/stevie_geraldmarcaaguil/dast-y-escaneo-de-contenedores-en-cicd-auditando-una-app-flask-con-wapiti-y-trivy-5db7</link>
      <guid>https://dev.to/stevie_geraldmarcaaguil/dast-y-escaneo-de-contenedores-en-cicd-auditando-una-app-flask-con-wapiti-y-trivy-5db7</guid>
      <description>&lt;p&gt;Autor: Stevie Gerald Marca Aguilar , Usher Damiron Halanocca Rojas&lt;br&gt;
Pipeline DevSecOps que construye una aplicación web, la ataca con un escáner dinámico, revisa su imagen Docker en busca de CVE y, al final, la publica automáticamente en la nube.&lt;/p&gt;

&lt;blockquote&gt;
&lt;h2&gt;
  
  
  ⚠️ La aplicación contiene vulnerabilidades &lt;strong&gt;a propósito&lt;/strong&gt; (SQLi y XSS) con fines educativos. No la reutilices en un entorno real.
&lt;/h2&gt;

&lt;p&gt;Tabla de contenidos&lt;br&gt;
Contexto: seguridad desde el inicio&lt;br&gt;
Herramientas elegidas&lt;br&gt;
Flujo del pipeline&lt;br&gt;
La aplicación de prueba&lt;br&gt;
Workflow de GitHub Actions&lt;br&gt;
Publicación en Render&lt;br&gt;
Qué encontraron los escáneres&lt;br&gt;
Cómo corregirlo&lt;br&gt;
Ejecución local&lt;br&gt;
Conclusiones&lt;/p&gt;
&lt;h2&gt;
  
  
  Enlaces
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Contexto: seguridad desde el inicio
Dejar la seguridad para la víspera del despliegue ya no es viable. La práctica DevSecOps, también llamada Shift-Left Security, propone que los controles de seguridad se ejecuten de forma automática desde las primeras etapas del desarrollo, igual que las pruebas unitarias.
OWASP mantiene un catálogo público de herramientas de escaneo de vulnerabilidades. Para este proyecto se combinaron dos enfoques complementarios: uno que prueba la aplicación mientras está en ejecución y otro que inspecciona el contenedor donde vive.&lt;/li&gt;
&lt;li&gt;Herramientas elegidas
Herramienta Enfoque Qué detecta
Wapiti  DAST (caja negra)   Envía payloads maliciosos a la app en ejecución para descubrir XSS, inyección SQL, inclusión de archivos, ejecución de comandos y cabeceras HTTP débiles
Trivy (Aqua Security)   Escaneo de contenedores y dependencias  CVE conocidas en la imagen Docker, en los paquetes del sistema operativo base y en las librerías de Python
Wapiti ve la aplicación como la vería un atacante desde fuera; Trivy mira hacia dentro, a los componentes con los que fue construida. Juntos cubren tanto los errores en el código propio como los heredados de terceros.&lt;/li&gt;
&lt;li&gt;Flujo del pipeline
Cada &lt;code&gt;push&lt;/code&gt; a &lt;code&gt;main&lt;/code&gt; dispara tres etapas en secuencia. Si una falla, las siguientes no se ejecutan:
&lt;/li&gt;
&lt;/ol&gt;
&lt;/blockquote&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;push a main
   │
   ▼
① Trivy   → construye la imagen y busca CVE en SO y dependencias
   │
   ▼
② Wapiti  → levanta el contenedor y lo audita dinámicamente (DAST)
   │
   ▼
③ Deploy  → llama al Deploy Hook de Render y publica la app
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;ol&gt;
&lt;li&gt;La aplicación de prueba
Para comprobar que los escáneres realmente detectan fallos, se creó una app mínima en Python 3.9 + Flask con una base SQLite en memoria. Incluye dos vulnerabilidades clásicas del OWASP Top 10 (categoría A03:2021 – Injection).
&lt;code&gt;app/app.py&lt;/code&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;flask&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;Flask&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;sqlite3&lt;/span&gt;

&lt;span class="n"&gt;app&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Flask&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;__name__&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;db&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;conn&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;sqlite3&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;connect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;":memory:"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;conn&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;execute&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"CREATE TABLE users (id INTEGER, name TEXT)"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;conn&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;execute&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"INSERT INTO users VALUES (1, 'admin'), (2, 'maria')"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;conn&lt;/span&gt;

&lt;span class="nd"&gt;@app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;home&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;return&lt;/span&gt; &lt;span class="s2"&gt;"&amp;lt;h1&amp;gt;Demo App&amp;lt;/h1&amp;gt;&amp;lt;a href='/search?q=maria'&amp;gt;Buscar&amp;lt;/a&amp;gt; | &amp;lt;a href='/user?id=1'&amp;gt;Usuario&amp;lt;/a&amp;gt;"&lt;/span&gt;

&lt;span class="c1"&gt;# Fallo intencional: XSS reflejado (CWE-79)&lt;/span&gt;
&lt;span class="nd"&gt;@app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/search"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;search&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;q&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"q"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"&amp;lt;p&amp;gt;Resultados para: {q}&amp;lt;/p&amp;gt;"&lt;/span&gt;

&lt;span class="c1"&gt;# Fallo intencional: inyección SQL (CWE-89)&lt;/span&gt;
&lt;span class="nd"&gt;@app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/user"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;user&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;uid&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"1"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;rows&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;db&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="nf"&gt;execute&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"SELECT * FROM users WHERE id = {uid}"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;fetchall&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="kt"&gt;str&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;rows&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;__name__&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="s2"&gt;"__main__"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;host&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"0.0.0.0"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;8000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;&lt;code&gt;Dockerfile&lt;/code&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight docker"&gt;&lt;code&gt;&lt;span class="k"&gt;FROM&lt;/span&gt; python:3.9-slim

&lt;span class="k"&gt;WORKDIR&lt;/span&gt; /app

&lt;span class="k"&gt;COPY&lt;/span&gt; app/requirements.txt .
&lt;span class="k"&gt;RUN&lt;/span&gt; pip install --no-cache-dir -r requirements.txt

&lt;span class="k"&gt;COPY&lt;/span&gt; app/ .

&lt;span class="k"&gt;EXPOSE&lt;/span&gt; 8000
&lt;span class="k"&gt;CMD&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"gunicorn"&lt;/span&gt;, &lt;span class="s2"&gt;"-b"&lt;/span&gt;, &lt;span class="s2"&gt;"0.0.0.0:8000"&lt;/span&gt;, &lt;span class="s2"&gt;"app:app"&lt;/span&gt;&lt;span class="o"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;Workflow de GitHub Actions
Archivo: &lt;code&gt;.github/workflows/pipeline.yml&lt;/code&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Build, Scan and Deploy&lt;/span&gt;

&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;push&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;main&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="na"&gt;jobs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;scan-dependencies-and-image&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Trivy — Container and Dependency Scan&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Build image&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;docker build -t demo-app:latest .&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Trivy — escaneo de imagen&lt;/span&gt;
        &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;aquasecurity/trivy-action@master&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;image-ref&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;demo-app:latest&lt;/span&gt;
          &lt;span class="na"&gt;format&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;table&lt;/span&gt;
          &lt;span class="na"&gt;output&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;trivy-report.txt&lt;/span&gt;
          &lt;span class="na"&gt;exit-code&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&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="p"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;trivy-report&lt;/span&gt;
          &lt;span class="na"&gt;path&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;trivy-report.txt&lt;/span&gt;

  &lt;span class="na"&gt;dast-scan&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Wapiti — Dynamic Application Security Testing (DAST)&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;needs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;scan-dependencies-and-image&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Levantar app&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
          &lt;span class="s"&gt;docker build -t demo-app .&lt;/span&gt;
          &lt;span class="s"&gt;docker run -d -p 8000:8000 demo-app&lt;/span&gt;
          &lt;span class="s"&gt;sleep 8&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Wapiti — escaneo dinámico&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
          &lt;span class="s"&gt;pip install wapiti3&lt;/span&gt;
          &lt;span class="s"&gt;wapiti -u http://localhost:8000/ -f html -o wapiti-report --scope folder&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&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="p"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wapiti-report&lt;/span&gt;
          &lt;span class="na"&gt;path&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;wapiti-report&lt;/span&gt;

  &lt;span class="na"&gt;deploy&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Deploy to Cloud (Render)&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;needs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;dast-scan&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Disparar despliegue en Render&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;curl -X POST "${{ secrets.RENDER_DEPLOY_HOOK }}"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Los reportes de Trivy y Wapiti quedan disponibles como artefactos descargables en cada ejecución.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Publicación en Render
En Render se creó un Web Service con entorno Docker, vinculado al repositorio público.
En la configuración avanzada del servicio se generó una Deploy Hook URL.
Esa URL se guardó en GitHub como secret &lt;code&gt;RENDER_DEPLOY_HOOK&lt;/code&gt;. Así, el pipeline puede ordenar el despliegue al terminar los escaneos sin exponer ninguna credencial en el código.
App en producción: &lt;a href="https://vuln-scan-demo.onrender.com" rel="noopener noreferrer"&gt;https://vuln-scan-demo.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Qué encontraron los escáneres
Wapiti (DAST)
Hallazgo    Severidad   Dónde  Detalle
Inyección SQL  Alta    &lt;code&gt;/user?id=&lt;/code&gt;    Al enviar valores como &lt;code&gt;' OR '1'='1&lt;/code&gt;, la consulta cambia su lógica y devuelve todos los usuarios
XSS reflejado   Media   &lt;code&gt;/search?q=&lt;/code&gt;   El parámetro se devuelve en el HTML sin codificar, por lo que un script inyectado se ejecuta en el navegador
Cabeceras de seguridad ausentes Baja / Info Todas las rutas Faltan &lt;code&gt;Content-Security-Policy&lt;/code&gt;, &lt;code&gt;X-Frame-Options&lt;/code&gt; (riesgo de clickjacking) y &lt;code&gt;X-Content-Type-Options: nosniff&lt;/code&gt;
Trivy (contenedor y dependencias)
Vulnerabilidades de severidad media y baja en paquetes del sistema base Debian de &lt;code&gt;python:3.9-slim&lt;/code&gt;, como &lt;code&gt;libssl&lt;/code&gt;, &lt;code&gt;glibc&lt;/code&gt; y &lt;code&gt;zlib&lt;/code&gt;.
CVE conocidas en la versión fijada de &lt;code&gt;flask&lt;/code&gt; y en su dependencia &lt;code&gt;Werkzeug&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Cómo corregirlo
Inyección SQL → consultas parametrizadas
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="nd"&gt;@app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/user"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;user&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;uid&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"1"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;rows&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;db&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="nf"&gt;execute&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"SELECT * FROM users WHERE id = ?"&lt;/span&gt;&lt;span class="p"&gt;,&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="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;fetchall&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="kt"&gt;str&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;rows&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;XSS → escapar la salida (o usar plantillas Jinja2, que escapan automáticamente)&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;markupsafe&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;escape&lt;/span&gt;

&lt;span class="nd"&gt;@app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/search"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;search&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;q&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;args&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"q"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"&amp;lt;p&amp;gt;Resultados para: {escape(q)}&amp;lt;/p&amp;gt;"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Cabeceras HTTP → Flask-Talisman&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;flask_talisman&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;Talisman&lt;/span&gt;

&lt;span class="nc"&gt;Talisman&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;content_security_policy&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s2"&gt;"default-src"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"'self'"&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;Hallazgos de Trivy&lt;br&gt;
Migrar la imagen base a una versión con soporte, como &lt;code&gt;python:3.12-slim&lt;/code&gt; o una variante Alpine.&lt;br&gt;
Actualizar Flask (&lt;code&gt;flask&amp;gt;=3.0.0&lt;/code&gt;) y Werkzeug, y añadir &lt;code&gt;pip-audit&lt;/code&gt; al pipeline para vigilar las dependencias.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Ejecución local
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Clonar&lt;/span&gt;
git clone https://github.com/UsherHalanoccaRojas/vuln-scan-demo.git
&lt;span class="nb"&gt;cd&lt;/span&gt; vuln-scan-demo

&lt;span class="c"&gt;# Construir y ejecutar&lt;/span&gt;
docker build -t demo-app .
docker run -d -p 8000:8000 demo-app

&lt;span class="c"&gt;# Trivy&lt;/span&gt;
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock aquasec/trivy:latest image demo-app

&lt;span class="c"&gt;# Wapiti&lt;/span&gt;
pip install wapiti3
wapiti -u http://localhost:8000/ -f html -o wapiti-report --scope folder
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Configuración en GitHub&lt;br&gt;
Secret  Valor&lt;br&gt;
&lt;code&gt;RENDER_DEPLOY_HOOK&lt;/code&gt;   Deploy Hook URL generada en Render&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Conclusiones
Con herramientas open source como Wapiti y Trivy se puede montar una defensa sólida sin pagar licencias costosas.
El escaneo continuo expone fallos graves, como SQLi y XSS, antes de que lleguen a producción.
Los reportes guardados como artefactos dejan un registro de cada CVE detectada en la imagen y en las dependencias.
El despliegue solo ocurre después de que los controles de seguridad se ejecutan.
Enlaces&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Repositorio: &lt;a href="https://github.com/UsherHalanoccaRojas/vuln-scan-demo" rel="noopener noreferrer"&gt;https://github.com/UsherHalanoccaRojas/vuln-scan-demo&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;App desplegada (Render): &lt;a href="https://vuln-scan-demo.onrender.com" rel="noopener noreferrer"&gt;https://vuln-scan-demo.onrender.com&lt;/a&gt;&lt;/p&gt;

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

&lt;h2&gt;
  
  
  Catálogo OWASP de herramientas: &lt;a href="https://community.owasp.org/Vulnerability_Scanning_Tools" rel="noopener noreferrer"&gt;https://community.owasp.org/Vulnerability_Scanning_Tools&lt;/a&gt;
&lt;/h2&gt;

</description>
      <category>cicd</category>
      <category>devops</category>
      <category>docker</category>
      <category>security</category>
    </item>
    <item>
      <title>Pruebas automatizadas de APIs con Newman y entrega continua en la nube</title>
      <dc:creator>STEVIE GERALD MARCA AGUILAR</dc:creator>
      <pubDate>Sun, 15 Nov 2026 04:02:38 +0000</pubDate>
      <link>https://dev.to/stevie_geraldmarcaaguil/pruebas-automatizadas-de-apis-con-newman-y-entrega-continua-en-la-nube-17o2</link>
      <guid>https://dev.to/stevie_geraldmarcaaguil/pruebas-automatizadas-de-apis-con-newman-y-entrega-continua-en-la-nube-17o2</guid>
      <description>&lt;p&gt;Autor: Stevie Gerald Marca Aguilar ,  Usher Halanocca Rojas&lt;br&gt;
Guía práctica para aplicar Shift-Left Testing combinando Node.js, Postman/Newman, GitHub Actions y Render.&lt;/p&gt;

&lt;blockquote&gt;
&lt;h2&gt;
  
  
  Calidad desde el primer commit: pruebas que se ejecutan solas y despliegues que solo ocurren cuando todo pasa.
&lt;/h2&gt;

&lt;p&gt;Tabla de contenidos&lt;br&gt;
Introducción&lt;br&gt;
¿Por qué Newman?&lt;br&gt;
Arquitectura&lt;br&gt;
API REST con Node.js y Express&lt;br&gt;
Colección de pruebas en Postman&lt;br&gt;
Ejecución con Newman&lt;br&gt;
Pipeline en GitHub Actions&lt;br&gt;
Despliegue en Render&lt;br&gt;
Pruebas de carga con k6&lt;br&gt;
Conclusiones&lt;/p&gt;
&lt;h2&gt;
  
  
  Recursos
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;Introducción: por qué adelantar las pruebas de API
Hoy en día, la mayoría de los sistemas se construyen sobre microservicios o arquitecturas orientadas a servicios, y en ese escenario las APIs se convierten en la pieza que conecta todo lo demás. Aun así, muchos equipos siguen probándolas a mano o dejan las pruebas para el final, lo que provoca que los errores de lógica y los problemas de seguridad aparezcan tarde, a veces cuando el sistema ya está en manos de los usuarios.
La filosofía Shift-Left Testing plantea lo contrario: mover la verificación hacia las primeras etapas del desarrollo. En vez de concentrar el esfuerzo en una ronda de pruebas manuales al cierre de cada sprint, cada contrato, código de estado y tiempo de respuesta se comprueba automáticamente dentro del propio flujo de CI/CD.
Este proyecto muestra cómo se desarrolló una API REST, cómo se armó una batería de pruebas con Postman y Newman, cómo se configuró un pipeline en GitHub Actions y cómo se publicó el servicio en Render.&lt;/li&gt;
&lt;li&gt;¿Qué herramienta elegir? El caso de Newman
Existen varias opciones para probar APIs. Se eligió Newman porque permite lanzar colecciones de Postman desde la terminal, sin interfaz gráfica, lo que encaja con los runners headless de GitHub Actions. Para cubrir el comportamiento bajo carga, se complementa con k6.&lt;/li&gt;
&lt;li&gt;Cómo está organizada la solución
El diseño tiene un objetivo claro: que ningún cambio que rompa el contrato de la API pueda llegar a producción.
&lt;/li&gt;
&lt;/ol&gt;
&lt;/blockquote&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Commit / PR ──► GitHub Actions ──► Levantar API ──► Newman (pruebas)
                                                        │
                                          ¿Todas pasan? │
                                     ┌──── No ──────────┤
                                     ▼                  ▼ Sí
                              Pipeline falla      Deploy en Render
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;ol&gt;
&lt;li&gt;Desarrollo de la API REST con Node.js y Express
La aplicación es un gestor de tareas que expone:
Método Ruta    Descripción
&lt;code&gt;GET&lt;/code&gt;  &lt;code&gt;/health&lt;/code&gt;  Verifica que el servicio esté activo
&lt;code&gt;GET&lt;/code&gt;  &lt;code&gt;/api/tasks&lt;/code&gt;   Lista las tareas
&lt;code&gt;POST&lt;/code&gt; &lt;code&gt;/api/tasks&lt;/code&gt;   Crea una tarea (con validación estricta)
&lt;code&gt;GET&lt;/code&gt;  &lt;code&gt;/api/tasks/:id&lt;/code&gt;   Obtiene una tarea
&lt;code&gt;PUT&lt;/code&gt;  &lt;code&gt;/api/tasks/:id&lt;/code&gt;   Actualiza el estado de una tarea
&lt;code&gt;DELETE&lt;/code&gt;   &lt;code&gt;/api/tasks/:id&lt;/code&gt;   Elimina una tarea
Servidor principal (&lt;code&gt;src/app.js&lt;/code&gt;):
&lt;/li&gt;
&lt;/ol&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;express&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;require&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'express'&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;cors&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;require&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'cors'&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;taskRoutes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;require&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'./routes/taskRoutes'&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;app&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;express&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;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;use&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;cors&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="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;use&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;express&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&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="c1"&gt;// Health check: confirma que el servicio está activo&lt;/span&gt;
&lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/health'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'healthy'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;service&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'task-management-api'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;timestamp&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Date&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="nf"&gt;toISOString&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;uptime&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sb"&gt;`${Math.floor(process.uptime())}s`&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="p"&gt;;&lt;/span&gt;

&lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;use&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/api/tasks'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;taskRoutes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="kd"&gt;module&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;exports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;ol&gt;
&lt;li&gt;La colección de pruebas en Postman
La colección cubre tanto los escenarios normales como los casos límite.
A. Código de estado y latencia
Cada petición comprueba que el servidor responda con el código esperado y dentro de un tiempo aceptable:
&lt;/li&gt;
&lt;/ol&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Status code is 200 OK"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kd"&gt;function&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;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;have&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;200&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="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Response time is less than 500ms"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kd"&gt;function&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;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;responseTime&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;be&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;below&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;500&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;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;B. Encadenar peticiones con variables dinámicas&lt;br&gt;
Al crear una tarea con &lt;code&gt;POST /api/tasks&lt;/code&gt;, el script recoge el ID asignado por el backend y lo guarda como variable de entorno:&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="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Task was created and ID stored"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kd"&gt;function&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;var&lt;/span&gt; &lt;span class="n"&gt;jsonData&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&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;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;jsonData&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;success&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;be&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;jsonData&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;have&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;property&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'id'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="c1"&gt;// Se guarda el ID para reutilizarlo en las peticiones siguientes&lt;/span&gt;
    &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environment&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="s2"&gt;"createdTaskId"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;jsonData&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&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="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;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Las peticiones posteriores usan &lt;code&gt;{{baseUrl}}/api/tasks/{{createdTaskId}}&lt;/code&gt; para leer, editar y eliminar la misma tarea. El ciclo se cierra verificando que, tras el borrado, una nueva consulta devuelva &lt;code&gt;404 Not Found&lt;/code&gt;.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Ejecutar la suite desde la terminal con Newman
Requisitos
Node.js 20 o superior
npm
Instalación y ejecución local
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Clonar el repositorio&lt;/span&gt;
git clone https://github.com/UsherHalanoccaRojas/api-testing-newman-cicd.git
&lt;span class="nb"&gt;cd&lt;/span&gt; api-testing-newman-cicd

&lt;span class="c"&gt;# Instalar dependencias&lt;/span&gt;
npm install

&lt;span class="c"&gt;# Iniciar la API (puerto 3000)&lt;/span&gt;
npm start
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;En otra terminal, ejecutar la suite completa sin abrir Postman:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx newman run tests/postman/task_api_collection.json \
  -e tests/postman/postman_environment.json \
  --reporters cli,json \
  --reporter-json-export newman-report.json
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Al terminar, la consola muestra un resumen con las peticiones realizadas y las aserciones aprobadas o fallidas, y el detalle queda en &lt;code&gt;newman-report.json&lt;/code&gt;.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;El pipeline en GitHub Actions
La automatización se define en &lt;code&gt;.github/workflows/ci-cd.yml&lt;/code&gt;. Tiene dos jobs: uno que prueba y otro que despliega, este último dependiente del primero.
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;CI/CD Pipeline - API Testing &amp;amp; Automated Deployment&lt;/span&gt;

&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;push&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt; &lt;span class="s"&gt;main&lt;/span&gt; &lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="na"&gt;pull_request&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt; &lt;span class="s"&gt;main&lt;/span&gt; &lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="na"&gt;jobs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;test&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Run API Automated Tests (Newman)&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;

    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Checkout Code&lt;/span&gt;
        &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Setup Node.js&lt;/span&gt;
        &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/setup-node@v4&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;node-version&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'20'&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Install Dependencies&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;npm ci || npm install&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Start API Server in Background&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
          &lt;span class="s"&gt;npm start &amp;amp;&lt;/span&gt;
          &lt;span class="s"&gt;npx wait-on http://localhost:3000/health --timeout 15000&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Execute Postman Suite with Newman CLI&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
          &lt;span class="s"&gt;npx newman run tests/postman/task_api_collection.json \&lt;/span&gt;
            &lt;span class="s"&gt;-e tests/postman/postman_environment.json \&lt;/span&gt;
            &lt;span class="s"&gt;--reporters cli&lt;/span&gt;

  &lt;span class="na"&gt;deploy&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Deploy to Public Cloud SaaS (Render)&lt;/span&gt;
    &lt;span class="na"&gt;needs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;test&lt;/span&gt;
    &lt;span class="na"&gt;if&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;github.ref == 'refs/heads/main'&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Trigger Render Deploy Webhook&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
          &lt;span class="s"&gt;echo "🚀 Desplegando en la nube pública tras validación exitosa de calidad..."&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;Publicación en Render
El proyecto se registró en Render como Web Service vinculado al repositorio de GitHub:
Parámetro  Valor
Build Command   &lt;code&gt;npm install&lt;/code&gt;
Start Command   &lt;code&gt;npm start&lt;/code&gt;
Health Check Path   &lt;code&gt;/health&lt;/code&gt;
Auto-Deploy Solo cuando el pipeline de GitHub Actions termina con éxito&lt;/li&gt;
&lt;li&gt;Pruebas de carga con k6
Que la API funcione bien con un usuario no garantiza que aguante varios a la vez. Este script de k6 sube gradualmente hasta 20 usuarios virtuales, mantiene la carga y luego la reduce:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;http&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'k6/http'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;check&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sleep&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;'k6'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;options&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;stages&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;duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'10s'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;20&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;duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'20s'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;20&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;duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'10s'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&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="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;thresholds&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;http_req_duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'p(95)&amp;lt;300'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;http_req_failed&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'rate&amp;lt;0.01'&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="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&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;res&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'http://localhost:3000/api/tasks'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nf"&gt;check&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="s1"&gt;'status is 200'&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;200&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="nf"&gt;sleep&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="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;Los umbrales exigen que el 95 % de las peticiones respondan en menos de 300 ms y que la tasa de errores se mantenga por debajo del 1 %.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Conclusiones
Detección temprana: al integrar Newman en GitHub Actions, un error que antes podía tardar días en descubrirse ahora se detecta en segundos.
Despliegues seguros: como la publicación depende de que el 100 % de las aserciones pasen, se evita que las regresiones lleguen a producción.
Reutilización: los entornos y variables dinámicas de Postman permiten usar la misma colección en local, staging y producción sin reescribir nada.
Recursos
Repositorio en GitHub: &lt;a href="https://github.com/UsherHalanoccaRojas/api-testing-newman-cicd" rel="noopener noreferrer"&gt;https://github.com/UsherHalanoccaRojas/api-testing-newman-cicd&lt;/a&gt;
Video demostrativo (YouTube, menos de 5 min): &lt;a href="https://youtu.be/dQw4w9WgXcQ" rel="noopener noreferrer"&gt;https://youtu.be/dQw4w9WgXcQ&lt;/a&gt;
API desplegada en Render: &lt;a href="https://api-testing-newman-cicd.onrender.com" rel="noopener noreferrer"&gt;https://api-testing-newman-cicd.onrender.com&lt;/a&gt;
---
Etiquetas: &lt;code&gt;Software Testing&lt;/code&gt; · &lt;code&gt;API&lt;/code&gt; · &lt;code&gt;DevOps&lt;/code&gt; · &lt;code&gt;GitHub Actions&lt;/code&gt; · &lt;code&gt;Postman&lt;/code&gt; · &lt;code&gt;Node.js&lt;/code&gt; · &lt;code&gt;QA&lt;/code&gt;
&lt;/li&gt;
&lt;/ol&gt;

</description>
      <category>api</category>
      <category>cicd</category>
      <category>devops</category>
      <category>testing</category>
    </item>
    <item>
      <title>SmartInventory</title>
      <dc:creator>STEVIE GERALD MARCA AGUILAR</dc:creator>
      <pubDate>Fri, 13 Nov 2026 16:11:12 +0000</pubDate>
      <link>https://dev.to/stevie_geraldmarcaaguil/smartinventory-13e4</link>
      <guid>https://dev.to/stevie_geraldmarcaaguil/smartinventory-13e4</guid>
      <description>&lt;p&gt;Integrantes:&lt;br&gt;
Stevie Gerald Marca Aguilar&lt;br&gt;
Soanny Geraldine Rivas Gutierrez&lt;/p&gt;
&lt;h1&gt;
  
  
  SmartInventory: un inventario que nunca se descuadra, con Couchbase Capella
&lt;/h1&gt;

&lt;p&gt;Un inventario parece un problema sencillo: productos, entradas y salidas. Pero en cuanto se mira de cerca aparecen exigencias serias. El catálogo cambia de forma según el tipo de producto. El stock no puede quedar nunca en negativo, ni siquiera si dos personas registran una salida al mismo tiempo. Y cada cambio tiene que quedar auditado.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;SmartInventory&lt;/strong&gt; es una aplicación web full stack que resuelve eso sobre una sola base de datos NoSQL: &lt;strong&gt;Couchbase Capella&lt;/strong&gt;, la versión gestionada en la nube de Couchbase. En este artículo contamos cómo la construimos, cómo la desplegamos de forma automática y qué aprendimos al probarla con escrituras concurrentes.&lt;/p&gt;
&lt;h2&gt;
  
  
  Enlaces del proyecto
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repositorio público:&lt;/strong&gt; &lt;a href="https://github.com/Stevien04/SmartInventory" rel="noopener noreferrer"&gt;https://github.com/Stevien04/SmartInventory&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Aplicación:&lt;/strong&gt; &lt;a href="https://smartinventory-app.onrender.com" rel="noopener noreferrer"&gt;https://smartinventory-app.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Estado de la API:&lt;/strong&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;/li&gt;
&lt;li&gt;
&lt;strong&gt;Video demostrativo (3 min):&lt;/strong&gt; &lt;a href="https://youtu.be/g1ksH2ASxBw" rel="noopener noreferrer"&gt;https://youtu.be/g1ksH2ASxBw&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;blockquote&gt;
&lt;p&gt;Los servicios están en el plan gratuito de Render: la primera petición después de un rato sin uso puede tardar unos 30 segundos mientras el servidor despierta.&lt;/p&gt;
&lt;/blockquote&gt;


&lt;h2&gt;
  
  
  Video demostrativo
&lt;/h2&gt;

&lt;p&gt;En 3 minutos: la arquitectura, la aplicación funcionando en Render, el rechazo de una salida sin stock, los documentos en Couchbase con una consulta SQL++ y el pipeline de CI/CD.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://youtu.be/g1ksH2ASxBw" rel="noopener noreferrer"&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%2Fn04ucd53wztxiktw7rax.jpg" alt="Video demostrativo de SmartInventory" width="480" height="360"&gt;&lt;/a&gt;&lt;/p&gt;


&lt;h2&gt;
  
  
  1. ¿Por qué Couchbase?
&lt;/h2&gt;

&lt;p&gt;Necesitábamos tres cosas de la base de datos:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Necesidad&lt;/th&gt;
&lt;th&gt;Lo que ofrece Couchbase&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Catálogo flexible, sin migraciones cada vez que cambia un producto&lt;/td&gt;
&lt;td&gt;Documentos JSON sin esquema rígido&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Leer un producto por su ID muy rápido&lt;/td&gt;
&lt;td&gt;Acceso &lt;strong&gt;clave-valor&lt;/strong&gt;: el ID es la clave del documento&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Listar, filtrar y agregar sin aprender un lenguaje nuevo&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;SQL++&lt;/strong&gt;, un SQL para JSON con &lt;code&gt;SELECT&lt;/code&gt;, &lt;code&gt;WHERE&lt;/code&gt;, &lt;code&gt;JOIN&lt;/code&gt; y &lt;code&gt;GROUP BY&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Descontar stock y registrar el movimiento a la vez&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Transacciones ACID&lt;/strong&gt; sobre varios documentos&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Couchbase combina un almacén clave-valor y un motor de consultas sobre el mismo dato, así que no tuvimos que añadir una caché ni un segundo motor. &lt;strong&gt;Capella&lt;/strong&gt; nos dio un clúster gratuito en la nube sin administrar servidores.&lt;/p&gt;
&lt;h2&gt;
  
  
  2. Arquitectura
&lt;/h2&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;        [ Navegador: React 18 + Vite + Tailwind ]        Render Static Site
                          │  HTTPS + JWT
                          ▼
             [ API: Node.js + Express ]                   Render Web Service
                          │  SDK de Couchbase (TLS)
                          ▼
                 [ Couchbase Capella ]                    DBaaS
      bucket smartinventory › scope inventario
      usuarios · categorias · proveedores · productos · movimientos
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;En Couchbase, un &lt;strong&gt;bucket&lt;/strong&gt; equivale a una base de datos, un &lt;strong&gt;scope&lt;/strong&gt; a un esquema y una &lt;strong&gt;collection&lt;/strong&gt; a una tabla. Usamos una colección por tipo de documento.&lt;/p&gt;
&lt;h2&gt;
  
  
  3. El modelo de documentos
&lt;/h2&gt;

&lt;p&gt;Un producto es un documento JSON cuya clave es su propio ID:&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="err"&gt;//&lt;/span&gt; &lt;span class="n"&gt;clave&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;PROD&lt;/span&gt;&lt;span class="mi"&gt;-001&lt;/span&gt;   &lt;span class="n"&gt;colecci&lt;/span&gt;&lt;span class="err"&gt;ó&lt;/span&gt;&lt;span class="n"&gt;n&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;productos&lt;/span&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;"codigo"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"SKU-KB-RGB"&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 RGB Industrial"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"categoriaId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"CAT-001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"proveedorId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"PROV-001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"precioCompra"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;45.0&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.9&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;El campo &lt;code&gt;stockActual&lt;/code&gt; &lt;strong&gt;no se edita desde el catálogo&lt;/strong&gt;. Solo cambia a través de un movimiento, y cada movimiento guarda el antes y el después:&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="err"&gt;//&lt;/span&gt; &lt;span class="n"&gt;clave&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;MOV&lt;/span&gt;&lt;span class="mi"&gt;-1731638400000&lt;/span&gt;&lt;span class="err"&gt;-&lt;/span&gt;&lt;span class="n"&gt;a1b2c&lt;/span&gt;   &lt;span class="n"&gt;colecci&lt;/span&gt;&lt;span class="err"&gt;ó&lt;/span&gt;&lt;span class="n"&gt;n&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;movimientos&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"productoId"&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;"tipo"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"SALIDA"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"cantidad"&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="nl"&gt;"stockAnterior"&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;"stockPosterior"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;13&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"motivo"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Venta"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"usuarioId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"USR-ADMIN-001"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"creadoEn"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"2026-11-14T21:00:00.000Z"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Así el historial completo se puede auditar y reconstruir.&lt;/p&gt;

&lt;h2&gt;
  
  
  4. Implementación
&lt;/h2&gt;

&lt;h3&gt;
  
  
  4.1 Conexión a Capella
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// backend/src/config/couchbase.js&lt;/span&gt;
&lt;span class="n"&gt;cluster&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;couchbase&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;connect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="no"&gt;COUCHBASE_CONNECTION_STRING&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;username&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="no"&gt;COUCHBASE_USERNAME&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;password&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="no"&gt;COUCHBASE_PASSWORD&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;configProfile&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'wanDevelopment'&lt;/span&gt; &lt;span class="c1"&gt;// tiempos de espera pensados para conectarse por Internet&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;bucket&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;cluster&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;bucket&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'smartinventory'&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;bucket&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;waitUntilReady&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;10000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="n"&gt;scope&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;bucket&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;scope&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'inventario'&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;La cadena de conexión empieza por &lt;code&gt;couchbases://&lt;/code&gt; (con &lt;strong&gt;s&lt;/strong&gt;): el tráfico entre Render y Capella va cifrado con TLS.&lt;/p&gt;

&lt;h3&gt;
  
  
  4.2 Clave-valor para leer, SQL++ para listar
&lt;/h3&gt;

&lt;p&gt;Leer un producto por ID no necesita consultas ni índices:&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="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;content&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;scope&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="s1"&gt;'productos'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'PROD-001'&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;Para listar y filtrar usamos SQL++. El repositorio arma la consulta a partir de un filtro y &lt;strong&gt;siempre usa parámetros&lt;/strong&gt;, nunca concatena valores:&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="c1"&gt;// SELECT d.* FROM `productos` AS d WHERE d.`estado` = $estado ORDER BY d.`nombre` ASC&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;resultado&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;scope&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;query&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sql&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;parameters&lt;/span&gt;&lt;span class="p"&gt;:&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;'ACTIVO'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;scanConsistency&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;couchbase&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;QueryScanConsistency&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;RequestPlus&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;&lt;code&gt;RequestPlus&lt;/code&gt; hace que la consulta espere a que los índices incluyan las últimas escrituras. Sin eso, un producto recién creado podría no aparecer en el listado durante unos milisegundos, porque los índices se actualizan de forma asíncrona.&lt;/p&gt;

&lt;p&gt;SQL++ también permite reportes que en otras bases NoSQL exigirían varias consultas. Por ejemplo, el valor del inventario por categoría, con un &lt;code&gt;JOIN&lt;/code&gt; entre colecciones:&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;SELECT&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;nombre&lt;/span&gt; &lt;span class="k"&gt;AS&lt;/span&gt; &lt;span class="n"&gt;categoria&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
       &lt;span class="nb"&gt;SUM&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stockActual&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;AS&lt;/span&gt; &lt;span class="n"&gt;unidades&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
       &lt;span class="nb"&gt;SUM&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stockActual&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;precioCompra&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;AS&lt;/span&gt; &lt;span class="n"&gt;valorCompra&lt;/span&gt;
&lt;span class="k"&gt;FROM&lt;/span&gt; &lt;span class="n"&gt;productos&lt;/span&gt; &lt;span class="k"&gt;AS&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;
&lt;span class="k"&gt;JOIN&lt;/span&gt; &lt;span class="n"&gt;categorias&lt;/span&gt; &lt;span class="k"&gt;AS&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt; &lt;span class="k"&gt;ON&lt;/span&gt; &lt;span class="no"&gt;KEYS&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;categoriaId&lt;/span&gt;
&lt;span class="k"&gt;WHERE&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;estado&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"ACTIVO"&lt;/span&gt;
&lt;span class="k"&gt;GROUP&lt;/span&gt; &lt;span class="k"&gt;BY&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;nombre&lt;/span&gt;
&lt;span class="k"&gt;ORDER&lt;/span&gt; &lt;span class="k"&gt;BY&lt;/span&gt; &lt;span class="n"&gt;valorCompra&lt;/span&gt; &lt;span class="k"&gt;DESC&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Los índices que usan estas consultas se crean con un script (&lt;code&gt;npm run db:init&lt;/code&gt;) o desde el editor de consultas de Capella:&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;INDEX&lt;/span&gt; &lt;span class="n"&gt;idx_productos_estado_nombre&lt;/span&gt; &lt;span class="k"&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="k"&gt;ON&lt;/span&gt; &lt;span class="nf"&gt;productos&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="n"&gt;nombre&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;CREATE&lt;/span&gt; &lt;span class="k"&gt;INDEX&lt;/span&gt; &lt;span class="n"&gt;idx_movimientos_producto_fecha&lt;/span&gt; &lt;span class="k"&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="k"&gt;ON&lt;/span&gt; &lt;span class="nf"&gt;movimientos&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;productoId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;creadoEn&lt;/span&gt; &lt;span class="k"&gt;DESC&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;h3&gt;
  
  
  4.3 El stock nunca queda en negativo: transacciones ACID
&lt;/h3&gt;

&lt;p&gt;La regla de negocio vive en una función pura, fácil de probar:&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="c1"&gt;// backend/src/services/stockService.js&lt;/span&gt;
&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;tipo&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'SALIDA'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;actual&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="n"&gt;cant&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;ErrorNegocio&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`Stock insuficiente: disponible ${actual}, solicitado ${cant}.`&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;nuevoStock&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;actual&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="n"&gt;cant&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;Y la escritura se hace dentro de una &lt;strong&gt;transacción ACID de Couchbase&lt;/strong&gt;, para que el stock del producto y el documento del movimiento se guarden juntos:&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="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;cluster&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;transactions&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="nf"&gt;run&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;ctx&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;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;doc&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;ctx&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&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;productoId&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;calculo&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;validarYCalcularNuevoStock&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stockActual&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="n"&gt;cantidad&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;ctx&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;doc&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="n"&gt;doc&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;content&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stockActual&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;calculo&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stockPosterior&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;ctx&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;insert&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;movimientos&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;movimiento&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;movimiento&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;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Si la validación falla, o si falla cualquiera de las dos escrituras, la transacción se revierte: nunca queda un movimiento registrado con el stock sin actualizar, ni al revés.&lt;/p&gt;

&lt;h2&gt;
  
  
  5. La prueba que nos enseñó algo: escrituras concurrentes
&lt;/h2&gt;

&lt;p&gt;Quisimos comprobar qué pasa si &lt;strong&gt;tres personas registran a la vez una salida del mismo producto&lt;/strong&gt;. Lanzamos tres peticiones simultáneas contra un Couchbase real: salidas de 3 unidades sobre un producto con 5 en stock. Lo correcto es que solo una se aplique.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Primer intento:&lt;/strong&gt; el stock final fue correcto (2 unidades, nunca negativo), pero las dos peticiones que perdieron la carrera devolvieron un error 500:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[ '201 ok',
  '500 unable to create staged replace ec="cas_mismatch (9)"',
  '500 unable to create staged replace ec="cas_mismatch (9)"' ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Couchbase protege cada documento con un &lt;strong&gt;CAS&lt;/strong&gt; (&lt;em&gt;compare-and-swap&lt;/em&gt;): un número de versión que cambia con cada escritura. Cuando dos transacciones leen la misma versión del producto y ambas intentan reemplazarlo, solo la primera lo consigue; la segunda detecta que el CAS ya no coincide. Es &lt;strong&gt;control de concurrencia optimista&lt;/strong&gt;: no se bloquea nada, y el conflicto se detecta al escribir.&lt;/p&gt;

&lt;p&gt;La integridad estaba garantizada, pero para el usuario un 500 no es una buena respuesta. La solución fue &lt;strong&gt;repetir la transacción ante un conflicto&lt;/strong&gt;: al repetirla, vuelve a leer el stock ya actualizado y aplica la regla de negocio sobre el dato real. Los errores de negocio (como "stock insuficiente") no se repiten.&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="k"&gt;for&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;intento&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;intento&lt;/span&gt;&lt;span class="o"&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;try&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;ejecutarTransaccion&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;fn&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;catch&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;error&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;esConflicto&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;error&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;cas_mismatch&lt;/span&gt;&lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="nc"&gt;TransactionFailed&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`${error.name} ${error.message}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;esConflicto&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;intento&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;=&lt;/span&gt; &lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="n"&gt;error&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;esperar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;20&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="n"&gt;intento&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nb"&gt;Math&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;random&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&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="c1"&gt;// pequeña espera aleatoria&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;&lt;strong&gt;Segundo intento&lt;/strong&gt;, con el mismo experimento:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[ '201 ok',
  '400 Stock insuficiente: disponible 2, solicitado 3. No se permite stock negativo.',
  '400 Stock insuficiente: disponible 2, solicitado 3. No se permite stock negativo.' ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Y con tres &lt;strong&gt;entradas&lt;/strong&gt; simultáneas de 4 unidades sobre un stock de 2, las tres se aplicaron y el stock final fue exactamente 14: ninguna actualización se perdió.&lt;/p&gt;

&lt;p&gt;La lección: una transacción ACID garantiza que los datos no se corrompan, pero &lt;strong&gt;la aplicación tiene que decidir qué hacer con los conflictos&lt;/strong&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  6. Diseñado para no caerse
&lt;/h2&gt;

&lt;p&gt;El backend tiene un &lt;strong&gt;repositorio&lt;/strong&gt; como punto único de acceso a los datos, con dos implementaciones de la misma interfaz:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;couchbaseStore.js&lt;/code&gt;: Couchbase Capella, en producción.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;memoria.js&lt;/code&gt;: un almacén en memoria con los mismos datos de ejemplo.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Si las variables de Couchbase no están configuradas, la API arranca igual con el almacén en memoria, y &lt;code&gt;/api/health&lt;/code&gt; lo indica. Esto nos permitió desarrollar el frontend sin conexión a la nube y ejecutar las pruebas de la API en GitHub Actions sin credenciales.&lt;/p&gt;

&lt;h2&gt;
  
  
  7. CI/CD con GitHub Actions y Render
&lt;/h2&gt;

&lt;p&gt;Cada push a &lt;code&gt;main&lt;/code&gt; ejecuta el workflow &lt;code&gt;.github/workflows/deploy.yml&lt;/code&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Instala las dependencias del backend y ejecuta las pruebas: reglas de stock, niveles de alerta y pruebas de la API completa (login, crear producto, entradas, salidas, salida rechazada, alertas y que las consultas SQL++ vayan parametrizadas).&lt;/li&gt;
&lt;li&gt;Compila el frontend con Vite.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Solo si todo pasa&lt;/strong&gt;, llama a los deploy hooks de Render para desplegar el backend (Web Service) y el frontend (Static Site).&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Las credenciales de Capella nunca están en el repositorio: son variables de entorno del Web Service en Render. Las URLs de los deploy hooks se guardan como secrets de GitHub.&lt;/p&gt;

&lt;h2&gt;
  
  
  8. Cómo probarlo
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/Stevien04/SmartInventory.git
&lt;span class="nb"&gt;cd&lt;/span&gt; SmartInventory/backend
cp .env.example .env     &lt;span class="c"&gt;# completar las variables COUCHBASE_*&lt;/span&gt;
npm install
npm run db:init          &lt;span class="c"&gt;# scope, colecciones e índices&lt;/span&gt;
npm run seed             &lt;span class="c"&gt;# datos de ejemplo&lt;/span&gt;
npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Usuario de prueba: &lt;code&gt;admin@smartinventory.com&lt;/code&gt; / &lt;code&gt;Admin2026*!&lt;/code&gt;. Sin credenciales de Couchbase, la API funciona igual con datos en memoria.&lt;/p&gt;

&lt;h2&gt;
  
  
  9. Limitaciones y siguientes pasos
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;El plan gratuito de Capella es un clúster de un solo nodo, así que las transacciones usan durabilidad &lt;code&gt;none&lt;/code&gt;. Con réplicas, basta con cambiar &lt;code&gt;COUCHBASE_TX_DURABILITY=majority&lt;/code&gt; para que cada transacción espere la confirmación de la mayoría.&lt;/li&gt;
&lt;li&gt;Los listados recorren el catálogo completo; con miles de productos convendría paginar.&lt;/li&gt;
&lt;li&gt;El reporte por categoría con &lt;code&gt;JOIN&lt;/code&gt; está en el archivo de consultas, pero todavía no tiene una pantalla propia en la aplicación.&lt;/li&gt;
&lt;/ul&gt;

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

&lt;p&gt;Una sola base de datos NoSQL bien elegida fue suficiente. Couchbase nos dio la flexibilidad de los documentos JSON, la velocidad del acceso clave-valor, la comodidad de SQL++ y la garantía de las transacciones ACID. La prueba de concurrencia fue la parte más valiosa: confirmó que el stock no se descuadra y nos obligó a manejar los conflictos de forma explícita en lugar de devolver errores al usuario.&lt;/p&gt;

&lt;p&gt;El código completo, con las instrucciones para desplegarlo, está en el &lt;a href="https://github.com/Stevien04/SmartInventory" rel="noopener noreferrer"&gt;repositorio público&lt;/a&gt;.&lt;/p&gt;

</description>
      <category>architecture</category>
      <category>database</category>
    </item>
    <item>
      <title>Helpdesk Cloud</title>
      <dc:creator>STEVIE GERALD MARCA AGUILAR</dc:creator>
      <pubDate>Tue, 10 Nov 2026 16:58:56 +0000</pubDate>
      <link>https://dev.to/stevie_geraldmarcaaguil/helpdesk-cloud-4521</link>
      <guid>https://dev.to/stevie_geraldmarcaaguil/helpdesk-cloud-4521</guid>
      <description>&lt;h1&gt;
  
  
  Estrategia de respaldo en bases de datos NoSQL: construcción y despliegue automatizado de HelpDesk Cloud con Cloud Firestore y CI/CD
&lt;/h1&gt;

&lt;p&gt;&lt;strong&gt;Autor:&lt;/strong&gt; Stevie Marca Aguilar , Soanny Geraldine Rivas Gutierrez &lt;br&gt;
&lt;strong&gt;Fecha:&lt;/strong&gt; 10 noviembre de 2026&lt;br&gt;
&lt;strong&gt;Etiquetas:&lt;/strong&gt; nosql, firebase, devops, githubactions&lt;/p&gt;


&lt;h2&gt;
  
  
  1. Problema y objetivo
&lt;/h2&gt;

&lt;p&gt;Las bases de datos NoSQL en la nube son hoy una opción habitual cuando una aplicación necesita esquemas flexibles, baja latencia y alta concurrencia. Pero hay una pregunta que suele quedar para el final: &lt;strong&gt;¿cómo se respalda y se recupera una base de datos que no tiene tablas, que guarda documentos anidados y que vive repartida entre varios centros de datos?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Para responderla con un caso práctico construimos &lt;strong&gt;HelpDesk Cloud&lt;/strong&gt;, una aplicación web de gestión de incidencias de soporte técnico. El objetivo del proyecto fue triple:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Desarrollar una aplicación funcional sobre una base de datos NoSQL documental.&lt;/li&gt;
&lt;li&gt;Publicarla en la nube mediante un flujo de integración y despliegue continuo (CI/CD).&lt;/li&gt;
&lt;li&gt;Diseñar una estrategia de respaldo y recuperación ante desastres adecuada a un motor NoSQL.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Este artículo recorre la arquitectura, el modelo de datos, las funcionalidades, el pipeline de CI/CD y, sobre todo, la estrategia de respaldo.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Enlaces del proyecto&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Repositorio público: &lt;a href="https://github.com/Stevien04/HelpDesk-Cloud" rel="noopener noreferrer"&gt;github.com/Stevien04/HelpDesk-Cloud&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Aplicación desplegada: &lt;a href="https://helpdesk-cloud.onrender.com" rel="noopener noreferrer"&gt;helpdesk-cloud.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Video demostrativo (menos de 5 minutos): &lt;a href="https://www.youtube.com/watch?v=ChbUKJrGsBg" rel="noopener noreferrer"&gt;youtube.com/watch?v=ChbUKJrGsBg&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  2. Por qué NoSQL y por qué Cloud Firestore
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Cloud Firestore&lt;/strong&gt; es una base de datos NoSQL de tipo documental: no almacena filas en tablas, sino documentos (objetos con pares campo-valor) agrupados en colecciones. No exige un esquema fijo, y un documento puede contener sus propias subcolecciones.&lt;/p&gt;

&lt;p&gt;Ese modelo encaja bien con una mesa de ayuda por tres razones:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Atributos variables.&lt;/strong&gt; Una incidencia de hardware no necesita los mismos datos que una de software o de red. En un modelo relacional eso obliga a columnas vacías o a tablas adicionales; en un documento, cada ticket lleva solo los campos que usa.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Jerarquía natural.&lt;/strong&gt; Cada ticket tiene un historial cronológico de intervenciones. En Firestore ese historial es una subcolección del propio ticket, sin tablas intermedias ni JOIN.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Seguridad en el motor de datos.&lt;/strong&gt; La aplicación no tiene servidor propio. Son las reglas de seguridad de Firestore las que validan, en cada lectura y escritura, la identidad del usuario y su rol.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Además, Firestore es un servicio gestionado: escala solo y no requiere administrar servidores.&lt;/p&gt;


&lt;h2&gt;
  
  
  3. Arquitectura y modelo de documentos
&lt;/h2&gt;

&lt;p&gt;La solución tiene tres capas:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;+----------------------------------------------------------------+
|  PRESENTACIÓN                                                  |
|  React 19 + Vite + Tailwind CSS (SPA)                          |
|  Publicada en Render como sitio estático (CDN + HTTPS)         |
+----------------------------------------------------------------+
                         | Firebase Web SDK (HTTPS)
                         v
+----------------------------------------------------------------+
|  SERVICIOS EN LA NUBE                                          |
|  Firebase Authentication      |   Cloud Firestore (NoSQL)      |
|  correo y contraseña, JWT     |   documentos + reglas          |
+----------------------------------------------------------------+
                         ^
                         | gcloud / tarea programada
+----------------------------------------------------------------+
|  RESPALDO Y RESILIENCIA                                        |
|  Point-in-Time Recovery       |   Exportaciones a Cloud Storage|
+----------------------------------------------------------------+
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El modelo de datos usa dos colecciones principales y una subcolección:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;usuarios/{uid}
   nombre, email, rol ('usuario' | 'tecnico' | 'admin'), activo, fechaCreacion

tickets/{ticketId}
   titulo, descripcion, categoriaId, prioridad, estado,
   creadoPor, creadorNombre, asignadoA, asignadoNombre,
   fechaCreacion, fechaActualizacion
   │
   └── historial/{eventoId}
          tipo, autorId, autorNombre, anterior, nuevo, comentario, fecha
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Dos decisiones de diseño merecen comentario:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Desnormalización.&lt;/strong&gt; El ticket guarda &lt;code&gt;creadorNombre&lt;/code&gt; y &lt;code&gt;asignadoNombre&lt;/code&gt; además de los identificadores. Así la lista de tickets se muestra con una sola consulta, sin leer la colección &lt;code&gt;usuarios&lt;/code&gt; por cada fila.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Escrituras atómicas.&lt;/strong&gt; Crear un ticket, asignarlo o cambiar su estado modifica el ticket y agrega un evento al historial dentro de un mismo &lt;code&gt;writeBatch&lt;/code&gt;. O se guardan los dos cambios o no se guarda ninguno, de modo que el historial nunca queda desfasado respecto del ticket.
&lt;/li&gt;
&lt;/ul&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="n"&gt;batch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;update&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;estado&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;newStatus&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;fechaActualizacion&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="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="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="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;'cambio_estado'&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;anterior&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;currentStatus&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="n"&gt;newStatus&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;Las reglas de seguridad (&lt;code&gt;firestore.rules&lt;/code&gt;) completan el modelo:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Operación&lt;/th&gt;
&lt;th&gt;Usuario&lt;/th&gt;
&lt;th&gt;Técnico&lt;/th&gt;
&lt;th&gt;Administrador&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Crear su perfil&lt;/td&gt;
&lt;td&gt;Solo con rol &lt;code&gt;usuario&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;td&gt;Sí&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Cambiar roles&lt;/td&gt;
&lt;td&gt;No&lt;/td&gt;
&lt;td&gt;No&lt;/td&gt;
&lt;td&gt;Sí&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Ver tickets&lt;/td&gt;
&lt;td&gt;Solo los propios&lt;/td&gt;
&lt;td&gt;Solo los asignados&lt;/td&gt;
&lt;td&gt;Todos&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Asignar técnico&lt;/td&gt;
&lt;td&gt;No&lt;/td&gt;
&lt;td&gt;No&lt;/td&gt;
&lt;td&gt;Sí&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Modificar o borrar historial&lt;/td&gt;
&lt;td&gt;No&lt;/td&gt;
&lt;td&gt;No&lt;/td&gt;
&lt;td&gt;No&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;El historial es inmutable para todos los roles, incluido el administrador:&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="n"&gt;match&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;historial&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;eventoId&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;allow&lt;/span&gt; &lt;span class="n"&gt;update&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;delete&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="kc"&gt;false&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;h2&gt;
  
  
  4. Funcionalidades desarrolladas
&lt;/h2&gt;

&lt;p&gt;La aplicación distingue tres roles:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Usuario:&lt;/strong&gt; se registra, crea tickets (título, descripción, categoría y prioridad), sigue su estado y agrega comentarios.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Técnico:&lt;/strong&gt; ve los tickets que tiene asignados, los pasa a «En proceso» y a «Resuelto», y documenta la solución.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Administrador:&lt;/strong&gt; ve todos los tickets, los asigna a técnicos, gestiona roles y consulta reportes.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Un ticket recorre los estados &lt;code&gt;pendiente → en_proceso → resuelto → cerrado&lt;/code&gt;. Las transiciones permitidas dependen del rol: por ejemplo, el técnico puede pasar un ticket de pendiente a en proceso, y el usuario que lo creó lo cierra una vez resuelto; el administrador puede hacer cualquier cambio. Esa lógica está en &lt;code&gt;src/utils/validators.js&lt;/code&gt; y tiene sus propias pruebas unitarias.&lt;/p&gt;

&lt;p&gt;La pantalla de inicio incluye accesos rápidos de demostración para cada rol. Cada uno inicia sesión con una cuenta de demostración real, de modo que los tres roles leen y escriben los mismos datos en Firestore y cualquiera puede recorrer el flujo completo sin registrarse:&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%2Fpbtnec1ehfjse4o99rw1.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%2Fpbtnec1ehfjse4o99rw1.png" alt="Pantalla de inicio de sesión de HelpDesk Cloud" width="800" height="500"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;El módulo de reportes incorpora además un panel con la estrategia de respaldo: niveles, objetivos de recuperación y comandos.&lt;/p&gt;




&lt;h2&gt;
  
  
  5. Repositorio público y organización del código
&lt;/h2&gt;

&lt;p&gt;El código es público en &lt;a href="https://github.com/Stevien04/HelpDesk-Cloud" rel="noopener noreferrer"&gt;github.com/Stevien04/HelpDesk-Cloud&lt;/a&gt; y está organizado así:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;HelpDesk-Cloud/
├── .github/workflows/deploy.yml   # Pipeline de CI/CD
├── docs/                          # Arquitectura, modelo, respaldo y despliegue
├── scripts/firestore-backup.js    # Automatización de la exportación
├── src/
│   ├── components/                # Navbar, Sidebar, TicketCard, TicketForm…
│   ├── context/                   # AuthContext (sesión y rol)
│   ├── hooks/                     # useAuth, useTickets
│   ├── pages/                     # Login, Dashboard, Tickets, Reportes…
│   ├── services/                  # Acceso a Firebase Auth y Firestore
│   └── utils/                     # Validaciones y transiciones de estado
├── tests/                         # Pruebas unitarias (Vitest)
├── firestore.rules                # Reglas de seguridad
├── firestore.indexes.json         # Índices compuestos
└── render.yaml                    # Infraestructura del despliegue
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Las credenciales de Firebase no están en el repositorio: se leen de variables de entorno (&lt;code&gt;.env&lt;/code&gt; en local, secretos en GitHub y en Render). El archivo &lt;code&gt;.env.example&lt;/code&gt; documenta cuáles hacen falta.&lt;/p&gt;




&lt;h2&gt;
  
  
  6. Estrategia de respaldo NoSQL
&lt;/h2&gt;

&lt;p&gt;Respaldar Firestore no se parece a ejecutar &lt;code&gt;pg_dump&lt;/code&gt; o &lt;code&gt;mysqldump&lt;/code&gt; sobre un servidor. Los datos están particionados y replicados entre nodos, la aplicación sigue escribiendo mientras se copia, y hay que conservar la jerarquía de documentos y subcolecciones. Por eso la estrategia combina dos niveles con propósitos distintos.&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 (producción)
                 usuarios · tickets · historial
                     |                    |
        Nivel 1: continuo        Nivel 2: programado
                     v                    v
       Point-in-Time Recovery     Cloud Scheduler (02:00 UTC)
       7 días de retención                |
       recuperación al segundo            v
                                  Exportación a Cloud Storage
                                  Standard → Nearline → Coldline
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Nivel 1: Point-in-Time Recovery (PITR)
&lt;/h3&gt;

&lt;p&gt;PITR conserva las versiones anteriores de los documentos durante 7 días y permite leer o restaurar la base tal como estaba en un instante concreto. Es la defensa contra el error más frecuente: un borrado o una actualización masiva equivocada.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Activar PITR&lt;/span&gt;
gcloud firestore databases update --database=&lt;span class="s2"&gt;"(default)"&lt;/span&gt; \
  --point-in-time-recovery=ENABLE

&lt;span class="c"&gt;# Recuperar el estado de un instante concreto en una base nueva&lt;/span&gt;
gcloud firestore databases clone \
  --source-database=&lt;span class="s2"&gt;"(default)"&lt;/span&gt; \
  --destination-database=&lt;span class="s2"&gt;"helpdesk-restored"&lt;/span&gt; \
  --point-in-time=&lt;span class="s2"&gt;"2026-10-30T20:00:00Z"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Nivel 2: exportaciones programadas a Cloud Storage
&lt;/h3&gt;

&lt;p&gt;PITR solo cubre una semana. Para conservar copias históricas se programa una exportación diaria a un bucket de Cloud Storage, con reglas de ciclo de vida que mueven las copias antiguas a clases de almacenamiento más baratas (Standard los primeros 30 días, luego Nearline y Coldline).&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;gcloud firestore &lt;span class="kd"&gt;export&lt;/span&gt; gs://helpdesk-cloud-backups/&lt;span class="nv"&gt;$(&lt;/span&gt;date +%Y%m%d_%H%M%S&lt;span class="o"&gt;)&lt;/span&gt; \
  --collection-ids=&lt;span class="s1"&gt;'tickets'&lt;/span&gt;,&lt;span class="s1"&gt;'usuarios'&lt;/span&gt;,&lt;span class="s1"&gt;'categorias'&lt;/span&gt;,&lt;span class="s1"&gt;'historial'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Un detalle propio de NoSQL: &lt;code&gt;--collection-ids&lt;/code&gt; filtra por identificador de colección, y las subcolecciones no se incluyen por pertenecer a un documento exportado. Si se omite &lt;code&gt;historial&lt;/code&gt;, la copia contiene los tickets pero no su auditoría.&lt;/p&gt;

&lt;p&gt;El repositorio incluye el script &lt;code&gt;scripts/firestore-backup.js&lt;/code&gt;, que arma y ejecuta este comando con la marca de tiempo del momento:&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://helpdesk-cloud-backups
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Objetivos de recuperación
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Métrica&lt;/th&gt;
&lt;th&gt;Significado&lt;/th&gt;
&lt;th&gt;Objetivo&lt;/th&gt;
&lt;th&gt;Mecanismo&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;RPO&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Cuántos datos se pueden perder, medido en tiempo&lt;/td&gt;
&lt;td&gt;Menos de 1 minuto&lt;/td&gt;
&lt;td&gt;PITR&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;RTO&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Cuánto se tarda en restaurar el servicio&lt;/td&gt;
&lt;td&gt;Menos de 20 minutos&lt;/td&gt;
&lt;td&gt;Clonado o &lt;code&gt;gcloud firestore import&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  Prueba de restauración
&lt;/h3&gt;

&lt;p&gt;Un respaldo que nunca se ha restaurado no es un respaldo fiable. El procedimiento de prueba previsto es:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# 1. Comprobar que la exportación existe&lt;/span&gt;
gsutil ls -l gs://helpdesk-cloud-backups/20261030_020000/

&lt;span class="c"&gt;# 2. Importarla en una base de datos de pruebas, nunca sobre producción&lt;/span&gt;
gcloud firestore import gs://helpdesk-cloud-backups/20261030_020000/ \
  --database=&lt;span class="s2"&gt;"helpdesk-dr-test"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Después se valida que el número de tickets coincide con producción y que cada historial sigue colgando de su ticket.&lt;/p&gt;

&lt;h3&gt;
  
  
  Seguridad de las copias
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Los objetos exportados se cifran en reposo (AES-256) y viajan cifrados entre Firestore y Cloud Storage.&lt;/li&gt;
&lt;li&gt;Solo una cuenta de servicio con el rol &lt;code&gt;roles/datastore.importExportAdmin&lt;/code&gt; puede lanzar exportaciones, siguiendo el principio de menor privilegio.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  7. Flujo CI/CD con GitHub Actions
&lt;/h2&gt;

&lt;p&gt;El pipeline está en &lt;code&gt;.github/workflows/deploy.yml&lt;/code&gt; y se ejecuta en cada &lt;code&gt;push&lt;/code&gt; y en cada pull request hacia &lt;code&gt;main&lt;/code&gt;:&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;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;CI/CD Pipeline - HelpDesk Cloud NoSQL (Render &amp;amp; Cloud)&lt;/span&gt;

&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;push&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;main&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="na"&gt;pull_request&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;branches&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;main&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="na"&gt;jobs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;test_and_build&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/setup-node@v4&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;node-version&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;22&lt;/span&gt;
          &lt;span class="na"&gt;cache&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'npm'&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;npm ci&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;npm run test&lt;/span&gt;

      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;npm run build&lt;/span&gt;
        &lt;span class="na"&gt;env&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;VITE_FIREBASE_API_KEY&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.VITE_FIREBASE_API_KEY }}&lt;/span&gt;
          &lt;span class="na"&gt;VITE_FIREBASE_PROJECT_ID&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.VITE_FIREBASE_PROJECT_ID }}&lt;/span&gt;
          &lt;span class="c1"&gt;# ...resto de variables de Firebase
&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Desplegar a Render&lt;/span&gt;
        &lt;span class="na"&gt;if&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;github.ref == 'refs/heads/main' &amp;amp;&amp;amp; github.event_name == 'push'&lt;/span&gt;
        &lt;span class="na"&gt;env&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;RENDER_DEPLOY_HOOK_URL&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.RENDER_DEPLOY_HOOK_URL }}&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
          &lt;span class="s"&gt;if [ -n "$RENDER_DEPLOY_HOOK_URL" ]; then&lt;/span&gt;
            &lt;span class="s"&gt;curl -s -X POST "$RENDER_DEPLOY_HOOK_URL"&lt;/span&gt;
          &lt;span class="s"&gt;fi&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El orden importa: si una prueba falla, el flujo se detiene y no se llega a compilar ni a desplegar. El despliegue solo ocurre con un &lt;code&gt;push&lt;/code&gt; a &lt;code&gt;main&lt;/code&gt;, no con un pull request.&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 en GitHub Actions" width="800" height="500"&gt;&lt;/a&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  8. Publicación en la nube
&lt;/h2&gt;

&lt;p&gt;La aplicación se publica en &lt;strong&gt;Render&lt;/strong&gt; como sitio estático. La configuración está versionada en &lt;code&gt;render.yaml&lt;/code&gt;:&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;services&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;web&lt;/span&gt;
    &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;helpdesk-cloud&lt;/span&gt;
    &lt;span class="na"&gt;runtime&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;static&lt;/span&gt;
    &lt;span class="na"&gt;buildCommand&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;npm run build&lt;/span&gt;
    &lt;span class="na"&gt;staticPublishPath&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;./dist&lt;/span&gt;
    &lt;span class="na"&gt;routes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
      &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;rewrite&lt;/span&gt;
        &lt;span class="na"&gt;source&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;/*&lt;/span&gt;
        &lt;span class="na"&gt;destination&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;/index.html&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La regla de reescritura es necesaria en una aplicación de una sola página: sin ella, recargar una ruta como &lt;code&gt;/tickets&lt;/code&gt; devolvería un error 404, porque ese archivo no existe en el servidor.&lt;/p&gt;

&lt;p&gt;La aplicación está disponible con HTTPS en &lt;a href="https://helpdesk-cloud.onrender.com" rel="noopener noreferrer"&gt;helpdesk-cloud.onrender.com&lt;/a&gt;.&lt;/p&gt;




&lt;h2&gt;
  
  
  9. Pruebas, dificultades y resultados
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Pruebas.&lt;/strong&gt; El proyecto tiene 13 pruebas unitarias con Vitest, repartidas en dos archivos:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;tests/validators.test.js&lt;/code&gt;: validación de correo y contraseña, validación del formulario de tickets y transiciones de estado permitidas para cada rol.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;tests/backup-strategy.test.js&lt;/code&gt;: parámetros de la estrategia de respaldo (retención de PITR, RPO, RTO y colecciones incluidas).&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Dificultades.&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;em&gt;Las reglas rechazaban la creación de tickets.&lt;/em&gt; Fue el error más instructivo del proyecto. Crear un ticket escribe dos documentos en un mismo lote: el ticket y su primer evento de historial. La regla del historial comprobaba quién era el dueño del ticket con &lt;code&gt;get()&lt;/code&gt;, que consulta el estado de la base &lt;strong&gt;antes&lt;/strong&gt; del lote, cuando el ticket todavía no existe. Resultado: &lt;code&gt;Missing or insufficient permissions&lt;/code&gt; para cualquier usuario que no fuera administrador. La solución fue usar &lt;code&gt;getAfter()&lt;/code&gt;, que evalúa el documento tal como quedará al terminar el lote (regla simplificada):
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;  &lt;span class="n"&gt;allow&lt;/span&gt; &lt;span class="n"&gt;create&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;resource&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;autorId&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;auth&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;uid&lt;/span&gt;
    &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nf"&gt;getAfter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;databases&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;&lt;span class="n"&gt;database&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;documents&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;tickets&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;&lt;span class="n"&gt;ticketId&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;data&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;creadoPor&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="n"&gt;request&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;auth&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;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;em&gt;Un mensaje de éxito que ocultaba el fallo.&lt;/em&gt; El error anterior tardó en aparecer porque la interfaz mostraba una confirmación aunque Firestore hubiera rechazado la escritura. La lección: ante un fallo de guardado, la aplicación debe mostrar el error real, no simular que todo salió bien.&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;La primera ejecución del pipeline falló.&lt;/em&gt; La primera ejecución terminó en error y las siguientes en verde. Tener el pipeline desde el primer commit hizo visible el fallo de inmediato, en lugar de descubrirlo con la aplicación ya publicada.&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;La versión de Node.js importa.&lt;/em&gt; Las versiones actuales de Vite y Vitest no arrancan con Node 20.11; el pipeline fija Node 22 para que el entorno de integración sea siempre el mismo, con independencia de lo que tenga instalado cada integrante.&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;Rutas de una SPA en un hosting estático.&lt;/em&gt; Hubo que añadir la regla de reescritura descrita en el apartado anterior.&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;Subcolecciones y exportaciones.&lt;/em&gt; Como se explicó, el historial debe indicarse de forma explícita al exportar.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;Resultados.&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Aplicación en producción, accesible públicamente y con tres roles operativos.&lt;/li&gt;
&lt;li&gt;Pipeline de CI/CD funcionando: cada cambio en &lt;code&gt;main&lt;/code&gt; se prueba, se compila y se publica sin pasos manuales.&lt;/li&gt;
&lt;li&gt;Estrategia de respaldo de dos niveles documentada, con comandos de activación, exportación y restauración, y objetivos de RPO y RTO definidos.&lt;/li&gt;
&lt;/ul&gt;




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

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Firestore acelera el desarrollo, pero traslada la seguridad a las reglas.&lt;/strong&gt; Sin un servidor intermedio, las reglas son la única barrera entre el navegador y los datos, y hay que diseñarlas con el mismo cuidado que el modelo.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;El modelo documental simplifica la auditoría.&lt;/strong&gt; Guardar el historial como subcolección y escribirlo en el mismo lote que el cambio mantiene la trazabilidad sin lógica adicional.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;El respaldo en NoSQL se diseña, no se improvisa.&lt;/strong&gt; PITR cubre el error reciente con precisión de segundos; las exportaciones cubren la retención a largo plazo. Ninguno de los dos basta por sí solo.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;CI/CD convierte el despliegue en rutina.&lt;/strong&gt; Con pruebas automáticas antes de cada publicación, llevar un cambio a producción deja de ser un momento de riesgo.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;strong&gt;Enlaces&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Repositorio: &lt;a href="https://github.com/Stevien04/HelpDesk-Cloud" rel="noopener noreferrer"&gt;github.com/Stevien04/HelpDesk-Cloud&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Aplicación: &lt;a href="https://helpdesk-cloud.onrender.com" rel="noopener noreferrer"&gt;helpdesk-cloud.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Video: &lt;a href="https://www.youtube.com/watch?v=ChbUKJrGsBg" rel="noopener noreferrer"&gt;youtube.com/watch?v=ChbUKJrGsBg&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>cicd</category>
      <category>cloud</category>
      <category>database</category>
      <category>devops</category>
    </item>
    <item>
      <title>Seguridad automatizada en la nube: integración de Semgrep, Gitleaks y Trivy en un pipeline CI/CD</title>
      <dc:creator>STEVIE GERALD MARCA AGUILAR</dc:creator>
      <pubDate>Fri, 16 Oct 2026 14:36:22 +0000</pubDate>
      <link>https://dev.to/stevie_geraldmarcaaguil/seguridad-automatizada-en-la-nube-integracion-de-semgrep-gitleaks-y-trivy-en-un-pipeline-cicd-1an</link>
      <guid>https://dev.to/stevie_geraldmarcaaguil/seguridad-automatizada-en-la-nube-integracion-de-semgrep-gitleaks-y-trivy-en-un-pipeline-cicd-1an</guid>
      <description>&lt;p&gt;&lt;strong&gt;Por: Stevie Gerald Marca Aguilar y Usher Damiron Halanocca Rojas&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Durante nuestro proyecto, integramos &lt;strong&gt;Semgrep, Gitleaks y Trivy en un pipeline de GitHub Actions&lt;/strong&gt;, conectado al despliegue de una aplicación en Render. El propósito fue establecer una revisión automática de seguridad antes de autorizar la publicación de una nueva versión.&lt;/p&gt;

&lt;p&gt;En este artículo explico cómo organizamos la solución, qué función cumple cada herramienta y qué aprendimos al analizar una aplicación con vulnerabilidades incorporadas intencionalmente.&lt;/p&gt;

&lt;h2&gt;
  
  
  ¿Por qué incorporar seguridad al pipeline?
&lt;/h2&gt;

&lt;p&gt;Durante el desarrollo pueden aparecer problemas que pasan desapercibidos en una revisión funcional. Por ejemplo, una aplicación puede permitir iniciar sesión correctamente y, al mismo tiempo, construir consultas SQL mediante concatenación o tener una clave privada escrita en sus archivos.&lt;/p&gt;

&lt;p&gt;Entre los riesgos que consideramos estuvieron:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Credenciales y tokens almacenados directamente en el repositorio.&lt;/li&gt;
&lt;li&gt;Dependencias con vulnerabilidades publicadas.&lt;/li&gt;
&lt;li&gt;Consultas SQL construidas con datos ingresados por el usuario.&lt;/li&gt;
&lt;li&gt;Ejecución de código mediante funciones inseguras.&lt;/li&gt;
&lt;li&gt;Registro de información sensible en los mensajes de la aplicación.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Revisar estos aspectos manualmente en cada cambio requiere tiempo y puede producir omisiones. Por ello, incorporamos herramientas que ejecutan controles de forma automática y entregan resultados para su revisión.&lt;/p&gt;

&lt;h2&gt;
  
  
  Las herramientas utilizadas
&lt;/h2&gt;

&lt;p&gt;Seleccionamos tres herramientas de código abierto que cubren aspectos diferentes del proyecto.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Herramienta&lt;/th&gt;
&lt;th&gt;Tipo de análisis&lt;/th&gt;
&lt;th&gt;Propósito en el proyecto&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Semgrep&lt;/td&gt;
&lt;td&gt;Análisis estático de código, SAST&lt;/td&gt;
&lt;td&gt;Identificar patrones de programación potencialmente inseguros.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gitleaks&lt;/td&gt;
&lt;td&gt;Detección de secretos&lt;/td&gt;
&lt;td&gt;Buscar credenciales y otros datos sensibles en el repositorio.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Trivy&lt;/td&gt;
&lt;td&gt;Análisis de dependencias y configuración&lt;/td&gt;
&lt;td&gt;Identificar vulnerabilidades conocidas y configuraciones inseguras.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  Semgrep: revisión del código fuente
&lt;/h3&gt;

&lt;p&gt;Semgrep analiza el código mediante reglas que describen patrones que queremos identificar. En nuestro caso, lo utilizamos para revisar una aplicación desarrollada con Node.js y Express.&lt;/p&gt;

&lt;p&gt;El análisis se orientó a encontrar construcciones como consultas SQL inseguras, uso de &lt;code&gt;eval()&lt;/code&gt; y otras prácticas que pueden comprometer la aplicación.&lt;/p&gt;

&lt;p&gt;Su utilidad depende de las reglas seleccionadas y del contexto del código. Por eso, los resultados necesitan una revisión para determinar cuáles representan problemas reales.&lt;/p&gt;

&lt;h3&gt;
  
  
  Gitleaks: búsqueda de credenciales expuestas
&lt;/h3&gt;

&lt;p&gt;Gitleaks permite detectar posibles secretos, como tokens, claves de acceso y credenciales incluidas en archivos versionados.&lt;/p&gt;

&lt;p&gt;En el proyecto lo empleamos para revisar el repositorio y su historial disponible. Esto es relevante porque eliminar una contraseña del archivo actual no significa que desaparezca de los commits anteriores.&lt;/p&gt;

&lt;p&gt;La detección tampoco debe considerarse infalible: algunas credenciales requieren reglas específicas y ciertos ejemplos pueden generar alertas que necesitan revisión.&lt;/p&gt;

&lt;h3&gt;
  
  
  Trivy: revisión de dependencias y configuraciones
&lt;/h3&gt;

&lt;p&gt;Trivy permite analizar distintas partes de una aplicación, entre ellas sus dependencias, imágenes de contenedores y archivos de configuración compatibles.&lt;/p&gt;

&lt;p&gt;En nuestra implementación lo utilizamos principalmente para identificar vulnerabilidades conocidas en las bibliotecas del proyecto. También exploramos el análisis de configuraciones, como las incluidas en un Dockerfile.&lt;/p&gt;

&lt;p&gt;Sus reportes ayudan a reconocer qué componente está afectado y, cuando existe información disponible, qué versión incorpora una corrección.&lt;/p&gt;

&lt;h2&gt;
  
  
  La aplicación de demostración
&lt;/h2&gt;

&lt;p&gt;Para evaluar las herramientas desarrollamos una API REST con Node.js y Express. La aplicación incluía funciones de autenticación, administración de usuarios y búsqueda.&lt;/p&gt;

&lt;p&gt;Incorporamos errores de seguridad de manera intencional para observar el comportamiento de los escáneres.&lt;/p&gt;

&lt;p&gt;Uno de los casos consistió en declarar un secreto directamente en el código:&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="nx"&gt;JWT_SECRET&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;clave_de_prueba_insegura&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;También incluimos una consulta SQL construida con datos del usuario:&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="nx"&gt;query&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt;
  &lt;span class="s2"&gt;`SELECT * FROM users WHERE username = '&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;username&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;'`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Otro ejemplo fue la ejecución dinámica de una transformación:&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="nx"&gt;fn&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;eval&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;`(&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;transform&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;)`&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Finalmente, agregamos registros que exponían contraseñas y versiones antiguas de algunas dependencias.&lt;/p&gt;

&lt;p&gt;Estos casos permitieron comparar los distintos enfoques de análisis. Cada herramienta revisó una parte diferente del problema.&lt;/p&gt;

&lt;h2&gt;
  
  
  Ejecución de los análisis
&lt;/h2&gt;

&lt;p&gt;Antes de configurar la automatización, ejecutamos las herramientas localmente para comprender sus resultados.&lt;/p&gt;

&lt;h3&gt;
  
  
  Análisis con Semgrep
&lt;/h3&gt;

&lt;p&gt;Utilizamos conjuntos de reglas relacionados con Node.js, JavaScript y riesgos de seguridad web:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pip &lt;span class="nb"&gt;install &lt;/span&gt;semgrep

semgrep &lt;span class="nt"&gt;--config&lt;/span&gt; &lt;span class="s2"&gt;"p/nodejs"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
        &lt;span class="nt"&gt;--config&lt;/span&gt; &lt;span class="s2"&gt;"p/javascript"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
        &lt;span class="nt"&gt;--config&lt;/span&gt; &lt;span class="s2"&gt;"p/owasp-top-ten"&lt;/span&gt; &lt;span class="se"&gt;\&lt;/span&gt;
        app/
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La revisión permitió identificar patrones que debían evaluarse y corregirse dentro de la aplicación.&lt;/p&gt;

&lt;h3&gt;
  
  
  Análisis con Gitleaks
&lt;/h3&gt;

&lt;p&gt;En la implementación descrita utilizamos el siguiente comando:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;gitleaks detect &lt;span class="nt"&gt;--source&lt;/span&gt; &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;-v&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El objetivo fue buscar posibles credenciales expuestas en el repositorio. El alcance efectivo de la revisión depende del historial disponible y de la configuración del escaneo.&lt;/p&gt;

&lt;h3&gt;
  
  
  Análisis con Trivy
&lt;/h3&gt;

&lt;p&gt;Para revisar las dependencias ejecutamos:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;trivy fs ./app
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;También realizamos un análisis de configuración:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;trivy config &lt;span class="nb"&gt;.&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Estos resultados permitieron identificar componentes y configuraciones que requerían atención.&lt;/p&gt;

&lt;h2&gt;
  
  
  Correcciones realizadas
&lt;/h2&gt;

&lt;p&gt;Después de revisar los hallazgos, aplicamos cambios en el código y en la gestión de dependencias.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Uso de variables de entorno
&lt;/h3&gt;

&lt;p&gt;Reemplazamos los secretos escritos directamente en los archivos por valores obtenidos desde el entorno:&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="nx"&gt;JWT_SECRET&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;env&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;JWT_SECRET&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;JWT_SECRET&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;La variable JWT_SECRET no está configurada&lt;/span&gt;&lt;span class="dl"&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;Esto permite configurar la credencial sin incluirla en el código fuente. Si una credencial real ya fue expuesta, también debe revocarse o reemplazarse; retirarla del archivo no resuelve por sí solo la exposición anterior.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Consultas parametrizadas
&lt;/h3&gt;

&lt;p&gt;Sustituimos la concatenación de datos por parámetros:&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="nx"&gt;query&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;SELECT * FROM users WHERE username = ?&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nx"&gt;db&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;query&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;username&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="nx"&gt;callback&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Así, el valor ingresado se proporciona por separado de la estructura de la consulta.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Sustitución de &lt;code&gt;eval()&lt;/code&gt;
&lt;/h3&gt;

&lt;p&gt;Reemplazamos la ejecución dinámica por un conjunto definido de operaciones permitidas:&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="nx"&gt;TRANSFORMS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;uppercase&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;user&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nx"&gt;user&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;username&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;user&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;username&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toUpperCase&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="nx"&gt;fn&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;TRANSFORMS&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;transform&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;

&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;fn&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Error&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;Transformación no permitida&lt;/span&gt;&lt;span class="dl"&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;De esta manera, la aplicación selecciona una operación previamente implementada.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Actualización de dependencias
&lt;/h3&gt;

&lt;p&gt;Revisamos las bibliotecas señaladas por Trivy y actualizamos las versiones correspondientes. Después repetimos los análisis para comprobar el efecto de las correcciones.&lt;/p&gt;

&lt;h2&gt;
  
  
  Resultados de la experiencia
&lt;/h2&gt;

&lt;p&gt;Los resultados reportados en el proyecto mostraron una reducción de los hallazgos después de aplicar los cambios.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Herramienta&lt;/th&gt;
&lt;th&gt;Resultado inicial reportado&lt;/th&gt;
&lt;th&gt;Resultado posterior reportado&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Semgrep&lt;/td&gt;
&lt;td&gt;9 hallazgos&lt;/td&gt;
&lt;td&gt;1 hallazgo, considerado falso positivo tras su revisión.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Gitleaks&lt;/td&gt;
&lt;td&gt;3 posibles secretos&lt;/td&gt;
&lt;td&gt;0 hallazgos en la revisión posterior.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Trivy&lt;/td&gt;
&lt;td&gt;4 vulnerabilidades&lt;/td&gt;
&lt;td&gt;0 vulnerabilidades críticas reportadas.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;En Trivy, &lt;strong&gt;no encontrar vulnerabilidades críticas no equivale a no tener vulnerabilidades de otras severidades&lt;/strong&gt;. La interpretación del resultado debe considerar los filtros utilizados.&lt;/p&gt;

&lt;p&gt;Asimismo, la ausencia de alertas en cualquiera de las herramientas no garantiza que la aplicación esté libre de problemas de seguridad.&lt;/p&gt;

&lt;h2&gt;
  
  
  Integración con GitHub Actions
&lt;/h2&gt;

&lt;p&gt;Una vez realizadas las pruebas locales, incorporamos los análisis al flujo automatizado del repositorio.&lt;/p&gt;

&lt;p&gt;El pipeline se configuró para ejecutarse con los cambios enviados a la rama &lt;code&gt;main&lt;/code&gt;. Organizamos el proceso en cuatro trabajos:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Análisis estático con Semgrep.&lt;/li&gt;
&lt;li&gt;Detección de secretos con Gitleaks.&lt;/li&gt;
&lt;li&gt;Revisión de dependencias con Trivy.&lt;/li&gt;
&lt;li&gt;Solicitud de despliegue a Render.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;La dependencia del trabajo de despliegue se expresó de esta forma:&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;deploy&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;needs&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;semgrep&lt;/span&gt;&lt;span class="pi"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;gitleaks&lt;/span&gt;&lt;span class="pi"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;trivy&lt;/span&gt;&lt;span class="pi"&gt;]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Esto hace que ese trabajo espere la finalización satisfactoria de los tres análisis.&lt;/p&gt;

&lt;p&gt;Para disponer del historial completo durante la revisión del repositorio, utilizamos:&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;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;fetch-depth&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="m"&gt;0&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;En el análisis de Trivy configuramos el bloqueo ante vulnerabilidades críticas:&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;severity&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;CRITICAL'&lt;/span&gt;
&lt;span class="na"&gt;exit-code&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;1'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Por tanto, el criterio de aprobación de este análisis estuvo limitado a dicha severidad. Los hallazgos de niveles inferiores requieren una política adicional si también se desea bloquear el despliegue por ellos.&lt;/p&gt;

&lt;h2&gt;
  
  
  Despliegue de la aplicación en Render
&lt;/h2&gt;

&lt;p&gt;Utilizamos Render como plataforma de despliegue de la API. La configuración del servicio definió el directorio de la aplicación, los comandos de instalación y ejecución, y la ruta de comprobación de salud.&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;services&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;web&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;vulnerable-demo-api&lt;/span&gt;
    &lt;span class="na"&gt;runtime&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;node&lt;/span&gt;
    &lt;span class="na"&gt;rootDir&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app&lt;/span&gt;
    &lt;span class="na"&gt;buildCommand&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;npm install&lt;/span&gt;
    &lt;span class="na"&gt;startCommand&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;node server.js&lt;/span&gt;
    &lt;span class="na"&gt;healthCheckPath&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;/health&lt;/span&gt;
    &lt;span class="na"&gt;envVars&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;key&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;JWT_SECRET&lt;/span&gt;
        &lt;span class="na"&gt;sync&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La solicitud de despliegue se realizó mediante un webhook cuya dirección se almacenó en GitHub Secrets como &lt;code&gt;RENDER_DEPLOY_HOOK_URL&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;El flujo planteado fue que GitHub Actions solicitara la publicación después de aprobar los controles. Para que esta condición se cumpla en toda la solución, la configuración de Render también debe evitar despliegues automáticos que omitan ese flujo.&lt;/p&gt;

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

&lt;p&gt;&lt;strong&gt;Integrar seguridad desde el desarrollo facilita detectar problemas antes de publicar.&lt;/strong&gt; Los análisis automáticos aportan una revisión repetible en cada ejecución del pipeline.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Las herramientas se complementan.&lt;/strong&gt; Semgrep revisa patrones del código, Gitleaks busca posibles secretos y Trivy analiza componentes y configuraciones compatibles.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Los reportes necesitan interpretación.&lt;/strong&gt; Una alerta debe revisarse considerando el contexto, mientras que un análisis aprobado debe entenderse según sus reglas, filtros y alcance.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;La gestión de secretos requiere más que eliminarlos del código.&lt;/strong&gt; También es necesario proteger su almacenamiento y reemplazar cualquier credencial real que haya quedado expuesta.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Mantener las dependencias actualizadas es una tarea continua.&lt;/strong&gt; Una versión sin alertas hoy puede presentar vulnerabilidades conocidas posteriormente.&lt;/p&gt;

&lt;p&gt;Este proyecto nos permitió incorporar controles de seguridad al proceso de entrega de software y comprender cómo conectarlos con un despliegue en la nube. Además de ejecutar herramientas, aprendimos a revisar sus resultados y a definir qué condiciones deben cumplirse antes de publicar una nueva versión.&lt;/p&gt;

&lt;p&gt;Aplicativo Prueba: &lt;a href="https://articulo-marca-usher.onrender.com/" rel="noopener noreferrer"&gt;https://articulo-marca-usher.onrender.com/&lt;/a&gt;&lt;br&gt;
Video:&lt;a href="https://studio.youtube.com/video/1DI_BEcRcOk/edit" rel="noopener noreferrer"&gt;https://studio.youtube.com/video/1DI_BEcRcOk/edit&lt;/a&gt;&lt;br&gt;
Git Hub: &lt;a href="https://github.com/Stevien04/Articulo-Marca-Usher.git" rel="noopener noreferrer"&gt;https://github.com/Stevien04/Articulo-Marca-Usher.git&lt;/a&gt;&lt;/p&gt;

</description>
      <category>automation</category>
      <category>cicd</category>
      <category>devops</category>
      <category>security</category>
    </item>
    <item>
      <title>Respaldo y recuperación de MySQL con Railway Aiven y GitHub Actions</title>
      <dc:creator>STEVIE GERALD MARCA AGUILAR</dc:creator>
      <pubDate>Sun, 04 Oct 2026 05:06:11 +0000</pubDate>
      <link>https://dev.to/stevie_geraldmarcaaguil/respaldo-y-recuperacion-de-mysql-con-railway-aiven-y-github-actions-44o6</link>
      <guid>https://dev.to/stevie_geraldmarcaaguil/respaldo-y-recuperacion-de-mysql-con-railway-aiven-y-github-actions-44o6</guid>
      <description>&lt;p&gt;Integrantes: &lt;br&gt;
Stevie Gerald Marca Aguilar&lt;br&gt;
Soanny Geraldine Rivas Gutierrez&lt;/p&gt;

&lt;p&gt;INTRODUCCIÓN&lt;br&gt;
Un inventario necesita conservar información fiable sobre las existencias y los precios. Si se elimina un registro o se modifica por error, una copia anterior permite recuperar su contenido. El código del repositorio reconstruye la aplicación, pero recuperar los datos requiere un respaldo de MySQL.&lt;br&gt;
El proyecto combina una aplicación de inventario en Node.js y Express con una base MySQL. Los scripts generan una exportación completa, la comprimen y la protegen mediante cifrado. GitHub Actions incluye un flujo diario de respaldo, mientras Railway publica la aplicación y la configuración contempla una conexión a MySQL administrado en Aiven.&lt;br&gt;
El documento describe la arquitectura, la preparación del entorno y el procedimiento de recuperación. Incluye las pruebas locales reportadas y las capturas de la publicación del repositorio y de una ejecución manual del backup. La aplicación pública responde y confirma su conexión con MySQL; la ejecución diaria programada debe comprobarse en el historial de Actions.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;1.    Arquitectura del inventario&lt;/strong&gt;&lt;br&gt;
El inventario permite listar productos, registrar nuevas entradas y eliminar registros. Cada producto contiene ID, nombre, precio, cantidad disponible y fecha de creación. Este modelo facilita comparar la información original con los datos obtenidos después de restaurar una copia.&lt;/p&gt;

&lt;p&gt;La Tabla 1 presenta componentes y responsabilidades de la solución.&lt;br&gt;
Tabla 1&lt;br&gt;
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%2Fl189i3us53oq21ppn0ji.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%2Fl189i3us53oq21ppn0ji.png" alt=" " width="699" height="401"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Las pruebas de desarrollo se realizan en el entorno local. Railway ejecuta la API en la nube y la configuración de conexión permite utilizar MySQL en Aiven. El proceso de Actions accede a la base configurada y conserva la copia como artefacto cifrado. El repositorio almacena el código; los archivos de respaldo se descargan aparte y tienen una retención limitada.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Criterios para conservar las copias&lt;/strong&gt;
Para esta base de demostración se eligió una exportación lógica completa. La copia reúne las tablas y sus registros en un archivo SQL que puede revisarse después del descifrado. El procedimiento no incluye respaldos incrementales ni recuperación a un instante específico mediante binlogs.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;La Tabla 2 reúne la frecuencia, la conservación y las condiciones necesarias para recuperar una copia.&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%2F65xubmvbzud2ruiuadfi.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%2F65xubmvbzud2ruiuadfi.png" alt=" " width="717" height="466"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Una copia diaria exitosa permite recuperar el estado guardado en la última ejecución. Por ello, podrían perderse los cambios posteriores, aproximadamente los de un día si se cumple el horario. Los fallos o retrasos aumentan ese intervalo. El tiempo de recuperación debe medirse con la cantidad real de datos; este proyecto no garantiza un RTO concreto.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. Organización y puesta en marcha&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;El proyecto organiza la API, la interfaz y las herramientas de mantenimiento en carpetas separadas. Los archivos de configuración permiten reproducir el entorno local y definir los procesos de pruebas, publicación y respaldo. La Tabla 3 identifica sus elementos principales.&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%2Fxrjerfegs8pj72el3h8l.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%2Fxrjerfegs8pj72el3h8l.png" alt=" " width="601" height="557"&gt;&lt;/a&gt;&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%2F8q3do995gsad49gfb65a.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%2F8q3do995gsad49gfb65a.png" alt=" " width="710" height="483"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;En Windows se prepara el archivo de variables a partir de la plantilla y se asignan claves propias. Docker Desktop debe utilizar contenedores Linux. Desde la carpeta del proyecto, estos comandos levantan los servicios y consultan su estado.&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%2F0tnxomeen38vzcc9i61z.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%2F0tnxomeen38vzcc9i61z.png" alt=" " width="416" height="121"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Los datos de MySQL permanecen en un volumen de Docker. MYSQL_DATABASE, MYSQL_USER y MYSQL_PASSWORD se aplican al inicializar un volumen nuevo. Cambiar esos valores posteriormente no actualiza las cuentas existentes. La aplicación establece la conexión con DB_HOST, DB_PORT, DB_USER, DB_PASSWORD y DB_NAME.&lt;br&gt;
La configuración de laboratorio admite DB_SSL=false en la red local. La conexión externa a Aiven requiere DB_SSL=true y su certificado CA. La comprobación TLS debe validar la confianza del certificado y el nombre del servidor.&lt;/p&gt;

&lt;p&gt;*&lt;em&gt;4.Estructura de datos y operaciones de la API&lt;br&gt;
*&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;La tabla productos usa InnoDB y guarda el precio con dos decimales. El stock no admite cantidades negativas. El SQL actúa sobre la base seleccionada por la conexión, sin imponer un nombre mediante USE; así puede importarse en una base de recuperación distinta.&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%2F90admr1qt5e11hrlgtn1.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%2F90admr1qt5e11hrlgtn1.png" alt=" " width="683" height="320"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;La API ofrece consultas públicas y operaciones de escritura protegidas. Registrar o eliminar productos exige enviar X-API-Key, cuyo valor se define en ADMIN_API_KEY. También se comprueba que el precio sea numérico y no negativo, con hasta dos decimales, y que el stock sea un entero no negativo.&lt;/p&gt;

&lt;p&gt;Las rutas y sus funciones se presentan en la Tabla 4.&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%2Fk11hkvak7u192c2j33tc.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%2Fk11hkvak7u192c2j33tc.png" alt=" " width="695" height="332"&gt;&lt;/a&gt;&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%2Fuchaia28twkieq7c2114.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%2Fuchaia28twkieq7c2114.png" alt=" " width="682" height="799"&gt;&lt;/a&gt;&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%2Fwlcrip5wpa9nyyo6s3wx.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%2Fwlcrip5wpa9nyyo6s3wx.png" alt=" " width="540" height="425"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;5.Generación y protección del respaldo&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Antes de exportar, backup.sh comprueba la configuración y crea un espacio temporal privado. La contraseña se entrega al cliente MySQL mediante un archivo de opciones, evitando incluirla en los argumentos del proceso. Ese archivo se retira cuando finaliza la ejecución.&lt;br&gt;
La exportación se realiza con las siguientes opciones de mysqldump.&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%2Ffkcpi75oob41ldlptuze.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%2Ffkcpi75oob41ldlptuze.png" alt=" " width="458" height="126"&gt;&lt;/a&gt;&lt;br&gt;
La opción --single-transaction obtiene una vista consistente de los datos en tablas InnoDB. Mientras se genera la copia deben evitarse cambios de estructura como ALTER, DROP y TRUNCATE. La exportación cubre la base de la aplicación, pero no incluye las cuentas del servidor, los procedimientos ni los eventos (Oracle, s. f.).&lt;br&gt;
Una vez validada la compresión, crypto.js obtiene la clave mediante scrypt y una sal aleatoria. AES 256 GCM protege el contenido con un nonce aleatorio y una etiqueta de autenticación. El archivo se identifica con la fecha y un valor aleatorio, y se acompaña de un checksum SHA 256. La frase de cifrado debe conservarse por separado mientras se necesiten las copias.&lt;br&gt;
El respaldo local puede ejecutarse desde PowerShell utilizando el contenedor de herramientas.&lt;br&gt;
docker compose --profile tools run --rm tools scripts/backup.sh&lt;br&gt;
Get-ChildItem backups&lt;br&gt;
El archivo .sql.gz.enc contiene datos comprimidos y cifrados; requiere el procedimiento de descifrado antes de leer el SQL. Debe conservarse junto a su archivo de checksum. La retención local elimina copias por antigüedad: siete días no significan necesariamente siete archivos, porque pueden realizarse varias ejecuciones en una misma fecha.&lt;/p&gt;

&lt;p&gt;*&lt;em&gt;6.Restauración y comprobación de los datos&lt;br&gt;
*&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;El script restore.sh recupera la información en otra base para proteger el inventario activo. Primero exige que el destino sea diferente de DB_NAME y esté vacío. Después comprueba el checksum, valida el descifrado y revisa el archivo comprimido antes de importar el SQL.&lt;br&gt;
En el entorno de práctica, una cuenta administradora prepara la base de destino y otorga los permisos necesarios al usuario utilizado por el proyecto.&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%2F395z5svienxwiomfnvcy.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%2F395z5svienxwiomfnvcy.png" alt=" " width="713" height="283"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;La prueba local reportada se ejecutó con MySQL 8.0.46. Se añadió un cuarto producto y se generó el respaldo. Al restaurarlo, se verificaron las cuatro filas y la igualdad de sus campos. Después se eliminó el registro de prueba desde la API y se comprobó que continuaba disponible en la base recuperada.&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%2Fraox1t2e4o1z4ygwj69v.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%2Fraox1t2e4o1z4ygwj69v.png" alt=" " width="697" height="285"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;También se verificó que el procedimiento rechazara una copia alterada, un destino con tablas y un destino con el mismo nombre de la base activa. La importación completa no constituye una operación atómica: ante un fallo parcial, hay que revisar los objetos creados antes de repetirla.&lt;/p&gt;

&lt;p&gt;*&lt;em&gt;7.Conexión de MySQL y publicación en Railway&lt;br&gt;
*&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Para utilizar MySQL en Aiven se toman de su consola el host, el puerto, el usuario, la contraseña y la base, además del certificado CA. Deben emplearse los valores reales del servicio: la base puede ser defaultdb y el puerto puede diferir de 3306. Las guías de conexión explican estos parámetros y el uso del certificado (Aiven, s. f.-a, s. f.-b).&lt;br&gt;
Railway ejecuta el servicio Node.js a partir del Dockerfile. Las variables de entorno indican cómo conectarse a MySQL. El archivo railway.json ejecuta la inicialización antes del despliegue y utiliza /health para revisar el servicio. La inicialización está preparada para conservar una tabla que ya exista.&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%2Fvsxfk48exon834xwgtvj.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%2Fvsxfk48exon834xwgtvj.png" alt=" " width="685" height="425"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;La aplicación publicada dispone de un dominio de Railway. En la comprobación realizada, la página devolvió HTTP 200 y /health respondió con status ok y database MySQL. El servicio escucha en 0.0.0.0 y toma el puerto del entorno. Esta respuesta confirma conectividad con MySQL, pero por sí sola no identifica su proveedor.&lt;br&gt;
El runner de GitHub Actions necesita acceso de red a la base remota. Si se restringen las direcciones permitidas, debe habilitarse la salida del runner o utilizar uno autorizado. Los valores sensibles se almacenan en Secrets y la conexión externa mantiene la verificación TLS.&lt;/p&gt;

&lt;p&gt;**&lt;br&gt;
8.Validación del código y publicación automática**&lt;/p&gt;

&lt;p&gt;La automatización distingue las pruebas del código, el despliegue y la copia de datos. El archivo ci.yml define pruebas de API y cifrado y una recuperación con MySQL 8.4. El flujo deploy.yml espera el resultado de CI en main para publicar el commit que superó las comprobaciones.&lt;br&gt;
El flujo de despliegue recibe la finalización de CI mediante este evento.&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%2Fsyd52tu8uc5wt2l44zkg.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%2Fsyd52tu8uc5wt2l44zkg.png" alt=" " width="499" height="115"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;El despliegue exige una ejecución de CI exitosa originada por un push del propio repositorio y la variable DEPLOY_ENABLED=true. Utiliza RAILWAY_TOKEN y RAILWAY_SERVICE_ID para seleccionar el servicio. Railway describe los Project Tokens para esta automatización (Railway, s. f.-a).&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%2Fc5g2i7t30zbxjfuiztus.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%2Fc5g2i7t30zbxjfuiztus.png" alt=" " width="296" height="43"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Después de railway up se consulta /health en el dominio público. Para comprobar el flujo completo puede modificarse un texto visible, enviar el commit a main y revisar CI, el despliegue y el cambio publicado. Conviene elegir un único mecanismo de publicación para evitar ejecuciones duplicadas. La documentación de railway up describe su comportamiento y opciones (Railway, s. f.-b).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;9. Copias remotas mediante GitHub Actions&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;El flujo backup.yml construye un contenedor con el cliente MySQL 8.4 y llama al mismo script usado en las pruebas locales. Las credenciales de la base y la frase de cifrado se obtienen de Secrets. El artefacto conserva el resultado cifrado y su checksum.&lt;br&gt;
Estas definiciones establecen el horario previsto y la conservación del artefacto.&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%2Fkfhb82qjm2xsakgxv9bn.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%2Fkfhb82qjm2xsakgxv9bn.png" alt=" " width="363" height="265"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;La ejecución requiere BACKUP_ENABLED=true. Se configuran DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME, DB_SSL_CA y BACKUP_PASSPHRASE como Secrets. Para Aiven, BACKUP_DB_SSL debe estar en true. La cuenta de respaldo necesita acceso de lectura y los permisos de los objetos incluidos en la exportación.&lt;br&gt;
La captura incorporada muestra una ejecución iniciada con workflow_dispatch que terminó correctamente y produjo un artefacto descargable. Este resultado acredita una prueba manual. Para verificar el horario diario hay que revisar una ejecución identificada como Scheduled. También debe descargarse la copia y comprobar su restauración en una base vacía usando la misma frase de cifrado.&lt;br&gt;
Los artefactos se descargan desde la página de la ejecución en GitHub Actions; git clone solo obtiene los archivos versionados del repositorio (GitHub, s. f.).&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%2Fa0zqp1p8oma14kedr9pj.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%2Fa0zqp1p8oma14kedr9pj.png" alt=" " width="711" height="400"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;*&lt;em&gt;10. Resultados y evidencias del proyecto&lt;br&gt;
*&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;La Figura 5 documenta el registro de un producto en el inventario local. Esta prueba permite observar la validación y la actualización de la lista, pero no demuestra por sí misma una recuperación ni un despliegue remoto.&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%2F5fpx2p9xb361cl3wvw5e.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%2F5fpx2p9xb361cl3wvw5e.png" alt=" " width="694" height="678"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Las pruebas de recuperación reportadas corresponden a MySQL 8.0.46. El entorno de Docker y los workflows emplean MySQL 8.4. Las nuevas capturas documentan el repositorio público y un backup manual exitoso. La respuesta de /health confirma que la aplicación pública llega a MySQL. Aún debe documentarse la ejecución programada y la restauración del respaldo remoto.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Conclusiones&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;El ejercicio de restauración permitió recuperar un estado anterior del inventario y comparar sus registros. Trabajar con una base de destino independiente evitó sobrescribir los datos activos durante la validación.&lt;br&gt;
La propuesta integra la comprobación del software, su publicación y la protección de sus datos en flujos separados. Railway mantiene accesible la API; la configuración permite conectar MySQL en Aiven, y GitHub Actions ejecuta las tareas definidas en el repositorio.&lt;br&gt;
Para una demostración con pocos datos, la exportación completa ofrece un procedimiento fácil de revisar. Un uso en producción requeriría definir el RPO y la retención según el negocio, añadir alertas y ensayos de recuperación y guardar otra copia independiente. El proyecto no implementa por sí solo una estrategia completa 3 2 1 ni recuperación PITR.&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Enlaces de la entrega
Repositorio público del proyecto: &lt;a href="https://github.com/Soanny/mysql-backup-strategy_Stevie-Marca_Soanny-Rivas" rel="noopener noreferrer"&gt;https://github.com/Soanny/mysql-backup-strategy_Stevie-Marca_Soanny-Rivas&lt;/a&gt;
Aplicación pública en Railway:  &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;
Video público de máximo cinco minutos:  &lt;a href="https://www.youtube.com/watch?v=ViPQl8gZ20U" rel="noopener noreferrer"&gt;https://www.youtube.com/watch?v=ViPQl8gZ20U&lt;/a&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Referencias&lt;br&gt;
Aiven. (s. f.-a). Connect to Aiven for MySQL® from the command line. Recuperado el 3 de octubre de 2026, de &lt;a href="https://aiven.io/docs/products/mysql/howto/connect-from-clI" rel="noopener noreferrer"&gt;https://aiven.io/docs/products/mysql/howto/connect-from-clI&lt;/a&gt;&lt;br&gt;
Aiven. (s. f.-b). Connect to Aiven for MySQL® with MySQL Workbench. Recuperado el 3 de octubre de 2026, de &lt;a href="https://aiven.io/docs/products/mysql/howto/connect-from-mysql-workbench" rel="noopener noreferrer"&gt;https://aiven.io/docs/products/mysql/howto/connect-from-mysql-workbench&lt;/a&gt;&lt;br&gt;
GitHub. (s. f.). Downloading workflow artifacts. Recuperado el 3 de octubre de 2026, de &lt;a href="https://docs.github.com/en/actions/how-tos/manage-workflow-runs/download-workflow-artifacts" rel="noopener noreferrer"&gt;https://docs.github.com/en/actions/how-tos/manage-workflow-runs/download-workflow-artifacts&lt;/a&gt;&lt;br&gt;
Oracle. (s. f.). 6.5.4 mysqldump — A database backup program. Recuperado el 3 de octubre de 2026, de &lt;a href="https://dev.mysql.com/doc/refman/8.4/en/mysqldump.html" rel="noopener noreferrer"&gt;https://dev.mysql.com/doc/refman/8.4/en/mysqldump.html&lt;/a&gt;&lt;br&gt;
Railway. (s. f.-a). Deploying with the CLI. Recuperado el 3 de octubre de 2026, de &lt;a href="https://docs.railway.com/cli/deploying" rel="noopener noreferrer"&gt;https://docs.railway.com/cli/deploying&lt;/a&gt;&lt;br&gt;
Railway. (s. f.-b). railway up. Recuperado el 3 de octubre de 2026, de &lt;a href="https://docs.railway.com/cli/up" rel="noopener noreferrer"&gt;https://docs.railway.com/cli/up&lt;/a&gt;&lt;/p&gt;

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