From d423cf5079358cd0984857f655eac376774f4e33 Mon Sep 17 00:00:00 2001 From: Hank Date: Thu, 18 Jun 2026 02:34:01 +0800 Subject: [PATCH] =?UTF-8?q?feat(infra):=20=E9=9B=B2=E7=AB=AF=E5=B0=B1?= =?UTF-8?q?=E7=B7=92=20P1=20=E2=80=94=20Session/Log/Scheduler=20=E6=94=B9?= =?UTF-8?q?=E9=80=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Dockerfile：移除 cron 安裝與 scheduler crontab 設定 - docker-entrypoint.sh：移除 service cron start - docker-compose.yml：新增 scheduler service（php artisan schedule:work） - .env.example：SESSION_DRIVER=redis、LOG_CHANNEL=stderr、移除 LOG_STACK/LOG_DAILY_DAYS - docs/STARTUP.md：新增 Log 查看、VPS 維護窗口操作與 Rollback 說明 VPS 部署需手動更新 .env 並執行 docker compose up -d --build（詳見 STARTUP.md §11） Co-Authored-By: Claude Sonnet 4.6 --- .env.example | 6 +- Dockerfile | 9 +- docker-compose.yml | 21 +++ docker/php/docker-entrypoint.sh | 3 - docs/STARTUP.md | 57 ++++++- .../changes/cloud-ready-p1/.openspec.yaml | 2 + openspec/changes/cloud-ready-p1/design.md | 151 ++++++++++++++++++ openspec/changes/cloud-ready-p1/proposal.md | 31 ++++ .../specs/env-cloud-annotations/spec.md | 27 ++++ .../specs/scheduler-container/spec.md | 19 +++ openspec/changes/cloud-ready-p1/tasks.md | 45 ++++++ 11 files changed, 354 insertions(+), 17 deletions(-) create mode 100644 openspec/changes/cloud-ready-p1/.openspec.yaml create mode 100644 openspec/changes/cloud-ready-p1/design.md create mode 100644 openspec/changes/cloud-ready-p1/proposal.md create mode 100644 openspec/changes/cloud-ready-p1/specs/env-cloud-annotations/spec.md create mode 100644 openspec/changes/cloud-ready-p1/specs/scheduler-container/spec.md create mode 100644 openspec/changes/cloud-ready-p1/tasks.md diff --git a/.env.example b/.env.example index a138440..c84015f 100644 --- a/.env.example +++ b/.env.example @@ -15,9 +15,7 @@ APP_MAINTENANCE_STORE=database BCRYPT_ROUNDS=12 -LOG_CHANNEL=stack -LOG_STACK=daily # 雲端建議改為 stderr 以接入雲端 logging aggregator -LOG_DAILY_DAYS=14 +LOG_CHANNEL=stderr LOG_DEPRECATIONS_CHANNEL=null LOG_LEVEL=debug @@ -29,7 +27,7 @@ DB_CONNECTION=sqlite # DB_PASSWORD= # MYSQL_ROOT_PASSWORD= -SESSION_DRIVER=database # 雲端建議改為 redis +SESSION_DRIVER=redis SESSION_LIFETIME=120 SESSION_ENCRYPT=false SESSION_PATH=/ diff --git a/Dockerfile b/Dockerfile index 0aa3b32..5bc7937 100644 --- a/Dockerfile +++ b/Dockerfile @@ -17,8 +17,7 @@ RUN apt-get update && apt-get install -y \ libzip-dev \ default-mysql-client \ netcat-openbsd \ - grep \ - cron + grep # 清理 apt 快取以減小鏡像大小 RUN apt-get clean && rm -rf /var/lib/apt/lists/* @@ -53,12 +52,6 @@ COPY docker/php/local.ini /usr/local/etc/php/conf.d/local.ini COPY docker/php/docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh RUN chmod +x /usr/local/bin/docker-entrypoint.sh -# 加入 Laravel Scheduler cron job -RUN echo "* * * * * www-data php /var/www/artisan schedule:run >> /var/log/laravel-scheduler.log 2>&1" \ - > /etc/cron.d/laravel-scheduler \ - && chmod 0644 /etc/cron.d/laravel-scheduler \ - && crontab /etc/cron.d/laravel-scheduler - # 設置容器啟動時執行的入口點 # 這將在 CMD 指令之前執行 ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"] diff --git a/docker-compose.yml b/docker-compose.yml index 2a62a7b..fa7bf6d 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -110,6 +110,27 @@ services: - "127.0.0.1:3306:3306" # 只綁 localhost，不對外 + 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 + queue-worker: image: cfdive-platform container_name: cfdive-queue diff --git a/docker/php/docker-entrypoint.sh b/docker/php/docker-entrypoint.sh index 1399ccc..1824c48 100644 --- a/docker/php/docker-entrypoint.sh +++ b/docker/php/docker-entrypoint.sh @@ -59,8 +59,5 @@ fi echo "✅ [背景] 初始化完成" ) & -# 啟動 cron（Laravel Scheduler） -service cron start || cron || true - echo "🚀 啟動 php-fpm..." exec "$@" diff --git a/docs/STARTUP.md b/docs/STARTUP.md index 14215d8..9f05eaf 100644 --- a/docs/STARTUP.md +++ b/docs/STARTUP.md @@ -6,7 +6,7 @@ | 檔案 | 用途 | |------|------| -| `docker-compose.yml` | 正式服務（app、nginx、frontend、db、redis、reverb、queue-worker） | +| `docker-compose.yml` | 正式服務（app、nginx、frontend、db、redis、reverb、queue-worker、scheduler） | | `compose.override.yml` | 開發工具（phpmyadmin、mailpit），已進版控 | **本機 / VPS（預設）**：Docker Compose 自動合併兩檔，開發工具一同啟動： @@ -187,7 +187,60 @@ npm run dev | Reverb WebSocket | | | Health Check | | -## 10. 停止服務 +## 10. Log 查看 + +Laravel 日誌走 stderr，透過 Docker 查看（不再有 `storage/logs/` 檔案）： + +```bash +# 即時串流 +docker compose logs -f app + +# 查看最後 50 行 +docker compose logs app --tail=50 +``` + +## 11. VPS 維護窗口操作（P1 部署） + +PR merge 後 CI/CD 自動跑 composer/migrate/cache，完成後 SSH 進 VPS 執行： + +```bash +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 # scheduler 應顯示 Up +docker compose logs app --tail=20 # 應有 stderr 日誌 +docker compose exec redis redis-cli keys "laravel_session*" # 登入後應有 session key +docker compose exec app sh -c "which cron 2>/dev/null || echo 'cron binary not found'" # 應輸出 not found +``` + +**Rollback（若需還原）：** + +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 +docker compose up -d --build +``` + +## 12. 停止服務 停止容器，但保留資料庫 volume： diff --git a/openspec/changes/cloud-ready-p1/.openspec.yaml b/openspec/changes/cloud-ready-p1/.openspec.yaml new file mode 100644 index 0000000..3ac681e --- /dev/null +++ b/openspec/changes/cloud-ready-p1/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-06-17 diff --git a/openspec/changes/cloud-ready-p1/design.md b/openspec/changes/cloud-ready-p1/design.md new file mode 100644 index 0000000..445a444 --- /dev/null +++ b/openspec/changes/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 +docker compose up -d --build +``` diff --git a/openspec/changes/cloud-ready-p1/proposal.md b/openspec/changes/cloud-ready-p1/proposal.md new file mode 100644 index 0000000..cbad1e9 --- /dev/null +++ b/openspec/changes/cloud-ready-p1/proposal.md @@ -0,0 +1,31 @@ +## Why + +P0 零影響改動完成後，P1 處理三個需要維護窗口但改完後功能完全等效的雲端就緒項目：Session 存 Redis 取代 MySQL（擴容必要）、Log 走 stdout 取代檔案（雲端 logging 標準）、Scheduler 抽成獨立 container 取代 app 容器內 cron（水平擴容不重複執行）。 + +## What Changes + +- **`.env.example`**：`SESSION_DRIVER` 預設改 `redis`；`LOG_CHANNEL` 預設改 `stderr` +- **`Dockerfile`**：移除 `cron` 安裝、移除 scheduler cron job 寫入 +- **`docker/php/docker-entrypoint.sh`**：移除 `service cron start` +- **`docker-compose.yml`**：新增 `scheduler` service（`php artisan schedule:work`） +- **`docs/STARTUP.md`**：更新服務清單，說明 scheduler container 與 log 查看方式 +- **VPS `.env`**：需在維護窗口更新 `SESSION_DRIVER=redis` 與 `LOG_CHANNEL=stderr`（不進版控） + +## Capabilities + +### New Capabilities + +- `scheduler-container`：Scheduler 以獨立 container 方式執行，不依賴 app container 內的 cron daemon + +### Modified Capabilities + +- `env-cloud-annotations`：補充 `SESSION_DRIVER` 與 `LOG_CHANNEL` 的正確雲端預設值（原 spec 已標注說明，現在升級為實際預設值） + +## Impact + +- **`Dockerfile`**：移除 cron 相關 2 行，需 rebuild image +- **`docker/php/docker-entrypoint.sh`**：移除 1 行 +- **`docker-compose.yml`**：新增 `scheduler` service +- **`.env.example`**：2 個預設值變動 +- **不影響**：所有 PHP 業務邏輯、API 行為、前端、資料庫 schema +- **部署影響**：Session 失效一次（用戶登出）、需 rebuild app image diff --git a/openspec/changes/cloud-ready-p1/specs/env-cloud-annotations/spec.md b/openspec/changes/cloud-ready-p1/specs/env-cloud-annotations/spec.md new file mode 100644 index 0000000..8293836 --- /dev/null +++ b/openspec/changes/cloud-ready-p1/specs/env-cloud-annotations/spec.md @@ -0,0 +1,27 @@ +## MODIFIED Requirements + +### Requirement: QUEUE_CONNECTION 預設值為 redis +`.env.example` 的 `QUEUE_CONNECTION` SHALL 預設為 `redis`，與 VPS 實際運作設定一致，避免新環境按範本初始化後跑在效能較差的 database queue。 + +#### Scenario: 新環境照 .env.example 初始化 +- **WHEN** 開發者或 CI 以 `.env.example` 為基礎建立 `.env`，未手動修改 `QUEUE_CONNECTION` +- **THEN** Laravel queue driver 使用 Redis，queue worker 正常消費 Redis 佇列中的 job + +### Requirement: .env.example 標示雲端必要變數 +`.env.example` SHALL 以行內註解或正確預設值標示以下雲端部署時必須明確設定的變數： +- `FILESYSTEM_DISK`：雲端應設為 `s3`（預設 `local` 在容器重啟後遺失上傳檔案） +- `LOG_CHANNEL`：預設改為 `stderr`（雲端 logging aggregator 標準；原 `stack/daily` 寫檔案不適合雲端） +- `QUEUE_CONNECTION`：預設為 `redis` +- `SESSION_DRIVER`：預設改為 `redis`（取代 `database`，擴容更高效） + +#### Scenario: 新環境照 .env.example 初始化 session driver +- **WHEN** 開發者以 `.env.example` 為基礎建立 `.env`，未手動修改 `SESSION_DRIVER` +- **THEN** Laravel session driver 使用 Redis + +#### Scenario: 新環境照 .env.example 初始化 log channel +- **WHEN** 開發者以 `.env.example` 為基礎建立 `.env`，未手動修改 `LOG_CHANNEL` +- **THEN** Laravel 日誌寫入 stderr，可透過 `docker compose logs app` 查看 + +#### Scenario: 操作者閱讀 .env.example 進行雲端部署 +- **WHEN** 操作者參照 `.env.example` 設定雲端環境的 `.env` +- **THEN** 每個雲端關鍵變數旁有說明，提示預設值在雲端環境的限制與建議替代值 diff --git a/openspec/changes/cloud-ready-p1/specs/scheduler-container/spec.md b/openspec/changes/cloud-ready-p1/specs/scheduler-container/spec.md new file mode 100644 index 0000000..ac4c5ba --- /dev/null +++ b/openspec/changes/cloud-ready-p1/specs/scheduler-container/spec.md @@ -0,0 +1,19 @@ +## ADDED Requirements + +### Requirement: Scheduler 以獨立 container 執行 +`docker-compose.yml` SHALL 定義 `scheduler` service，使用 `cfdive-platform` image，以 `php artisan schedule:work` 前台輪詢方式執行 Laravel Scheduler，取代原本在 app container 內的 cron daemon。 + +#### Scenario: Scheduler container 隨 app 啟動 +- **WHEN** 執行 `docker compose up -d` 且 `app` container 已 healthy +- **THEN** `scheduler` container 啟動並持續執行 `php artisan schedule:work` + +#### Scenario: App container 重啟時 scheduler 等待就緒 +- **WHEN** `app` container 重啟中（unhealthy） +- **THEN** `scheduler` container 依 `depends_on` 等待 `app` healthy 後才啟動，避免 scheduler 在 PHP-FPM 未就緒時執行任務 + +### Requirement: App container 不再包含 cron daemon +`Dockerfile` SHALL 不安裝 `cron` 套件，`docker-entrypoint.sh` SHALL 不執行 `service cron start`，確保 app container 職責單一（只跑 PHP-FPM）。 + +#### Scenario: App container 啟動不啟動 cron +- **WHEN** `app` container 啟動並執行 entrypoint +- **THEN** 不存在 cron daemon 程序，`pgrep cron` 回傳 exit code 1 diff --git a/openspec/changes/cloud-ready-p1/tasks.md b/openspec/changes/cloud-ready-p1/tasks.md new file mode 100644 index 0000000..6e30901 --- /dev/null +++ b/openspec/changes/cloud-ready-p1/tasks.md @@ -0,0 +1,45 @@ +## 1. Dockerfile 移除 cron + +- [x] 1.1 [後端] 從 `Dockerfile` 的 `apt-get install -y` 清單移除 `cron` +- [x] 1.2 [後端] 從 `Dockerfile` 移除寫入 `/etc/cron.d/laravel-scheduler` 的 `RUN echo ...` 指令 +- [x] 1.3 [後端] 從 `Dockerfile` 移除 `crontab /etc/cron.d/laravel-scheduler` 指令 + +## 2. docker-entrypoint.sh 移除 cron 啟動 + +- [x] 2.1 [後端] 從 `docker/php/docker-entrypoint.sh` 移除 `service cron start || cron || true` 這一行 + +## 3. docker-compose.yml 新增 scheduler service + +- [x] 3.1 [後端] 在 `docker-compose.yml` 新增 `scheduler` service，設定如下： + - `image: cfdive-platform`、`container_name: cfdive-scheduler`、`restart: unless-stopped` + - `working_dir: /var/www/`、`command: php artisan schedule:work` + - `volumes: - ./:/var/www` + - 環境變數：`DB_CONNECTION`、`DB_HOST=db`、`DB_PORT`、`DB_DATABASE`、`DB_USERNAME`、`DB_PASSWORD`（與 queue-worker 相同） + - `networks: - cfdive-network` + - `depends_on: app: condition: service_healthy` + +## 4. .env.example 更新 + +- [x] 4.1 [後端] 將 `.env.example` 的 `SESSION_DRIVER=database # 雲端建議改為 redis` 改為 `SESSION_DRIVER=redis`（升級為預設值，移除說明） +- [x] 4.2 [後端] 將 `.env.example` 的 `LOG_CHANNEL=stack` 改為 `LOG_CHANNEL=stderr` +- [x] 4.3 [後端] 從 `.env.example` 移除 `LOG_STACK=daily` 與 `LOG_DAILY_DAYS=14` 兩行（改 stderr 後無作用） + +## 5. 文件更新 + +- [x] 5.1 [後端] 更新 `docs/STARTUP.md`，補充以下內容： + - 服務清單新增 `scheduler`（`docker compose ps` 應見 `cfdive-scheduler`） + - Log 查看方式：`docker compose logs -f app`（不再有 `storage/logs/` 檔案） + - **VPS 維護窗口操作**：說明 `sed` 更新 `.env` 的四個指令 + `docker compose up -d --build` + - **Config cache 注意**：`.env` 改完須清 cache（rebuild 時 entrypoint 自動處理） + - **Rollback 步驟**：Session/Log 還原指令（不需 rebuild）+ Scheduler 還原（需 rebuild） + +## 6. 手動驗證（本機，不需 VPS .env） + +- [x] 6.1 [整合測試] 在本機 rebuild 後確認 `cfdive-scheduler` 正常啟動：`docker compose ps` 顯示 scheduler Up +- [x] 6.2 [整合測試] 確認 app container 無 cron：`docker compose exec app sh -c "which cron 2>/dev/null || echo 'cron binary not found'"`（cron binary 已從 image 移除，輸出 `cron binary not found`） + +## 7. 手動驗證（VPS，需更新 .env 後） + +- [ ] 7.1 [整合測試] 確認 log 走 stderr：呼叫任意 API 後 `docker compose logs app | tail -20` 有日誌輸出 +- [ ] 7.2 [整合測試] 確認 `storage/logs/` 無新增日誌檔（舊檔保留） +- [ ] 7.3 [整合測試] 確認 session 走 Redis：登入後 `docker compose exec redis redis-cli keys "laravel_session*"` 有輸出