feat(visionA-backend): Phase 0.8b v0.6 T4 — config FAA 欄位砍 + .env 清 + i18n/godoc polish

對齊 ADR-016 / conversion.md v0.6.1 §3.1：visionA 端不再需要 FAA 設定（v0.5 T1 加的 FAAAPIKey/FAABaseURL 撤回）。

config 砍除：
- internal/config/config.go: ConversionConfig.FAABaseURL + FAAAPIKey 兩欄位
- internal/config/load.go: VISIONA_FAA_BASE_URL + VISIONA_FAA_API_KEY 兩 env 讀取
- Enabled() 簡化為「ConverterBaseURL + ConverterAPIKey 兩個非空」
- internal/config/load_test.go: TestLoad_ConversionEnabled 從 6 case 簡化為 4 case (all_set / missing_converter_url / missing_converter_key / all_empty)

.env*.example 對齊（3 個檔）:
- visionA-backend/.env.example: 砍 2 個 FAA env row + 註解；header 改「2 欄位啟用」
- .env.stage.example: 同上；VISIONA_CONVERTER_API_KEY 保留 CHANGE_ME_OPENSSL_RAND_HEX_32 placeholder
- .env.dev.example: 註解區塊統一對齊

T3 review polish:
- m-2 internal/api/conversion.go: i18n message map 砍 4 個 dead case (download_token_failed / mc_token_unavailable / idp_misconfigured / idp_unavailable) — 對應 v0.5 mc_token_client 撤回時砍的 sentinel；落入 default「內部錯誤」、行為不變
- m-3 internal/conversion/util.go: hashObjectKey godoc 補「設計約束（重要）」段 + 3 條「不應做的事」（不出現在 response body/header / 不組 URL / 不寫進 user-facing 錯誤訊息）— 明示用途限定於 slog 欄位內、避免 misuse vector
- cmd/api-server/main.go: godoc 對齊 T4 完成狀態

驗證:
- B 層 verification 主動跑（T3 reviewer 接受暫緩、backend 主動跑避免 reviewer 二次要求）：
  * 跨檔 grep: production code 0 functional 命中（殘留全是註解 audit trail / test fixture name）
  * 17 packages race -count=3 全綠
  * 3 個 .env 環境一致性驗證
- go build ./... exit 0
- go test -race -count=3 ./... 17 packages 全綠
- Reviewer 5 軸（v0.6-t4-review）✅ 通過（0 Critical / 0 Major / 2 Minor / 4 Suggestion）

v0.6 對齊改造事實上完工：
- T1 ConverterClient.GetResult method
- T2 flow.go DownloadStream/PromoteToModels 改用 GetResult + e2e endpoint
- T3 faa_client 整檔砍 + ErrFAA* sentinel 清 + s-3/s-4/s-5 必補 + mockFAA regression-only
- T4 config FAA 欄位砍 + .env 清 + i18n/godoc polish

main.go startup log 已是「converter_api_key_set only」、無 FAA 殘留 / 無 tenant_id（T2-T3 已處理）。e2e regression 防護由 mockFAA negative assertion 守住（T3）。

下一步:
- visionA backend 端 ADR-016 對齊完工，等使用者跨 repo 加 converter GET /api/v1/jobs/{id}/result endpoint
- stage redeploy + e2e 完整測試

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.env.dev.example

@@ -79,16 +79,18 @@ VISIONA_PAIRING_TOKEN=
 # ============================================================
 # Phase 0.8 / 0.8b — 轉檔功能整合（dev 通常不啟用，留空即可）
 # ============================================================
-# 對齊 .autoflow/04-architecture/conversion.md §3 + ADR-015。
+# 對齊 docs/autoflow/04-architecture/conversion.md §3 + ADR-015 + ADR-016。
 #
-# 4 個欄位全部非空才會啟用 conversion 模組；dev 全空 = sidebar tab 顯示但 endpoint 不註冊。
+# 2 個欄位（ConverterBaseURL / ConverterAPIKey）全部非空才會啟用 conversion 模組；
-# 若要在 dev 連 stage 的 converter / FAA 測整合，依 .env.stage.example 模板填入。
+# dev 全空 = sidebar tab 顯示但 endpoint 不註冊。
+# 若要在 dev 連 stage 的 converter 測整合，依 .env.stage.example 模板填入。
+#
+# Phase 0.8b v0.6 T4：原 FAA 相關 env（VISIONA_FAA_BASE_URL / VISIONA_FAA_API_KEY）
+# 已撤回（ADR-016：visionA 端不再直接呼叫 FAA；download / promote 改走 converter.GetResult）。
 #
 # 產生 API key：openssl rand -hex 32
 # VISIONA_CONVERTER_BASE_URL=http://192.168.0.130:9501
