feat: add visible flag for works
This commit is contained in:
kdletters
@@ -39,6 +39,8 @@
|
||||
- `sort_time_micros`
|
||||
- `detail_payload_json`
|
||||
|
||||
作品源表新增 `visible` 可见性字段，默认 `true`。`visible` 属于源表 / source view 过滤条件，不作为统一公开契约默认返回字段；当 `visible=false` 时，对应作品不得进入 `public_work_gallery_entry` 和 `public_work_detail_entry`。
|
||||
|
||||
其中 `detail_payload_json` 只承载平台详情页展示扩展，不承载正式 runtime 配置、玩法规则或草稿真相。
|
||||
|
||||
## 来源与兼容
|
||||
@@ -63,6 +65,7 @@
|
||||
- 旧 view 保留，不删除。
|
||||
- 旧 view 退到底层 source / 兼容职责。
|
||||
- 新 `public_work_*` view 是 `api-server` 公开列表 / 详情的统一主读模型。
|
||||
- 各玩法 source view 只暴露 `visible=true` 的已发布作品；旧数据迁移默认补 `visible=true`，避免历史作品被误隐藏。
|
||||
- 旧 `/api/runtime/<play>/gallery` 响应 shape 保持兼容，由 BFF mapper 把统一 cache 再映射回当前 DTO。
|
||||
- 旧详情 / runtime / 点赞 / 游玩 / Remix 仍走玩法专用路径。
|
||||
|
||||
|
||||
@@ -252,6 +252,7 @@ npm run check:server-rs-ddd
|
||||
|
||||
- Rust 结构体：`BarkBattlePublishedConfigRow`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/bark_battle/tables.rs`
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `bark_battle_runtime_run`
|
||||
|
||||
@@ -288,6 +289,7 @@ npm run check:server-rs-ddd
|
||||
- Rust 结构体：`BigFishCreationSession`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/big_fish/tables.rs`
|
||||
- 索引：`by_big_fish_session_owner_user_id`、`by_big_fish_session_stage`。公开广场 view 使用 `by_big_fish_session_stage` 读取已发布会话，避免扫整表。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `big_fish_event`
|
||||
|
||||
@@ -351,11 +353,13 @@ npm run check:server-rs-ddd
|
||||
- Rust 结构体：`CustomWorldGalleryEntry`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/custom_world.rs`
|
||||
- 作用：自定义世界公开 source 读模型。统一公开列表 / 详情主路径通过 `public_work_gallery_entry` / `public_work_detail_entry` 消费该投影并映射成跨玩法契约；`/api/runtime/custom-world-gallery` 保留旧 HTTP shape，并从统一 public cache 映射回旧 DTO。旧 procedure 只用于兼容旧库缺少 gallery 读模型行时的一次性同步兜底。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `custom_world_profile`
|
||||
|
||||
- Rust 结构体：`CustomWorldProfile`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/custom_world.rs`
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `custom_world_session`
|
||||
|
||||
@@ -410,6 +414,7 @@ npm run check:server-rs-ddd
|
||||
- 返回类型：`Vec<JumpHopGalleryViewRow>`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/jump_hop.rs`
|
||||
- 说明：跳一跳公开详情兼容投影，包含作品、路径和素材字段；统一公开详情主路径通过 `public_work_detail_entry` 消费该 view，只保留平台详情页展示摘要。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `wooden_fish_agent_session`
|
||||
|
||||
@@ -445,6 +450,7 @@ npm run check:server-rs-ddd
|
||||
- 返回类型：`Vec<WoodenFishGalleryViewRow>`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/wooden_fish.rs`
|
||||
- 说明：敲木鱼公开详情兼容投影，包含敲击物图案、背景环境图、主题返回按钮图、敲击音效和飘字配置；统一公开详情主路径通过 `public_work_detail_entry` 消费该 view，只保留平台详情页展示摘要。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `match3d_agent_message`
|
||||
|
||||
@@ -472,6 +478,7 @@ npm run check:server-rs-ddd
|
||||
- 返回类型：`Vec<Match3DGalleryViewRow>`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/match3d.rs`
|
||||
- 说明：抓大鹅公开 source 投影，只暴露 `publication_status = published` 的作品卡片字段；统一公开列表 / 详情主路径通过 `public_work_gallery_entry` / `public_work_detail_entry` 消费该 view 并映射成跨玩法契约。个人作品列表、详情、发布、点赞、游玩记录和 Remix 仍按原有 procedure / reducer 路径处理。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `npc_state`
|
||||
|
||||
@@ -658,6 +665,7 @@ RPG 创作入口的配置 ID 是 `rpg`，当前 `visible=true`、`open=true`；
|
||||
结构化创作和 RPG 的 LLM JSON 链路默认不启用 Responses `web_search`；只有在明确需要联网增强时，才通过 `GENARRATIVE_RPG_LLM_WEB_SEARCH_ENABLED` 或 `GENARRATIVE_CREATION_AGENT_LLM_WEB_SEARCH_ENABLED` 显式打开。否则未开通工具的上游会先吐自然语言再返回 `ToolNotOpen`，这类失败要按上游工具不可用处理，不要误判成模型返回结果解析失败。
|
||||
|
||||
统一公开作品 BFF 路由是 `GET /api/public-works` 与 `GET /api/public-works/{publicWorkCode}`，响应契约由 `shared-contracts::public_work` 和 `packages/shared/src/contracts/publicWork.ts` 共同维护。前端首期仍走 BFF HTTP，不直接订阅 SpacetimeDB；后续若允许浏览器直连订阅，也只能订阅 `public_work_gallery_entry` / `public_work_detail_entry` 这类稳定公开 read model，不能订阅 `puzzle_work_profile`、`custom_world_profile` 等源表后自行拼装列表。设计细节见 `docs/technical/【后端架构】统一公开作品ReadModel设计-2026-05-26.md`。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `quest_log`
|
||||
|
||||
@@ -710,6 +718,7 @@ RPG 创作入口的配置 ID 是 `rpg`，当前 `visible=true`、`open=true`；
|
||||
- 返回类型：`Vec<SquareHoleGalleryViewRow>`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/square_hole.rs`
|
||||
- 说明：方洞挑战公开 source 投影，只暴露 `publication_status = published` 的作品卡片字段；统一公开列表 / 详情主路径通过 `public_work_gallery_entry` / `public_work_detail_entry` 消费该 view 并映射成跨玩法契约。个人作品列表、详情、发布、点赞、游玩记录和 Remix 仍按原有 procedure / reducer 路径处理。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
### `story_event`
|
||||
|
||||
@@ -785,3 +794,4 @@ RPG 创作入口的配置 ID 是 `rpg`，当前 `visible=true`、`open=true`；
|
||||
- 返回类型：`Vec<VisualNovelGalleryViewRow>`
|
||||
- 源码：`server-rs/crates/spacetime-module/src/visual_novel.rs`
|
||||
- 说明：视觉小说公开 source 投影，只暴露 `publication_status = published` 的作品卡片字段，不把完整 `draft` 暴露给公开列表订阅；统一公开列表 / 详情主路径通过 `public_work_gallery_entry` / `public_work_detail_entry` 消费该 view 并映射成跨玩法契约。个人历史、详情、运行态和发布仍按原有 procedure / reducer 路径处理。
|
||||
- 字段变更：`visible` 控制是否进入公开列表 / 详情，默认 `true`；旧迁移数据由 `migration.rs` 补默认值。
|
||||
|
||||
Reference in New Issue
Block a user