Start Here
New to 2.0? The 60-second mental model and the three service shapes orient you fast.
Soundverse 2.0 — Engineering Docs
How to build, extend, run, and operate the Soundverse 2.0 backend. Start with a task, drill into the architecture when you need it.
I want to…
Section titled “I want to…”Add a new toolCopy the template, write three things, declare pricing, deploy.
Change the database / add an RPCEdit the proto + schema.sql, mind the $N rule, regenerate.
Ship a proto changeDrive the proto → deploy cascade end to end.
Deploy a servicePush to staging/prod; the shared template does the rest.
Run it locallyOne command with docker-compose, or bottom-up from source.
Extend the consumer APIAdd a BFF route + gateway mapper for the browser.
Understand the system
Section titled “Understand the system”Architecture
Deep dives: the request lifecycle, the contract-first proto model, the token ledger & money path, and per-service field guides.
Operations
Runbooks for deploying, observability, troubleshooting, and the honest known-limitations register.
Reference
Durable lookups: the service catalog, env-var catalog, proto contract, TaskContext API, and glossary.