Sonnance Infrastructure & Docs — Agent Guide

Azure infrastructure (ARM templates + shell scripts) and all product documentation.

Product docs (read order)

• 00-ROADMAP.md — single source of truth (vision, MVP, platform strategy, roadmap).
• 01–18 numbered docs = reference/archive; defer to 00 on conflict. Conflicting ones carry an "Archived — see 00-ROADMAP.md" banner.
• 19-IOS-MVP-REVIEW-APPROVE.md — the native iOS MVP spec (screens → live endpoints + gaps, Liquid Glass tokens).
• 20-UI-SIMPLIFICATION.md — one-dashboard / one-layout decision.
• ctrl-audio-docs/ — VitePress doc site (deployed to Azure Static Web Apps).

Azure resources (resource group Sonnance-WebApp, westeurope)

Live resources are currently deleted; the ARM templates are the reproducible record.

• ARM templates/template_sonnance-acr.json — Container Registry sonnanceacr (Basic, admin-enabled). Present & valid (was thought lost; recovered/exported 2026-05-18). Do not overwrite without reason.
• ARM templates/template_ctrl-audio-backend.json / …-dev.json — Container Apps (prod / dev).
• ARM templates/template_sonnance-cdn.json — Front Door CDN (sonnance-cdn / sonnance-images).
• Storage account sonnancewebappstorage00 is created imperatively by setup-azure.sh — no ARM template yet (a real gap if full reproducibility is wanted).

Scripts

• setup-azure.sh — imperative provisioning (ACR, Container Apps env + apps, Static Web Apps, Service Principal). It's the canonical reference for what the ARM templates encode.
• cleanup-azure.sh, configure-env.sh, setup-cdn.sh.

CI/CD

GitHub Actions live in each repo (deploy.yml, mirror-to-azure.yml); the infra repo deploys the docs site. External services: MongoDB Atlas, Stripe, Google OAuth, Sentry.

Naming

All Azure resources use the sonnance* prefix. Product brand = Sonnance.