508.dev Integrations

Monorepo for the 508.dev operations automation stack: Discord workflows, the FastAPI operations dashboard, background jobs, CRM sync, and shared integration clients.

What Is In This Repo

Path	Purpose
apps/discord_bot	Discord gateway process and slash-command cogs.
apps/api	FastAPI backend, protected ingest endpoints, auth, and /dashboard.
apps/admin_dashboard	React + Vite admin dashboard source.
apps/worker	Queue consumer, job handlers, CRM processors, and Alembic migrations.
packages/shared	Shared settings, queue helpers, integration clients, CRM utilities, and agent code.
scripts	Local development, test, formatting, and Compose helpers.
docs	Feature and operational documentation.

Quickstart

Install dependencies:

uv sync

Create local configuration:

cp .env.example .env

Start the dashboard/API, worker, and local infrastructure without the Discord bot:

./scripts/dev.sh no-bot

In another terminal, create a local dashboard login link:

./scripts/dev.sh login

Open the printed link, then use the dashboard at /dashboard.

To run the Discord bot too:

./scripts/dev.sh all

Common Commands

./scripts/dev.sh infra       # Redis, Postgres, MinIO only
./scripts/dev.sh web         # FastAPI dashboard/API with reload
./scripts/dev.sh worker      # worker consumer with reload
./scripts/dev.sh discord-bot # Discord bot process
./scripts/dev.sh no-bot      # infra + dashboard/API + worker
./scripts/dev.sh login       # local/dev dashboard login link
./scripts/dev.sh ports       # deterministic worktree ports
./scripts/dev.sh down        # stop local Docker infra

./scripts/test.sh
./scripts/lint.sh
./scripts/format.sh
./scripts/mypy.sh

For workspace archival, stop host-run dev processes and Docker Compose together:

./scripts/archive-workspace.sh --dry-run
./scripts/archive-workspace.sh

./scripts/dev.sh env emits shell-safe exports for the current worktree and avoids printing the resolved Postgres password directly.

Documentation

• Development Guide: local setup, service commands, dashboard login, Compose workflow, quality checks, and CLIs.
• Architecture: services, job model, auth model, deployment shape, and extension points.
• Configuration Reference: environment variable groups and local/runtime configuration notes.
• API Service: backend endpoints and dashboard auth routes.
• Worker Service: job CLI, worker endpoints, and queue usage examples.
• Discord Bot: bot commands and Discord-specific workflows.
• Discord Gig Dashboard: gig tracking and dashboard behavior.
• Discord Agent Eval Harness: Discord agent eval workflow.

Deployment

Production runs as a Compose application with independently restartable discord_bot, web, and worker services plus Redis, Postgres, and MinIO. See Architecture and Configuration Reference before changing runtime configuration.

License

This repository is licensed under the GNU Affero General Public License v3.0. See LICENSE.