Lazy loading of the admin per plugin assembly, gated by enablement and access

Aperta
#3,288 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
csharp

Direzione di ricerca

Read docs/planning/admin-technical-spec.md sections 2.6, 5.1, and 10.4, along with prerequisite A-18. Start by mapping the admin app build, plugin manifest, navigation, and field, widget, and service registries; the issue names no source files or tests for these entry points. Done means the media admin half loads only when enabled and accessible, passes the listed component and end-to-end coverage, and preserves the first-download size budget.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

area:admin type:feature

Problem

Decision 29 asks that each plugin admin half is one assembly, loaded the first time one of its contributions is used, and row 8.15 that a plugin disabled in a site shows nothing there. The app loads every assembly at start, the sidebar and the registries know the core's contributions only, and nothing reads GET /plugins to gate a contribution.

Proposal

  • The app's build gathers the fluentcms-admin.json of every half it references into one file, and lists each half as BlazorWebAssemblyLazyLoad. The shell reads the file at start with one request.
  • The shell shows a contribution from the manifest only while its server plugin is enabled in the site (GET /plugins, read once per site) and the caller holds its permission (IAdminAccess). Both are re-read on a site switch.
  • A half is loaded with LazyAssemblyLoader at the moment the table of 2.6 names: its route in the router's OnNavigateAsync, its field editor or list cell when a form or list with that field type opens, its widget when the home page shows it, its service when it is first asked for. The lookups of the field editor, list cell and filter registries become asynchronous for a type a manifest names; core types stay as they are.
  • Configure runs once per half, into a provider of the half that falls back to the admin's services; the half's components reach it through IAdminPluginServices (AQ4).
  • A half whose AdminRange does not hold the running version is not loaded and is listed on an error page; a half that fails to load shows an error state with a retry, not a blank page.
  • Create FluentCMS.Plugins.Media.Admin under admin/src/plugins/ with its manifest, its manifest test and an empty /media page with its menu item, so that the loading is proven on a real half and A-20, A-21 and A-22 start from it. A half's project takes the component library with PrivateAssets="compile" or what gives the same result, so that a half cannot name the library's types (#3178).

Acceptance

  • The first download of the app does not hold the media half; the network shows it fetched on the first visit of /media, and once
  • In a site where the media plugin is disabled the menu item is absent, /media answers the not-found page, and the half is never fetched
  • A caller without the page's permission sees no menu item, and the route answers the no-access state
  • A service registered in Configure is injected into a component of the half, and is not in the app's container
  • A half outside the admin range is listed on the error page, and the rest of the admin works
  • The download size budget of A-06 still holds for the first download
  • Component tests cover the gating and the registries; an end-to-end case covers the lazy fetch and the disabled site

Design: docs/planning/admin-technical-spec.md, sections 2.6, 5.1 and 10.4 (A-19). Rows 8.15, decision 29. Needs A-18. Size: M.

Lingua principale
C#
Stelle
569
Fork
107
Merge medio
2h 49m
PR unite (30g)
397

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di fluentcms/FluentCMS

Tutte le issue di fluentcms/FluentCMS

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.