reloopsh/be-workflow repository overview

⁠⚙️ Reloop — Workflow Service

The Workflow Service is the background job and workflow orchestration microservice in the Reloop⁠ platform. It processes async tasks — such as sending emails, handling events, and running scheduled operations — using BullMQ queues, and includes a built-in Bull Board dashboard for real-time job monitoring.

Built on Bun⁠ + Elysia⁠, backed by PostgreSQL and Redis.

⁠🚀 Features

• BullMQ Queues — Reliable background job processing with Redis-backed queues
• Bull Board Dashboard — Built-in UI at /api/workflow/bull-board for job monitoring
• Workflow Orchestration — Coordinate multi-step async workflows
• Retry & Backoff — Automatic retry logic for failed jobs
• OpenTelemetry — Full distributed tracing support
• API Key Auth — Secured via x-api-key header
• OpenAPI Docs — Auto-generated spec at /api/workflow/openapi
• NATS Bus — Event-driven trigger integration

⁠🔗 Quick Links

⁠⚡ Quick Start

docker pull reloopsh/be-workflow:latest

docker run -d \
  -p 8017:8017 \
  -e PG_URL=postgresql://user:password@host:5432/reloop \
  -e REDIS_URL=redis://:password@host:6379 \
  -e NATS_URL=nats://host:4222 \
  -e BASE_URL=https://your-domain.com \
  reloopsh/be-workflow:latest

• API: http://localhost:8017/api/workflow
• Bull Board: http://localhost:8017/api/workflow/bull-board

⁠🔧 Environment Variables

⁠🛠 Tech Stack

• Runtime: Bun⁠
• Framework: Elysia⁠
• Queue: BullMQ⁠
• Dashboard: Bull Board⁠
• Database: PostgreSQL via Drizzle ORM⁠
• Cache / Queue Store: Redis
• Messaging: NATS
• Observability: OpenTelemetry (OTLP)

⁠📦 Part of the Reloop Platform

This image is one of several microservices that make up the Reloop backend. See the full list at hub.docker.com/u/reloopsh⁠.