Initial import of streamline
This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
# 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 凭据(和证据镜像同一套)。
|
||||
Reference in New Issue
Block a user