From a0fa339d6dbbdba8960c08295e768f11bcefdaaa Mon Sep 17 00:00:00 2001
From: Hank <a6209123456789@yahoo.com.tw>
Date: Mon, 3 Aug 2026 03:40:47 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=A8=99=E8=A8=BB=20S3=20=E7=9B=B8?=
 =?UTF-8?q?=E5=AE=B9=E5=84=B2=E5=AD=98=E5=B0=9A=E6=9C=AA=E5=95=9F=E7=94=A8?=
 =?UTF-8?q?=EF=BC=88=E7=BC=BA=20R2=20=E5=B8=B3=E8=99=9F=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

在 .env.example 的 AWS_* 區塊與 MigrateStorageToS3 command 加上
TODO(2026-08-03) 註解，說明目前功能已實作但因缺帳號未啟用，直接在
code 裡就看得到狀態，不用另外翻 openspec 文件。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011LpcY9b7y9x4fusHBTXciQ
---
 .env.example                                | 3 +++
 app/Console/Commands/MigrateStorageToS3.php | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/.env.example b/.env.example
index b7bde77..798fb8a 100644
--- a/.env.example
+++ b/.env.example
@@ -56,6 +56,9 @@ MAIL_ENCRYPTION=null
 MAIL_FROM_ADDRESS="hello@example.com"
 MAIL_FROM_NAME="${APP_NAME}"
 
+# TODO(2026-08-03): 尚未申請 S3 相容服務帳號，以下 AWS_* 僅供未來啟用 FILESYSTEM_DISK=s3
+# 時填入，目前留空不影響任何功能（public disk 走 local）。詳見
+# openspec/changes/cloud-ready-s3-storage/tasks.md 第 4-6 組。
 AWS_ACCESS_KEY_ID=
 AWS_SECRET_ACCESS_KEY=
 AWS_DEFAULT_REGION=us-east-1
diff --git a/app/Console/Commands/MigrateStorageToS3.php b/app/Console/Commands/MigrateStorageToS3.php
index 1515561..4ba6612 100644
--- a/app/Console/Commands/MigrateStorageToS3.php
+++ b/app/Console/Commands/MigrateStorageToS3.php
@@ -6,6 +6,9 @@ use Illuminate\Console\Command;
 use Illuminate\Support\Facades\Storage;
 use Throwable;
 
+// TODO(2026-08-03): 尚未申請 S3 相容服務帳號，此指令目前無法在正式環境執行
+// （會因缺少 AWS_* credentials 連線失敗）。待 R2 帳號建立後才會實際使用，
+// 見 openspec/changes/cloud-ready-s3-storage/tasks.md 第 4-6 組。
 class MigrateStorageToS3 extends Command
 {
     protected $signature = 'storage:migrate-to-s3