🛰️ DevFleet — Remote Server & Job Runner as a Service

DevFleet is a self-hosted, developer-focused job orchestration platform.
Think of it as a hybrid between GitHub Actions, Elastic Beanstalk, and Node-based cron job runners — except it runs entirely on your infrastructure and is fully extensible.

Run and monitor scripts on any remote machine you control — securely, reliably, and with full observability.

---

🔧 Use Cases

• Run shell commands across remote dev servers, edge devices, or cloud VMs
• Replace fragile SSH scripts with token-authenticated job agents
• Schedule cron jobs via a UI, with real-time logs and retry handling
• Self-hosted alternative to GitHub Actions, tailored to your infra

---

⚙️ System Overview

    User → Web App → REST → Backend → PostgreSQL + Redis
    ↓
    Scheduler / Runner
    ↓
    Agent (via WebSocket)
    ↓
    Logs → Backend ← Job Status
    ↓
    Web UI

---

🏗️ Architecture

Core Components

Component	Tech Stack	Role
Backend API	Node.js + Express	Manages jobs, agents, auth
Scheduler	Node + Cron + BullMQ	Schedules future jobs
Agent CLI	Golang + WebSocket	Executes scripts on remote servers
Database	PostgreSQL	Stores jobs, runs, agents, logs
Queue	Redis + BullMQ	Dispatches jobs to runners
Frontend	Vue	Dashboard to manage jobs and view logs
Network Layer	Tailscale / Ngrok	NAT-safe agent connectivity

High-Level Diagram

            +----------------------------+
            |     Web Dashboard (UI)     |
            +-------------+--------------+
                          |
                          v
            +-------------+--------------+
            |         Backend API        |
           +-------------+--------------+
                          |
          +---------------+-------------------------------+
          |               |                               |
          v               v                               v
    +----------+   +----------------+           +---------------------+
    |PostgreSQL|   |Redis + BullMQ  |<--------->|   Cron Scheduler    |
    |(jobs/logs)|   |(Queue system) |           |(Node + TTL Watchers)|
    +----------+   +----------------+           +---------------------+
                          |
                          v
              +-----------+-----------+
              |     Job Runner Service |
              +-----------+-----------+
                          |
                          v
            +-------------+--------------+
            |      Remote Agent (CLI)    |
            | - WebSocket listener       |
            | - Push logs & status       |
            +-------------+--------------+
                          |
            +-------------+--------------+
            | Tailscale / Ngrok (Optional)|
            +-----------------------------+

---