---
title: "Architecture"
weight: 6
---

Architecture notes and analyses:

- [API Route Layout and Refactoring Plan](API-ROUTE-LAYOUT.md) - route
  classification (frozen speaker contract vs our movable surface), the
  actor / deployment / trust model, auth, and the staged plan toward the
  `soundtouch-player` / `soundtouch-service` merge (issue #451).
- [Device-Local Install: Four User Journeys](DEVICE-LOCAL-INSTALL.md) - install
  patterns and user journeys for on-device deployment.
