GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 39 Pull Requests 9 Actions Packages Projects 1 Releases Wiki Activity
Files
1bdffcdef0f90331b02b260623f6d763efd057c4
Genarrative/server-rs/crates/shared-contracts
T
History
suzmii 6e5cf195f8
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Has been cancelled
Details
Project CI / AI game creator shell Rust crates (pull_request) Has been cancelled
Details
Project CI / Backend tests (pull_request) Has been cancelled
Details
Project CI / Native shell tests (pull_request) Has been cancelled
Details
Project CI / Frontend tests (pull_request) Has been cancelled
Details
Project CI / Repository checks (pull_request) Has been cancelled
Details
Project CI / AI game creator shell web tests (pull_request) Has been cancelled
Details
feat(游戏共创): 公开目录补真游标分页（修「48 硬上限 + 无游标」导致最老作品永久不可见） 
真实库实证：51 条 published 时**最老的 3 条**（含最关键的 A0/A1/A11 母版与主干）在公开目录里不可见
（AGC 共创页显示「已检查最新 48 个作品（1 页）」；数据本身没丢）。根因：handler 写死
`limit: MAX_LIST_LIMIT(48)`（并忽略客户端 `limit`），事务过滤排序后 `truncate(limit)`，**既无 has_more
也无游标**。

- **页大小**：默认 **48**（保持既有 AGC 共创页首屏语义——48 只该是默认值而非硬上限）、上限 **100**
  （单响应体量）；`0` 取默认、超界**截断**（不报错）；api-server 与事务共用同一归一函数。
- **游标**：`"{created_at_micros}:{game_id}"`（复用仓库既有 `"{micros}:{id}"` 惯例，与主题列表同构）；
  排序键 `created_at` **倒序** + `game_id` **升序**兜底（与改前比较器逐字同序 ⇒ 首页顺序不变；全序 ⇒
  翻页不重不漏）；**先过滤再切页**；「多取一条」判 has_more；`nextCursor` 为真值、**末页为 `null`**。
- **非法游标**：模块产出 `CATALOG_INVALID_CURSOR: 目录游标格式无效` → api-server 新增 `CATALOG_` 前缀分支
  （**排在 owner 不匹配 / 不存在 / 状态 等子串分支之前**）→ **400 + 稳定码 `CATALOG_INVALID_CURSOR`**，
  并纳入「码由模块真实文案可达」的枚举测试（防上次那种不可达码）；未登记的 `CATALOG_` 码兜底
  `CATALOG_ERROR`(400)。
- **响应形状不变**：仍是 `{ games, nextCursor }`（`nextCursor` 从恒 `null` 变成真值）；抽命名构建器
  `public_games_payload` 并登记 parity（构建器 18→**19**，`mustEmit: ['games','nextCursor']`）。
- **生成绑定**：`game_distribution_public_game_list_input_type.rs`(+`cursor`)、
  `game_distribution_game_list_procedure_result_type.rs`(+`next_cursor`)；client facade 改返回
  `(games, next_cursor)`，mapper 同步。
- **文档**（同批）：主规范 HTTP 表 `GET /games` 行改为真游标分页；创作者主页工程设计两处「最多 48 / 不分页」
  改写（并注明前端尚未消费游标）；`docs/README.md` 索引行同步。
- **测试 +15**：纯函数 9（**51 条能翻到最老那条**、恰好整页不产生空游标、同 `created_at` 用 `game_id` 兜底、
  **先过滤再切页**、游标指向页内最后一条、limit 0/超界、非法游标 7 种）；事务结构断言 1；api-server 5
  （形状、`limit` 默认与截断、非法游标 400 + 稳定码、码可达性枚举、**51 条走真实 handler 链路翻页且
  未公开/已软删/无公开版本三种不可见行不出现**）。

