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 凭据(和证据镜像同一套)。