🌌 Quark's Holo-Grid Ledger

Welcome to the Holo-Grid Ledger — an authentic, plaintext terminal-style sportsbook application built for the Star Trek-inspired galactic economy.

🏛 Project Architecture

This repository is organized as a clean monorepo:

web-terminal/: The frontend user interface built with TanStack Start, Vite, Valkey, and Tailwind CSS. It renders high-density VT100-style console dashboards.
tongo-core/: The high-performance Go simulation and probability engine. It runs as a background daemon, streaming active match telemetry and live odds directly to the Valkey cache.
data-source/: Static definition registry (taxonomy.yaml) containing quadrants, factions, venues, and market templates.
reference/: Architectural references and blueprint documents for components and the simulation engine.

🛠 Getting Started

1. Start Infrastructure (Valkey & Redis Insight)

The sportsbook relies on Valkey as a shared memory layer, and Redis Insight provides a GUI for database inspection.

# Start Valkey and Redis Insight in the background
make infra-up

# View logs
make infra-logs

# Stop infrastructure
make infra-down

Valkey will run on localhost:6379, and Redis Insight will be accessible at http://localhost:5540.

2. Start the Simulation Engine

Go to the Go backend folder and start the engine daemon:

make run-engine

3. Start the Web Terminal UI

Go to the frontend folder, install dependencies, and start the Vite dev server:

make run-web

Visit the console at http://localhost:3000.

📜 Ferengi Code of Conduct

"The riskier the road, the greater the profit." — Rule of Acquisition #62

2.1 KiB Raw Blame History