Files
streamline/docs/ideas.md
T
2026-11-16 17:26:44 -08:00

7.0 KiB

Ideas 墙

大家愿意公开的「想法 demo」:Pinterest / Mobbin 式多列卡片,直接看 demo 效果,点开可以点赞、分享、接力。 类型和校验规则在 shared/src/ideas.ts,存储在 ideas / idea_likes / feature_relays(drizzle/0071_ideas.sql)和 idea_comments / idea_stamps(drizzle/0072_idea_comments_stamps.sql)。

来源与发布

来源 谁能发布 怎么发布
Feature / Bug 任何登录的人(包括别人的单) 详情页右下「新增修改」左边的「发布到 Ideas」,证据里的截图 / 录屏默认全选(录屏在前,≤ 9 个)
Eddy 任何登录的人(上传人即作者) Ideas 页右上「上传 Eddy 想法」:先拖入 Eddy 导出的分享包(必传;Mac 版 Eddy「分享」导出的 .eddy,或命令行导出的 .eddy.zip),浏览器读出标题 / 说明 / 平台 / 包内截图,确认后上传
  • 入口只在 Feature 上出现:Bug / Security / 原型 / 验证的抽屉右下角没有「发布到 Ideas」,判定集中在 control-web/src/lib/ideas.ts::canPublishToIdeas(control-web/test/ideasPublishGate.test.ts 锁住)。 Bug 是缺陷单,不是「想法」;历史已经发布过的 Bug 想法仍留在墙上,能看能移除。 POST /api/ideas 仍接受 source: "bug"(兼容存量数据 / 脚本),但 UI 不再产出新的。
  • 作者:原单主人(第一个邮箱关注人;存量 Bug 没有时取 QA),不是发布人;同一张单再发布 = 更新,作者不变。
  • 移除:作者、发布人或管理员可以从 Ideas 移除(只删这一条,原单 / Eddy 任务不受影响)。
  • Eddy 包的解析在 shared/src/eddy_share.ts(浏览器和控制面共用,无 zip 依赖)。
    • 文件名:.eddy、.eddy.zip、.zip 都收,内容是同一种 zip(eddy-task-share)。Mac 版 Eddy 导出 .eddy 是为了双击能直接用 Eddy 打开。 判断文件名统一用 eddyShareExt / isEddyShareName / eddyShareBaseName,不要在组件里另写正则。
    • 说明依次取:share.json 的 description / summary → changes.text(Eddy 导出时写的改动说明)里「改了什么」一节,去掉 Markdown 记号 → instructions(发送者填的体验说明)→ 补丁脚本首行注释。最长 2000 字,确认页可以再改。
    • 截图 / 录屏:新版 Eddy 导出时可以带上做原型时截的图和录的屏(发送者在分享卡上逐个勾选),放在包里 assets/media/<sha>/<名字>, share.json 的 media([{path, kind: screenshot|recording, name, bytes}])列着它们:有这个清单就只按它取,截图在前, 第一张截图当封面,录屏排后面,最多 9 个;清单为空就是发送者一个都没勾。没有 media 的旧包照旧扫 assets/ 以外的图片视频 (Eddy 旧包里一般没有,确认页要手动加)。包里其余 assets/ 下的图片是任务替换进 App 的资源,不当演示截图。

接力

Feature 想法 Bug 想法(仅存量) Eddy 想法
Streamline 接力(主) 复制一张到接力人名下:baseRef = 源单已推送的分支,remark 带源单需求 / 方案 / 实现报告 / 复核反馈 + 接力人这次想改的 打开原单 新建一张 Feature,按原型效果在代码仓正式实现,remark 带 Eddy 包里的补丁脚本当挂点参考
Eddy 接力(次) iOS Feature:准备 Eddy 接力包 — 下载作者上传的 Eddy 包(文件名是想法标题,扩展名和上传时一样)

Streamline 接力出来的新单走正常流程:评估 → 待确认计划(不自动执行)→ 确认后执行出新 MR。 Feature 接力的新 MR 默认合进源单分支(叠在对方结果上)。逻辑在 control-server/src/feature_relay.ts。

