A7 Distributions and admin preview
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 20/100
Rechercherichtung
Start with docs/planning/admin-technical-spec.md, especially sections 2.5, 2.8, 3.1, 4.17, 4.18, 5.1, 6, 7, 9 and 10.8, then review the linked A7 issues #3454–#3464 and their dependencies. This tracking issue is complete when all listed exit criteria pass, the release and package preview are ready, and the maintainer's required checks and release steps are done.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Tracking issue for milestone A7 of the admin plan. Goal: the admin ships.
Exit criteria: the admin is in its three distributions with a preview of the packages; the end-to-end and accessibility checks pass on the image; the admin runs in English and a right-to-left pseudo-culture with each user's formats; the screen reader pass is done.
Suggested order, in five waves of at most three lanes, with the fourth lane kept free for fixes:
- First: A-53, resources and pseudo-cultures, A-43, the static build, and A-45, the image. A-53 keeps to
Localization/, the resource files and the shared test helpers; A-43 topublish.yml, thePackjob, the app'swwwrootand the Dockerfile; A-45 to the harness and its new job. The three meet in one file,EndToEndHost.cs: A-45 restructures it and is merged first, then A-53 adds the publish property and the culture of a run, and A-43 one origin and one redirect URI for its case. - Second: A-41, language and formats, once A-53 is merged; A-42, the axe-core sweep, once A-53 is merged; and A-55, the build inside the hosting package, once A-43 is merged. A-42 fixes markup across the admin: a fix in a file that another lane of the wave has open, such as the account page of A-41, goes to that lane.
- Third: A-54, keyboard and the screen reader script, once A-42 is merged; A-44, the templates, once A-55 is merged; and A-56, Firefox and WebKit, once A-45 is merged. A-54 adds classes to the end-to-end project and A-56 changes how it launches a browser, so they share no file.
- Fourth: A-46, the guides. The free lanes take what the audit found, and what the screen reader pass finds once the maintainer has run it.
- Fifth: A-47, the release, alone and last.
The waves are an order and not a gate: a free lane takes the next issue whose needs are merged. A6 (#3431) is merged before A-42 and A-44 start, since the first sweeps its pages and the second references its packages.
Backend, for workstation B (#3356). The audit of 20 Nov 2026 found what A7 needs of the Management API on main: GET and PUT /me/preferences with culture, timeZone, dateFormat and numberFormat (#3096, merged), and the locales of GET /me/sites. Three gaps, each with what its admin issue does until it is merged: #3450, a write of /me/preferences replaces every value and has no ETag (A-41 reads just before it writes); #3451, FluentCMS.Admin.Hosting reads Core through InternalsVisibleTo (A-47 pins the package to the exact version of Core); #3452, the files of /admin count against the pre-authentication rate limit (A-46 documents the key). None blocks.
Taken from other issues: #3214 by A-41, which closes it; #3215 is done beside the milestone, into main, and A-43 puts the notices in the zip as it decides. Of #3178: the library's built-in strings, the gallery's texts and the label of a content type by A-53; the accent color by A-42; toasts, the dialog and the drawer, and the theme items by A-54; the favicon and routes with a dot by A-43; the icon assemblies and the code of a malformed index.html by A-55; the rate limit of the static files by A-46, as documentation; the public seam and the configured client by A-47. Tick each when its issue is done; an item that a free lane closes into main before its issue starts is dropped from that issue. Left in #3178: the client row kept when the admin is turned off, the opener policy and preview, a path base of dot segments, and the rest of IAdminAccess. #3213 stays outside the milestone, for the free lane, except that A-41 covers the preferences card of its account page item.
The maintainer's part:
- The word on each dependency below before it is used.
- The screen reader pass, with the script of A-54: NVDA with Firefox and VoiceOver with Safari. What it finds is fixed before A-47.
- The cloud recipes of the hosting guide (Azure Static Web Apps, Amazon S3 with CloudFront, Cloudflare Pages) need accounts no lane has: run them, or accept them marked as not run.
- The version of the release, the last read of its notes, the tag, and the approval in the
releaseenvironment. Twelve package ids are new on nuget.org.
Branch: the issues are worked on feature/a7, cut from main after feature/a6 is merged. Each issue opens its pull request into it, and one pull request from feature/a7 into main closes them after full CI. Bugs go to main.
CI: an issue pull request runs the fast checks only, and most of A7 changes what they do not run: the Pack, Templates and End-to-end (admin) jobs, the Compose workflow and Publish. Run the quick manual CI on feature/a7 (-f quick=true) after every merge that changes one of those jobs or its script, and the full one before the final pull request. Compose, with the image job of A-45, runs by itself on each push to the branch. A pull request that changes the packaging runs the dry run of Publish. The nightly jobs of A-56 run on main only, so they are run once by hand on the branch. A lane runs its end-to-end cases once in slow mode before it pushes, and a pull request is merged by hand after every check of its last commit is read (#3356).
Dependencies: Deque.AxeCore.Playwright 4.14.0 (A-42, decided by AQ9), which brings Deque.AxeCore.Commons 4.14.0 and System.IO.Abstractions 17.0.24 with it; and the Firefox and WebKit builds of Playwright 1.64.1, with the system libraries WebKit needs on the runner (A-56). No npm package, no GitHub Action and no container image in CI. A-41 adds a storage type to the script allow-list of 3.1.
Migrations and backend: none in the milestone. The three gap issues change no model.
Public surface: A-41 adds the formats of a user to FluentCMS.Admin.Abstractions; A-53 adds a resource type of the app to AddFluentCmsAdmin and a check of menu texts per culture to the manifest check; A-54 adds radio items and the close button to FluentCMS.Admin.Components; A-55 changes what MapFluentCmsAdmin serves without an app project; A-44 adds the template fluentcms-admin and the option --admin; A-47 puts FluentCMS.Admin and FluentCMS.Admin.Hosting under the public API analyzer. Every entry stays in PublicAPI.Unshipped.txt.
Size budget: the first download is 3,570,716 B of 3,600,000 B on the branch of A-51 (#3438), 29,284 B free; it is measured again once A6 is merged. The budget is not raised. A translation is a set of satellite assemblies, which the measurement leaves out; the first download grows by the preferences card and the read of the culture at start (A-41), the favicon (A-43) and the fixes of A-42 and A-54 in the wrapped set. What does not fit leaves the first download under #3354, the component gallery first.
The specification: the pull request of the first issue merged adds A-53 to A-56 to section 10.8, with the numbers of this milestone's issues and the sizes below, corrects the rows the code has overtaken (#3096 as a need of A-41, the hosting guide named under A-43 and A-46), and adds the decisions below to section 11, after those of A6.
Decided when A7 was planned (20 Nov 2026):
- A-41 is split: A-53 takes the resources, the test of the keys and the pseudo-cultures in the browser, which A-42 needs as well, and A-41 keeps the language at start, the time zone and the formats (#3214).
- A-42 is split: it keeps the axe-core harness, the sweep of every page and the fixes, and A-54 takes the keyboard-only loop, the criteria of WCAG 2.2 that axe-core does not check, three faults of the wrapped set and the script of the screen reader pass. The pages of A6 make the sweep alone an M.
- A-43 is split: it keeps the zip on the release and the hosting guide, and A-55 takes the build inside
FluentCMS.Admin.Hosting, whose way of serving is open and which A-44 waits for. - A-45 is split: it keeps the run on the image, and A-56 takes Firefox and WebKit, whose work depends on how many cases fail there, which no run has shown.
- A-43, A-46 and A-47 are M where section 10.8 has S: the five recipes and the run from another origin, four guides in place of three, and the two tracked packages with the items of #3178.
- English alone ships (AQ14 stands). The pseudo-cultures are built under a build property and are in no release; the right-to-left checks run on a publish that has them, and the image is checked as it ships.
- The copy of the interface culture is one key of
localStorage; a new device loads once in the browser's culture and reloads after sign-in. - The current culture of the app follows the user's formats, and the formats are a service of the contract, so that a half shows a moment in the user's time zone.
- The static build is proven from another origin by an end-to-end case with a file server of the test project's own; nginx and Caddy are not run in CI.
- The image run stays where
Composeruns and the publish run on every full run; Firefox and WebKit run nightly against the publish. fluentcms-adminholds every first-party half and has no option.--adminoffluentcmsis on by default and serves the build of the package.- The hosting guide is A-43's; A-46 writes the overview, the configuration, the writing of a half and the translating.
- A-47 turns the admin on by default, as section 6.1 says, and adds no refusal at start in a preview: a configured client that cannot sign in is named in the startup report.
- #3213 is not part of A7.
- A release tagged before A-47 needs #3453 first: the
Publishworkflow would push the admin halves without the packages they depend on.
Design: docs/planning/admin-technical-spec.md, sections 2.5, 2.8, 3.1, 4.17, 4.18, 5.1, 6, 7, 9 and 10.8.
Issues
- #3454 Admin resources ready for contributed translations, and the pseudo-cultures in the browser (A-53)
- #3455 Prebuilt static build of the admin on the release, with the hosting guide (A-43)
- #3456 End-to-end tests of the admin's daily loop on the image (A-45)
- #3457 Interface language, time zone and formats per user in the admin, applied at start (A-41)
- #3458 Accessibility audit of the admin to WCAG 2.2 AA: axe-core checks of every page, in both themes and right to left (A-42)
- #3459 The prebuilt admin inside FluentCMS.Admin.Hosting, served without the app's project (A-55)
- #3460 Keyboard-only daily loop of the admin, the WCAG 2.2 criteria axe-core does not check, and the screen reader pass (A-54)
- #3461 dotnet new fluentcms-admin, and the admin in dotnet new fluentcms (A-44)
- #3462 End-to-end tests of the admin on Firefox and WebKit, nightly (A-56)
- #3463 Admin guides in docs: overview, configuration, writing an admin half and translating (A-46)
- #3464 Release of the admin with a preview of its packages (A-47)
- Vorherrschende Sprache
- C#
- Sterne
- 567
- Forks
- 107
- Ø Merge
- 1 Std. 19 Min.
- Gemergte PRs (30 T.)
- 353
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus fluentcms/FluentCMS
-
area:localization plugin type:bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
-
area:storage type:bug
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 48/100
Maintainer antworten meist innerhalb von 1 Tag
-
area:testing type:bug
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 1 Tag
-
area:api area:publishing type:feature
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100
fluentcms/FluentCMS#3473 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
area:storage plugin type:bug
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 35/100
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in fluentcms/FluentCMS
Ähnliche Issues
-
worldInstancedOccluderNode reads its appendix count as one byte, but it is a VLQEvtl. vergeben @spuddeh hat das heute übernommen. Offen
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
-
fix(ocr): compile the Tesseract-free pipeline with Tokio runtimeEvtl. vergeben @Goldziher hat das heute übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
-
priority:P2
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
-
lompotc silently drops Java/C# class members past 128 instead of erroring, as its header claimsOffenbug sev-5 vm
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100