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 4125f6e8..1fc5c2d4 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -69,7 +69,8 @@ 交付物:[../server-rs/packages/module-runtime-item/README.md](../server-rs/packages/module-runtime-item/README.md) - [x] 创建 `packages/module-custom-world` 交付物:[../server-rs/packages/module-custom-world/README.md](../server-rs/packages/module-custom-world/README.md) -- [ ] 创建 `packages/module-assets` +- [x] 创建 `packages/module-assets` + 交付物:[../server-rs/packages/module-assets/README.md](../server-rs/packages/module-assets/README.md) - [ ] 创建 `packages/module-editor` - [ ] 创建 `packages/module-ai` - [ ] 创建 `packages/shared-contracts` diff --git a/server-rs/README.md b/server-rs/README.md index 8e62ea39..4ab07858 100644 --- a/server-rs/README.md +++ b/server-rs/README.md @@ -14,7 +14,7 @@ ## 2. 当前阶段说明 -当前目录已经完成以下十五项初始化: +当前目录已经完成以下十六项初始化: 1. 为新后端预留正式目录并把路径固定到仓库结构中。 2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。 @@ -31,20 +31,20 @@ 13. 创建 `packages/module-quest/` 目录占位,固定任务运行时模块 package 落位。 14. 创建 `packages/module-runtime-item/` 目录占位,固定运行时物品模块 package 落位。 15. 创建 `packages/module-custom-world/` 目录占位,固定自定义世界与 agent 模块 package 落位。 +16. 创建 `packages/module-assets/` 目录占位,固定资产任务与对象绑定模块 package 落位。 后续任务会继续在本目录内按顺序补齐: -1. `packages/module-assets` -2. `packages/module-editor` -3. `packages/module-ai` -4. `packages/shared-contracts` -5. `packages/shared-kernel` -6. `packages/platform-auth` -7. `packages/platform-oss` -8. `packages/platform-llm` -9. `packages/spacetime-client` -10. `packages/tests-support` -11. `scripts/*` +1. `packages/module-editor` +2. `packages/module-ai` +3. `packages/shared-contracts` +4. `packages/shared-kernel` +5. `packages/platform-auth` +6. `packages/platform-oss` +7. `packages/platform-llm` +8. `packages/spacetime-client` +9. `packages/tests-support` +10. `scripts/*` ## 3. 已冻结边界 diff --git a/server-rs/packages/module-assets/README.md b/server-rs/packages/module-assets/README.md new file mode 100644 index 00000000..6b72841c --- /dev/null +++ b/server-rs/packages/module-assets/README.md @@ -0,0 +1,30 @@ +# module-assets 独立模块 package 占位说明 + +日期:`2026-04-20` + +## 1. package 职责 + +`module-assets` 是资产任务与对象绑定模块 package,后续负责: + +1. `asset_job`、`asset_object`、`asset_manifest` 等资产状态模型 +2. 角色形象、动作、Qwen 精灵表、场景图、封面图等资产任务编排 +3. 业务实体与 OSS 对象的绑定关系 +4. 与 `apps/api-server` 的 assets 兼容接口对接 +5. 与 `apps/spacetime-module` 的资产表、reducer、view 聚合对接 + +## 2. 当前阶段说明 + +当前提交仅完成目录占位,不提前进入生成链路、对象确认与兼容接口实现。 + +后续与本 package 直接相关的任务包括: + +1. 设计 `asset_job`、`asset_object`、`asset_manifest` +2. 设计角色、动作、场景、精灵表相关资产表 +3. 对齐资产生成、发布、对象确认与兼容接口链路 +4. 接入 OSS 对象写入与绑定编排 + +## 3. 边界约束 + +1. `module-assets` 负责资产任务状态、对象引用关系与模块级编排,不把二进制对象本身放回本地持久化目录真相中。 +2. OSS 上传、签名、对象读写等副作用通过平台适配完成,状态最终回写到 `apps/spacetime-module` 聚合的状态模型中。 +3. 前端兼容接口由 `apps/api-server` 暴露,但资产任务状态与对象绑定关系不能再次散落到本地文件判断逻辑里。