⚙️ DevOps Manual

Welcome to the Hoox DevOps & System Operations Manual. This manual is the primary, production-grade reference for system administrators, security engineers, and platform operators responsible for provisioning edge databases, orchestrating secure V8 service bindings, deploying multi-exchange execution workers, auditing secrets, and monitoring system health.

graph TD
    subgraph "Public Entryways"
        GW[hoox Gateway Isolate]
        DASH[dashboard Next.js OpenNext]
    end
    subgraph "Private V8 Compute Layer"
        TW[trade-worker Execution Engine]
        D1W[d1-worker SQL Hub]
        TGW[telegram-worker Alerts]
        AW[agent-worker AI Risk Monitor]
    end
    subgraph "Edge Data Storage Layer"
        D1[(D1 SQLite Database)]
        KV[(CONFIG_KV Namespace)]
        R2[(R2 Log offload Bucket)]
    end

    GW -->|Service Binding| TW
    GW -->|Service Binding| TGW
    TW -->|Service Binding| D1W
    AW -->|Service Binding| TW
    D1W -.->|SQLite read/write| D1
    TW -.->|Config Read| KV
    TW -.->|Log Offload| R2
    DASH -->|Service Binding| GW

🗺️ Operator’s System Directory

The DevOps manual is structured into five core architectural operational layers:

1. 📋 Operations & Setup Runbooks

Complete guides for bootstrapping environments, managing interactive terminal dashboards, and diagnosing local runner configurations:

• Operations & Troubleshooting — Core operations manual, 31-key environment variable matrices, and diagnostic codes.
• Core Installation Flow — Guided, step-by-step local machine and edge provision setup.
• Terminal UI Cockpit Development — Code architectures, stores, and operations of the OpenTUI monitor.

2. 🏗️ Architectural Specifications

Deep dives into latency structures, isolation parameters, and bindings linkages:

• System Topology Overview — Architectural layout, regional edge clustering, and scaling limits.
• Isolate Communication — Deep dive into Service Bindings, zero-TCP routing, and V8 engines.
• Data Flow Architecture — Flowcharts for trade execution, backup queues, and cron risk monitoring.
• Bindings Matrix — Exact mapping of D1, KV, Queues, R2, and Service Bindings.
• Storage Engineering — Persistent storage boundaries, SQLite DDL parameters, and R2 buckets.
• Internal Endpoints Map — Sub-millisecond binding paths and routing maps.
• Visual Tokens & Design System — Monochromatic token mappings and visual SVGs catalog.

3. ⚙️ Edge Worker Microservices (10 Profiles)

Individual developer profiles for each running isolate, cataloging bindings, custom middlewares, and API formats:

• hoox Gateway · trade-worker · agent-worker · telegram-worker
• d1-worker · web3-wallet-worker · email-worker · analytics-worker
• report-worker · dashboard (Next.js OpenNext)

4. 🚢 Deployment, WAF, & CI/CD Pipelines

Rollout manuals, Access gates, and GitHub Actions telemetry:

• Production Deployment — Wrangler commands, Account provisioning, and production variables.
• CI/CD Workflow pipelines — GitHub Actions secrets, syntax tests, and automated edge uploads.
• Monitoring & Telemetry — Live wrangler logs streaming and custom Analytics Engine metrics.
• Cloudflare Zero Trust Corridor — Setting up Access client corridors, IP firewalls, and WAF rules.

💻 5. Developer & API Reference

TypeScript interfaces, compiler settings, Bun test specs, and HTTP schemas:

• Wrangler Dev Setup · Testing Standards · Debugging Runbook
• Exposed API Routes · Request Payloads · Standard Responses
• CLI Commands Engine — Command-line argument parsing, binary execution, and JSON flags.

Tip: First time deploying a Hoox workspace to production? Start with the Production Deployment Manual to verify your Cloudflare Account permissions and execute sequencial deployments seamlessly.

🔗 Quick Links & Offline Reference

• End-User Documentation Hub — Standard setup, cURL webhooks, and TradingView Pine Scripts.
• Hoox Git Submodules — Central monorepo codebase.
• Download Enduser Full PDF Manual — Complete concatenated offline guide.
• Download DevOps Full PDF Manual — Complete concatenated offline DevOps spec.
• View Consolidated LLM Context Text — Giant single-file text format for AI/LLM models.