merge: T5 COS 直传预签名（POST /uploads/presign，FR-SYS-03）

apps/api/routers/uploads.py

@@ -1,10 +1,27 @@
-"""``POST /uploads/presign`` — COS 直传预签名（骨架，T5 填充实现）。
+"""``POST /uploads/presign`` — COS 直传预签名（FR-SYS-03 / T-P1-27）。
 
-FR-SYS-03：图片不经应用服务器；实现契约见 docs/开发任务包/T5-上传预签名.md。
+图片不经应用服务器：本接口只做场景/类型/大小校验并签发 PUT 预签名 URL，
+字节流由客户端直传 COS。真实联调需在 `.env` 配 COS 四件套
+（COS_REGION / COS_SECRET_ID / COS_SECRET_KEY + 场景桶配置
+UPLOAD_SCENES_JSON）；本地单测注入 FakeSigner，不依赖任何真实 COS。
 """
 
 from __future__ import annotations
 
 from fastapi import APIRouter
 
+from apps.api.deps import CurrentUserId, StorageServiceDep
+from packages.shared.response import ok
+from packages.storage.schemas import PresignRequest
+
 router = APIRouter(prefix="/uploads", tags=["uploads"])
+
+
+@router.post("/presign", summary="签发图片直传 COS 的 PUT 预签名 URL")
+async def presign_upload(
+    user_id: CurrentUserId,
+    storage: StorageServiceDep,
+    request: PresignRequest,
+) -> dict[str, object]:
+    presigned = storage.build_presign(user_id=user_id, request=request)
+    return ok(presigned.model_dump())