编写后台游戏评价管理方案

明确评价隐藏、恢复、删除及必填原因规则
补充后台筛选分页、权限与网站统计联动合同
定义隐藏字段、操作记录及存量迁移方案
新增管理里程碑和实施计划并同步文档索引与决策记录

docs/project-memory/plans/【实施计划】后台游戏评价管理-2026-10-01.md

@@ -0,0 +1,48 @@
+# 【实施计划】后台游戏评价管理
+
+| 字段 | 值 |
+| --- | --- |
+| Milestone | [后台游戏评价管理](./【里程碑】后台游戏评价管理-2026-10-01.md) |
+| Status | draft（待技术方案评审，未开始编码） |
+| Owner | Codex |
+
+## 修改边界
+
+- 主规范：[后台游戏评价管理合同](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#后台游戏评价管理合同)；不扩大其四类筛选与单条管理范围。
+- 领域：`server-rs/crates/module-game-distribution/src/reviews.rs` 的管理动作/原因校验与有效评价统计规则。
+- 数据：`spacetime-module/src/game_distribution.rs` 追加隐藏字段、用户索引、新私有管理记录及读写事务；同步 migration、表目录与生成绑定。
+- 后端：`spacetime-client` facade/mapper、`shared-contracts`、`api-server/src/modules/game_distribution.rs` 路由与 handler，`admin.rs` 页面权限映射；不得使用新直接数据库访问路径。
+- 前端：admin-web 的路由/导航/账号权限/DTO/client/评价管理页及游戏管理跳转；网站评价 DTO、个人提示、摘要/列表读取。复用共享列表、表单、弹窗和后台写确认。
+- 文档：主规范、后端数据契约、决策记录和索引；不改 AGC、游戏发行审核或外部 OpenAPI。
+
+## 实现顺序
+
+1. 技术评审后将方案转为 ready；冻结原因校验、四类筛选、DTO及错误码。
+2. 追加默认 false 字段与索引、新管理记录表；事务实现隐藏/恢复/删除、创建时间目标核对及操作 key 重放，公共所有统计统一过滤，个人写保留隐藏状态。
+3. 同步迁移/绑定和 facade；新增后台列表、游戏选择、详情与管理 POST，接入独立 game-reviews 权限；普通用户投影不包含原因。
+4. 接入后台页、游戏入口、分页筛选、原因确认和详情内记录；网站个人状态加精确提示。请求重试复用同 key，不用旧响应覆盖新目标。
+5. 定向测试及真实运行时验证，包括旧 schema 带评价升级、删除后主键复用和后台/网站联动；回写证据和限制，交付验收。
+
+## 验证命令与操作
+
+- `cargo test --manifest-path server-rs/Cargo.toml --locked -p module-game-distribution`
+- `cargo test --manifest-path server-rs/Cargo.toml --locked -p api-server game_distribution`，另运行 admin 权限映射相关定向测试。
+- `cargo check --manifest-path server-rs/Cargo.toml --locked -p spacetime-module`
+- `npm run spacetime:generate`、`npm run check:spacetime-schema`、`npm run check:game-distribution-dto-parity`
+- Vitest 定向运行后台新评价页、路由/权限/client与网站 `GameReviews` 测试；以仓库 include 配置核对实际执行名单。
+- `npm run admin-web:typecheck`、`npm run typecheck`，受影响文件 ESLint/Prettier。
+- `npm run check:doc-index`、`npm run check:encoding`、`git diff --check`
+- 通过项目 dev 脚本启动隔离数据库及 `npm run dev:api-server` 并检查 `/healthz`；端口按运行状态核实，不使用人工 `spacetime --root-dir`。
+- 在隔离数据库先发布旧 schema 并写入评价，再兼容升级；核对旧评价全部公开且内容/时间不变。真实 HTTP 验证跨页过滤、隐藏/统计/恢复/删除、重新评价、旧 key 重试和权限。
+- 桌面与移动视口真实浏览器验证游戏管理跳转、长评论弹窗、原因必填/取消/失败，以及网站回读。缺失证据如实标记未验证。
+
+## 风险与回滚点
+
+- 删除是不可恢复操作；复用确认交互，事务校验原创建时间和幂等操作 key，禁止旧请求作用于新评价。
+- schema 只兼容追加和新增私有表，不删字段/表或清空数据。发布冲突时停止，不通过 delete-data 绕过迁移。
+- 隐藏后的旧后端会重新暴露评价；产生隐藏记录后只能回滚到仍过滤隐藏状态的兼容实现，保留全部数据和操作记录。
+- 不引入前端内容版本锁、搜索服务或统计缓存；当前规模采用完整筛选后分页，不在有限首批数据上筛选造成漏查。
+
+## 当前状态
+
+只编写方案和计划，业务代码/schema 均未修改，所有功能测试及运行时证据待实现后提供。

docs/project-memory/plans/【里程碑】后台游戏评价管理-2026-10-01.md

@@ -0,0 +1,53 @@
+# 【里程碑】后台游戏评价管理
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 1.0 |
+| Status | proposed（产品规则已确认，技术方案待评审；未实现） |
+| Date | 2026-10-01 |
+| Parent Spec | [后台游戏评价管理合同](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#后台游戏评价管理合同) Version 1.0 |
+
+## 目标
+
+交付后台查找评价、隐藏/恢复/删除、原因与操作记录，并同步网站公共分页/统计和个人隐藏状态，保持每账号每游戏唯一评价。
+
+## 范围
+
+- 独立“游戏评价”后台页及页面权限；从游戏管理带游戏 ID 进入，完整正文和评分只读。
+- 游戏名称搜索选择/ID定位、评价用户 ID、正文关键词和公开/隐藏状态组合筛选；完整数据过滤后分页。
+- 隐藏/删除必填原因，恢复无须原因；管理操作原子保存，失败与取消不产生部分写入。
+- 隐藏排除整条评价及评分，个人固定提示“已被管理员隐藏”；用户编辑保持隐藏，恢复重新参与统计。
+- 删除不可恢复，允许用户重新评价；旧管理目标和重复请求不能误处理重新创建的记录。
+- 存量无损升级、管理员权限、私有原因隔离、真实数据库/API和桌面/移动后台及网站联动。
+
+## 不在范围内
+
+- 管理员修改正文/分数、删除恢复、再次评价封禁、批量、导出、举报、自动审核、申诉、通知/轮询/推送。
+- 评分/时间范围等额外筛选、独立操作日志页、AGC 评价、外部 API、统计缓存或清理任务。
+
+## 依赖与前置条件
+
+- 主规范与本里程碑的技术方案评审后才进入编码；本轮仅方案文档，实施计划为待评审草案。
+- 基础网站评价已实现且本地验证通过，其用户验收/生产发布状态独立；本次不推定该功能已验收。
+- 现有后台认证/账号授权、游戏/账号读取、评价唯一写入、受信服务身份及 SpacetimeDB 2.8.3 可用。
+- 有隔离数据库可验证带真实存量评价的旧 schema 升级，以及超过 20 条评价的筛选/分页。
+
+## 验收标准
+
+- [ ] 游戏管理入口按权限显示，ID 参数首次及切换生效；四条件组合查询、重置、刷新、跨页匹配、空态正确。
+- [ ] 列表与详情显示游戏/用户/评分/完整纯文本；仅评分记录可管理，管理员没有编辑内容/分数入口。
+- [ ] 原因 1–4000 码点，隐藏/删除空原因被拒，恢复不要求；取消无写入，失败保留草稿，删除明确不可恢复。
+- [ ] 隐藏后公共列表/人数/均分排除，全部隐藏为空态；个人提示精确、仍可编辑且不解除隐藏。
+- [ ] 恢复后参与公共统计，创建和用户修改时间不变；游戏恢复公开不自动解除隐藏。
+- [ ] 删除后个人读取为空并可重新评价，记录仍唯一；删除后总数减少、越界页正确回退。
+- [ ] 原因和管理员身份仅后台可见；匿名 401、无权限 403、伪造身份/隐藏状态无效，下架游戏后台可管理。
+- [ ] 管理变更与记录原子保存；同 key 重试不重复动作或日志，不同请求 409；旧页面/旧 key 不删除重新提交的新评价。
+- [ ] 旧 schema 有数据升级后内容/时间/唯一性不变，默认公开；schema/绑定/DTO 和定向检查通过。
+- [ ] 真实数据库/API及桌面/移动浏览器覆盖后台操作、前台回读、分页、长评论和失败；证据与未验证项逐条记录。
+
+## 证据要求
+
+- 自动化：领域原因校验/统计过滤，API鉴权/错误/DTO，后台筛选及操作交互、网站隐藏个人状态。
+- 运行时：存量 schema 升级，21 条以上评价的筛选分页、隐藏/恢复/删除、重新提交与重试；浏览器后台和网站联动。
+- 边界：401/403、管理原因泄漏、原子失败、状态并发、删除后主键复用、全部隐藏和页码越界。
+- 当前仅文档验证，不将既有评价功能证据复用为本里程碑通过记录。

docs/project-memory/shared-memory/decision-log.md

@@ -1,5 +1,14 @@
 # 决策记录
 
+## 2026-10-01 后台游戏评价管理规则
+
+- 用户确认新增管理员隐藏/删除评价，后台不能修改分数或正文；隐藏整条评价并从公共列表、平均分、人数和公共分页总数排除，恢复后重新参与。个人区域固定提示“已被管理员隐藏”，用户仍可编辑但不能自动恢复公开。
+- 隐藏和删除必须填写原因，恢复不要求；原因仅后台展示。删除物理移除，不能恢复，用户可重新评价，唯一规则继续成立。
+- 当前方案范围为游戏名称选择/ID定位、评价用户 ID、评论关键词、状态四类组合筛选，以及分页、详情、单条操作和持久操作记录。不增加批量、导出、举报、自动审核或评分/时间范围筛选。
+- 数据方案：评价表末尾追加默认 false 的 is_hidden；新增私有管理记录，事务保存操作人/原因/时间，以创建时间区分删除后重建记录，同 key 重试不得再次操作新评价。不增加统计缓存。
+- 状态：用户本次要求先写方案，未授权本轮编码/部署；产品规则已确认，接口/schema 技术方案待评审，既有评价测试不代表管理功能完成。
+- 权威入口：[后台游戏评价管理合同](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#后台游戏评价管理合同)；活动[里程碑](../plans/【里程碑】后台游戏评价管理-2026-10-01.md)与[实施计划](../plans/【实施计划】后台游戏评价管理-2026-10-01.md)。
+
 ## 2026-09-30 网站游戏评价范围与状态边界
 
 - 已确认需求：网站游戏详情支持每账号每游戏唯一一条 1–10 分评分和可空的评论（最多 4000 字符），可修改自己的评价；个人区默认展示已有评价并提供编辑预填，公共列表分页且不排除自己。