xiaoxia/xiaoxia-saas

refactor(#778): 统一Storage接口，定义StoragePort+SharedStorageService作为唯一入口 #794

Merged

xiaoxia merged 2 commits from refactor/unified-storage-interface into develop

2026-07-24 19:00:13 +08:00

Author	SHA1	Message	Date
CI Bot	848705a67d	style: black格式化storage.py CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 20s Details CI/CD Pipeline / Validate - Type Check (mypy) (pull_request) Successful in 1m2s Details CI/CD Pipeline / Frontend Lint (pull_request) Successful in 37s Details CI/CD Pipeline / Validate - Migration (alembic) (pull_request) Successful in 1m10s Details CI/CD Pipeline / PR Build Web Image (pull_request) Successful in 39s Details CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped Details CI/CD Pipeline / Validate - Code Quality (pull_request) Successful in 3m45s Details Preview Deploy / Deploy Preview Environment (pull_request) Failing after 25s Details PR Automation / Auto Approve on CI Green (pull_request) Successful in 3m25s Details AI Code Review / AI Code Review (pull_request) Successful in 3m40s Details CI/CD Pipeline / PR Build API Image (pull_request) Successful in 5m25s Details CI/CD Pipeline / PR Build Worker Image (pull_request) Successful in 11m21s Details CI/CD Pipeline / Frontend Unit Tests (pull_request) Has been skipped Details CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped Details CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped Details CI/CD Pipeline / Integration Tests (pull_request) Successful in 4m21s Details CI/CD Pipeline / Unit Tests (pull_request) Failing after 8m7s Details PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 34m3s Details CI/CD Pipeline / Deploy Production (pull_request) Has been skipped Details CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped Details CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped Details CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped Details CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped Details Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 11s Details	2026-07-24 10:47:36 +08:00
CI Bot	b5bc22834c	refactor(#778 ): 统一Storage接口，定义StoragePort+SharedStorageService作为唯一入口 CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 23s Details CI/CD Pipeline / Validate - Type Check (mypy) (pull_request) Successful in 1m29s Details CI/CD Pipeline / Frontend Lint (pull_request) Successful in 58s Details CI/CD Pipeline / Validate - Migration (alembic) (pull_request) Successful in 1m18s Details CI/CD Pipeline / Validate - Code Quality (pull_request) Failing after 2m20s Details CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped Details CI/CD Pipeline / PR Build Web Image (pull_request) Successful in 1m22s Details PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 55s Details Preview Deploy / Deploy Preview Environment (pull_request) Failing after 27s Details AI Code Review / AI Code Review (pull_request) Successful in 3m52s Details PR Automation / Auto Approve on CI Green (pull_request) Successful in 3m32s Details CI/CD Pipeline / PR Build API Image (pull_request) Successful in 5m59s Details CI/CD Pipeline / Frontend Unit Tests (pull_request) Has been skipped Details CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped Details CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped Details CI/CD Pipeline / Unit Tests (pull_request) Has been cancelled Details CI/CD Pipeline / Integration Tests (pull_request) Has been cancelled Details CI/CD Pipeline / PR Build Worker Image (pull_request) Has been cancelled Details CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been cancelled Details CI/CD Pipeline / Staging E2E Tests (pull_request) Has been cancelled Details CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been cancelled Details CI/CD Pipeline / Deploy Production (pull_request) Has been cancelled Details CI/CD Pipeline / Production Browser E2E (pull_request) Has been cancelled Details CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been cancelled Details - 新增 packages/ports/storage_port.py → StoragePort 抽象接口（12个核心方法） - SharedStorageService 实现 StoragePort，整合两套实现的全部能力 - 新增 upload_file_smart()：大文件分片上传+超时保护（从oss_helpers合并） - 新增 download_asset()：自动识别URL/存储键，支持HTTP+SDK双路径 - 新增 resolve_asset_path() / resolve_asset_ids_to_paths()：素材路径解析+缓存 - 新增 normalize_storage_key() 公开方法 - connect_timeout=10s 防挂死 - oss_helpers 保留为独立实现（向后兼容，后续逐步迁移） - 全量单测 4383 passed, 8 skipped	2026-07-24 10:36:13 +08:00