DEV Community: Gersom Hernandez Ramos

¿Qué pasa cuando el switchMap no es suficiente?

Gersom Hernandez Ramos — Tue, 03 Feb 2026 03:29:01 +0000

En el desarrollo mobile (Ionic + Angular), solemos confiar en RxJS para encadenar peticiones. Todo funciona genial con switchMap hasta que entra en juego el mundo real: la falta de conexión.

Recientemente tuve que implementar un flujo crítico para ventas:
1️⃣ Crear ticket.
2️⃣ Obtener geolocalización.
3️⃣ Actualizar ticket con GPS.
4️⃣ Crear registro de prospecto.

El problema: Si el internet fallaba en el paso 3, terminábamos con datos huérfanos y procesos duplicados al reintentar. El switchMap moría con la suscripción.

La solución: Un Orquestador Offline con SQLite. 💡

En lugar de disparar y rezar, implementé una estrategia de Cola con Checkpoints:

Persistencia Local: Creé un servicio QueueLeads en SQLite. Cada paso del proceso se guarda localmente con un estado.

Orquestador de Estados: Un servicio que actúa como máquina de estados. No procesa todo en un for (porque los Observables son asíncronos), sino que toma el último registro pendiente, revisa en qué paso se quedó y lo retoma.

Resiliencia: Si la app se cierra o se pierde la señal, el orquestador se reinicia en cuanto hay conexión, leyendo la base de datos y continuando exactamente donde falló.

Resultado: Eliminamos el 100% de los datos duplicados y aseguramos que cada venta se registre, sin importar si el vendedor está en un sótano sin señal.

A veces, la mejor decisión técnica no es usar el operador más complejo de RxJS, sino dar un paso atrás y asegurar la integridad de los datos en el disco.

¿Alguna vez te ha tocado lidiar con flujos offline complejos? Te leo en los comentarios. 👇

TaskMaster el futuro del desarrollo con IA

Gersom Hernandez Ramos — Thu, 03 Jul 2025 21:08:12 +0000

¡Hola, programadores!

Con la llegada de la inteligencia artificial y los agentes, la programación ha dado pasos agigantados. Agentes como Cursor son herramientas muy útiles para tareas repetitivas que, comúnmente, nos llevarían más tiempo del necesario. Hace unos días, realicé un pequeño proyecto en Angular 18. Le pedí el diseño a Cursor y, al implementar una arquitectura hexagonal, solicité a Cursor todos los archivos necesarios con un prompt específico. Hasta aquí, todo bien. Todos hemos realizado algún trabajo con IA, ¿pero qué sucede si queremos crear un sistema grande, como un ERP o un CRM?

El problema: La sobrecarga de contexto

Como sabemos, las solicitudes a la IA se generan a través de tokens. Esto nos lleva a la ventana de contexto. No sé si les ha pasado que están trabajando en una ventana y la IA no puede responder más. Esto ocurre porque llegamos al límite del contexto que la IA puede almacenar en memoria. Google ha solucionado esto en parte, pero ese no es el tema principal. El verdadero desafío es realizar un proyecto grande sin perder el contexto.

La solución: TaskMaster

¿Pero qué es TaskMaster?

TaskMaster es un sistema de gestión de tareas que descompone proyectos complejos en tareas manejables. Es decir, en lugar de pedirle a nuestro agente (como Cursor) que recuerde todo lo que ya hizo o lo que hará, ahora le daremos *pequeños pasos, como si fuera una receta. Véamoslo así: sin importar la complejidad de la comida que queramos cocinar, si seguimos la receta al pie de la letra, podremos hacerla. No necesitamos memorizar ni los pasos ni los ingredientes; solo necesitamos saber qué hemos hecho y cuál es el siguiente paso.

TaskMaster tiene como propósito principal mantener a tu agente de IA en el camino correcto, eliminando la sobrecarga de contexto y evitando que la IA rompa nuestro código.

Características principales:

CLI independiente: Cuenta con una interfaz de línea de comandos (CLI) que es independiente de la plataforma o editor de texto.
Integración con editores de IA: Diseñado para integrarse perfectamente con editores de código impulsados por IA como Cursor AI, Lovable, Windsurf y Roo.
Soporte MCP: Incluye un servidor MCP, lo cual es excelente porque no necesitas cambiar de contexto a una ventana diferente.
Powered by Claude: Utiliza la API de Anthropic (Claude).
Open source: Completamente gratuito y de código abierto. Solo necesitas traer tus propias claves API.

Si bien este artículo no se centrará en su funcionamiento interno, veamos un caso simple.

Nuestro ejemplo

Actividad: Realizar una aplicación en Angular 19 que gestione tareas asignadas, que tenga autenticación con JWT y que use técnicas de refresh token al expirar nuestro token principal.

Este es nuestro prompt principal, pero si te das cuenta, hay muchos vacíos, como si debería usar Tailwind o CSS puro con SASS, o si debe tener una guía de estilos específica, entre otras cosas. Aquí es donde entra nuestro TaskMaster.

