文档：完善网站游戏评分与评价方案

新增网站游戏评分与评价主规范及独立里程碑明确唯一评价、编辑取消、公共分页与平均分人数合同补齐提交期间冻结输入和迟到读取响应隔离的验收要求同步文档索引、发行范围说明与共享决策记录
2026-09-30 14:43:58 +08:00
parent 66ff5bf4b7
commit 15c123bc59
5 changed files with 194 additions and 5 deletions
@@ -36,7 +36,7 @@
 - 正式状态来自后端，素材仍复用平台上传与归属能力；前端和 AGC 不另建公开游戏状态、owner 事实或审核结果。
 - 真实发行包具有不可变版本和 SHA-256，AGC dist 归一化为发行根 `index.html`；网页 ZIP 与 AGC 共用一条服务管道。
 - 不恢复退役玩法 API、公开作品表或专属 runtime；不把私有项目源码镜像公开。
- 首版不包含原生/Wasm 游戏、任意外网依赖、服务端进程、多人联机、云存档、评论/评分/关注、排行榜、推荐算法和收益结算。
+- 本发行里程碑不包含原生/Wasm 游戏、任意外网依赖、服务端进程、多人联机、云存档、评论/评分/关注、排行榜、推荐算法和收益结算。网站评分与评价作为[独立里程碑](./【里程碑】网站游戏评分与评价-2026-09-30.md)推进，不借用本文件的发行验收结论。
 - 本文件只协调本业务；不顺带改造图片编辑器、Agent Runtime 执行模型或无关项目数据。

 ## 阶段 A：真实包、身份与可恢复发行
