xsl
367b610e93
feat(storage): COS presigned PUT URL endpoint for direct upload
POST /uploads/presign:场景/类型/大小三重校验 + 可审计 object_key 布局 +
SDK 隔离在 CosSigner Protocol 后(FR-SYS-03,T-P1-27)。
实现:packages/storage/schemas.py(PresignRequest/PresignResponse)、
packages/storage/service.py(CosSigner Protocol / QcloudCosSigner /
StorageService.build_presign,bucket 四别名映射到 cos_bucket_*,
object_key 写死 {scene}/{user_id}/{yyyyMMdd}/{uuid4hex}.{ext})、
apps/api/routers/uploads.py(POST /presign,CurrentUserId 认证 + ok 信封)。
测试:tests/unit/test_upload_presign.py 16 例全部经 FakeSigner 注入,
零网络、零 SDK client 构造;覆盖 key 布局逐段断言、三重校验统一 40010、
bucket 别名映射、白名单字符串解析(空串/空格容错)、配置错误分支、
schema 层 size>=1。门禁全绿:ruff check/format、mypy(宽松 48 文件 +
domain strict 7 文件)、lint-imports 4 契约、pytest 185 passed
(基线 169 + 新增 16)。
偏差说明:
1) SDK 实际无 qcloud_cos.method 模块,Method 按官方文档传字符串 "PUT";
get_presigned_url 参数名为 Expired(非任务文档写的 Expire);配置类
导出名为 CosConfig(非 CosS3Config)。按文档 §3 "以实际 SDK 签名为准"
处理,已用假密钥端到端冒烟验证(纯本地签名计算,零网络)。
2) build_presign 增加可选 keyword-only 参数 now(默认 None=当前 UTC),
供单测注入固定时钟(对齐 DailyBudgetGuard 的 clock 注入惯例),
不改变文档签名的调用兼容性。
3) 两处防御分支文档未规定,均配了单测:场景 bucket 别名非法报
CONFIG_ERROR 而非 40010(配置错误不应让客户端背 4xx);COS 密钥为空
在 SDK 构造前报 CONFIG_ERROR,避免未处理的裸 500。
2026-08-14 16:17:49 +08:00
..
2026-08-14 00:54:40 +08:00
2026-08-14 00:54:40 +08:00
2026-08-14 00:26:39 +08:00
2026-08-14 00:26:39 +08:00
2026-08-14 01:02:13 +08:00
2026-08-14 00:54:40 +08:00
2026-08-14 00:54:40 +08:00
2026-08-14 01:02:13 +08:00
2026-08-14 00:26:39 +08:00
2026-08-14 00:26:39 +08:00
2026-08-14 11:28:35 +08:00
2026-08-14 00:26:39 +08:00
2026-08-14 00:26:39 +08:00
2026-08-14 00:26:39 +08:00
2026-08-14 00:54:40 +08:00
2026-08-14 16:17:49 +08:00