diff --git a/docs/backend-integration.md b/docs/backend-integration.md
new file mode 100644
index 0000000..8b4b321
--- /dev/null
+++ b/docs/backend-integration.md
@@ -0,0 +1,12 @@
+# Backend Integration
+
+The frontend is intentionally backend-ready but backend-free.
+
+Integration steps:
+
+1. Implement an HTTP client in `src/api/client.ts`.
+2. Replace mock methods in `src/api/services/panel-service.ts` with real service calls.
+3. Preserve the response envelope and DTOs in `src/api/contracts`.
+4. Map backend validation errors into `ApiError.fields`.
+5. Add WebSocket/SSE adapters for jobs, terminal state, notifications, metrics, and logs.
+6. Keep destructive actions behind typed confirmation, reason capture, two-factor confirmation, and audit-preview flows.