# haixun-deployment

| 欄位 | 值 |
|------|-----|
| **Goal** | 只需在本機填寫主機 IP 與加密設定，即可從空 Ubuntu VM 建立並維護完整正式環境 |
| **Phase** | `planning` |
| **Status** | `implementation-not-started` |
| **Runtime** | Docker Compose on Ubuntu 24.04 LTS |
| **Control plane** | Ansible + SSH |
| **Updated** | 2026-07-18 |

## 文件

| 檔案 | 狀態 |
|------|------|
| [requirements.md](./requirements.md) | `draft-for-review` |
| [spec.md](./spec.md) | `draft-for-review` |
| [plan.md](./plan.md) | `draft-for-review` |

## 已確認方向

- MongoDB 使用 MongoDB Atlas，backend/worker 經固定出口 IP 連線。
- frontend、backend、worker 可配置多台主機；Redis、MinIO 第一版各一台。
- 使用自架 Docker Registry、Ansible、WireGuard 與自架 Edge Nginx。
- 本機 build/push image 與編輯設定；遠端不編譯，只安裝基礎設施、pull、recreate/restart。
- 機密使用 Ansible Vault；空 VM 鎖定 Ubuntu 24.04 LTS。
- Edge 與 Registry 網域先完成 DNS，再由 bootstrap 申請 Let's Encrypt。
- Scout crawler 與每台 worker 以 sidecar 方式共同部署。

## 本輪邊界

本文件只保存規劃。Dockerfile、Ansible role、部署 script、VM、Atlas、Redis、MinIO 與 Registry 均尚未修改或部署。