确认创作者主页产品规则并统一他人列表只读

将他人的关注和粉丝列表统一为只读并跳过关系检测确认移动端三入口、本人公开游戏范围与移除粉丝二次确认同步主规范、工程设计、里程碑状态和验收标准
2026-10-05 10:20:07 +01:00
parent f542bd11ce
commit f4e5aaf441
6 changed files with 41 additions and 39 deletions
@@ -2,8 +2,8 @@

 | 字段 | 值 |
 | --- | --- |
-| Version | 0.2 |
-| Status | proposed（文档已形成，业务未实现、未部署） |
+| Version | 1.0 |
+| Status | ready（产品规则已确认，业务未实现、未部署） |
 | Date | 2026-10-05 |
 | Parent Spec | [创作者主页与关注粉丝合同](../【玩法创作】平台入口与玩法链路-2026-05-15.md#创作者主页与关注粉丝合同) |

@@ -69,7 +69,7 @@ type CreatorProfile = {
 type CreatorConnection = {
  user: CreatorUser;
  followedAt: string; // 当前列表所表示方向的建立时间，RFC 3339
-  relationship: CreatorRelationship | null; // 游客或查看他人的关注列表时为 null
+  relationship: CreatorRelationship | null; // 仅本人读取自己的列表时返回，其他情况为 null
 };
 type CreatorConnections = {
  items: CreatorConnection[];
@@ -86,9 +86,9 @@ type CreatorRelationshipResponse = {

 关系写操作成功返回 200，目标存在时重复关注/删除仍成功；对自己操作返回 400，未认证为 401，非受信或越权调用为 403，不存在的用户为 404。有效目标但不存在关系的删除与“目标不存在”明确区分。前端不自动重试结果未知的写请求，先回读关系。

-主页摘要一次事务内完成用户和双向计数读取；关系列表一次事务内读取 `items/total`，仅需要关系操作的视图附带当前访问者相对各行的关系。`tab=following` 且已认证访问者 ID 不等于列表主人时，仅查询主人出边及对应公开用户资料，不探测访问者到列表用户的任何出边或入边，逐行 `relationship` 固定为 null。该条件由后端认证身份与路径主人 ID 决定，不接受客户端开关绕过。不同 HTTP 请求不承诺共享同一事务快照，跨页变化通过写后失效与回读收敛，不能要求两次独立请求永远返回相同计数。
+主页摘要一次事务内完成用户和双向计数读取；关系列表一次事务内读取 `items/total`，仅已认证访问者 ID 等于列表主人时附带逐行关系。游客或访问他人列表时，following 只查询主人出边、followers 只查询主人入边及对应公开用户资料，不额外探测访问者与列表用户的关系，逐行 `relationship` 固定为 null。该条件由后端认证身份与路径主人 ID 决定，不接受客户端开关绕过。不同 HTTP 请求不承诺共享同一事务快照，跨页变化通过写后失效与回读收敛，不能要求两次独立请求永远返回相同计数。

-公开主页不携带访问者状态；`relationship` 端点必须认证。列表无 Authorization 时按游客读取，有 Authorization 时校验并判断列表视图是否需要关系操作；他人的关注列表始终跳过访问者关系计算，其余需操作的视图批量返回关系。无效凭据返回 401，前端经现有认证处理后可回到游客读取。关系端点和带认证列表响应使用 `Cache-Control: private, no-store`，不得进入跨用户缓存。
+公开主页不携带访问者状态；`relationship` 端点必须认证。列表无 Authorization 时按游客读取，有 Authorization 时校验并判断是否本人列表；他人的关注、粉丝列表始终跳过访问者关系计算，只有自己的列表批量返回所需关系。无效凭据返回 401，前端经现有认证处理后可回到游客读取。关系端点和带认证列表响应使用 `Cache-Control: private, no-store`，不得进入跨用户缓存。

 ## 关系列表分页与作者游戏读取

@@ -103,7 +103,7 @@ type CreatorRelationshipResponse = {
 - 主页 `/creators` 解析当前账号，`/creators?id=...` 读取指定公开用户；关系列表用 `/creators/connections?id=...&tab=following|followers`，缺主人或非法 tab 展示明确无效链接状态。显式他人 ID 不因登录切换改成自己的主页。
 - 关系状态按访问者 ID、目标 ID 隔离。业务 hook/client 负责请求、写入单飞、失败回读和失效；共享关注按钮、用户行只接收数据、pending 和回调，不直接持有认证或网络副作用。
 - 自己/他人的关注列表、粉丝列表四种组合均支持头像/昵称进入任意用户主页；用独立链接和按钮避免嵌套交互。列表用户为自己时隐藏关注按钮，主页仍可访问。
- 他人的关注列表使用只读用户行，不挂载关系动作或触发关系 hook，不调用 relationship 补查接口、不比对访问者自己的关注集合，也不使用预存关系缓存推导按钮。列表切换或账号切换后重新按主人/访问者身份确定模式；进入目标用户主页后，再按主页本身的规则读取关系和提供关注操作。
+- 他人的关注、粉丝列表统一使用只读用户行，不挂载关系动作或触发关系 hook，不调用 relationship 补查接口、不比对访问者自己的关注集合，也不使用预存关系缓存推导按钮。列表切换或账号切换后重新按主人/访问者身份确定模式；进入目标用户主页后，再按主页本身的规则读取关系和提供关注操作。
 - 取消关注后的行保留集合只属于当前列表生命周期，与服务端成员和 total 分离；成功重新关注后清除暂留标记。刷新、离开列表或账号变化清除暂留集合；正常失效回读时不可把可重新关注的行立即抹掉。
 - 移除粉丝成功从粉丝列表去行，回关/取消回关不去行。确认弹窗复用公共组件；两个方向的按钮在同一目标写入期间一起禁用，写后刷新摘要和相关列表。
 - 进入页面、返回和重新聚焦时回读；旧请求通过请求序号/取消机制隔离。认证变化清除私有关系缓存和旧页请求，不让上个账号响应覆盖新账号。
@@ -135,4 +135,4 @@ git diff --check

 `creator` 测试组为实施时新增的定向分组，届时核对实际匹配数量，零匹配不算通过；补充共享 DTO/UI 和 facade 的对应测试。host 单测不替代 SpacetimeDB 事务验证，运行时通过 `npm run dev:api-server` 启动并验证实际开发地址 `/healthz`，使用隔离开发库的 A/B/C 三账号完成权限、重复写入、双向关系与未知结果回读。

-浏览器覆盖桌面与 375px 移动，四类列表跳转、返回位置、自己的空游戏主页、互关后移除粉丝和登录切换。他人关注列表夹具同时包含访问者已关注、未关注及访问者本人，断言一律无关注操作，后端响应 relationship 为 null 且不调用访问者关系投影，前端无补查/写请求；预置关系缓存也不得改变只读表现，点击用户进入主页仍可正常操作。游戏边界夹具应包含超过 48 项及其他作者作品，证明作者过滤在截取前，广场原有上限保持不变；关系列表用超过 50 项和同时间关系验证分页。所有执行结果回填里程碑证据，本次不宣称实现或运行时验收完成。
+浏览器覆盖桌面与 375px 移动，四类列表跳转、返回位置、自己的空游戏主页、互关后移除粉丝和登录切换。他人的关注、粉丝两类列表夹具均包含访问者已关注、未关注及访问者本人，断言一律无关系操作，后端响应 relationship 为 null 且不调用访问者关系投影，前端无补查/写请求；预置关系缓存也不得改变只读表现，点击用户进入主页仍可正常操作。游戏边界夹具应包含超过 48 项及其他作者作品，证明作者过滤在截取前，广场原有上限保持不变；关系列表用超过 50 项和同时间关系验证分页。所有执行结果回填里程碑证据，本次不宣称实现或运行时验收完成。