chore: synchronize remaining workspace updates

Makefile

@@ -20,6 +20,7 @@ TIMEOUT_SLOW := 600
 .PHONY: help test test-unit test-frontend test-related test-integration test-e2e test-all
 .PHONY: coverage coverage-backend coverage-frontend
 .PHONY: lint lint-backend lint-frontend
+.PHONY: docs-doxygen docs-doxygen-check
 
 # ── Help ───────────────────────────────────────────────────
 help: ## Show this help message
@@ -85,3 +86,39 @@ lint-backend: ## Backend ruff check
 
 lint-frontend: ## Frontend eslint
 	@cd $(FRONTEND) && npx eslint .
+
+# ── Documentation ───────────────────────────────────────────
+docs-doxygen: ## Generate Doxygen XML and HTML documentation
+	@if ! command -v doxygen >/dev/null 2>&1; then \
+		echo "  ✗ doxygen not found."; \
+		echo "    Debian/Ubuntu: sudo apt-get install -y doxygen"; \
+		echo "    macOS: brew install doxygen"; \
+		exit 1; \
+	fi
+	@echo "  ▶ Generating Doxygen XML + HTML..."
+	@rm -rf "$(ROOT)/docs/api/build"
+	@cd "$(ROOT)" && { cat docs/api/Doxyfile; printf '\nSTRIP_FROM_PATH = %s\n' "$(ROOT)"; } | doxygen -
+	@test -f "$(ROOT)/docs/api/build/xml/index.xml"
+	@echo "  ✅ XML: docs/api/build/xml/index.xml"
+	@echo "  ✅ HTML: docs/api/build/html/index.html"
+
+docs-doxygen-check: ## Validate Doxygen configuration and generated XML
+	@if ! command -v doxygen >/dev/null 2>&1; then \
+		echo "  ✗ doxygen not found."; \
+		echo "    Debian/Ubuntu: sudo apt-get install -y doxygen"; \
+		echo "    macOS: brew install doxygen"; \
+		exit 1; \
+	fi
+	@if rg -n '/home/|/Users/' "$(ROOT)/docs/api/Doxyfile" >/dev/null; then \
+		echo "  ✗ Doxyfile contains an absolute user path"; \
+		exit 1; \
+	fi
+	@test -f "$(ROOT)/docs/api/build/xml/index.xml" || { \
+		echo "  ✗ Doxygen XML is missing; run make docs-doxygen"; \
+	exit 1; \
+	}
+	@if rg -n 'filename="/home/|<compoundname>/home/|<name>/home/' "$(ROOT)/docs/api/build/xml" >/dev/null; then \
+		echo "  ✗ Doxygen XML contains an absolute source filename"; \
+		exit 1; \
+	fi
+	@echo "  ✅ Doxygen configuration and XML artifact are present"