How asef69/wave_bakery works
WaveBakery is an educational signals-and-systems cooking game: players select recipes, process ingredient signals through kitchen stations, correct cooking and delivery distortions, then serve a dish for authoritative server scoring. The graph includes the documented account, recipe, leaderboard and sandbox features alongside the main run. Backend links are grounded in excerpts and SOURCE INDEX references; frontend stage and HTTP links rely on README documentation where route or API implementation was not sampled.
Main entry points: main.py FastAPI app · routes Game screens · gameplay.py Dish rebuild and score · database.py SQL database
Components 25
Game experience
- Game screens
frontend/src/routes - Recipe catalog
frontend/src/lib/recipes.ts - Signal playground
frontend/src/routes/labs.tsx - API client
frontend/src/lib/api.ts
Signal processing
- Station pipeline
frontend/src/lib/pipeline.ts - Precision oven
frontend/src/routes/filtering.tsx - System delivery
frontend/src/routes/beam-delivery.tsx - DSP core
backend/app/dsp/core.py - Ingredient signals
backend/app/dsp/instruments.py - Signal contamination
backend/app/dsp/contamination.py - Canonical pipeline
backend/app/dsp/pipeline.py - Appliance systems
backend/app/dsp/systems.py - Scoring metrics
backend/app/dsp/metrics.py - Delivery effects
backend/app/delivery.py
Game services
- FastAPI app
backend/app/main.py - Recipe catalogue
backend/app/routers/catalogue.py - Game sessions
backend/app/routers/sessions.py - Dish rebuild and score
backend/app/gameplay.py - DSP endpoints
backend/app/routers/dsp.py - Player accounts
backend/app/routers/players.py - Leaderboard
backend/app/routers/leaderboard.py
Persistent state
- SQL database
backend/app/database.py - Game records
backend/app/models.py - Initial game data
backend/app/seed.py
Other components
- Player
Connections 38
- Player → Game screens: plays
- Game screens → Recipe catalog: selects recipe
- Game screens → Station pipeline: operates stations
- Station pipeline → Recipe catalog: loads recipe signals
frontend/src/lib/pipeline.ts - Game screens → Precision oven: corrects cooking
- Game screens → System delivery: cancels vibration
- Game screens → Signal playground: opens sandbox
- Game screens → API client: requests game data
- API client → FastAPI app: calls API
- FastAPI app → Recipe catalogue: registers router
backend/app/main.py - FastAPI app → Game sessions: registers router
backend/app/main.py - FastAPI app → Player accounts: registers router
backend/app/main.py - FastAPI app → Leaderboard: registers router
backend/app/main.py - FastAPI app → DSP endpoints: registers router
backend/app/main.py - Game sessions → Dish rebuild and score: rebuilds and scores
backend/app/routers/sessions.py - Dish rebuild and score → Ingredient signals: generates signals
backend/app/gameplay.py - Dish rebuild and score → Signal contamination: contaminates signals
backend/app/gameplay.py - Dish rebuild and score → Canonical pipeline: runs pipeline
backend/app/gameplay.py - Dish rebuild and score → Delivery effects: applies delivery effects
backend/app/gameplay.py - Dish rebuild and score → Scoring metrics: measures dish
backend/app/gameplay.py - Canonical pipeline → DSP core: uses DSP operations
backend/app/dsp/pipeline.py - Canonical pipeline → Appliance systems: applies appliances
backend/app/dsp/pipeline.py - Ingredient signals → DSP core: uses signal functions
backend/app/dsp/instruments.py - Signal contamination → DSP core: uses signal functions
backend/app/dsp/contamination.py - Scoring metrics → DSP core: uses signal functions
backend/app/dsp/metrics.py - Delivery effects → DSP core: uses signal functions
backend/app/delivery.py - DSP endpoints → DSP core: serves DSP tools
backend/app/routers/dsp.py - Game sessions → SQL database: reads and writes
backend/app/routers/sessions.py - Player accounts → SQL database: reads and writes
backend/app/routers/players.py - Leaderboard → SQL database: queries rankings
backend/app/routers/leaderboard.py - Recipe catalogue → SQL database: queries catalogue
backend/app/routers/catalogue.py - SQL database → Game records: registers mappings
backend/app/database.py - FastAPI app → SQL database: initializes store
backend/app/main.py - FastAPI app → Initial game data: seeds records
backend/app/main.py - Initial game data → SQL database: writes initial data
backend/app/seed.py - Game sessions → Dish rebuild and score: computes stage views
backend/app/routers/sessions.py - Player → Player accounts: manages account
- Player → Leaderboard: views rankings