How ooks-io/wowsim-stats works
wowsimstats combines a WoW statistics-data pipeline, a web frontend for browsing player and simulation data, and Discord interactions. The README describes a separate simulation workflow—generating inputs, running wowsimcli, and aggregating results—but its implementation is not present in this tree, so the graph focuses on components that are represented here. Go pipeline connections are kept unasserted because the sampled Go files do not show their callers; web and Discord links are limited to relationships visible in excerpts or explicit README statements.
Main entry points: cmd ookstats CLI · discord.ts Discord interaction endpoint · simulation-comparison.ts Simulation comparison · pipeline Fetch and process
Components 29
Statistics data pipeline
- ookstats CLI
nix/pkgs/ookstats/src/cmd - Blizzard API client
nix/pkgs/ookstats/src/internal/blizzard - Statistics database
nix/pkgs/ookstats/src/internal/database - Data loaders
nix/pkgs/ookstats/src/internal/loader - Fetch and process
nix/pkgs/ookstats/src/internal/pipeline - Player identity
nix/pkgs/ookstats/src/internal/playerid - Ranking calculations
nix/pkgs/ookstats/src/internal/pipeline/player_rankings.go - Site data generation
nix/pkgs/ookstats/src/internal/generator - JSON writer
nix/pkgs/ookstats/src/internal/writer/json.go
Web experience
- Generated JSON data
- Player search
web/src/components/PlayerSearch/PlayerSearch.ts - Data API helpers
web/src/lib/api.ts - Simulation comparison
web/src/client/simulation-comparison.ts - Comparison chart
web/src/client/sim-chart/render/charts.ts - Comparison metadata
web/src/client/sim-chart/render/meta.ts - Comparison UI
web/src/client/sim-chart/ui.ts - Loadout rendering
web/src/client/sim-chart/loadout.ts
Discord bot
- Discord interaction endpoint
web/api/discord.ts - Autocomplete indexes
web/src/discord/indexes/cache.ts - Leaderboard command
web/src/discord/commands/leaderboard.ts - Player command
web/src/discord/commands/player.ts - Leaderboard embeds
web/src/discord/embeds/leaderboard.ts - Request verification
web/src/discord/verify.ts
Shared domain logic
- WoW domain constants
web/src/lib/wow-constants.ts - Client formatting
web/src/lib/client-utils.ts - Equipment utilities
web/src/lib/equipment-utils.ts
Other components
- Data operator
- Website visitor
- Discord user
Connections 27
- Discord user → Discord interaction endpoint: sends interaction
web/api/discord.ts - Discord interaction endpoint → Request verification: verifies signature
web/api/discord.ts - Discord interaction endpoint → Autocomplete indexes: initializes caches
web/api/discord.ts - Discord interaction endpoint → Leaderboard command: dispatches commands
web/api/discord.ts - Discord interaction endpoint → Player command: dispatches commands
web/api/discord.ts - Leaderboard command → Data API helpers: fetches leaderboard
web/src/discord/commands/leaderboard.ts - Leaderboard command → Autocomplete indexes: reads dungeon index
web/src/discord/commands/leaderboard.ts - Leaderboard command → Leaderboard embeds: builds embed
web/src/discord/commands/leaderboard.ts - Autocomplete indexes → Generated JSON data: fetches index files
web/src/discord/indexes/cache.ts - Website visitor → Player search: searches players
- Player search → Generated JSON data: loads player index
- Simulation comparison → Comparison chart: renders chart
web/src/client/simulation-comparison.ts - Simulation comparison → Comparison metadata: renders metadata
web/src/client/simulation-comparison.ts - Simulation comparison → Comparison UI: updates interface
web/src/client/simulation-comparison.ts - Simulation comparison → Generated JSON data: loads comparison data
- Loadout rendering → Equipment utilities: renders equipment
web/src/client/sim-chart/loadout.ts - Client formatting → WoW domain constants: uses class and spec data
web/src/lib/client-utils.ts - Data operator → ookstats CLI: runs data commands
- ookstats CLI → Blizzard API client: requests game data
- ookstats CLI → Statistics database: manages stored data
- ookstats CLI → Fetch and process: runs processing
- Fetch and process → Data loaders: loads records
- Fetch and process → Player identity: resolves players
- Fetch and process → Ranking calculations: calculates rankings
- ookstats CLI → Site data generation: builds site datasets
- Site data generation → JSON writer: writes JSON
- JSON writer → Generated JSON data: produces data files