Documentation Library

Complete technical documentation for the Listener Price Oracle, Listener Reporting Service, Webhook Push, and the Trinity Beast Command Center. Everything you need to integrate, operate, and optimize — organized by category.

🌐 Documents available in 12 languages. Your selected language is applied automatically.

Translated by the Trinity Beast Translation Service — AI-powered, code-aware document translation.

Core Reference
Architecture & Infrastructure
Data & Reports
Operations & Lifecycle
Performance & Security

Live operational dashboards, API reference, application features, and the tools that run the platform day-to-day. Start here.

Core Reference

Infrastructure Observability Live

Public view of the entire network — 4 containers, 6 exchanges, Aurora, ElastiCache, SQS, Lambda, WAF, and a live price feed cycling every 6 seconds. No auth required.

View Live →
Core Reference

Website Analytics

Pattern explorer — page views, reading time, scroll depth, video plays, CTA clicks, form submissions, downloads, traffic sources, and visitor countries.

Open Analytics →
Core Reference

Website Analytics Guide

Privacy-first website analytics — client beacon, 5 event types, 2 Aurora tables, 6 indexes, admin API with 10 aggregation fields, security & abuse prevention, 24-page coverage map, KCC/TBCC integration. Zero cookies, zero third-party deps.

View Guide →
Core Reference

API Reference

Comprehensive endpoint documentation for LPO and LRS — authentication, parameters, full response schemas, rate limits, and error codes.

View Reference →
Core Reference

Go Application Features

The engineering showcase — table-driven Exchange Manager, 6-exchange WebSocket engine, zero-alloc UDP v6, 24-counter runtime telemetry, cluster-wide ElastiCache aggregation, and 16 tunable profiles.

View Features →
Core Reference

Project Structure

Go monorepo layout — 3 binaries, 10 internal packages, Mermaid folder tree diagram, and file-by-file reference guide.

View Structure →
Core Reference

Docker Setup Guide

Multi-stage Dockerfiles, 14-tool troubleshooting toolkit, build commands, ECR push, ECS deploy, health checks, and ECS Exec container access.

View Guide →
Core ReferenceNew

Translation Service

AI-powered document translation as a service. $3.00 per document-language pair, 21 languages, validator system that catches what AWS Translate misses. Full API reference, UME-compliant responses, Account Dashboard integration, and transparent pricing with our_cost visibility.

View Service →
Core ReferenceNew

TBI Translation Engine

Custom Bedrock-powered translation engine replacing AWS Translate. Sentinel preprocessing, validator system, Step Function orchestration, 9 admin endpoints, Aurora observability, cost protection, and CLI compatibility. The only Python Lambda in the fleet.

View Guide →
Core ReferenceNew

Technical Showcase

The TBI story told through its architecture. Single binary, two-level cache, 6 AI agents, honeypot auto-block, self-healing, 5-layer AutoOps, and the economics of build-versus-buy. One page, the whole system.

View Showcase →

System design, AWS resource specifications, messaging patterns, and infrastructure-as-code. The technical foundation of The Trinity Beast Infrastructure — how it's built, how it's deployed, and what it costs.

Architecture

Quick Reference

Common tasks, code examples in 15+ languages, all 4 LRS report endpoints with full JSON responses, troubleshooting tips, and operational cheat sheets.

View Guide →
Architecture

System Architecture Guide

Complete system architecture — three-tier cache (sync.Map → ElastiCache → REST), data flows, Mermaid diagrams, deployment strategies, and security model.

View Guide →
Architecture

Infrastructure Specification v16

Full technical specification — AWS resource inventory, networking, Aurora Serverless v2, ElastiCache for Valkey, ECS Fargate, Distributed Adaptive Governor, ALB with LOR algorithm, and CloudFormation templates.

View Spec →
Architecture

Unified Messaging Envelope

