Design doc: Studio screens and Central Manager routes for automatic upgrades

Đang mở
#2,091 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
42/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
documentation

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

documentation

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/current returns (HarperFast/central-manager#1183).
  • Types come from Central Manager's OpenAPI spec (pnpm update-sdk regenerates api.gen.d.ts). Every new route is documented in that spec, so no hand-typed entries in api.patch.d.ts should 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 /scaling is 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 /notifications read GET /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 with hasStaffPermission and 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.

Ngôn ngữ chính
TypeScript
Star
5
Fork
4
Merge trung bình
2 ngày 13 giờ
Pull request đã merge (30 ngày)
60

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của HarperFast/studio

Tất cả issue của HarperFast/studio

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.