chore(openspec): 歸檔 cloud-ready-p1 + 同步主規格

- 所有 task 驗證完成（7.1 stderr log / 7.2 無新增日誌檔 / 7.3 session 走 Redis）
- 同步 env-cloud-annotations 主 spec（LOG_CHANNEL 取代 LOG_STACK + 新增 scenario）
- 新增 scheduler-container 主 spec（獨立 container 取代 cron daemon）
- 移至 archive/2026-06-18-cloud-ready-p1

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

openspec/changes/archive/2026-06-18-cloud-ready-p1/design.md

@@ -0,0 +1,151 @@
+## Context
+
+P0 完成後 VPS 目前狀態：
+- Session：`SESSION_DRIVER=database`（MySQL）
+- Log：`LOG_CHANNEL=stack`、`LOG_STACK=daily`（寫檔案）
+- Scheduler：cron daemon 跑在 app container 內，entrypoint 啟動
+
+三項都是雲端不友善的設定：多實例時 cron 重複執行、檔案 log 無法被雲端 aggregator 收集、DB session 擴容效率低。
+
+**Bind mount 暫時保留**：`./:/var/www` 目前仍保留，移除 bind mount 屬於 P0 剩餘項目（需將 code bake 進 image），本 change 不處理。scheduler service 同樣沿用 bind mount，與 app/queue-worker 一致。
+
+## Goals / Non-Goals
+
+**Goals:**
+- Session 存 Redis，擴容時不需共享 DB session table
+- Log 走 stderr，`docker compose logs` 及雲端 aggregator 皆可收
+- Scheduler 獨立 container，水平擴容 app 時不會重複跑定時任務
+- Dockerfile 移除 cron 依賴，image 更精簡
+
+**Non-Goals:**
+- 不處理 S3 檔案儲存（P0 待辦）
+- 不移除 bind mount（P0 待辦）
+- 不動任何 PHP 業務邏輯、config/ 目錄下的 PHP 設定檔
+
+## Pre-flight 確認（實作前已驗證）
+
+| 項目 | 結果 |
+|---|---|
+| `config/logging.php` 有 `stderr` channel | ✅ 已存在（line 97），不需改 code |
+| `config/session.php` 的 `driver` 讀 `.env` | ✅ `env('SESSION_DRIVER', 'database')`（line 21） |
+| `SESSION_CONNECTION` | 預設 `null`（使用 default Redis connection），VPS Redis 已在跑，不需額外設定 |
+
+## Decisions
+
+### D1：Scheduler 用 `php artisan schedule:work` 而非 crontab
+
+`schedule:work` 是 Laravel 10+ 內建指令，在前台以無限迴圈每分鐘執行一次 `schedule:run`，不需要 cron daemon。符合 12-factor「一個 container 跑一個 process」原則。
+
+**`depends_on` 取捨**：scheduler 設 `depends_on: app: condition: service_healthy`，確保首次啟動時 PHP-FPM 就緒後 scheduler 才開始執行。注意：`depends_on` 只控制啟動順序，不控制運行時依賴——app container 重啟時 scheduler **不會**跟著重啟，會繼續跑；若 app 還沒 ready 而 scheduler 已觸發任務，任務本身可能失敗，但 scheduler 程序不會崩潰。這是可接受的，定時任務本身應有冪等與錯誤處理。
+
+```yaml
+scheduler:
+  image: cfdive-platform
+  container_name: cfdive-scheduler
+  restart: unless-stopped
+  working_dir: /var/www/
+  command: php artisan schedule:work
+  volumes:
+    - ./:/var/www
+  environment:
+    - DB_CONNECTION=mysql
+    - DB_HOST=db
+    - DB_PORT=3306
+    - DB_DATABASE=${DB_DATABASE:-CFDivePlatform}
+    - DB_USERNAME=${DB_USERNAME:-cfdiveuser}
+    - DB_PASSWORD=${DB_PASSWORD}
+  networks:
+    - cfdive-network
+  depends_on:
+    app:
+      condition: service_healthy
+```
+
+### D2：Log 改 `LOG_CHANNEL=stderr`
+
+`config/logging.php` 已內建 `stderr` channel（`php://stderr`），Docker 自動對應到 container stderr stream，`docker compose logs app` 即可看到。不需新增任何 PHP 設定。
+
+`.env.example` 同步移除 `LOG_STACK` 與 `LOG_DAILY_DAYS`（改 stderr 後這兩個無作用，留著造成混淆）。
+
+**Config cache 注意**：VPS `.env` 改完後需清除 config cache 才能生效：
+```bash
+docker compose exec app php artisan config:clear
+```
+或直接 `docker compose up -d --build`（entrypoint 會自動 `config:clear`）。
+
+### D3：Session 改 Redis，不需建新資料表
+
+Redis 已在跑（`cfdive-redis`），`config/session.php` 讀 `.env`，開箱即用。`sessions` table 保留不刪（避免 rollback 需要重建）。
+
+### D4：VPS `.env` 更新方式
+
+選手動 SSH 更新（不進 deploy.yml 自動化），原因：`.env` 含機敏值，CI 自動覆寫風險高；此為一次性變更。
+
+## Risks / Trade-offs
+
+- **[Risk] Session 失效**：改 driver 後所有現有 session 立即失效，用戶需重新登入。  
+  → **Mitigation**：排低流量時段；VPS `.env` 改完後直接 rebuild，縮短空窗。
+
+- **[Risk] Rebuild image 期間短暫停機**：Dockerfile 移除 cron 需 rebuild。  
+  → **Mitigation**：`docker compose up -d --build` 滾動更新，停機窗口約 30 秒。
+
+- **[Risk] Config cache 未清除**：`.env` 改了但 `bootstrap/cache/config.php` 仍是舊值，session/log 不生效。  
+  → **Mitigation**：Migration Plan 步驟明確包含 `config:clear`；entrypoint 在 rebuild 後也會自動清除。
+
+- **[Risk] Log 遺失歷史**：改 stderr 後 `storage/logs/` 不再更新，但舊檔保留在磁碟。  
+  → **Mitigation**：Sentry 持續收錯誤；需要查歷史時直接看舊檔案。
+
+## Acceptance Criteria
+
+- [ ] `docker compose ps` 顯示 `cfdive-scheduler` 容器 Up
+- [ ] `docker compose exec app sh -c "which cron 2>/dev/null || echo 'cron binary not found'"` 輸出 `cron binary not found`（binary 已從 image 移除）
+- [ ] 呼叫任意 API 後，`docker compose logs app` 有日誌輸出（stderr log 生效）
+- [ ] `storage/logs/` 下無新增日誌檔（舊檔保留）
+- [ ] 登入後 `docker compose exec redis redis-cli keys "laravel_session*"` 有輸出（session 走 Redis）
+
+## Migration Plan
+
+**程式碼（PR 合併前）：**
+1. `Dockerfile`：移除 cron 安裝與 crontab 設定
+2. `docker/php/docker-entrypoint.sh`：移除 `service cron start`
+3. `docker-compose.yml`：新增 `scheduler` service
+4. `.env.example`：`SESSION_DRIVER=redis`、`LOG_CHANNEL=stderr`、移除 `LOG_STACK`/`LOG_DAILY_DAYS`
+5. `docs/STARTUP.md`：補充 scheduler、log 查看、VPS 操作說明
+
+**VPS 維護窗口（PR merge + CI/CD 完成後）：**
+```bash
+# SSH 進 VPS
+cd /root/myproject/CFDivePlatform
+
+# 1. 更新 .env
+sed -i 's/SESSION_DRIVER=database/SESSION_DRIVER=redis/' .env
+sed -i 's/LOG_CHANNEL=stack/LOG_CHANNEL=stderr/' .env
+sed -i '/^LOG_STACK=/d' .env
+sed -i '/^LOG_DAILY_DAYS=/d' .env
+
+# 2. Rebuild + 重啟（entrypoint 自動 config:clear）
+docker compose up -d --build
+
+# 3. 驗證
+docker compose ps
+docker compose logs app | tail -20
+docker compose exec redis redis-cli keys "laravel_session*"
+```
+
+## Rollback Plan
+
+Session/Log 還原（不需 rebuild）：
+```bash
+sed -i 's/SESSION_DRIVER=redis/SESSION_DRIVER=database/' .env
+sed -i 's/LOG_CHANNEL=stderr/LOG_CHANNEL=stack/' .env
+echo "LOG_STACK=daily" >> .env
+echo "LOG_DAILY_DAYS=14" >> .env
+docker compose exec app php artisan config:clear
+docker compose restart app
+```
+
+Scheduler 還原（需 rebuild）：
+```bash
+git revert <commit-hash>
+docker compose up -d --build
+```