Overview
GoldWatch.live is a real-time macro dashboard for monitoring the drivers behind Gold (XAU/USD). It brings together market prices, rates, currency strength, risk sentiment, commodities, positioning, technical trend, trading sessions, alerts, news, and AI-assisted analysis into one operational interface.
The product has SaaS characteristics such as accounts, plan tiers, subscriptions, alerts, and authenticated real-time access, but I classify it primarily as a data workflow project. Its core value is the pipeline that collects, normalizes, scores, streams, and explains market-moving inputs.
This is a self-directed product that I planned, designed, implemented, deployed, and maintain.
Product Architecture
- Monorepo product system - The project is organized with pnpm workspaces and Turborepo. It contains a React Router dashboard, a Hono REST API, a dedicated Hono SSE service, a crawler pipeline, a Laravel auth and billing gateway, and shared TypeScript packages for schema, constants, tiers, and score configuration.
- Read/write separation - The crawler writes market and macro records into PostgreSQL on scheduled intervals. The API reads from the database and does not trigger external fetches from user requests, which keeps latency predictable and data-provider usage controlled.
- Provider abstraction - Data inputs are mapped through provider interfaces and per-indicator configuration. This allows each symbol or indicator to define fetch intervals, fallback behavior, historical coverage, and computed values without coupling the UI to collection details.
- Gold Score model - A factor-weighted score converts macro inputs into a 0-100 reading with bias, coverage, freshness, and factor breakdowns. The score combines real rates, USD strength, risk sentiment, commodity context, positioning, and technical trend through bounded normalization.
- Realtime delivery layer - A standalone SSE service polls the latest price table once, then fans out changed prices to connected clients. This avoids per-client polling loops and keeps database load close to O(1) for real-time pushes.
- Tier-aware data serving - Anonymous, free, and Pro users receive different polling and streaming behavior. The system uses activity state, tab coordination, CDN caching, rate limits, and graceful degradation to balance real-time UX with infrastructure cost.
- AI news workflow - A news pipeline fetches public financial headlines, deduplicates them, filters for gold relevance, scores sentiment, summarizes expected impact, and exposes the resulting feed through the API and dashboard drawer.
- Auth and billing boundary - Laravel issues ES256 JWTs that can be verified by the API and SSE services without database lookups. Stripe billing and plan claims drive Pro behavior such as always-on streaming and advanced features.
Key Features
- Gold macro dashboard - Watch XAUUSD alongside macro factor cards, market sessions, selected indicators, and contextual state in one dashboard.
- Explainable Gold Score - Inspect a single 0-100 score plus factor-level bias, coverage, freshness, and underlying signal contribution.
- Realtime price updates - Authenticated users receive live updates through SSE, while guests and background users fall back to tier-aware polling.
- Trading session context - The dashboard shows major session windows and market state so users can interpret moves in time context.
- AI-assisted analysis - On-demand and scheduled analysis summarizes current macro conditions and the likely direction of pressure on gold.
- Filtered news feed - Public financial headlines are filtered, scored, summarized, and tagged for gold relevance rather than displayed as a noisy raw feed.
- Alerts and subscriptions - User accounts, alert behavior, and Pro subscription features turn the data workflow into a recurring SaaS product surface.
