Dev Backend Guides — Claude Code Development Reference

Savoy Signature Hotels — Multi-Site Headless Platform
Purpose: Actionable backend development guides for AI-assisted (Claude Code) and human BE development
Stack: Umbraco 17 (.NET 10 LTS) + Azure SQL + Azure Blob Storage + Cloudflare

---

Guide Index

Guide	Filename	Focus
00	00_INDEX.md	This index
01	01_UMBRACO_CONTENT_MODELING.md	How to create Document Types, Element Types, compositions, and configure Block Lists
02	02_CONTENT_DELIVERY_API.md	Umbraco Content Delivery API v2 usage, headers, filtering, pagination
03	03_MULTISITE_SETUP.md	Multi-site content tree, root nodes, domain bindings, shared content
04	04_WEBHOOKS_AND_CACHE_PURGE.md	Publish webhooks, Cloudflare purge integration, dependency graph
05	05_MEDIA_AND_BLOB_STORAGE.md	Azure Blob Storage setup, media library organization, upload restrictions
06	06_CUSTOM_API_ENDPOINTS.md	Search, forms, redirects, sitemap — custom .NET controllers
07	07_SECURITY_AND_ENVIRONMENTS.md	Azure infrastructure, Key Vault, backoffice access, RBAC, environments
08	08-headless-preview-configuration.md	Headless preview mode configuration
09	09_INFRASTRUCTURE_BICEP.md	Bicep IaC templates, resource config, CI/CD pipeline, deployment guide

---

How to Use These Guides

For Claude Code (AI Agent)

These guides are the operational manual for backend tasks. Before implementing:

1. Read the relevant PRD document (e.g., docs/PRD/06_Content_Modeling_Umbraco.md)
2. Read the corresponding dev guide for the workflow
3. Follow naming conventions, content type patterns, and acceptance criteria

For Human Developers

These guides complement the PRD by explaining how to implement backend features consistently in Umbraco 17 and Azure.

---

Relationship to PRD

PRD Document	Related Dev Guide(s)
01_General_Architecture.md	03, 04, 07
02_Infrastructure_and_Environments.md	05, 07, 09
03_MultiSite_and_Domains.md	03
06_Content_Modeling_Umbraco.md	01, 03
08_API_Contracts.md	02, 04, 06
09_Cache_and_Performance.md	04
13_Media_and_Image_Pipeline.md	05
15_Security_and_Data_Protection.md	07

---

Phase 1 Priority Order

1. 09 Infrastructure (Bicep) — Provision Azure resources via IaC
2. 07 Security & Environments — Configure Key Vault, RBAC, security headers
3. 01 Content Modeling — Create all Document Types, Element Types, compositions
4. 03 Multi-site Setup — Configure 8 root nodes, domain bindings, shared content
5. 05 Media & Blob Storage — Azure Blob provider, media library structure
6. 02 Content Delivery API — Enable API, validate responses match FE contracts
7. 04 Webhooks & Cache Purge — Publish hooks, Cloudflare purge integration
8. 06 Custom Endpoints — Search, forms, redirects, sitemap