补充创作者主页与关注粉丝工程文档

明确主页入口、公开关系列表及用户主页跳转行为补充关注关系表、接口契约、权限和前端状态设计拆分后端查询与页面交互里程碑及验收标准记录游戏列表沿用现有上限、不增加分页改造的边界同步文档索引与团队决策记录
2026-10-05 09:55:56 +01:00
parent 7b1d57c5da
commit 74063263fc
6 changed files with 331 additions and 1 deletions
@@ -0,0 +1,38 @@
+# 创作者主页与关系交互
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 0.1 |
+| Status | proposed |
+| Date | 2026-10-05 |
+| Parent Spec | [创作者主页与关注粉丝合同](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#创作者主页与关注粉丝合同) |
+
+## 目标与范围
+
+在既有主站接入第四项创作者主页、游戏详情作者链接和关注按钮、公开主页与游戏列表、关注和粉丝列表及本人管理操作。
+
+复用公共游戏卡、账号资料、登录能力、确认弹窗与页面导航；通用关注表现和用户行抽到共享组件，后端副作用与正式关系由业务层持有。不包含主页装修、资料编辑新系统和关注消息通知。
+
+## 前置条件
+
+- [创作者关系与公开查询](./【里程碑】创作者关系与公开查询-2026-10-05.md)已验收。
+- 主规范和本里程碑完成评审；开始编码前单独落地本阶段实施计划。
+
+## 验收标准
+
+- [ ] 桌面第四项进入自己主页，第五项为“我的”；移动入口按评审口径接入。
+- [ ] 游戏详情可进入自己或他人主页，关注按钮与作者链接互不误触。
+- [ ] 主页显示真实计数和公开游戏，点击进入现有详情；本人无自关注按钮。
+- [ ] 公开关注/粉丝列表支持分页；只有本人有移除粉丝动作。
+- [ ] 自己/他人的关注/粉丝四类列表，游客和登录用户均可点击列表用户头像或昵称进入其创作者主页，覆盖本人及无公开游戏用户；返回恢复来源列表和分页/滚动位置，关系操作按钮不误触跳转。
+- [ ] 取消关注后可在当前行重新关注；刷新后的正式列表正确。
+- [ ] 粉丝列表回关/取消回关和移除粉丝分别改变正确方向。
+- [ ] 登录、退出、账号切换、请求迟到和网络失败不污染关系状态。
+- [ ] 主页/详情/列表往返状态一致，深链刷新和返回位置正确。
+- [ ] 375px 移动和桌面布局、长昵称、空态/错误态、键盘和触摸操作可用。
+
+## 证据与停止点
+
+前端定向 Vitest、`npm run typecheck`、`npm run check:encoding`、`npm run check:doc-index` 和 `git diff --check`；真实浏览器配合三个测试账号完成关系闭环，验证公开与私有游戏隔离。
+
+提交最终逐条证据，等待验收；通过后将持久结论更新到主规范和相关共享记忆，删除已完成临时计划。本里程碑不授权自动生产部署。当前无实现或浏览器证据。
@@ -0,0 +1,36 @@
+# 创作者关系与公开查询
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 0.1 |
+| Status | proposed |
+| Date | 2026-10-05 |
+| Parent Spec | [创作者主页与关注粉丝合同](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#创作者主页与关注粉丝合同) |
+
+## 目标与范围
+
+为公开创作者主页提供真实用户资料、关注/粉丝计数、分页关系列表、访问者关系和作者公开游戏筛选，并支持认证用户关注、取消关注和移除自己粉丝。
+
+不包含页面接入、消息通知、推荐、拉黑、既有游戏列表分页改造和生产部署。不新增独立创作者身份，公开游戏沿用现有可见性口径及最多 48 项限制。
+
+## 前置条件
+
+- 主规范与本里程碑完成评审，明确账号不可公开状态的现有判断依据。
+- 开始实现前另建仅覆盖本里程碑的实施计划，明确 schema、DTO、事务、API、测试及回滚边界。
+
+## 验收标准
+
+- [ ] 用户对唯一、不能自关注、重复写入与删除幂等。
+- [ ] 关注和粉丝方向正确，移除粉丝不取消本人对对方的关注。
+- [ ] 第三方不能代替他人写出边或删除入边。
+- [ ] 游客可读公开资料和列表，认证关系不混入共享公共缓存。
+- [ ] 分页、计数、失效账号过滤一致，响应不泄露私有账号字段。
+- [ ] 作者游戏筛选发生在最多 48 项截取前，过滤未公开、下架和删除作品；不增加游戏分页，未传作者的广场请求保持原有行为。
+- [ ] schema、迁移、表目录、生成绑定与共享 DTO 同步。
+- [ ] 正常、重复、并发和权限负向用例通过真实 API/SpacetimeDB 验证。
+
+## 证据与停止点
+
+领域/契约定向测试、schema 与 DDD 边界检查、编码/文档检查；通过 `npm run dev:api-server` 启动并验证 `/healthz` 后，以三个测试账号验证本人/对方/第三方关系。新增测试数据仅写隔离开发环境。
+
+提供主规范逐条证据矩阵及未验证项；通过验收后才进入页面里程碑。当前只有规划草案，无实现或运行时证据。
@@ -1,5 +1,12 @@
 # 决策记录

+## 2026-10-05 创作者主页与关注粉丝的产品边界
+
+- 已确认但未实现：桌面第四项“创作者主页”默认进入当前账号主页，“我的”移到第五项；他人的关注/粉丝列表公开可查看，自己或他人的两类列表均可点击用户进入其创作者主页。
+- 关注为单向关系，取消回关与移除粉丝分别影响不同方向；只有本人可移除自己的粉丝，自己不能关注自己。
+- 用户明确本次不额外改造游戏目录分页：既有游戏广场和“我的游戏”保持现状，作者主页按作者过滤后沿用最多 48 项限制。新关注/粉丝列表的分页仍按主规范设计。
+- 行为真相见[创作者主页与关注粉丝合同](../../【玩法创作】平台入口与玩法链路-2026-05-15.md#创作者主页与关注粉丝合同)，工程落点见[工程设计](../../technical/【技术方案】创作者主页与关注粉丝工程设计-2026-10-05.md)。当前仅完成文档，不代表功能上线。
+
 ## 2026-10-03 AGC 发布版本标签改为由工程内部版本派生，取代「用户可编辑标签」口径

 - 背景：用户实机验收指出发布面板「项目版本」显示 v6，而 AGC 工程内部只有 4 条正式版本记录（资源总览「项目版本」栏目 4 张卡，顶栏「智能体修订」下拉同样只有这 4 条）。核实：面板值来自本地清单 `manifest.projectVersion` 这个可编辑标量，它被三条链路反复钉到**平台** `game_distribution_version.version_number` 上——发布成功回写（`apps/ai-game-creator-shell/src-tauri/src/game_distribution_publish.rs:1531-1535`）、打开面板回读绑定回填（`:536-541`）、用户手改（`:944-965`）；而 `manifest.versions` 从头到尾不参与该值。`publicationRevision` 只做 CAS，与任何版本号都无推导关系（`module-game-distribution/src/domain.rs:27-40` 的版本号解析只比 `max_existing` 与 `requested`）。