Este prompt sencillo lo guardaremos en un archivo prd.txt y se lo pasaremos a TaskMaster para que genere las tareas usando:

task-master parse-prd scripts/prd.txt
task-master generate

Con esto, TaskMaster generará algunos archivos para que nuestro editor siempre tenga el contexto sin saturar la ventana del mismo:

proyecto/
├── scripts/
│   └── prd.txt
├── tasks/
│   ├── task_001.txt
│   ├── task_002.txt
│   └── ...
├── tasks.json
└── .cursor/
    └── rules/
        └── dev_workflow.mdc

Ahora podemos ver y trabajar con tareas usando:

task-master list # ver todas las tareas
task-master next # ver cuál es la siguiente tarea a trabajar
task-master set-status --id=1 --status=done # marcamos como completada una tarea

Aquí tienes un ejemplo de la salida de task-master list:

=== PROJECT TASKS ===
📋 Total Tasks: 8
✅ Completed: 2
🔄 In Progress: 1
⏳ Pending: 5
=== TASK LIST ===
[001] ✅ DONE     | Setup project structure and dependencies  | Priority: high    | Dependencies: none
[002] ✅ DONE     | Create database schema and models         | Priority: high    | Dependencies: 001
[003] 🔄 PROGRESS | Implement user authentication system      | Priority: high    | Dependencies: 002
[004] ⏳ PENDING  | Build user registration API endpoint      | Priority: medium  | Dependencies: 003
[005] ⏳ PENDING  | Create login/logout functionality         | Priority: medium  | Dependencies: 003
[006] ⏳ PENDING  | Implement JWT token management            | Priority: medium  | Dependencies: 004, 005
[007] ⏳ PENDING  | Build todo CRUD operations                | Priority: high    | Dependencies: 006
[008] ⏳ PENDING  | Create frontend components                | Priority: low     | Dependencies: 007

Si lo integramos a nuestro editor como servidor MCP, podemos usar lenguaje natural como:

"¿Puedes parsear mi PRD en scripts/prd.txt?"
"¿Cuál es la siguiente tarea en la que debo trabajar?"
"Ayúdame a implementar la tarea 3."
"La tarea 2 está completa, actualiza su estado."

Y lo mejor es que podemos hacer las tareas aún más pequeñas. Con esto, nuestro agente podrá realizar tareas más eficientes y sin dañar código que ya esté revisado.

Conclusión

Este es un preview de TaskMaster. Estaré realizando algunos proyectos para mi portafolio personal y, después, haré un post paso a paso de cómo utilizarlo con un proyecto de la vida real.

Por ahora, esto es todo, Devs. Les mando un saludo y recuerden que nunca es tarde para empezar a aprender.

Por favor, envíame un tweet a @gersomsim y dime qué te pareció este primer vistazo.

¡Gracias por leer y saludos! 😎

🚀 Deploy Your Astro Static Site on Railway

Gersom Hernandez Ramos — Sun, 15 Jun 2025 01:59:48 +0000

Before we begin, note that there are two ways to deploy an Astro site on Railway:

If your website uses SSR (Server-Side Rendering) or adapters.
If your website is completely static.

This post focuses on the second option: deploying a fully static Astro site on Railway.

1. Initialize Your Astro Project

First, create your Astro project. Open your terminal and run:

npm create astro@latest

Follow the prompts to set up a static site. In my case, I'm building a personal portfolio to showcase my projects.

You can fork or contribute to my repo here: https://github.com/Gersomsim/Pesonal-web

2. Prepare Your Site for Deployment

Once your site is ready, modify your package.json:

"scripts": {
  "dev": "astro dev",
  "build": "astro build",
  "preview": "astro preview",
  "start": "npx serve dist" // Crucial for static Astro sites
}

Then add this at the end of package.json:

"engines": {
  "node": ">=18.0.0" // Tells Railway the minimum Node.js version
}

3. Configuration Files

3.1 astro.config.mjs

Projects scaffolded with Astro default to static output. Just confirm:

import { defineConfig } from 'astro/config';

export default defineConfig({
  // output: "static" (default value)
});

Uncomment the output line if unsure, but it’s static by default.

3.2 Create Railway’s Config File (railway.json)

Add this to instruct Railway’s builder:

{
  "builds": [
    {
      "src": "package.json",
      "use": "@railway/nixpacks"
    }
  ]
}

3.3 Optional: static.json (Static Server Config)

Create this file to configure static file serving:

{
  "root": "dist",
  "clean_urls": true,
  "routes": {
    "**": "index.html"
  }
}

Ready to Deploy!

With these steps complete, your static site is prepped for Railway.

Deployment is straightforward:

1.- Log into Railway with your GitHub account
2.- Grant repository access
3.- Select your repo
4.- Railway handles the rest automatically

Why Railway?

You might wonder: "Why Railway over Vercel/Netlify?" While alternatives exist, I chose Railway for its $5/month Hobby Plan. This lets me host:

Frontend projects
Backend APIs (Laravel, NestJS, etc.)
My entire portfolio

For the price of a coffee, I avoid juggling multiple services.

Thanks for reading my first post! 🚀

Cheers!