The architectural pattern that unifies the entire system. Every API response, every email, every webhook delivery follows the same envelope — identifying the service, node, region, and timestamp. Shows how email connects all database islands through a shared identity thread. Live examples from every endpoint. Designed for extensibility.

View Guide →
Architecture

Unified Logs & Observability

Centralized logging architecture — 1 unified S3 bucket, 30 CloudWatch log groups, 3-tier model (S3 archive + CloudWatch instant search + Valkey state), WAF/ALB/CloudFront/S3 access logs, container UME self-identification, retention policies, query patterns, and cost analysis.

View Logs Guide →
Architecture

Resource Inventory

Complete inventory of all AWS resources — ECS services, Aurora, ElastiCache, ALB, NLB, CloudFront, S3, Lambda, DNS, VPC, and every connection between them.

View Inventory →
Architecture

Infrastructure Resource Costs

Full cost transparency — monthly breakdown by resource, visual cost distribution, optimization history, and future savings opportunities. Every dollar accounted for.

View Costs →
Architecture

Multi-Lingual Communications

12 languages, zero barriers. Static JSON i18n engine, AWS Translate for dynamic content, multi-lingual SES emails, real-time map caption translation with ElastiCache caching. Full architecture diagram showing how language flows through every layer — website, email, support tickets, and the Impact Map.

View Guide →
Architecture

Message Queue Configuration

SQS-powered usage log pipeline — fire-and-forget from the hot path, guaranteed delivery to Aurora via Lambda consumer. Application parameters, message envelope format, and extensibility patterns.

View Configuration →
Architecture

AI AutoOps Implementation

5-layer autonomous operations system — all LIVE. Self-healing, AI threat analysis, anomaly detection, support automation, and Bedrock-generated operational digests. 7 Lambdas, 6 EventBridge rules, 4 ML anomaly detectors.

View Guide →

Database schemas, cache key patterns, application parameters, and reporting infrastructure. The data layer — every table, every key, every metric.

Data & Reports

Aurora Data Dictionary

Complete schema reference — all 37 Aurora tables with every column, data type, default, nullable, indexes, foreign keys, CREATE TABLE statements, and descriptions.

View Dictionary →
Data & Reports

Application Parameters

Complete reference for all 80 runtime parameters across 12 categories — system mode profiles, cache tuning, DB pool settings, usage log batching, price source configuration, webhook tiers, and rate limiting.

View Reference →
Data & ReportsNew

Translation Parameters

Complete reference for all 39 runtime parameters governing the Translation Engine — Bedrock pricing per model and execution mode, token estimation ratios, daily spend controls, customer pricing and service fee markup, and batch inference configuration. Separate from application parameters — translation is a standalone service.

View Reference →
Data & Reports

ElastiCache Operations & Recovery

Valkey operational reference — key inventory, dependency classification, graceful degradation matrix, BeastReconciler responsibilities, disaster recovery runbook, and health monitoring baselines.

View Operations →
Data & Reports

LRS Report Management

Listener Reporting Service deep dive — usage reports, summary analytics, report-on-report tracking, limits, and integration patterns.

View Guide →
Data & Reports

Performance Report

Run 17 — 1.34 billion requests at 746,374 combined RPS sustained for 30 minutes. 369,600 TCP RPS. 487,900 UDP RPS with 100% success through all 13 levels. 943× improvement in 19 days. The definitive performance validation of The Trinity Beast.

View Report →
Data & Reports

Kiro Expert Assessment

An independent technical and strategic evaluation of The Trinity Beast Infrastructure by Kiro — covering architecture, performance, engineering quality, operational maturity, security posture, and the mission that drives it all. Honest analysis with ratings across 8 dimensions.

View Assessment →
Data & ReportsNew

TBTS Data Dictionary

Complete schema reference for the Translation Service — 7 Aurora tables, 118 columns, Valkey cache keys, entity relationships, and admin API endpoints. Jobs, quotes, tasks, model catalog, language profiles, and the dedicated parameter store.

View Dictionary →

