Communitygithub.com

Trabajos en Segundo Plano

Colas de trabajos con BullMQ/Inngest/Trigger.dev, reintentos de trabajos, colas de mensajes muertos y concurrencia.

¿Qué es Trabajos en Segundo Plano?

Este skill proporciona una guía completa para implementar trabajos en segundo plano utilizando herramientas modernas como BullMQ, Inngest y Trigger.dev. El enfoque principal es descargar tareas lentas (envío de correos, procesamiento de imágenes, webhooks, informes, llamadas a IA) de los manejadores de solicitudes API para mantener la capacidad de respuesta del sistema. Se enfatizan principios clave como la idempotencia de trabajos, reintentos con backoff exponencial, colas de mensajes muertos (DLQ) para evitar la pérdida silenciosa de trabajos fallidos, y límites de concurrencia para prevenir la sobrecarga de workers. El skill incluye patrones de código tanto para BullMQ como para Inngest, cubriendo desde la creación de colas y workers hasta la definición de estrategias de reintento y límites de concurrencia. Es útil para desarrolladores que necesiten procesar trabajos de manera fiable y escalable en aplicaciones Node.js.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/background-jobs

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Trabajos en Segundo Plano?

Reglas

  • Descargar trabajos lentos a tareas en segundo plano: correos electrónicos, procesamiento de imágenes, webhooks, informes, llamadas a IA
  • BullMQ para colas Redis auto-alojadas — Inngest o Trigger.dev para entornos serverless/gestionados
  • Cada trabajo debe ser idempotente — seguro de reintentar sin efectos secundarios (usar claves de idempotencia)
  • Reintentar con backoff exponencial: 3-5 intentos, demoras de 1s, 10s, 60s, 5min
  • Cola de mensajes muertos (DLQ): después de los reintentos máximos, mover a DLQ para investigación — nunca descartar en silencio
  • Establecer límites de concurrencia por cola — evitar sobrecarga del worker (ej., concurrency: 5)
  • Las cargas útiles de los trabajos deben ser pequeñas: pasar IDs y referencias, no objetos completos
  • Separar colas por prioridad: critical (pagos), default (correos electrónicos), low (análisis)
  • Monitorear la profundidad de la cola y el tiempo de procesamiento — alertar cuando la cola se acumule

Patrones

// Patrón BullMQ
import { Queue, Worker } from "bullmq";
const queue = new Queue("emails", { connection: redis });

await queue.add("welcome", { userId }, {
  attempts: 3,
  backoff: { type: "exponential", delay: 1000 },
});

const worker = new Worker("emails", async (job) => {
  await sendWelcomeEmail(job.data.userId);
}, { connection: redis, concurrency: 5 });
// Patrón Inngest serverless
import { inngest } from "./client";

export const sendEmail = inngest.createFunction(
  { id: "send-welcome-email", retries: 3 },
  { event: "user/created" },
  async ({ event }) => { await sendWelcomeEmail(event.data.userId); }
);

Evitar

  • Procesar tareas lentas en manejadores de solicitudes API — responder rápido, procesar en segundo plano
  • Trabajos no idempotentes — la ejecución duplicada causará dobles cargos, dobles correos
  • Concurrencia sin límite — agotará las conexiones de base de datos y la memoria
  • Almacenar cargas útiles grandes en la cola de trabajos — pasar referencias en su lugar

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Skills relacionados