-# VISIONA_FAA_BASE_URL=http://192.168.0.130:5081
 # VISIONA_CONVERTER_API_KEY=
-# VISIONA_FAA_API_KEY=
 
 # ============================================================
 # 進階：port 衝突時可改

.env.stage.example

@@ -115,33 +115,29 @@ VISIONA_SEED_DEMO_DATA=false
 # 留註解作為 audit trail；stage 部署不需設定 VISIONA_STATIC_USER_ID。
 
 # ============================================================
-# Phase 0.8 / 0.8b — 轉檔功能整合（converter / FAA pre-shared API key）
+# Phase 0.8 / 0.8b — 轉檔功能整合（converter pre-shared API key）
 # ============================================================
-# 對齊 .autoflow/04-architecture/conversion.md §3 + ADR-015。
+# 對齊 docs/autoflow/04-architecture/conversion.md §3 + ADR-015 + ADR-016。
 #
 # Phase 0.8b 變更：服務間認證從 OAuth client_credentials 改為 pre-shared API key。
 #
-# 啟用判定：4 個欄位（ConverterBaseURL / FAABaseURL / ConverterAPIKey / FAAAPIKey）
+# 啟用判定：2 個欄位（ConverterBaseURL / ConverterAPIKey）**全部非空**才視為啟用；
-# **全部非空**才視為啟用；任一缺 → 5 個 /api/conversion/* endpoint 不註冊。
+# 任一缺 → 5 個 /api/conversion/* endpoint 不註冊。
 #
 # Phase 0.8b 移除（不再讀取，也別再放進 .env.stage）：
 #   - VISIONA_OIDC_SERVICE_CLIENT_ID / _SECRET（服務間認證取消 MC client_credentials）
 #   - VISIONA_CONVERSION_TENANT_ID / VISIONA_OIDC_TENANT_ID（取消 tenant 概念）
 #   - VISIONA_FAA_DELEGATED_TTL_SECONDS（取消 delegated download token 機制；改 server-side stream proxy）
+#
+# Phase 0.8b v0.6 T4 移除（不再讀取，也別再放進 .env.stage；ADR-016 撤回 v0.5 設計缺口）：
+#   - VISIONA_FAA_BASE_URL（visionA 端不再直接呼叫 FAA）
+#   - VISIONA_FAA_API_KEY（同上；download / promote 改走 converter.GetResult）
 
 # kneron_model_converter task-scheduler base URL（stage 公司內網）
 VISIONA_CONVERTER_BASE_URL=http://192.168.0.130:9501
 
-# File Access Agent base URL
-VISIONA_FAA_BASE_URL=http://192.168.0.130:5081
-
 # Pre-shared API key — visionA → converter 服務間認證（Phase 0.8b 新增；ADR-015 §3）
 # **必須換掉**：openssl rand -hex 32 產生 64 字元 hex；與 converter 端 CONVERTER_API_KEY 對齊
 # 雙方獨立持有、不共用、嚴格分環境（dev / stage / prod 各自獨立 key）
 # log 永遠不印此值全文；部署時用 AWS Secrets Manager / Vault 注入
 VISIONA_CONVERTER_API_KEY=CHANGE_ME_OPENSSL_RAND_HEX_32
-
-# Pre-shared API key — visionA → FAA 服務間認證（Phase 0.8b 新增；ADR-015 §3）
-# **必須換掉**：openssl rand -hex 32；與 FAA 端 FAA_API_KEY 對齊（warrenchen 配置）
-# 與 ConverterAPIKey **不共用**（每條 trust boundary 各自獨立，避免一處洩漏連坐）
-VISIONA_FAA_API_KEY=CHANGE_ME_OPENSSL_RAND_HEX_32

visionA-backend/.env.example

@@ -80,7 +80,8 @@ VISIONA_FRONTEND_URL=http://localhost:3000
 # 服務間認證從 OAuth client_credentials 改為 pre-shared API key（見 ADR-015、conversion.md §3）。
 # 兩個 service client env 不再讀取（OIDCConfig.ServiceClientID/Secret struct 欄位
 # 為了 backward compat 暫保留、但 conversion 模組不再依賴）。
