Plugins, jobs, event dead letters and diagnostics pages of the admin, and the search rebuild (A-39)

Đang mở
#3,427 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ó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
csharp
Lĩnh vực
backend

Hướng nghiên cứu

Start with docs/planning/admin-technical-spec.md sections 4.15, 5.7 and 10.7, then inspect the administration assembly and FluentCMS.Plugins.Search.Admin entry points. The issue identifies the API routes and permissions, but no implementation files or tests; first map the existing admin pages and component test patterns. Done means the specified pages and actions meet the acceptance criteria, with component, API contract and end-to-end coverage.

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

Mô tả

area:admin type:feature

Problem

Rows 8.15, 8.10, 6.6 and 10.14 ask that an administrator switches a plugin per site, reads the job log, retries what failed and reads the startup report in the admin, and section 5.7 that the search index is rebuilt from it. The Management API has /plugins, /jobs, /events/dead-letter, /system/diagnostics, /system/health and /search/rebuild. The admin shows the manifest problems of its own halves on /system/plugins and nothing else of this.

Proposal

In the administration assembly (4.15):

  • /plugins. The plugins of GET /plugins with version, SDK range and contributions, and their enablement per site, with a switch for each site where the caller holds plugins.manage. A plugin's entry links to the pages of its admin half, and the page links to the manifest problems.
  • /jobs, for jobs.manage for the instance. Jobs by status, type and queue, read in pages; a job's attempts, where one abandoned past its timeout shows as failed with FCMS2508; cancel of a pending job; the dead letters with retry. A running job's status is read again every five seconds at most while the page shows (2.7).
  • Event dead letters, on the jobs page. The list has no total and no filter by handler, so it reads on with "more", and purge by handler offers the handlers of the rows read. Retry, remove and purge after a confirmation. A dead letter or a job that the 30-day retention removed meanwhile answers 404: the row is dropped and the page says so.
  • /system/diagnostics, for system.read for the instance. The startup report: providers, plugins, pending migrations, schema drift and insecure defaults (row 10.14), and the detailed health of GET /system/health.

The search half (5.7), FluentCMS.Plugins.Search.Admin. A page /search for search.manage in the site, linked from the plugin's entry: rebuild the index of the site or of one type. The answer is a job id: a caller who also holds jobs.manage for the instance gets a link to the job, and any other the notice that the rebuild started, since GET /jobs/{id} is instance-only. The contract has no contribution into a core page, so the action is a page of the half and not a button on the plugins page.

Acceptance

  • An administrator turns a plugin off for one site, and its admin contributions leave that site without a reload
  • A failed job shows its attempts and is retried from the dead letters, a pending job is cancelled, and a running job's status follows without a reload
  • An event dead letter is retried and removed, and the dead letters of one handler are purged after the confirmation
  • The diagnostics page shows the startup report with an insecure default of the test host, and the health
  • A rebuild of the index is started for one type, and its job is followed by a caller who may read jobs
  • A caller who holds jobs.manage or system.read through a site role only sees no entry and no page for them
  • Component tests cover each page; the API tests check the records against the OpenAPI document; an end-to-end case switches a plugin and retries a dead-lettered job

Design: docs/planning/admin-technical-spec.md, sections 4.15, 5.7 and 10.7 (A-39). Rows 6.6, 8.10, 8.15, 10.14. Needs A-51. Size: M; it is five views, and splits along the jobs and dead letters if a lane finds it L.

Ngôn ngữ chính
C#
Star
567
Fork
107
Merge trung bình
1 giờ 19 phút
Pull request đã merge (30 ngày)
353

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 fluentcms/FluentCMS

Tất cả issue của fluentcms/FluentCMS

Issue tương tự

Thêm issue về C#

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.