thread-master/docs/product/haixun-backend/tasks/T158-media-real-upload.md

T158 — media-real-upload

Status: todo
Milestone: M3
Kind: feat
Est. change: ~180 lines (target 100–200)

Goal

完成後系統應：真上傳 attach：multipart→持久 URL；非法失敗

Depends on

• T111

Inputs

• 讀取 / 依賴：
  • 決策 #19；IN-08 IN-09；UI 附圖（live 改走 repo.media.attachLocal）
  • Spec：docs/product/haixun-backend/spec.md（§9：IN-08 IN-09）
  • 對照：docs/product/haixun-backend/fe-spec-alignment.md（UI MUST）
  • 後端根：apps/backend
  • Remove（本 task 禁止實作）： 舊靈感 list/viral/bookmark/spark/searchTrends；generateFromFormula；ScoutTopic CRUD；live 以 simulate／createMock 當完成；Insights 真管線（P2）。

Outputs

程式變更（預期路徑）

路徑	動作	說明
apps/backend/internal/**/media/**	add	upload handler + storage 介面（local disk 可）
apps/web/src/components/studio/ImageAttach.tsx	edit	live 時走 repos.media.attachLocal 真上傳
apps/web/src/data/**	edit	live attachLocal

行為變更

• 跨請求／跨裝置可取 url；非 data URL 冒充

API / 契約（若有）

• multipart /api/v1/media/upload

測試交付（強制）

• TestIN_08_RealUploadReturnsURL
• TestIN_09_UnimplementedNotEmptySuccess

Out of scope

• generateImage（T191）

Acceptance

• Spec／UI MUST 覆蓋：IN-08 IN-09
• 每個相關 §9 ID 有可 grep 的 case 名（TestXX_01_… 或完整覆蓋在里程碑 test task）
• 未實作不回 102000+空 data
• 指令：

cd apps/backend && go test ./internal/.../media/... -count=1

Notes

儲存可先 local ./data/uploads。