🎰 TONGO CORE

Tongo Core is the Star Trek-inspired live simulation and probability engine powering Quark's Holo-Grid Ledger. It operates as a background daemon, simulating active space-grid combat, generating random in-play events, recalculating live market odds, and writing JSON telemetry directly to Valkey for client-side consumption.

🏛 Architecture: Onion Clean Architecture

The engine uses a strict clean architecture (onion pattern) with clean separation between layers:

Domain Layer (internal/domain/): Pure domain models (entity/) and output/input interface definitions (port/). Free of external frameworks or dependencies.
Application Layer (internal/application/): Application services coordinating domain logic (match scheduling, combat resolution, probability calculation, markets).
Infrastructure Layer (internal/infrastructure/): Concrete implementations of ports (Valkey adapter, YAML loader, Viper config).

🚀 Getting Started

Prerequisites

Go 1.23+
Valkey or Redis running on port 6379

Commands

Run using the Makefile:

# Build the binary
make build

# Run the simulation daemon
make run

# Validate taxonomy config
make validate

# Run tests
make test

CLI Interface

Direct CLI commands:

tongo serve: Start the simulation engine daemon.
tongo validate: Parse and check structure of taxonomy.yaml.
tongo version: Display current version.

1.4 KiB Raw Blame History