来源链路:每次接力在 feature_relays 记一跳(新单 ← 谁的第几版 / 哪个 Eddy 原型)。新单详情的关注人处显示完整链路, 源头在前,例如「Eddy 原型 · A → B 第 2 版 → 你接力(当前)」,节点可点回对应的单 / 想法;多人多次接力一节一节串下去(最多追 20 跳)。

评论与审阅章

  • 评论:卡片和详情里点赞左边的评论按钮;详情里有评论区,最新的在最上面,回车发送,评论人自己或管理员可删。
  • 审阅章(control-web/src/components/IdeaStamps.tsx):详情弹窗右侧一列 PASS / CONDITIONAL PASS / NO PASS。点章拿起(跟随鼠标、带投影), 在弹窗上左键按下 → 压下、抖动、印上,章飞回章架;右键 / Esc 松手放回。每人每条只留一个章,再盖替换旧的; 所有人可见,平时 40% 不透明度,悬停 100% 并显示谁、什么时候盖的。NO PASS / CONDITIONAL PASS 必须写原因: 按下时先弹原因框,原因以「【NO PASS】…」发成评论后才盖下去,服务端也校验盖章人在这条下留过评论。

接口

浏览器(SSO):

  • GET /api/ideas → { ideas: Idea[] },新的在前;每条带 likes / liked / likedBy(最近 8 个点赞人)。
  • POST /api/ideas { source: "feature"|"bug", sourceId, title, summary?, media: [{type, url}], platform? } → { idea }。 面板只会发 feature;bug 保留给存量数据 / 脚本,新 UI 不再产生。 media.url 只收站内 /api/... 地址或 TOS 下载地址。
  • DELETE /api/ideas/:id —— 从 Ideas 移除。
  • PUT / DELETE /api/ideas/:id/like —— 点赞 / 取消 → { likes, liked, likedBy }。
  • GET /api/ideas/:id/likes → { likes: [{ email, at }] },全部点赞人和时间。
  • GET / POST /api/ideas/:id/comments { text }、DELETE /api/ideas/:id/comments/:cid —— 评论。列表里每条想法带 comments(条数)。
  • GET /api/ideas/:id/stamps、PUT /api/ideas/:id/stamps { kind: "pass"|"cond"|"nopass", x, y, rot }、DELETE /api/ideas/:id/stamps —— 审阅章。
  • POST /api/ideas/:id/relay { note? } → { feature } —— Streamline 接力。
  • GET /api/ideas/relay-of/:featureId → { chain } —— 这张单的接力链路(源头在前,不是接力来的为空)。
  • POST /api/ideas/upload(multipart):字段 title(必填)、summary、platform;文件 media(≥ 1,单个 ≤ 60 MB)、 bundle(Eddy 分享包,.eddy / .eddy.zip,必传,≤ 300 MB)。服务端转存 TOS 的 ideas/<ideaId>/,不看扩展名。
  • GET /api/ideas/:id/bundle —— 下载这条 Eddy 想法的包(「Eddy 接力」用)。从 TOS 转一手,文件名给成「想法标题 + 上传时的扩展名」 (TOS 上的对象名只留 ASCII,中文标题直链下载会变成 eddy-_.eddy);取不到时 302 回 TOS 直链。

分享链接:/ideas?id=<ideaId> 落到 Ideas 页并展开那条详情。

本地体验

?mock=1 下 Ideas 墙用线上真实已完成单的证据(只读 TOS 镜像)+ 几条 Eddy 演示;发布 / 移除 / 点赞 / 接力只改浏览器本地,不碰线上写接口。 上传弹窗在 mock 下有「用示例包直接看确认页」。

部署

新表:先跑 0071_ideas.sql(已上线)和 0072_idea_comments_stamps.sql 再上代码(只建表、不动已有表;反过来只有 Ideas 页报错,不影响看板)。上传依赖 TOS 凭据(和证据镜像同一套)。