@@ -0,0 +1,62 @@
+# 【里程碑】网站游戏评分与评价
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 1.0 |
+| Status | proposed（待评审，未实现、未验收） |
+| Date | 2026-09-30 |
+| Parent Spec | [平台入口与玩法链路](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#网站游戏评分与评价合同)中的“网站游戏评分与评价合同”Version 1.0 |
+
+## 目标
+
+在网站公开游戏详情页交付“一用户一游戏一条评分与可选评论 → 查看个人评价 → 编辑与取消/提交 → 公共分页浏览 → 平均分与评分人数更新”的完整行为闭环。
+
+## 范围
+
+- 复用现有平台登录态，游客可浏览公开评价与统计，登录后可保存和修改自己的唯一评价。
+- 评分为 1–10 整数且必选，评论可空、最多 4000 Unicode 码点；实时显示字数与上限。
+- 已评价默认显示个人记录和编辑按钮，编辑时预填；取消不保存修改，成功提交收起输入模块。
+- 公共列表默认每页 20 条，按首次提交时间倒序；包含当前用户和空评论评价，不因编辑改变位置。
+- 详情显示平均分与评分人数，无人评分为“暂无评分”；人数不因修改增加，均分覆盖全部评价。
+- 评价随游戏身份保留，新版本发布不清空；下架与封禁关闭评价读写，重新公开恢复读取。
+- 覆盖并发唯一性、账号切换、失败与重试、移动端和键盘可操作性。
+
+## 不在范围内
+
+- AGC 客户端评价、独立评价页面、游戏广场评分卡片、评论回复/点赞/附件/Markdown。
+- 评价删除、评价审核、评分排行/推荐、必须游玩或消费才能评价的门槛。
+- 通用评论框架、统计缓存、评分任务或外部 API；不补做游戏发行原里程碑的生产上线验收。
+
+## 依赖与前置条件
+
+- 主规范与本里程碑评审通过，整数评分、分页与取消行为等默认规则已确认；均分/人数已由用户确认纳入范围。
+- 当前游戏详情、公开可见性、平台认证、账号公开资料读取与受信服务身份链路在验收环境可用。
+- 能建立独立测试账号及公开游戏，运行真实 SpacetimeDB/API 和网站浏览器验收；不得把本地通过当成生产上线。
+- 新增评价 schema、共享 DTO 与既有绑定变更在实现前写入本里程碑的单独实施计划，不对现有表进行破坏性修改。
+
+## 验收标准
+
+- [ ] 游客可读公开游戏评价与摘要；未登录不能保存或读取个人评价。
+- [ ] 1/10 分和空评论成功，未选/越界/非整数分数与超长评论均被拒。
+- [ ] 中文、英文、emoji、空格及换行计数一致，4000/4001 边界、粘贴和中文输入法符合主规范。
+- [ ] 已评价先显示自己的记录，编辑预填；取消恢复旧记录，提交中禁用评分选择、评论输入及取消/提交，成功隐藏表单，失败恢复编辑并保留草稿。
+- [ ] 首次取消不落库；同一账号/游戏的重复与并发保存只有一条；不能指定他人身份写入。
+- [ ] 至少 21 条真实记录验证分页、顺序和总数，自己的评价允许在个人区与公共区各出现一次。
+- [ ] 空评论也展示分数并计人数；编辑不增加人数、不改变创建时间或排序位置。
+- [ ] 无评价显示“暂无评分”；改分正确更新全部评价均分，改评论不改变均分，分页不影响统计。
+- [ ] 切换账号或游戏不残留个人草稿、不接受旧响应覆盖；读取失败不伪装为未评价。
+- [ ] 保存成功后此前的个人评价与公共列表读取失效，不覆盖新记录、摘要或列表；快速翻页/重复刷新只接受各区域最新请求的结果，旧请求不改写错误及加载状态。
+- [ ] 游戏下架/封禁后读写不可见，恢复公开后仍能读取已有评价，新版本不清空评价。
+- [ ] 评价读取或保存故障不阻断既有游戏资料与游玩；桌面/移动/键盘操作均可用。
+- [ ] 定向测试、网站类型、DTO、schema/生成绑定、真实 API/SpacetimeDB/browser smoke 及编码/文档索引/diff 检查有可复核结果。
+
+## 证据要求
+
+- 自动化：评分/字数/唯一性与修改规则、统计、分页、页面交互及账号切换定向测试。
+- 运行时：真实 SpacetimeDB/API 上的两账号写入、并发首次保存与分页统计；真实浏览器编辑/取消/提交、移动端字数提示与键盘评分。
+- 边界：未登录、伪造身份、不可见游戏、4000/4001 字符、0/11/非整数分数、响应丢失与迟到响应。
+- 证据按主规范条款逐项记录环境、操作、结果与未验证原因，原游戏发行证据不自动代替本次验收。
+
+## 未验证
+
+当前仅有方案文档，所有实现与运行时验收尚未开始。评审后再创建单里程碑实现计划；功能完成前保持本文件活动状态，完成后将稳定结论回写主规范并清理临时计划。
@@ -1,5 +1,12 @@
 # 决策记录

+## 2026-09-30 网站游戏评价范围与状态边界
+
+- 已确认需求：网站游戏详情支持每账号每游戏唯一一条 1–10 分评分和可空的评论（最多 4000 字符），可修改自己的评价；个人区默认展示已有评价并提供编辑预填，公共列表分页且不排除自己。
+- 已确认扩展：详情显示真实平均分与评分人数，空评论计人数，修改不增加人数；当前先由后端评价记录计算，不增加统计缓存。
+- 状态：本次仅保存 proposed 方案，尚未实现或验收；整数评分、默认每页 20 条、创建时间排序、取消行为与游戏维度保留按主规范评审默认值推进。原发行 Version 0.2 的排除项不再被解释为永久禁止新增用户评价。
+- 权威入口：[平台入口与玩法链路](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#网站游戏评分与评价合同)；执行验收使用[独立里程碑](../plans/【里程碑】网站游戏评分与评价-2026-09-30.md)，不得把既有发行或本次文档检查当作评价功能上线证据。
+
 ## 2026-09-30 release 渠道移除产品名与包名后缀

 - 决策：`release` 渠道的正式产品名统一为 `陶泥儿`，Windows NSIS、macOS DMG / updater 归档等由 Tauri `productName` 派生的包名不再包含 `Release` 文本；`identifier=world.genarrative.ai-game-creator.release` 与 `release-win` 更新分区保持不变。