a620906209
e794fddfb1
延續 P1 雲原生改造方向，規劃將上傳檔案（課程圖片、教練證照、聊天室圖片） 改存 S3 相容物件儲存，實現 container 無狀態化。核心設計：public disk driver 直接吃 FILESYSTEM_DISK env 切換，既有 6 個呼叫點零改動，本機開發 環境維持 local 預設不受影響。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011LpcY9b7y9x4fusHBTXciQ
3.0 KiB
3.0 KiB
Why
作為實踐雲原生架構的一環，延續 P1 階段（Session/Log/Scheduler 雲端化）的方向，將使用者上傳檔案（課程圖片、教練證照、預約聊天室圖片）改為 S3 相容物件儲存，是 container 無狀態化的標準作法——容器可以隨時被重建、複製、水平擴容，而不必依賴本機磁碟保留使用者資料。env-cloud-annotations spec 已標注 FILESYSTEM_DISK 雲端應設為 s3，但目前只是註解提醒，尚未實際遷移——.env.example 仍預設 local，public disk 驅動也還是本機磁碟。這是 cloud-ready 路線圖 P0 剩餘兩項之一（另一項為移除 bind mount，不在本次範圍）。
What Changes
composer.json：新增league/flysystem-aws-s3-v3（Laravel 官方 S3 驅動套件，目前未安裝）config/filesystems.php：publicdisk 的driver從local改為s3相容設定（disk key 名稱維持public不變，因為 6 個既有呼叫點都寫死Storage::disk('public')，此法零程式碼改動）.env.example：FILESYSTEM_DISK預設維持local（本機開發環境沒有 S3 相容服務可用，維持 dev 友善），補上AWS_ENDPOINT、AWS_URL、AWS_USE_PATH_STYLE_ENDPOINT等 R2 相容欄位與「雲端環境請設為 s3」的說明註解- 新增一次性遷移 artisan command：把
storage/app/public/現有檔案（課程圖片、教練證照、聊天室圖片）上傳到 S3/R2，避免切換後舊圖 404 - VPS
.env：手動新增 AWS/R2 credentials（機敏值，不進版控） - 驗證：上傳、刪除、顯示三個流程在課程圖片、教練證照、預約聊天室圖片三個既有功能上皆需重新驗證
Capabilities
New Capabilities
file-storage-s3：使用者上傳檔案（課程圖片、教練證照、聊天室圖片）存放於 S3 相容物件儲存，而非 container 本地磁碟；container 重建/水平擴容時檔案不遺失
Modified Capabilities
env-cloud-annotations：FILESYSTEM_DISK需求從「標注建議值」升級為「實際預設值」，比照 P1 階段SESSION_DRIVER／LOG_CHANNEL已完成的模式
Impact
config/filesystems.php：publicdisk 驅動設定composer.json/composer.lock：新增 S3 驅動依賴.env.example：新增/調整 AWS_* 相關變數與說明- 新增檔案：一次性遷移 command（
app/Console/Commands/） - VPS
.env：需手動補齊 credentials（不進版控） - 外部依賴（新增）：需要一組 S3 相容物件儲存帳號（建議 Cloudflare R2，免費額度足夠現行用量）
- 不影響：
CourseImageController、CompressesImagestrait、CourseImage／ProviderCertificationmodel、BookingMessageController這 6 個呼叫點程式碼本身（disk 名稱不變）；資料庫 schema；前端 - 部署影響：需 rebuild app image（新 composer 依賴）；遷移舊檔案時有短暫視窗新舊圖網址不一致，建議排低流量時段