30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# platform-oss 平台适配 package 占位说明
|
||
|
||
日期：`2026-04-20`
|
||
|
||
## 1. package 职责
|
||
|
||
`platform-oss` 是 OSS 平台适配 package，后续负责：
|
||
|
||
1. OSS 直传签名、STS、上传策略适配
|
||
2. 对象上传、下载、签名 URL 与 `cdn_url` 解析适配
|
||
3. 对象元数据、标签与内容 hash 适配
|
||
4. 供 `module-assets`、`module-custom-world` 等模块复用的对象存储基础设施能力
|
||
|
||
## 2. 当前阶段说明
|
||
|
||
当前提交仅完成目录占位，不提前进入 OSS SDK、上传策略与对象读写实现。
|
||
|
||
后续与本 package 直接相关的任务包括：
|
||
|
||
1. 落地 `PostObject`、STS、服务端上传适配
|
||
2. 落地对象确认、签名 URL 与 CDN URL 解析适配
|
||
3. 落地 `x-oss-meta-*` 元数据与对象标签适配
|
||
4. 对齐旧 `/generated-*` 路径兼容策略
|
||
|
||
## 3. 边界约束
|
||
|
||
1. `platform-oss` 只承接对象存储平台适配，不承接业务实体状态与业务规则。
|
||
2. 资产状态与对象绑定最终由业务模块和 `apps/spacetime-module` 管理，前端接口由 `apps/api-server` 暴露。
|
||
3. 不允许把 OSS SDK、签名逻辑和 URL 策略重新散落到多个业务模块里各自实现。
|