graph LR
  subgraph ROUTES["Express API Routes"]
    direction TB
    R1["auth\nLogin, Logout, Users, Tokens"]
    R2["releases\nCRUD + Phase + Lifecycle"]
    R3["bot\nStart, Stop, Actions"]
    R4["integrations\nConfig + Test Connection"]
    R5["clickup\nMulti-List Tasks + Sync"]
    R6["test-runs\nResults + Triage + Suggestions"]
    R7["webhooks\nGitHub, ClickUp Events"]
    R8["sideload\nTokenized Build Upload"]
    R9["system\nHealth + Uptime"]
  end

  classDef route fill:#15151e,stroke:#448aff,stroke-width:1px,color:#e8e8f0
  class R1,R2,R3,R4,R5,R6,R7,R8,R9 route
          

sequenceDiagram
  participant U as User
  participant API as Bot API
  participant E as OpenAI Engine
  participant T as Tool Executor
  participant I as Integrations
  participant DB as PostgreSQL

  U->>API: POST action
  API->>E: processMessage
  loop Tool Calling max 10
    E->>E: Chat Completion
    E->>T: Execute tools
    T->>I: Integration action
    I-->>T: Results
    T-->>E: Tool outputs
  end
  E->>DB: Log results
  E-->>API: Reply
  API-->>U: JSON response
          

graph TB
  subgraph SCHEDULER["Three-Tier Execution"]
    direction TB
    Q["Job Queue\nPolls bot_jobs every 5s"]
    C["Cron Tasks\nClickUp sync: 15m\nDataDog check: 10m"]
    W["Webhook Triggers\nGitHub PR, ClickUp events"]
  end

  Q --> ENG2["Bot Engine\nprocessMessage"]
  C --> ENG2
  W --> ENG2

  ENG2 --> DB2["PostgreSQL\nbot_jobs table"]
  ENG2 --> EVT["Event Bus\nWebSocket broadcast"]

  classDef sched fill:#15151e,stroke:#e91e8c,stroke-width:2px,color:#e8e8f0
  classDef engine fill:#15151e,stroke:#ffd740,stroke-width:2px,color:#e8e8f0
  classDef store fill:#15151e,stroke:#00e676,stroke-width:2px,color:#e8e8f0

  class Q,C,W sched
  class ENG2 engine
  class DB2,EVT store
          

erDiagram
  users ||--o{ sessions : has
  users ||--o{ upload_tokens : issues
  releases ||--o{ test_runs : tracks
  releases ||--o{ mobile_builds : receives
  releases ||--o{ release_approvals : gates
  test_runs ||--o{ test_failures : contains
  test_failures ||--o{ bug_suggestions : proposes
  bot_jobs }o--|| releases : belongs-to
  upload_audit }o--|| upload_tokens : logs

  users {
    int id PK
    varchar email
    varchar name
    varchar role
    timestamp created_at
  }
  releases {
    int id PK
    varchar tag
    varchar app
    varchar phase
    int bugs
    varchar status
    jsonb features
    date deployed_at
  }
  test_runs {
    int id PK
    varchar runner
    varchar platform
    varchar status
    int passed
    int failed
  }
  test_failures {
    int id PK
    int test_run_id FK
    varchar severity
    varchar kanban_status
    varchar pagerduty_dedup_key
    int suggestion_id FK
  }
  bug_suggestions {
    int id PK
    int failure_id FK
    varchar status
    text title
    text body
  }
  integrations {
    varchar service PK
    varchar status
    jsonb config
  }
  bot_jobs {
    int id PK
    varchar job_type
    varchar status
    jsonb input
    jsonb output
  }
  browserstack_apps {
    int id PK
    varchar platform
    varchar app_url
    varchar version
  }
  mobile_builds {
    int id PK
    int release_id FK
    varchar source
    varchar version
    jsonb metadata
  }
  release_approvals {
    int id PK
    int release_id FK
    varchar stakeholder
    varchar decision
  }
  upload_tokens {
    uuid token PK
    int user_id FK
    varchar scope
    timestamp expires_at
  }
  upload_audit {
    int id PK
    uuid token FK
    varchar filename
    bigint size_bytes
    varchar ip
  }
          

graph LR
  subgraph PLATFORMS["Platform to Runner Mapping"]
    direction TB
    WEB["Web"] --> PWR["Playwright + Cucumber"]
    WEB --> VISREGR["Visual Regression"]
    IOS["iOS"] --> APPR2["Appium + BrowserStack"]
    AND["Android"] --> APPR2
    TVP["TV"] --> APPR2
    APIP["API"] --> K6R2["k6 Load Tests"]
  end

  PWR --> DBR[("test_runs")]
  VISREGR --> DBR
  APPR2 --> DBR
  K6R2 --> DBR

  classDef platform fill:#15151e,stroke:#e91e8c,stroke-width:2px,color:#e8e8f0
  classDef runner fill:#15151e,stroke:#b388ff,stroke-width:2px,color:#e8e8f0
  classDef db fill:#15151e,stroke:#ffd740,stroke-width:2px,color:#e8e8f0

  class WEB,IOS,AND,TVP,APIP platform
  class PWR,VISREGR,APPR2,K6R2 runner
  class DBR db
          

graph TB
  subgraph INBOUND["Inbound Events"]
    GHW["GitHub Webhook"]
    CUW["ClickUp Webhook"]
    PCW["Play Console\nPoll / Callback"]
    ASCW["App Store Connect\nPoll"]
    SLDW["Sideload Upload\nTokenized"]
  end

  subgraph CORE["Core Platform"]
    WHR["Webhook Router"]
    BOT["OpenClaw Bot"]
    REL["Release Manager"]
    MB["Mobile Builds\nIngest"]
  end

  subgraph OUTBOUND["Outbound Actions"]
    CUA["ClickUp API
Tasks + Priority Map"]
    GHA["GitHub API
PR Status, Deploys"]
    SLA["Slack / Discord
Notifications"]
    DDA["DataDog API
Alert Queries"]
    TRA["TestRail API
Result Sync"]
    GDA["Google Drive
Report Upload"]
    PDA["PagerDuty
Critical Paging"]
    BSA["BrowserStack
App Upload + Sessions"]
  end

  GHW --> WHR
  CUW --> WHR
  PCW --> MB
  ASCW --> MB
  SLDW --> MB
  WHR --> BOT
  MB --> REL
  BOT --> REL
  BOT --> CUA
  BOT --> GHA
  BOT --> SLA
  BOT --> DDA
  BOT --> TRA
  BOT --> GDA
  BOT --> PDA
  BOT --> BSA

  classDef inbound fill:#15151e,stroke:#ffd740,stroke-width:2px,color:#e8e8f0
  classDef core fill:#15151e,stroke:#e91e8c,stroke-width:2px,color:#e8e8f0
  classDef outbound fill:#15151e,stroke:#00e676,stroke-width:2px,color:#e8e8f0

  class GHW,CUW,PCW,ASCW,SLDW inbound
  class WHR,BOT,REL,MB core
  class CUA,GHA,SLA,DDA,TRA,GDA,PDA,BSA outbound