-# 取代設定見下方 Phase 0.8 / 0.8b 區塊的 VISIONA_CONVERTER_API_KEY / VISIONA_FAA_API_KEY。
+# 取代設定見下方 Phase 0.8 / 0.8b 區塊的 VISIONA_CONVERTER_API_KEY
+# （Phase 0.8b v0.6 T4 起 visionA 端不再直接呼叫 FAA、原 VISIONA_FAA_API_KEY 已撤回）。
 
 # Cookie HMAC 簽章 secret（⚠️ 至少 32 byte 隨機字串；prod 用 openssl rand -hex 32）
 VISIONA_SESSION_SECRET=CHANGE_ME_TO_RANDOM_64_BYTES_in_production
@@ -157,40 +158,34 @@ VISIONA_PAIRING_TOKEN=
 
 
 # ============================================================
-# Phase 0.8 / 0.8b — 轉檔功能整合（converter / FAA pre-shared API key）
+# Phase 0.8 / 0.8b — 轉檔功能整合（converter pre-shared API key）
 # ============================================================
-# 對齊 .autoflow/04-architecture/conversion.md §3 + ADR-015。
+# 對齊 docs/autoflow/04-architecture/conversion.md §3 + ADR-015 + ADR-016。
 #
 # Phase 0.8b 變更：服務間認證從 OAuth client_credentials 改為 pre-shared API key。
 #
-# 啟用判定：4 個欄位（ConverterBaseURL / FAABaseURL / ConverterAPIKey / FAAAPIKey）
+# 啟用判定：2 個欄位（ConverterBaseURL / ConverterAPIKey）**全部非空**才視為啟用；
-# **全部非空**才視為啟用；任一缺 → 5 個 /api/conversion/* endpoint 不註冊 / 回 501。
+# 任一缺 → 5 個 /api/conversion/* endpoint 不註冊 / 回 501。
 #
 # Phase 0.8b 移除（不再讀取）：
 #   - VISIONA_OIDC_SERVICE_CLIENT_ID / _SECRET（OAuth client_credentials 機制取消）
 #   - VISIONA_OIDC_TENANT_ID（取消 tenant 概念，converter 端的 user_id 仍由 visionA 灌入）
 #   - VISIONA_FAA_DELEGATED_TTL_SECONDS（delegated download token 機制取消，改 server-side stream proxy）
+#
+# Phase 0.8b v0.6 T4 移除（不再讀取；ADR-016 撤回 v0.5 設計缺口）：
+#   - VISIONA_FAA_BASE_URL（visionA 端不再直接呼叫 FAA）
+#   - VISIONA_FAA_API_KEY（同上；download / promote 改走 converter.GetResult）
 
 # kneron_model_converter task-scheduler base URL
 # dev/stage：http://192.168.0.130:9501
 # prod：https://converter.visiona.cloud
 VISIONA_CONVERTER_BASE_URL=
 
-# File Access Agent base URL
-# dev/stage：http://192.168.0.130:5081
-# prod：https://faa.innovedus.com
-VISIONA_FAA_BASE_URL=
-
 # Pre-shared API key — visionA → converter 服務間認證（Phase 0.8b 新增；ADR-015 §3）
 # 產生：openssl rand -hex 32（64 字元 hex）
 # 與 converter 端 CONVERTER_API_KEY env 對齊（雙方獨立持有，嚴格分環境 dev / stage / prod）
 # ⚠️ 不可 commit；prod 用 Secrets Manager / Vault；log 永遠不印此值全文
 VISIONA_CONVERTER_API_KEY=
 
-# Pre-shared API key — visionA → FAA 服務間認證（Phase 0.8b 新增；ADR-015 §3）
-# 產生方式同上；與 FAA 端 FAA_API_KEY env 對齊（warrenchen 配置）
-# 與 ConverterAPIKey **不共用**（每條 trust boundary 各自獨立，避免一處洩漏連坐）
-VISIONA_FAA_API_KEY=
-
 # 上傳模型檔大小上限（MB）— 與 converter 端 limit 對齊
 VISIONA_CONVERTER_MAX_MODEL_SIZE_MB=500

visionA-backend/cmd/api-server/main.go

