Changelog

All notable changes to the Ctrl-Audio platform are documented here.

Format follows Keep a Changelog.

---

[Unreleased]

Added

• AZURE-RESOURCES.md — dedicated Azure resource inventory
• CDN-FRONTDOOR.md — CDN/Front Door architecture documentation
• CHANGELOG.md — this file
• .agent/workflows/changelog.md — workflow rule for consistent changelog maintenance
• TECHNICAL-DEBT.md — centralized technical debt catalog
• RBAC-DESIGN.md — team/permissions planning document
• scripts/migrate-s3url-to-bloburl.js — database migration script
• Sentry integration token for error monitoring setup

Changed

• BREAKING: Renamed s3Url → blobUrl across backend (6 files) and frontend (26 files) — requires DB migration
• Updated API-DESIGN.md with shortId/slug URL identifier system
• Updated DATA-MODEL.md with shortId/slug fields and blobUrl rename
• Reorganized infrastructure docs: numbered 01-14, replaced CI/CD-only README with proper index, fixed cross-references
• Moved 04-SCALABILITY.md from backend to infrastructure as 14-SCALABILITY.md
• Removed SENTRY_PERSONALTOKEN.md (secret — should not be in docs)
• Updated PLATFORM-VISION.md to reflect current infrastructure state
• Fixed frontend doc numbering (10-FEATURES-ROADMAP.md → 15-FEATURES-ROADMAP.md)
• Fixed corrupted table in Features Roadmap
• Updated feature roadmap infrastructure checkboxes (Container Apps ✅, CDN ✅, Blob Storage ✅)
• Updated frontend and backend doc READMEs with product name TBD note

Removed

• Cosmos DB references from active planning (decision: stay with MongoDB Atlas)

---

[2026-02-06] — Production Bug Fix

Fixed

• Resolved 500 errors on project track access caused by BSONError in identifier resolution
• TrackController and TrackService now correctly handle shortId/slug identifiers

---

[2026-02-04] — Performance & CDN

Added

• Azure Front Door CDN for image and audio delivery (sonnance-cdn profile)
• setup-cdn.sh infrastructure script
• AzureImage frontend component for CDN-aware image loading
• ReactQuery caching strategy (staleTime: 5min, gcTime: 30min)

Changed

• Image processing pipeline: Sharp generates thumb/medium/original WebP variants
• Backend CDN_URL env var set on prod and dev Container Apps

---

[2026-01-27] — URL Identifier System

Added

• ShortId system using nanoid (6-char alphanumeric codes)
• Slug support for premium/user-customized URLs
• findByIdentifier() resolution: slug → shortId → ObjectId
• Database migration script for existing entities

---

[2026-01-XX] — Initial Deployment

Added

• Azure Container Apps backend (prod + dev)
• Azure Static Web Apps frontend (prod + dev)
• Azure Container Registry (sonnanceacr)
• GitHub Actions CI/CD workflows (deploy.yml, mirror-to-azure.yml)
• MongoDB Atlas integration
• Google OAuth authentication
• Stripe payment integration (test mode)