Account management, subscription lifecycle, payment processing, exchange asset management, and operational guides. How to operate The Trinity Beast Infrastructure day-to-day.

Operations

Account Dashboards

The customer self-service portal — passwordless magic link auth, role-based panel routing, Stripe billing portal, API key management, 30-day usage charts, donation history, webhook configuration, and admin impersonation. Full architecture, API reference, and security design.

View Guide →
Operations

EAM Admin Panel

Visual management of the Exchange Asset Map — toggle prewarm WebSocket feeds and dropdown visibility per asset, add or remove assets, and sync changes to running containers without writing SQL. Replaces the raw SQL + kcc sync-eam + force-deploy manual workflow.

View Guide →
Operations

Partner Onboarding

How to connect AWS partners via PrivateLink (TCP) and VPC Peering (UDP) — step-by-step onboarding for both sides with exact CLI commands.

View Guide →
Operations

Associate Onboarding

How to subscribe, configure, and receive real-time prices via Webhook Push — tiers, endpoints, payload format, HMAC verification, and FAQ.

View Guide →
Operations

Subscription Lifecycle

Subscription lifecycle management — Stripe SDK integration, webhook processing, Customer Portal, tier upgrades/downgrades, cancellations, LRS add-on lifecycle, payment failure grace period, and cache invalidation.

View Guide →
Operations

Stripe Implementation

Payment processing — Stripe Payment Links, webhook handling, receipt Lambda, subscription management, donation processing, and LRS add-on activation.

View Guide →
Operations

Ad Campaign Setup Guide

X (Twitter) ad campaign setup — targeting, budget, ad copy variations, campaign flow, and pre-launch checklist for the LPO launch campaign.

View Guide →
Operations

Command Center Guide

Complete user's guide to the TBCC — 6 widget dashboards, Kiro CLI, Aurora pgAdmin, terminal relay, AWS operations, and admin console walkthroughs.

View Guide →
Operations

Kiro Command Center (KCC)

How Kiro operates The TBI — pre-built API routines, deployment automation, session-persistent steering, and the KCC vs TBCC comparison.

View Guide →

Stress test results, security assessments, monitoring guides, disaster recovery, and infrastructure recovery playbooks. Proving the system works under pressure — and protecting it.

Performance & Security

Stress Test Plan

7 targeted tests across 2 phases — Public subscriber and Partner access paths. Single-container ceiling tests, production topology validation, combined LPO+LRS load, and 30-minute endurance. Real-time 24-counter telemetry with cluster-wide ElastiCache aggregation.

View Plan →
Performance & SecurityNew

Security Posture

Complete defensive security architecture — 11 layers from edge to data. CloudFront + Shield, dual WAF with honeypot traps, application auth & rate limiting, VPC isolation, encryption everywhere, the Flame Path (UDP), GuardDuty + anomaly detection, AI-powered AutoOps threat response, full audit trail, least-privilege IAM, and secrets management. Every rule, every path, every defense.

View Posture →
Performance & Security

Internal Security Audit

Detailed inside-threat assessment, IAM role audit, and network isolation analysis. Attack path traces, penetration difficulty ratings, partner and associate access boundaries, and active mitigation verification across all service roles.

View Audit →
Performance & Security

CloudWatch & Alarms Guide

4 dashboards, 17 alarms, SNS notifications (email + SMS), 10 log groups, custom metrics, and alarm response playbook.

View Guide →
Performance & Security

CloudFormation Recovery Guide

Complete infrastructure-as-code template — 123 resources, one command to recreate everything. Disaster recovery playbook, deployment guide, and resource wiring explained.

View Guide →
Performance & Security

Disaster Recovery Runbook

13 failure scenarios from routine to catastrophic — ECS container failure, Aurora failover, ElastiCache flush, WebSocket feed loss, DNS failure, admin key compromise, full region outage. Step-by-step recovery with KCC commands and verification procedures.

View Runbook →