# 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.