Genarrative/server-rs/crates/module-assets/README.md

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. 当前阶段说明

当前资产对象主链已完成后端收口：资产对象确认、实体槽位绑定、历史读取、OSS 对象确认、API facade、SpacetimeDB adapter 和资产事件表已经形成同一条后端真相链。与本模块直接相关的基础设施包括：

1. api-server 已具备 POST /api/assets/direct-upload-tickets
2. platform-oss 已具备旧 /generated-* 前缀兼容的 PostObject 签名能力
3. 资产对象引用口径已冻结为 bucket + object_key 双列
4. module-assets 已落地：
   • AssetObjectAccessPolicy
   • asset_object 字段校验 helper
   • assetobj_ ID 前缀与初始版本常量
   • asset_entity_binding 输入、快照、返回记录与字段校验 helper
   • assetbind_ ID 前缀
5. WP-AS Assets 资产对象类型归位已完成，领域快照、命令 DTO、应用返回 DTO、领域事件和字段错误已分别落到 DDD 骨架文件中。
6. asset_event public event table 已承接对象确认与实体绑定变更事实，订阅端和审计流程可以感知资产主链变化。

当前 asset_object 表的字段、索引与可编码约束见：

1. ../../../docs/technical/SPACETIMEDB_ASSET_OBJECT_TABLE_DESIGN_2026-04-21.md
2. ../../../docs/technical/ASSET_OBJECT_CONFIRM_FLOW_DESIGN_2026-04-21.md
3. ../../../docs/technical/ASSET_ENTITY_BINDING_REDUCER_DESIGN_2026-04-21.md
4. ../../../docs/technical/SERVER_RS_DDD_WP_AS_ASSET_OBJECT_TYPE_REHOME_2026-04-29.md
5. ../../../docs/technical/SERVER_RS_DDD_WP_AS_ASSET_CHAIN_CLOSURE_2026-05-01.md

当前还已补齐：

1. AssetObjectService
2. 私有 bucket HEAD Object 后的对象确认写入
3. 当前阶段的进程内 asset_object 去重存储
4. SpacetimeDB asset_object / asset_entity_binding / asset_event adapter 写入
5. Rust spacetime-client 资产对象确认、绑定和历史 facade

后续与本 package 直接相关的任务包括：

1. 设计 asset_job 和 asset_manifest
2. 设计角色、动作、场景、精灵表相关资产表
3. 对齐资产生成、发布和专业资产任务编排
4. 新增资产生成表或专业资产任务时继续复用 OSS read-url 读取链路

3. 边界约束

1. module-assets 负责资产任务状态、对象引用关系与模块级编排，不把二进制对象本身放回本地持久化目录真相中。
2. OSS 上传、签名、对象读写等副作用通过平台适配完成，状态最终回写到 apps/spacetime-module 聚合的状态模型中。
3. 前端兼容接口由 apps/api-server 暴露，但资产任务状态与对象绑定关系不能再次散落到本地文件判断逻辑里。
4. 后续 SpacetimeDB 中的对象引用统一按 bucket + object_key 两列建模，不存完整 URL 作为真相字段。