门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p module-game-distribution` **143 passed**；
`-p spacetime-module` **307 passed / 1 ignored**；`-p spacetime-client` 44 passed；`-p api-server game_distribution`
**112 passed**；DTO parity 0（66 组 / **19** 构建器 / 15 手拼类型）；`check:spacetime-schema` 0（98 表）；
`check:encoding` 0（5548 files）；`cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check` 0；
`git diff --check` 0。
2026-10-07 11:23:59 +08:00
..
src
feat(游戏共创): 公开目录补真游标分页（修「48 硬上限 + 无游标」导致最老作品永久不可见）
2026-10-07 11:23:59 +08:00
tests
后台支持多账号与页面访问权限
2026-07-14 19:21:33 +08:00
Cargo.toml
GameCreationApp 资源 kind 词汇表收敛为 Rust 单源并接上可注册留痕回调
2026-09-17 15:43:51 +08:00
README.md
Merge origin/master into codex/wechat
2026-05-12 16:20:45 +08:00

README.md

shared-contracts 共享 crate 说明

日期：2026-04-21

1. crate 职责

shared-contracts 是前后端兼容 contract 共享 crate，后续负责：

  1. HTTP 请求与响应 DTO
  2. SSE 事件结构与事件名约定
  3. response envelope、错误结构、兼容头部契约
  4. 各模块对外暴露的共享协议类型

2. 当前阶段说明

当前阶段已完成 Stage1 最小真实落地：

  1. 统一 response envelope / 头部常量
  2. auth/login-options
  3. auth/me
  4. auth/sessions
  5. runtime/settings

当前阶段继续补齐的 Stage2 鉴权 DTO：

  1. auth/entry
  2. auth/refresh
  3. auth/logout
  4. auth/logout-all
  5. auth/phone/send-code
  6. auth/phone/login
  7. auth/wechat/start
  8. auth/wechat/callback
  9. auth/wechat/bind-phone
  10. auth/wechat/miniprogram-login

当前阶段继续补齐的 Stage3 公开请求 DTO：

  1. assets/direct-upload-tickets
  2. assets/read-url
  3. assets/objects/confirm
  4. assets/objects/bind
  5. story-sessions/begin
  6. story-sessions/continue

当前阶段继续补齐的 Stage4 显式成功响应 DTO：

  1. assets/direct-upload-tickets
  2. assets/read-url
  3. assets/objects/confirm
  4. assets/objects/bind
  5. story-sessions/begin
  6. story-sessions/continue

当前阶段新增 Stage6 character visual 兼容 DTO：

  1. assets/character-visual/generate
  2. assets/character-visual/jobs/:taskId
  3. assets/character-visual/publish

当前阶段新增 Stage7 character animation 模板与导入兼容 DTO：

  1. assets/character-animation/templates
  2. assets/character-animation/import-video

当前阶段新增 Stage8 character workflow cache 第一批兼容 DTO：

  1. assets/character-workflow-cache
  2. assets/character-workflow-cache/:characterId

当前阶段新增 Stage9 character animation 主链兼容 DTO：

  1. assets/character-animation/generate
  2. assets/character-animation/jobs/:taskId
  3. assets/character-animation/publish

当前阶段新增 Stage5 story session scoped runtime story 写读 DTO：

  1. BeginStoryRuntimeSessionRequest
  2. ResolveStoryRuntimeActionRequest
  3. StoryRuntimeProjectionResponse
  4. StoryRuntimeMutationResponse
  5. StoryRuntimeSnapshotPayload 仅用于 story session scoped 写侧持久化边界，不复用旧 /api/runtime/story/* 总入口 contract。

WP-DEL 已删除旧 runtime story HTTP DTO：RuntimeStoryStateResolveRequest、RuntimeStoryBootstrapRequest/Response、RuntimeStoryActionResponse 和旧 RuntimeStorySnapshotPayload。runtime_story 模块中仍保留的 RuntimeStoryViewModel、RuntimeStoryPresentation、RuntimeStoryPatch 与 battle presentation 是当前投影/表现构件，不作为旧 HTTP 写入口。

当前仍刻意未做：

  1. SSE 事件结构
  2. 自动代码生成或跨语言 contract 同步
  3. 其他尚未收口模块的 handler 响应体显式 DTO 化

3. 边界约束

  1. shared-contracts 只放协议类型与兼容结构，不承接业务规则、供应商适配或状态写入逻辑。
  2. 各模块 crate 对外暴露的协议优先复用这里的共享定义，避免重复散落。
  3. 前端兼容契约一旦进入本 crate，就必须与任务清单和基线文档同步维护。
  4. assets 模块依赖 platform-oss 的稳定返回类型，默认通过 oss-contracts feature 给 api-server 使用；SpacetimeDB WASM 构建链路必须通过 workspace 依赖关闭默认 feature，避免把 platform-oss / reqwest / wasm-bindgen 带进 spacetime-module。
Reference in New Issue View Git Blame Copy Permalink