# Context and Scope

## Business Context

```txt
┌─────────────────┐       Discord API         ┌──────────────────┐
│  Discord Users  │◄───────────────────────►  │   omo-bot        │
│  (Community)    │   slash cmds, embeds      │   (Discord Bot)  │
└─────────────────┘                           └────────┬─────────┘
                                                       │
                                         OAuth2 + REST │
                                                       ▼
                                           ┌────────────────┐
                                           │ openmicodyssey │
                                           │ .com (Web App) │
                                           └────────────────┘
```

## Technical Context

| Partner            | Protocol                   | Data                                    | Description                          |
| ------------------ | -------------------------- | --------------------------------------- | ------------------------------------ |
| Discord API        | WebSocket (Gateway) + REST | Messages, roles, events, voice states   | Bot core communication               |
| YouTube Data API   | HTTPS (REST + polling)     | Video metadata, thumbnails              | Auto-post new uploads to #screenings |
| Instagram API      | HTTPS (REST + polling)     | Image URLs, captions                    | Auto-post to #polaroids-from-the-van |
| TikTok API         | HTTPS (REST + polling)     | Video metadata                          | Auto-post to #outtakes               |
| openmicodyssey.com | HTTPS (OAuth2 + REST)      | User profiles, mileage data, map routes | Web session sync                     |

## Scope

**In scope:** Discord bot commands, reaction-role management, event queue, content webhook syndication, mileage tracking, admin dashboard API.

**Out of scope:** The main `openmicodyssey.com` website frontend, native mobile apps, third-party content moderation.