Design doc: Studio screens and Central Manager routes for automatic upgrades
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 42/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- typescript
调研方向
Start by reviewing the upgrade decision issues and the existing Studio routes and components named in the issue, including /edit/version, /scaling, /notifications, and /admin with AdminShell. Then map each listed screen to its Central Manager routes and account for the current notification, permission, and version flows. Done means a design document is merged with every route matching its linked issue and reviewed by the engineer building the screens.
由索引模型根据 Issue 内容生成。
描述
Start: Waits for sign-off of the upgrade decisions.
Delivery: in one PR with #2092 and #2093.
What and why
Central Manager is adding automatic monthly upgrades for Fabric clusters (HarperFast/central-manager#1177). That brings several new customer screens and staff pages to Studio, each backed by new Central Manager routes. This issue is a short design document in this repo: each screen, where it sits, and the routes it calls. It should be complete enough to hand to an engineer who has not followed the backend work (D37).
Scope
The document covers these screens:
| Screen | Where | Central Manager routes |
|---|---|---|
| Upgrades: schedule and next cycle, move a date earlier, conservative-track hold | Organization menu | GET /UpgradeSchedule, GET and PATCH /UpgradeCycle (HarperFast/central-manager#1191) |
| Upgrade history | Cluster menu, next to Version | GET /Cluster/:id/upgrades (HarperFast/central-manager#1191) |
| Stage link | Cluster settings | PUT /Cluster/:id (HarperFast/central-manager#1179), POST /OrganizationLink (HarperFast/central-manager#1178) |
| Notices in the bell, banner and notification center | Existing components | GET /OrganizationNotification plus its subscription (HarperFast/central-manager#1180) |
| Notification settings | Organization settings | NotificationSettings, NotificationPreference (HarperFast/central-manager#1181) |
| Staff: releases, blackouts, exceptions | /admin |
/Admin/HarperRelease, /Admin/UpgradeBlackout, /Admin/UpgradeException (HarperFast/central-manager#1182, HarperFast/central-manager#1184, HarperFast/central-manager#1185) |
| Staff: organization page (upgrade track, slot, off-hours) | /admin, new |
/Admin/Organization, /Admin/UpgradeSchedule (HarperFast/central-manager#1184) |
| Staff: plan and status | /admin |
GET /Admin/Upgrade/plan, GET /Admin/Upgrade/status (HarperFast/central-manager#1186, HarperFast/central-manager#1190) |
| Staff: scoped notice form | Existing notifications page | POST /Admin/OrganizationNotification (HarperFast/central-manager#1180) |
| Staff: permission grants | /admin, new |
/Admin/StaffPermissionGrant (HarperFast/central-manager#1183) |
And how Studio behaves until the backend is switched on:
- Studio has no feature flags. Pages stay hidden while their routes answer 404 or the mode is off. Staff pages are gated on the new permissions, which
GET /User/currentreturns (HarperFast/central-manager#1183). - Types come from Central Manager's OpenAPI spec (
pnpm update-sdkregeneratesapi.gen.d.ts). Every new route is documented in that spec, so no hand-typed entries inapi.patch.d.tsshould be needed.
Current Studio behavior the document should account for:
- "Version" is not its own page. It is the shared cluster editor at
/edit/version, and/scalingis the progress screen after a submit. - A manual version change has no confirmation dialog. The product proposal (HarperFast/central-manager#707) asks for one; the document should say whether it is in scope.
- Studio hides downgrades with a client-side filter. Central Manager now refuses them on the server (HarperFast/central-manager#1187).
- Notices: the bell, banner and
/notificationsreadGET /SystemStatus/, refreshed by an anonymous WebSocket with a 60-second poll as fallback. Dismissals live in localStorage (AckedNotificationIds). The organization notice subscription is authenticated. - The staff area (
/admin,AdminShell) filters menu items withhasStaffPermissionand has no router guards. There is no staff organization page today.
Out of scope
- Building the screens: #2092, #2093, #2094.
Depends on decisions
The scope may change with sign-off of the upgrade decisions. If one of these changes, revisit this issue.
- Studio gets a rough screen-and-endpoint design document, complete enough to hand to another engineer (D37).
- Everything ships off and is turned on by configuration, so Studio pages stay hidden until then (D38).
- Launch scope includes the upgrade history page; customers changing their own slot comes after launch (D43).
- The screens follow the decisions listed in the issues each one belongs to. When one of those changes, update this document too.
Depends on
- The route list above. The routes are designed; they do not have to be built before the document is written.
Needed by
- #2092, #2093, #2094.
Acceptance
- The document is merged in this repo.
- Every route it names exists in the linked Central Manager issues, with the same method and path.
- The engineer who will build the screens has reviewed it.
Part of HarperFast/central-manager#1177.
🤖 Generated by Claude Code (Claude Opus 5.5); posted via @Devin-Holland.
- 主要语言
- TypeScript
- 星标
- 5
- 派生
- 4
- 平均合并
- 2 天 13 小时
- 30 天内合并 PR
- 60
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
HarperFast/studio 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 70/100
HarperFast/studio#2111 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
HarperFast/studio#2109 ·
维护者通常 1 天内回复
-
rum
难度 2/5 1-3 小时 新手友好度 72/100
HarperFast/studio#2085 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
HarperFast/studio#2070 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 74/100
HarperFast/studio#2067 ·
维护者通常 1 天内回复
查看 HarperFast/studio 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 67/100
ilan-pinto/roaring-lions#1552 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
bug: [React Native/Android] KeepAliveService never starts when CAMERA is not granted (Android 14+)未关闭
难度 2/5 1-3 小时 新手友好度 78/100
cloudflare/realtimekit-ui#208 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
usebruno/bruno-vscode#235 ·
维护者通常 3 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复