Design: KeyForge Hive

Responsibility: Job orchestration, API hosting, and State management. Tier: 3 (The Shell)

1. Vertical Slice Architecture

Each feature is self-contained in src/features/<name>.

graph TD
    subgraph "Feature: Register Job"
        Handler[handler.rs]
        Logic[logic.rs]
        Model[models.rs]
    end

    subgraph "Shared Kernel"
        State[AppState]
        DB[UserRepo]
    end

    Handler --> Logic
    Logic --> Model
    Logic --> State
    State --> DB

2. The Worker Protocol (WebSocket)

Hive manages the Work distribution, not the Data distribution.

sequenceDiagram
    participant Agent
    participant Hive
    participant Queue
    participant Assets as AssetServer

    Agent->>Hive: Connect (WS /ws?node_id=X)
    Hive-->>Agent: 101 Switching Protocols

    loop Heartbeat
        Hive->>Agent: Ping
        Agent-->>Hive: Pong
    end

    Note over Hive: Job Submitted

    Hive->>Queue: Check Queue
    Queue-->>Hive: JobID

    Hive->>Agent: { type: "Job", id: "123" }

    Note over Agent: Fetch Assets (Data Plane)
    Agent->>Assets: GET /manifest
    Agent->>Assets: GET /data/corpora/en_std/1grams

    Note over Agent: Optimizing...

    Agent->>Hive: POST /results
    Hive-->>Agent: 200 OK

3. Scope Boundaries

In Scope (Hive)	Out of Scope (Assets)
Job Queue Management	Serving 50MB corpus files
User Authentication	Asset Hashing / Integrity
Result Verification	System Config Distribution
Node Registry