diff --git a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md index 18def294..75ab90c2 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -81,7 +81,8 @@ 交付物:[../server-rs/packages/shared-kernel/README.md](../server-rs/packages/shared-kernel/README.md) - [x] 创建 `packages/platform-auth` 交付物:[../server-rs/packages/platform-auth/README.md](../server-rs/packages/platform-auth/README.md) -- [ ] 创建 `packages/platform-oss` +- [x] 创建 `packages/platform-oss` + 交付物:[../server-rs/packages/platform-oss/README.md](../server-rs/packages/platform-oss/README.md) - [ ] 创建 `packages/platform-llm` - [ ] 创建 `packages/spacetime-client` - [ ] 创建 `packages/tests-support` diff --git a/server-rs/README.md b/server-rs/README.md index 91c9a855..3b47d02f 100644 --- a/server-rs/README.md +++ b/server-rs/README.md @@ -14,7 +14,7 @@ ## 2. 当前阶段说明 -当前目录已经完成以下二十一项初始化: +当前目录已经完成以下二十二项初始化: 1. 为新后端预留正式目录并把路径固定到仓库结构中。 2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。 @@ -37,14 +37,14 @@ 19. 创建 `packages/shared-contracts/` 目录占位,固定前后端兼容 contract 共享 package 落位。 20. 创建 `packages/shared-kernel/` 目录占位,固定跨模块共享领域内核 package 落位。 21. 创建 `packages/platform-auth/` 目录占位,固定鉴权平台适配 package 落位。 +22. 创建 `packages/platform-oss/` 目录占位,固定 OSS 平台适配 package 落位。 后续任务会继续在本目录内按顺序补齐: -1. `packages/platform-oss` -2. `packages/platform-llm` -3. `packages/spacetime-client` -4. `packages/tests-support` -5. `scripts/*` +1. `packages/platform-llm` +2. `packages/spacetime-client` +3. `packages/tests-support` +4. `scripts/*` ## 3. 已冻结边界 diff --git a/server-rs/packages/platform-oss/README.md b/server-rs/packages/platform-oss/README.md new file mode 100644 index 00000000..e12a2d15 --- /dev/null +++ b/server-rs/packages/platform-oss/README.md @@ -0,0 +1,29 @@ +# 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`、`module-editor` 复用的对象存储基础设施能力 + +## 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 策略重新散落到多个业务模块里各自实现。