docs: add oss platform package placeholder
This commit is contained in:
@@ -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`
|
||||
|
||||
@@ -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. 已冻结边界
|
||||
|
||||
|
||||
29
server-rs/packages/platform-oss/README.md
Normal file
29
server-rs/packages/platform-oss/README.md
Normal file
@@ -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 策略重新散落到多个业务模块里各自实现。
|
||||
Reference in New Issue
Block a user