Remove Azure deployment stack; Proxmox 7810 is canonical production.

Delete Static Web Apps workflow, Bicep infra, Azure Functions api/, SWA configs, and Azure-only scripts; document Proxmox deploy path and refresh QuickStart and prerequisites. Co-authored-by: Cursor <[email protected]>
2026-06-15 19:41:08 -07:00
parent d5a8a263cb
commit e3a171c5ff
39 changed files with 168 additions and 10642 deletions
@@ -0,0 +1,56 @@
+# MIM4U production deployment (Proxmox)
+
+Production for **https://mim4u.org** is served from **VMID 7810** (mim-web-1 @ `192.168.11.37`) behind NPMplus. Azure Static Web Apps and Azure Functions are **not** used.
+
+## Prerequisites
+
+- Node.js 22.x, npm 10+
+- ImageMagick (`convert`) for `npm run brand:export` (runs on `prebuild`)
+- LAN SSH to Proxmox host **192.168.11.12** (r630-02)
+- Sibling repo layout: `../proxmox` beside `miracles_in_motion`, or set `MIM_ROOT`
+
+## Build and deploy
+
+From the **proxmox** repo (operator LAN):
+
+```bash
+./scripts/mim4u-deploy-to-7810.sh
+```
+
+Or manually:
+
+```bash
+cd ~/projects/miracles_in_motion
+npm run build
+# then tar dist/ into VMID 7810 /var/www/html (see deploy script)
+```
+
+The deploy script **wipes** `/var/www/html/*` before extract to avoid stale PWA/JS bundles.
+
+## Verify
+
+```bash
+curl -I -H 'Host: mim4u.org' http://192.168.11.37/
+curl -I -H 'Host: mim4u.org' http://192.168.11.37/brand/logo-horizontal-nav.svg
+```
+
+Public HTTPS: NPMplus proxy hosts for `mim4u.org`, `www.mim4u.org`, `secure.mim4u.org`, `training.mim4u.org` → `192.168.11.37:80`.
+
+## CI (GitHub Actions)
+
+| Workflow | Trigger | Purpose |
+|----------|---------|---------|
+| `validate.yml` | Pull requests | type-check, tests, header WCAG audit, build |
+| `deploy.yml` | Push to `main` | validate + GitHub Pages artifact (optional mirror) |
+| `a11y-live.yml` | Weekly / manual | Lighthouse accessibility on live mim4u.org |
+
+Canonical production traffic is **Proxmox 7810**, not GitHub Pages.
+
+## API backend
+
+`/api/*` on mim4u.org is proxied by nginx on **7810** to **VMID 7811** (mim-api-1 @ `192.168.11.36:3001`). API deployment is separate from this frontend repo.
+
+## Related proxmox docs
+
+- `docs/04-configuration/ALL_VMIDS_ENDPOINTS.md` — VMIDs and FQDNs
+- `docs/04-configuration/E2E_ENDPOINTS_LIST.md` — public routing verification
@@ -1,46 +1,20 @@
-# 📚 Deployment Documentation
+# Deployment documentation

-This directory contains all deployment-related documentation for the Miracles In Motion project.
+## Canonical (use this)

---
+| Doc | Purpose |
+|-----|---------|
+| [PROXMOX_DEPLOYMENT.md](./PROXMOX_DEPLOYMENT.md) | Production deploy to VMID 7810 |
+| [../DEPLOYMENT_PREREQUISITES.md](../DEPLOYMENT_PREREQUISITES.md) | Checklist and env vars |
+| [../QuickStart.md](../QuickStart.md) | Local dev, test, build |

-## 📋 Documentation Files
+Proxmox operator script: `../../proxmox/scripts/mim4u-deploy-to-7810.sh` (sibling repo).

-### Status & Reports
- **DEPLOYMENT_STATUS.md** - Current deployment status and checklist
- **DEPLOYMENT_STATUS_FINAL.md** - Final deployment status summary
- **DEPLOYMENT_VERIFICATION_REPORT.md** - Deployment verification results
- **DEPLOYMENT_COMPLETE.md** - Deployment completion summary
+## Archived (Azure — removed 2026-06)

-### Guides & Instructions
- **DEPLOYMENT_SETUP_README.md** - Deployment setup overview
- **ALL_NEXT_STEPS.md** - Complete next steps for deployment
- **COMPLETE_NEXT_STEPS.md** - Complete deployment steps guide
- **DEPLOYMENT_COMPLETE_GUIDE.md** - Quick deployment guide
- **FINAL_DEPLOYMENT_STEPS.md** - Final deployment steps
+The following files describe **deprecated** Azure Static Web Apps / Functions / Bicep flows. Do not use for new deployments:

-### Next Steps & Tasks
- **DEPLOYMENT_NEXT_STEPS.md** - Next steps for deployment
- **NEXT_STEPS_COMPLETE.md** - Next steps completion summary
- **REMAINING_TASKS_COMPLETE.md** - Remaining tasks summary
-
-### Cloudflare & Domain
- **CLOUDFLARE_SETUP.md** - Cloudflare setup instructions
- **CLOUDFLARE_AUTOMATION_COMPLETE.md** - Cloudflare automation guide
- **CUSTOM_DOMAIN_SETUP.md** - Custom domain configuration
-
---
-
-## 🚀 Quick Start
-
-1. **Check Current Status:** Start with `DEPLOYMENT_STATUS.md`
-2. **Follow Next Steps:** See `ALL_NEXT_STEPS.md` for complete guide
-3. **Cloudflare Setup:** See `CLOUDFLARE_SETUP.md` if using Cloudflare
-4. **Custom Domain:** See `CUSTOM_DOMAIN_SETUP.md` for domain configuration
-
---
-
-## 📝 Note
-
-All deployment documentation has been organized here from the project root for better structure and easier access.
+- `CLOUDFLARE_*.md`, `DEPLOYMENT_*.md`, `FINAL_*.md`, `ALL_NEXT_STEPS.md`, etc. in this folder
+- `docs/phases/*DEPLOYMENT*`, `PRODUCTION_DEPLOYMENT_SUCCESS.md`

+Production is **https://mim4u.org** on Proxmox **7810** only.