Initial Animatrix import

Docs/RUNBOOK.md

@@ -0,0 +1,64 @@
+# Animatrix Runbook
+
+## Production Runtime
+
+- frontend: `127.0.0.1:3200`
+- backend: `127.0.0.1:8200`
+- public hostname: `animatrix.desineuron.in`
+- Comfy dependency: `https://comfy.desineuron.in`
+- frontend service root: `/opt/animatrix/frontend/.next/standalone`
+- backend env should include `BACKEND_BASE_URL=https://animatrix.desineuron.in`
+
+## Frontend Build Packaging
+
+The frontend is deployed using Next.js standalone output. After every build, static assets must be copied into the standalone directory or the site will render unstyled because `/_next/static/css/*` will 404.
+
+Required packaging flow:
+
+```bash
+cd /opt/animatrix
+./scripts/build_frontend_standalone.sh
+sudo systemctl restart animatrix-frontend
+sudo systemctl restart animatrix-backend
+```
+
+If the site looks like plain HTML with unstyled buttons and form controls, check:
+
+```bash
+curl -I https://animatrix.desineuron.in/_next/static/css/<hash>.css
+```
+
+That request must return `200`, not `404`.
+
+## Auth Cookie Safety
+
+The backend now treats forwarded HTTPS headers from nginx as authoritative for cookie security. Even so, keep:
+
+```bash
+BACKEND_BASE_URL=https://animatrix.desineuron.in
+```
+
+in the production backend environment so generated backend URLs and cookie policy stay aligned with the public host.
+
+## First Production Check
+
+1. Open `https://animatrix.desineuron.in/login`
+2. Register a user
+3. Upload one image
+4. Upload one video or one audio file depending on mode
+5. Submit a job
+6. Confirm job transitions out of `created`
+
+## Expected Non-Test Scope
+
+This deployment verifies:
+
+- app hosting
+- TLS
+- backend reachability
+- auth flow
+- asset upload
+- job creation
+- ComfyUI connectivity path
+
+It does not assert final video quality or creative correctness.