汉秋
e91a46c315
未绑定相册的新拍照片被错误过滤导致列表始终为空；同时调整入口卡片点击区域与详情素材网格布局。 Co-authored-by: Cursor <cursoragent@cursor.com>
39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
# TravelAlbum
|
||
|
||
## 职责
|
||
|
||
旅拍相册（新增相册 / 新建相册任务）模块，包含任务创建、相册详情、小程序码与 USB 有线传图上传。
|
||
|
||
## 入口
|
||
|
||
- 权限 URI：`travel_album` → `TravelAlbumEntryView`
|
||
- Android 对照：`ui/travelalbum`
|
||
|
||
## 核心页面
|
||
|
||
| 页面 | 说明 |
|
||
| --- | --- |
|
||
| `TravelAlbumEntryView` | 新增相册列表、新建任务入口；卡片主区域点击进入详情，底部保留「拍传」「相册码」 |
|
||
| `CreateTravelAlbumSheet` | 先拍再买 / 买了再拍创建弹窗 |
|
||
| `TravelAlbumDetailView` | 相册详情与素材管理 |
|
||
| `WiredCameraTransferView` | 有线传图页 |
|
||
|
||
## 业务流程
|
||
|
||
1. 创建任务：`POST .../travel-album/create`
|
||
2. 进入有线传图：Sony 相机 PTP 下载（`Core/CameraTethering`）
|
||
3. OSS 上传：复用 `OSSUploadService.uploadAlbumFile`
|
||
4. 素材登记：`POST .../travel-album/upload-material`
|
||
|
||
## 解耦关系
|
||
|
||
- `CameraTransferPipeline` 只依赖 `CameraAssetUploadSink` 协议
|
||
- `TravelAlbumMaterialUploader` 实现 OSS + 后端登记
|
||
- 与「相册管理」（`Features/Assets`）API、Store、路由完全隔离
|
||
|
||
## 依赖模块
|
||
|
||
- `Core/CameraTethering` — USB/PTP 相机
|
||
- `Core/CameraTransfer` — 传输编排
|
||
- `Core/Upload` — OSS STS 上传
|