init with react+axum+spacetimedb

docs/technical/CREATION_WORK_SHELF_UNIFICATION_2026-04-25.md

@@ -0,0 +1,46 @@
+# 作品货架统一 2026-04-25
+
+## 背景
+
+创作中心目前已经把 RPG、大鱼吃小鱼、拼图三类作品展示在同一个网格里，但前端组件仍直接消费三类原始 works：
+
+1. RPG 使用 `status`、`title`、`subtitle`、`canEnterWorld`。
+2. 大鱼使用 `status`、`title`、资源完成度字段。
+3. 拼图使用 `publicationStatus`、`levelName`、`authorDisplayName`、`themeTags`。
+
+这导致筛选、计数、按钮文案、卡片标题、副标题、标签、删除忙碌态都在 UI 组件里做三套判断。后续再接新作品类型时，货架组件会继续膨胀。
+
+## 目标
+
+1. 新增前端统一作品货架视图模型 `CreationWorkShelfItem`。
+2. 由归一化函数把 RPG / Big Fish / Puzzle works 映射成统一字段。
+3. `CustomWorldCreationHub` 只负责筛选、空态和动作分发。
+4. `CustomWorldWorkCard` 只负责渲染统一字段，不再理解三类原始 schema。
+
+## 非目标
+
+1. 本轮不新增后端统一 works 聚合接口。
+2. 不改变三类现有 works API contract。
+3. 不改变平台首页公开广场的 gallery 合并逻辑。
+4. 不改变删除、体验、恢复草稿的业务规则。
+
+## 统一字段
+
+`CreationWorkShelfItem` 至少包含：
+
+1. `id`：稳定货架 id。
+2. `kind`：`rpg | big-fish | puzzle`。
+3. `status`：`draft | published`。
+4. `title / subtitle / summary / updatedAt`。
+5. `coverImageSrc / coverRenderMode / coverCharacterImageSrcs`。
+6. `badges`：状态、类型、阶段、标签等展示徽标。
+7. `metrics`：角色数、地点数、素材完成度、游玩数等底部指标。
+8. `openActionLabel`：卡片无障碍文案与主动作语义。
+9. `source`：保留原始 work，用于平台壳层执行动作。
+
+## 验收
+
+1. 创作中心三类作品仍在同一个网格展示。
+2. 草稿 / 已发布筛选计数统一从 `CreationWorkShelfItem.status` 读取。
+3. 卡片渲染不再直接判断 `publicationStatus` 或不同 works schema 的标题字段。
+4. 现有创作中心交互测试通过。