# DRB Server

The server-side stack for the Discord Radio Bot system. Handles command-and-control, Firestore sync, Discord slash commands, and the web frontend.

## Services

| Service | Description | Port |
|---|---|---|
| `mosquitto` | MQTT broker — receives telemetry from edge nodes | 1883 |
| `c2-core` | FastAPI C2 API — processes MQTT, writes to Firestore, manages nodes/systems/tokens | 8888 |
| `discord-bot` | Discord bot — `/join`, `/leave`, `/status` slash commands | — |
| `frontend` | Next.js admin UI — real-time dashboard, node management, call history | 3000 |

## Prerequisites

- Docker + Docker Compose
- A Firebase project with Firestore enabled (Native mode)
- A GCP service account key with Firestore and Firebase Auth permissions
- A Discord bot token (for the server bot that handles slash commands)
- One or more Discord bot tokens in the token pool (for edge nodes to join voice channels)

## Setup

```bash
# 1. Copy env files
make setup

# 2. Fill in secrets
#    drb-c2-core/.env       — MQTT, Firestore database name, GCS bucket
#    drb-server-discord-bot/.env — Discord bot token, C2 URL
#    drb-frontend/.env      — Firebase config (NEXT_PUBLIC_*), C2 URL

# 3. Place your GCP service account key
cp /path/to/your-key.json drb-c2-core/gcp-key.json

# 4. Build and start
make build
make up
```

## Environment Variables

### `drb-c2-core/.env`
| Variable | Description |
|---|---|
| `MQTT_BROKER` | Hostname of the MQTT broker (default: `mosquitto`) |
| `FIRESTORE_DATABASE` | Firestore database name (default: `(default)`) |
| `GCP_CREDENTIALS_PATH` | Path to the GCP key file inside the container |
| `GCS_BUCKET` | GCS bucket name for audio uploads (optional) |

### `drb-server-discord-bot/.env`
| Variable | Description |
|---|---|
| `DISCORD_TOKEN` | Bot token for the server-side command bot |
| `C2_URL` | Internal URL of c2-core (default: `http://c2-core:8000`) |
| `DEV_GUILD_ID` | Optional guild ID to sync slash commands instantly during dev |

### `drb-frontend/.env`
| Variable | Description |
|---|---|
| `NEXT_PUBLIC_FIREBASE_*` | Firebase project config (from Firebase console) |
| `NEXT_PUBLIC_FIRESTORE_DATABASE` | Firestore database name (must match c2-core) |
| `NEXT_PUBLIC_C2_URL` | C2 API URL reachable from the browser |

## Admin Setup

After the stack is running, grant admin access to your Firebase user:

```bash
cd drb-c2-core
python scripts/set_admin.py grant your@email.com
```

Then sign out and back in to the frontend.

## Makefile Targets

```
make setup    — copy .env.example files
make build    — docker compose build
make up       — docker compose up -d
make down     — docker compose down
make logs     — follow all logs
make logs-c2       — c2-core logs only
make logs-bot      — discord-bot logs only
make logs-frontend — frontend logs only
```

## Architecture

```
Edge Node (client machine)
    │
    ├── MQTT checkin/status/metadata ──► mosquitto ──► c2-core ──► Firestore
    │
    └── MQTT commands ◄─────────────────────────────── c2-core
              │
              └── discord_join ──► edge node joins Discord voice + streams Icecast

Discord User
    │
    └── /join /leave /status ──► discord-bot ──► c2-core ──► MQTT ──► edge node

Browser (admin)
    └── frontend ──► Firestore (real-time reads)
                └── c2-core REST API (writes/commands)
```