a620906209
d423cf5079
Run Tests / test (pull_request) Successful in 29s
- 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 <noreply@anthropic.com>
28 lines
1.7 KiB
Markdown
28 lines
1.7 KiB
Markdown
## 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** 每個雲端關鍵變數旁有說明，提示預設值在雲端環境的限制與建議替代值
|