# Deployment Quick Reference

**Last Updated**: 2026-04-16
**Purpose**: Quick command reference for The Order deployment operations on Sankofa Phoenix / Proxmox

---

## Prerequisites Check

```bash
# Verify tools
node --version    # >= 18.0.0
pnpm --version    # >= 8.0.0
docker --version
ssh -V
tar --version

# Verify Proxmox access
ssh root@192.168.11.11 "echo ok"
```

---

## Phase 1: Prerequisites

```bash
git clone <repo-url> && cd the-order
git submodule update --init --recursive
pnpm install --frozen-lockfile
./scripts/deploy/phase1-prerequisites.sh
```

---

## Phase 2: Sankofa Phoenix Target Preparation

```bash
./scripts/deploy/phase2-sankofa-phoenix-target.sh

# Preview the Order edge config directly from the parent Proxmox workspace
bash ../scripts/deployment/provision-order-haproxy-10210.sh --dry-run
```

---

## Phase 3: Identity Provider Secrets

```bash
# Confirm the local env file has the issuer values this environment needs.
./scripts/deploy/phase3-identity-secrets.sh
```

---

## Phase 5: Local Artifact / Runtime Preparation

```bash
./scripts/deploy/phase5-container-registry.sh
cat .deployment/artifacts/image-manifest-dev.txt
```

---

## Phase 6: Build & Package

```bash
# Build packages and local images
./scripts/deploy/phase6-build-package.sh

# Preview the Phoenix sync artifact only
./scripts/deploy/sync-portal-public-to-sankofa-phoenix.sh --dry-run --skip-build
```

---

## Phase 11: Frontend Apps

```bash
# Standard deploy
./scripts/deploy/deploy.sh --phase 11 --environment dev

# Direct sync
./scripts/deploy/sync-portal-public-to-sankofa-phoenix.sh

# Verify
curl -fsS http://192.168.11.36:3000/api/health
curl -fsS -H 'Host: the-order.sankofa.nexus' http://192.168.11.39/api/health
curl -fsS https://the-order.sankofa.nexus/api/health
```

---

## Phase 12: Networking

```bash
# Refresh HAProxy and NPM routing from the parent Proxmox workspace
bash ../scripts/deployment/provision-order-haproxy-10210.sh
bash ../scripts/nginx-proxy-manager/update-npmplus-proxy-hosts-api.sh
```

---

## Phase 13: Monitoring

```bash
./scripts/deploy/phase13-monitoring.sh

# Tail logs directly
ssh root@192.168.11.11 "pct exec 10090 -- journalctl -u the-order-portal-public -f"
```

---

## Phase 14: Testing

```bash
./scripts/deploy/phase14-testing.sh

# Quick health probes
curl -fsS https://phoenix.sankofa.nexus/health
curl -fsS https://the-order.sankofa.nexus/api/health
pnpm --dir apps/portal-public test
```

---

## Common Operations

### Check deployment status

```bash
ssh root@192.168.11.11 "pct status 10090 && pct status 10210"
curl -fsS https://the-order.sankofa.nexus/api/health
```

### View logs

```bash
ssh root@192.168.11.11 "pct exec 10090 -- journalctl -u the-order-portal-public -n 100 --no-pager"
```

### Restart the app

```bash
ssh root@192.168.11.11 "pct exec 10090 -- systemctl restart the-order-portal-public"
```

### Preview the public edge

```bash
curl -i -H 'Host: the-order.sankofa.nexus' http://192.168.11.39/
```