@@ -141,16 +141,17 @@ func main() {
 	// 對齊 docs/autoflow/04-architecture/conversion.md、ADR-015、ADR-016。
 	//
 	// 啟用條件：cfg.Conversion.Enabled() —
-	// 由 ConverterBaseURL + ConverterAPIKey 決定（FAABaseURL / FAAAPIKey 由 T4 砍除 env 校驗）。
+	// 由 ConverterBaseURL + ConverterAPIKey 決定（v0.6 T4 起 visionA 端不再需要 FAA env）。
 	// 不啟用時 deps.Conversion 為 nil，5 個 endpoint 自動回 501（registerConversionRoutes 處理）。
 	//
 	// **Phase 0.8b T5**：完全切換至 pre-shared API key 認證 — 不再 wire MCTokenClient、
 	// 不再讀 OIDCConfig.ServiceClientID/Secret、不再有 tenant_id / delegated_ttl_sec
 	// 概念。參見 ADR-015 §6 變更影響清單。
 	//
-	// **Phase 0.8b v0.6 T3**：撤回 visionA → FAA 直接呼叫（ADR-016 撤回 v0.5 設計缺口）。
+	// **Phase 0.8b v0.6 T3 + T4**：撤回 visionA → FAA 直接呼叫（ADR-016 撤回 v0.5 設計缺口）。
-	// faa_client.go / FAAClient interface / FlowOpts.FAA 全部砍除；download / promote 流程
+	// T3 砍 faa_client.go / FAAClient interface / FlowOpts.FAA；T4 砍 ConversionConfig
-	// 改走 converter.GetResult。FAABaseURL / FAAAPIKey env 仍保留在 config 直到 T4 一併砍。
+	// FAABaseURL / FAAAPIKey 兩欄位與對應 env（VISIONA_FAA_BASE_URL / VISIONA_FAA_API_KEY），
+	// `Enabled()` 簡化為只判 converter 兩欄位。download / promote 流程改走 converter.GetResult。
 	var conversionService conversion.Service
 	if cfg.Conversion.Enabled() {
 		// 不再檢查 ServiceClientID/Secret —— Phase 0.8b 起 conversion 不依賴 OIDC service client。

visionA-backend/internal/api/conversion.go

@@ -508,17 +508,15 @@ func errorMessageFor(code string) string {
 	case "converter_unavailable":
 		return "轉檔服務暫時無法使用"
 	case "faa_unavailable":
+		// converter promote 內部 PUT FAA 失敗時透傳，由 SRE 區分 converter 不可達 vs
+		// converter→FAA push 失敗（ADR-016：visionA 端不再直接呼叫 FAA）。
 		return "檔案存取服務暫時無法使用"
-	case "download_token_failed":
-		return "無法取得下載授權"
-	case "mc_token_unavailable":
-		return "無法取得下載授權，請重試"
-	case "idp_misconfigured":
-		return "系統設定錯誤，請聯絡支援"
-	case "idp_unavailable":
-		return "認證服務暫時無法使用"
 	case "service_busy":
 		return "系統繁忙，請稍後再試"
+	// Phase 0.8b v0.6 T3 / T4：以下 i18n key 對應的 sentinel 已砍除，不再會被產生：
+	//   - download_token_failed / mc_token_unavailable（v0.5 mc_token_client 撤回）
+	//   - idp_misconfigured / idp_unavailable（同上）
+	// 故 case 直接省略；errorMessageFor 落入 default。
 	default:
 		return "內部錯誤"
 	}

visionA-backend/internal/config/config.go

@@ -182,30 +182,31 @@ type LoggerConfig struct {
 
 // ConversionConfig 控制 Phase 0.8 / 0.8b 轉檔功能整合。
 //
-// 對齊 .autoflow/04-architecture/conversion.md §3、`adr/adr-015-server-to-server-api-key.md`。
+// 對齊 docs/autoflow/04-architecture/conversion.md §3、
+// `adr/adr-015-server-to-server-api-key.md`、`adr/adr-016-download-via-converter.md`。
 //
-// 啟用判定（由 Enabled() 給 main.go 用）：Phase 0.8b 起，4 個欄位（ConverterBaseURL /
+// 啟用判定（由 Enabled() 給 main.go 用）：Phase 0.8b v0.6 起，2 個必要欄位
-// FAABaseURL / ConverterAPIKey / FAAAPIKey）**全部非空**才視為啟用；任一缺即視為未啟用，
+// （ConverterBaseURL / ConverterAPIKey）**全部非空**才視為啟用；任一缺即視為未啟用，
 // 5 個 /api/conversion/* endpoint 不會 wire（main.go 在 wire 階段跳過、log warn）。
 //
-// **Phase 0.8b 變更**：服務間認證從 OAuth client_credentials 改為 pre-shared API key（ADR-015）；
+// **Phase 0.8b 變更**：服務間認證從 OAuth client_credentials 改為 pre-shared API key（ADR-015）。
-// `Enabled()` 加入兩個 API key 非空檢查。
 //
 // **Phase 0.8b T5 完成**（見 conversion.md §3.2 / ADR-015 §5 §7）：原暫留欄位
 // TenantID / DelegatedTTLSeconds 已移除 — MC 認證鏈與 delegated download token 機制
 // 都不存在了，兩個欄位連同對應 env（VISIONA_OIDC_TENANT_ID /
 // VISIONA_FAA_DELEGATED_TTL_SECONDS）一併清除。
+//
+// **Phase 0.8b v0.6 T4 完成**（見 ADR-016 §2 / conversion.md v0.6.1 §3.1）：原 FAA 相關
+// 欄位 FAABaseURL / FAAAPIKey 已移除 — visionA 端不再直接呼叫 FAA，download / promote
+// 流程改走 converter.GetResult（ADR-016 撤回 v0.5 設計缺口），兩個欄位連同對應 env
+// （VISIONA_FAA_BASE_URL / VISIONA_FAA_API_KEY）一併清除；`Enabled()` 也簡化為只判
+// converter 兩欄位。
 type ConversionConfig struct {
 	// ConverterBaseURL 是 kneron_model_converter task-scheduler 服務的 base URL。
 	// 例：http://192.168.0.130:9501（dev / stage） / https://converter.visiona.cloud（prod）
 	// 對齊 VISIONA_CONVERTER_BASE_URL；留空 = 不啟用 Phase 0.8 轉檔功能。
 	ConverterBaseURL string
 
-	// FAABaseURL 是 File Access Agent 的 base URL。
-	// 例：http://192.168.0.130:5081（dev / stage） / https://faa.innovedus.com（prod）
-	// 對齊 VISIONA_FAA_BASE_URL；留空 = 不啟用 Phase 0.8 轉檔功能。
-	FAABaseURL string
-
 	// ConverterAPIKey 是 visionA → converter 服務間認證的 pre-shared API key（Phase 0.8b 新增）。
 	// 對齊 VISIONA_CONVERTER_API_KEY；以 `Authorization: Bearer <key>` 形式帶上。
 	// 雙方獨立產生（`openssl rand -hex 32`），visionA 端的值必須與 converter 端的
@@ -216,12 +217,6 @@ type ConversionConfig struct {
 	// 部署用 AWS Secrets Manager / Vault；嚴格分環境（dev / stage / prod 各自獨立 key）。
 	ConverterAPIKey string
 
-	// FAAAPIKey 是 visionA → FAA 服務間認證的 pre-shared API key（Phase 0.8b 新增）。
-	// 對齊 VISIONA_FAA_API_KEY；以 `Authorization: Bearer <key>` 形式帶上。
-	// 與 ConverterAPIKey **不共用**（每條 trust boundary 各自獨立，避免一處洩漏連坐 — ADR-015 §3）；
-	// 對應 FAA 端的 `FAA_API_KEY` env，由 warrenchen 配置（跨 repo 同步）。
-	FAAAPIKey string
-
 	// MaxModelSizeMB 是 visionA-backend 端對上傳模型檔的大小上限（MB）。
 	// 與 converter 端 limit 對齊（converter 預設 500 MB）。
 	// 對齊 VISIONA_CONVERTER_MAX_MODEL_SIZE_MB；預設 500。
@@ -230,14 +225,12 @@ type ConversionConfig struct {
 
 // Enabled 回傳 Phase 0.8 / 0.8b conversion 是否啟用。
 //
-// **Phase 0.8b 變更**（ADR-015 §6）：除既有的 ConverterBaseURL / FAABaseURL 外，
+// **Phase 0.8b v0.6 T4 簡化**（ADR-016 §2 / conversion.md v0.6.1 §3.1）：visionA 端撤回
-// 加入 ConverterAPIKey / FAAAPIKey 非空檢查；4 個欄位皆非空才算啟用。
+// 對 FAA 的直接呼叫，download / promote 改走 converter.GetResult；只剩 ConverterBaseURL
-// 任一缺 → 視為未啟用，main.go 不會 wire conversion.Service（5 個 endpoint 回 501 / 不註冊）。
+// 與 ConverterAPIKey 兩個欄位需非空。任一缺 → 視為未啟用，main.go 不會 wire
+// conversion.Service（5 個 endpoint 回 501 / 不註冊）。
 func (c ConversionConfig) Enabled() bool {
-	return c.ConverterBaseURL != "" &&
+	return c.ConverterBaseURL != "" && c.ConverterAPIKey != ""
-		c.FAABaseURL != "" &&
-		c.ConverterAPIKey != "" &&
-		c.FAAAPIKey != ""
 }
 
 // CORSConfig 控制 api-server 對瀏覽器的 CORS 白名單。

visionA-backend/internal/config/load.go

@@ -68,15 +68,17 @@ func Load() *Config {
 		CORS: CORSConfig{
 			AllowedOrigins: getEnvStringSlice("VISIONA_CORS_ALLOWED_ORIGINS", nil),
 		},
-		// Phase 0.8 / 0.8b conversion (見 .autoflow/04-architecture/conversion.md §3、ADR-015)
+		// Phase 0.8 / 0.8b conversion (見 docs/autoflow/04-architecture/conversion.md §3、
+		// ADR-015、ADR-016)
 		// Phase 0.8b T5：原暫留欄位 TenantID / DelegatedTTLSeconds 與對應 env
 		// （VISIONA_OIDC_TENANT_ID / VISIONA_FAA_DELEGATED_TTL_SECONDS）已移除 —
 		// MC 認證鏈與 delegated download token 機制不存在了。
+		// Phase 0.8b v0.6 T4：原 FAA 相關欄位 FAABaseURL / FAAAPIKey 與對應 env
+		// （VISIONA_FAA_BASE_URL / VISIONA_FAA_API_KEY）已移除 — ADR-016 撤回 v0.5
+		// 設計缺口，visionA 端不再直接呼叫 FAA、download/promote 改走 converter.GetResult。
 		Conversion: ConversionConfig{
 			ConverterBaseURL: getEnvString("VISIONA_CONVERTER_BASE_URL", ""),
-			FAABaseURL:       getEnvString("VISIONA_FAA_BASE_URL", ""),
 			ConverterAPIKey:  getEnvString("VISIONA_CONVERTER_API_KEY", ""),
-			FAAAPIKey:        getEnvString("VISIONA_FAA_API_KEY", ""),
 			MaxModelSizeMB:   getEnvInt("VISIONA_CONVERTER_MAX_MODEL_SIZE_MB", 500),
 		},
 	}

visionA-backend/internal/config/load_test.go

@@ -268,15 +268,19 @@ func TestLoad_CORSAllowedOrigins(t *testing.T) {
 
 // TestLoad_ConversionDefaults 驗證 Phase 0.8 / 0.8b conversion 欄位的預設行為。
 //
-// 對齊 .autoflow/04-architecture/conversion.md §3 + ADR-015：留空時 Enabled() 為 false，
+// 對齊 docs/autoflow/04-architecture/conversion.md §3 + ADR-015 + ADR-016：留空時
-// 5 個 endpoint 不會 wire（main.go 在 wire 階段會跳過）。
+// Enabled() 為 false，5 個 endpoint 不會 wire（main.go 在 wire 階段會跳過）。
 //
 // Phase 0.8b T5：原暫留欄位 TenantID / DelegatedTTLSeconds 已從 ConversionConfig 移除
 // （MC 認證鏈與 delegated download token 機制不存在了）；本 test 不再驗這兩欄位。
+//
+// Phase 0.8b v0.6 T4：原 FAA 相關欄位 FAABaseURL / FAAAPIKey 已移除（ADR-016 撤回
+// v0.5 設計缺口，visionA 端不再直接呼叫 FAA）；本 test 不再驗這兩欄位，對應的
+// VISIONA_FAA_BASE_URL / VISIONA_FAA_API_KEY env 也不再 clear。
 func TestLoad_ConversionDefaults(t *testing.T) {
 	for _, k := range []string{
-		"VISIONA_CONVERTER_BASE_URL", "VISIONA_FAA_BASE_URL",
+		"VISIONA_CONVERTER_BASE_URL",
-		"VISIONA_CONVERTER_API_KEY", "VISIONA_FAA_API_KEY",
+		"VISIONA_CONVERTER_API_KEY",
 		"VISIONA_CONVERTER_MAX_MODEL_SIZE_MB",
 	} {
 		t.Setenv(k, "")
@@ -284,49 +288,36 @@ func TestLoad_ConversionDefaults(t *testing.T) {
 
 	cfg := Load()
 	assert.Empty(t, cfg.Conversion.ConverterBaseURL)
-	assert.Empty(t, cfg.Conversion.FAABaseURL)
 	assert.Empty(t, cfg.Conversion.ConverterAPIKey, "Phase 0.8b：API key 預設留空")
-	assert.Empty(t, cfg.Conversion.FAAAPIKey, "Phase 0.8b：API key 預設留空")
 	assert.Equal(t, 500, cfg.Conversion.MaxModelSizeMB, "預設 500 MB（與 converter 對齊）")
 	assert.False(t, cfg.Conversion.Enabled(), "全空 → 不啟用")
 }
 
-// TestLoad_ConversionEnabled 驗證 Conversion.Enabled() 的判定邏輯（Phase 0.8b 修訂）。
+// TestLoad_ConversionEnabled 驗證 Conversion.Enabled() 的判定邏輯。
 //
-// Phase 0.8b 變更：4 個欄位（Converter URL / FAA URL / Converter API key / FAA API key）
+// Phase 0.8b v0.6 T4 簡化（ADR-016）：visionA 端撤回對 FAA 的直接呼叫後，
-// 全部非空才視為啟用；任一缺即 disable。
+// 只剩 ConverterBaseURL + ConverterAPIKey 兩個欄位需非空；任一缺即 disable。
 func TestLoad_ConversionEnabled(t *testing.T) {
 	cases := []struct {
 		name         string
 		converterURL string
-		faaURL       string
 		converterKey string
-		faaKey       string
 		wantEnabled  bool
 	}{
 		{"all_set_enables",
-			"http://converter:9501", "http://faa:5081",
+			"http://converter:9501",
 			"converter-key-32-bytes-hex-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-			"faa-key-32-bytes-hex-bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
 			true},
 		{"missing_converter_url_disabled",
-			"", "http://faa:5081",
+			"",
-			"converter-key", "faa-key",
+			"converter-key",
-			false},
-		{"missing_faa_url_disabled",
-			"http://converter:9501", "",
-			"converter-key", "faa-key",
 			false},
 		{"missing_converter_key_disabled",
-			"http://converter:9501", "http://faa:5081",
+			"http://converter:9501",
-			"", "faa-key",
+			"",
-			false},
-		{"missing_faa_key_disabled",
-			"http://converter:9501", "http://faa:5081",
-			"converter-key", "",
 			false},
 		{"all_empty_disabled",
-			"", "", "", "",
+			"", "",
 			false},
 	}
 
@@ -334,9 +325,7 @@ func TestLoad_ConversionEnabled(t *testing.T) {
 		tc := tc
 		t.Run(tc.name, func(t *testing.T) {
 			t.Setenv("VISIONA_CONVERTER_BASE_URL", tc.converterURL)
-			t.Setenv("VISIONA_FAA_BASE_URL", tc.faaURL)
 			t.Setenv("VISIONA_CONVERTER_API_KEY", tc.converterKey)
-			t.Setenv("VISIONA_FAA_API_KEY", tc.faaKey)
 			cfg := Load()
 			assert.Equal(t, tc.wantEnabled, cfg.Conversion.Enabled())
 		})
@@ -347,39 +336,35 @@ func TestLoad_ConversionEnabled(t *testing.T) {
 //
 // Phase 0.8b T5：原暫留欄位 TenantID / DelegatedTTLSeconds 已移除，本 test
 // 不再驗這兩欄位（對應 env 也不再讀取）。
+//
+// Phase 0.8b v0.6 T4：原 FAA 相關欄位 FAABaseURL / FAAAPIKey 已移除（ADR-016），
+// 本 test 不再驗這兩欄位、對應 env 也不再讀取。
 func TestLoad_ConversionAllSet(t *testing.T) {
 	const fakeConverterKey = "fake-converter-api-key-for-test-do-not-use-in-prod"
-	const fakeFAAKey = "fake-faa-api-key-for-test-do-not-use-in-prod"
 
 	t.Setenv("VISIONA_CONVERTER_BASE_URL", "http://192.168.0.130:9501")
-	t.Setenv("VISIONA_FAA_BASE_URL", "http://192.168.0.130:5081")
 	t.Setenv("VISIONA_CONVERTER_API_KEY", fakeConverterKey)
-	t.Setenv("VISIONA_FAA_API_KEY", fakeFAAKey)
 	t.Setenv("VISIONA_CONVERTER_MAX_MODEL_SIZE_MB", "300")
 
 	cfg := Load()
 	assert.Equal(t, "http://192.168.0.130:9501", cfg.Conversion.ConverterBaseURL)
-	assert.Equal(t, "http://192.168.0.130:5081", cfg.Conversion.FAABaseURL)
 	assert.Equal(t, fakeConverterKey, cfg.Conversion.ConverterAPIKey)
-	assert.Equal(t, fakeFAAKey, cfg.Conversion.FAAAPIKey)
 	assert.Equal(t, 300, cfg.Conversion.MaxModelSizeMB)
 	assert.True(t, cfg.Conversion.Enabled())
 }
 
-// TestLoad_ConversionAPIKeysOnly：Phase 0.8b T5 — 4 個必要欄位齊全即 Enabled。
+// TestLoad_ConversionAPIKeysOnly：Phase 0.8b v0.6 T4 — 2 個必要欄位齊全即 Enabled。
 //
-// 此 test 在 T1-T4 期間驗證「廢棄 env 不設也能 Enabled」；T5 完成後該邏輯
+// 本 test 與 TestLoad_ConversionAllSet 共同覆蓋 Enabled() 的最小啟用條件：
-// 由本 test 與 TestLoad_ConversionAllSet 共同覆蓋（因為廢棄 env 已徹底移除）。
+// 只要 ConverterBaseURL + ConverterAPIKey 兩個欄位都非空、即視為啟用，
+// MaxModelSizeMB 不影響啟用判定。
 func TestLoad_ConversionAPIKeysOnly(t *testing.T) {
 	const fakeConverterKey = "fake-converter-api-key-only-test"
-	const fakeFAAKey = "fake-faa-api-key-only-test"
 
 	t.Setenv("VISIONA_CONVERTER_BASE_URL", "http://192.168.0.130:9501")
-	t.Setenv("VISIONA_FAA_BASE_URL", "http://192.168.0.130:5081")
 	t.Setenv("VISIONA_CONVERTER_API_KEY", fakeConverterKey)
-	t.Setenv("VISIONA_FAA_API_KEY", fakeFAAKey)
 
 	cfg := Load()
 	assert.True(t, cfg.Conversion.Enabled(),
-		"Phase 0.8b T5：4 個必要欄位齊全即 Enabled")
+		"Phase 0.8b v0.6 T4：2 個必要欄位齊全即 Enabled")
 }

visionA-backend/internal/conversion/util.go

@@ -30,6 +30,15 @@ func truncate(s string, max int) string {
 //   - 目前 visionA 的 object_key 不直接含 user 敏感資訊，但保險起見統一 hash
 //   - 16 chars hex（64-bit）對 visionA 內部 job 數量來說碰撞機率極低，足以追蹤單一 request
 //
+// **設計約束（重要）：此 hash 僅供內部 log / observability 用、不應對外暴露**。
+// 具體不應：
+//   - 出現在 HTTP response body / header（frontend 不需要、洩漏內部 storage 結構）
+//   - 拿來組 presigned URL / download URL 的 path（hash 不可逆、不能用來定位物件）
+//   - 寫進使用者可見的錯誤訊息（用 request_id 追蹤即可）
+//
+// 用途限定於 slog 欄位（如 `slog.String("object_key_hash", hashObjectKey(...))`），
+// 配合 request_id 在 log aggregator 內串接同一 NEF 物件在多個 service 之間的流向。
+//
 // Phase 0.8b v0.6（T3）：原本定義在 faa_client.go；砍 faa_client.go 時搬到 util.go
 // （flow.go DownloadStream / PromoteToModels 仍用 hashObjectKey 為 log 加 target_object_key
 // 標記，方便跨 service 追蹤同一個 NEF 物件）。