visionA

jim800121/visionA

Fork 0

Commit Graph

Author	SHA1	Message	Date
jim800121chen	3e45532f55	fix(model-download): 改 redirect/query-string token 下載，根除 CORS preflight 405 模型庫下載原本前端用 fetch + Authorization: Bearer 跨 origin 直連 FAA，觸發 CORS preflight(OPTIONS)；FAA 未設 CORS、OPTIONS 回 405 → 下載失敗。 FAA 設計本就支援「token 放 query string(access_token) + redirect 導航下載」，故不需 FAA 設 CORS。改採 ADR-017 §11 v1.3 乙案： - backend: download_url 組成含 ?access_token={url.QueryEscape(token)} 完整 FAA URL； ModelDownloadResponse.Token 標 deprecated 保留（向下相容）；token 不進 log - frontend: 移除 downloadModelFile/deriveDownloadFilename(fetch+blob)，改 triggerNavDownload 用 <a download href> 導航；ModelDownloadGrant 移除 token 欄 - 整條鏈無 CORS：前端→backend 同 origin、前端→FAA 導航無 preflight docs: ADR-017 增補 §11(v1.3) + TDD.md §9.5 tests: backend 8 PASS(含 token escape 邊界)、frontend 35 PASS；Reviewer 通過(0C/0M) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-27 06:18:05 +08:00
jim800121chen	88a8ddbd82	docs(architecture): ADR-017 模型庫存取架構（FAA delegated token）— v1.2 stage e2e 實證決策：模型庫下載走 (a) MC delegated download token + Client 直連 FAA（照 pptx） - visionA 向 MC POST /file-access/download-tokens 簽 fdt_ token - Client 帶 Authorization: Bearer 直接打 FAA GET /files/{key}（不經 visionA、不經 AWS） - FAA 用 MemberCenterDelegatedDownloadTokenValidator 打 MC validate v1.0→v1.1→v1.2 演進（保留歷史）： - v1.0 推 (c) visionA 自簽（誤判 MC endpoint fictional，只看了 master） - v1.1 改推 (a)（發現 MC develop 已實作 Issue/Validate、FAA validator 配套） - v1.2 stage 真環境 + 真 secret + 真 user e2e 實測打通（§10 證據）： MC Issue HTTP 200 簽出 fdt token → FAA 僅因假 object_key 回 404 file_not_found（認證鏈全綠）剩餘 visionA 端 blocking（backend 接手）： - B1 object_key 斷層：model.Model 加 FAAObjectKey，第一階段只支援轉檔→promote 類 model - B2 加打 MC Issue 簽 fdt 的 client code + .env 技術債（正式上線前處理）：短期共用 FAA service client 4242ba63 做 PoC，正式上線須 MC 配發 visionA 專屬 usage=file_api client（MC 規範禁止 client 混用 usage） Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-07 03:42:46 +08:00

Author

SHA1

Message

Date

jim800121chen

3e45532f55

fix(model-download): 改 redirect/query-string token 下載，根除 CORS preflight 405

模型庫下載原本前端用 fetch + Authorization: Bearer 跨 origin 直連 FAA，
觸發 CORS preflight(OPTIONS)；FAA 未設 CORS、OPTIONS 回 405 → 下載失敗。

FAA 設計本就支援「token 放 query string(access_token) + redirect 導航下載」，
故不需 FAA 設 CORS。改採 ADR-017 §11 v1.3 乙案：

- backend: download_url 組成含 ?access_token={url.QueryEscape(token)} 完整 FAA URL；
  ModelDownloadResponse.Token 標 deprecated 保留（向下相容）；token 不進 log
- frontend: 移除 downloadModelFile/deriveDownloadFilename(fetch+blob)，
  改 triggerNavDownload 用 <a download href> 導航；ModelDownloadGrant 移除 token 欄
- 整條鏈無 CORS：前端→backend 同 origin、前端→FAA 導航無 preflight

docs: ADR-017 增補 §11(v1.3) + TDD.md §9.5
tests: backend 8 PASS(含 token escape 邊界)、frontend 35 PASS；Reviewer 通過(0C/0M)

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

2026-06-27 06:18:05 +08:00

jim800121chen

88a8ddbd82

docs(architecture): ADR-017 模型庫存取架構（FAA delegated token）— v1.2 stage e2e 實證

決策：模型庫下載走 (a) MC delegated download token + Client 直連 FAA（照 pptx）
- visionA 向 MC POST /file-access/download-tokens 簽 fdt_ token
- Client 帶 Authorization: Bearer 直接打 FAA GET /files/{key}（不經 visionA、不經 AWS）
- FAA 用 MemberCenterDelegatedDownloadTokenValidator 打 MC validate

v1.0→v1.1→v1.2 演進（保留歷史）：
- v1.0 推 (c) visionA 自簽（誤判 MC endpoint fictional，只看了 master）
- v1.1 改推 (a)（發現 MC develop 已實作 Issue/Validate、FAA validator 配套）
- v1.2 stage 真環境 + 真 secret + 真 user e2e 實測打通（§10 證據）：
  MC Issue HTTP 200 簽出 fdt token → FAA 僅因假 object_key 回 404 file_not_found（認證鏈全綠）

剩餘 visionA 端 blocking（backend 接手）：
- B1 object_key 斷層：model.Model 加 FAAObjectKey，第一階段只支援轉檔→promote 類 model
- B2 加打 MC Issue 簽 fdt 的 client code + .env

技術債（正式上線前處理）：短期共用 FAA service client 4242ba63 做 PoC，
正式上線須 MC 配發 visionA 專屬 usage=file_api client（MC 規範禁止 client 混用 usage）

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

2026-06-07 03:42:46 +08:00

2 Commits