[DevOps Manual]
Infrastructure provisioning, deployment sequences, secret management, and edge operations for HOOX administrators.
Tip
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.
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 sequential deployments seamlessly.
Quick Links
- End-User Documentation Hub — Standard setup, cURL webhooks, and TradingView Pine Scripts.
- Hoox Git Submodules — Central monorepo codebase.
Enterprise (Commercial Layer)
Full institutional architecture documentation (Workers for Platforms, Workflows, Logpush audit, Enterprise security) for the closed-source commercial layer lives at docs/enterprise/.
See root OPEN_CORE.md and OPEN_CORE_FEATURE_SPLIT.md. This public repo only includes the open core + public design docs.