[Debt] Migrate Admin WebUI to the interface pattern language #8

New Issue

2026-08-03T08:08:41+02:00

zemion commented

2026-08-03 08:08:41 +02:00

Context

This is the bounded govoplan-admin work package for the platform interface pattern-language rollout.

Platform pattern contract: GovOPlaN #11
Guided administration/configuration program: Core #225

Current generated inventory boundary:

Contributed surfaces: admin.section.overview, admin.section.system-configuration-changes, admin.section.system-configuration-packages, admin.section.system-groups, admin.section.system-modules, admin.section.system-role-templates, admin.section.system-settings

The issue owns only module-provided UI. Shared primitives remain in Core; optional integrations must continue to use declared contracts and capabilities.

Scope

Audit the listed routes and contributed surfaces, classify each by the canonical archetypes in govoplan/docs/INTERFACE_PATTERN_LANGUAGE.md, and migrate deviations without redesigning unrelated behavior.

Acceptance Criteria

Inventory the module's routes, panels, dialogs, tables, workflows, and destructive actions and record their archetype and consequence class.
Use shared Core components and tokens for equivalent controls, status, dialogs, loading, empty, error, stale, offline, partial, and permission states.
Explain disabled or unavailable actions with actor, reason, required action, and destination where applicable.
Add stable contextual Docs links for routes, fields, blockers, and consequential actions.
Preserve optional-module boundaries; no private imports from sibling modules.
Verify keyboard order, focus handling, responsive behavior, localization, privacy-safe rendering, and destructive confirmation behavior.
Update the module's user/admin DocumentationTopic contributions and focused regression tests.
Record completion evidence in the rollout matrix under govoplan/docs/INTERFACE_SURFACE_INVENTORY.md.

Verification

Run the module's targeted backend/WebUI tests, the manifest-shape check, and the consolidated focused check when shared contracts or optional integrations change.

## Context This is the bounded `govoplan-admin` work package for the platform interface pattern-language rollout. - Platform pattern contract: [GovOPlaN #11](https://git.add-ideas.de/GovOPlaN/govoplan/issues/11) - Guided administration/configuration program: [Core #225](https://git.add-ideas.de/GovOPlaN/govoplan-core/issues/225) Current generated inventory boundary: - Contributed surfaces: `admin.section.overview`, `admin.section.system-configuration-changes`, `admin.section.system-configuration-packages`, `admin.section.system-groups`, `admin.section.system-modules`, `admin.section.system-role-templates`, `admin.section.system-settings` The issue owns only module-provided UI. Shared primitives remain in Core; optional integrations must continue to use declared contracts and capabilities. ## Scope Audit the listed routes and contributed surfaces, classify each by the canonical archetypes in `govoplan/docs/INTERFACE_PATTERN_LANGUAGE.md`, and migrate deviations without redesigning unrelated behavior. ## Acceptance Criteria - [ ] Inventory the module's routes, panels, dialogs, tables, workflows, and destructive actions and record their archetype and consequence class. - [ ] Use shared Core components and tokens for equivalent controls, status, dialogs, loading, empty, error, stale, offline, partial, and permission states. - [ ] Explain disabled or unavailable actions with actor, reason, required action, and destination where applicable. - [ ] Add stable contextual Docs links for routes, fields, blockers, and consequential actions. - [ ] Preserve optional-module boundaries; no private imports from sibling modules. - [ ] Verify keyboard order, focus handling, responsive behavior, localization, privacy-safe rendering, and destructive confirmation behavior. - [ ] Update the module's user/admin `DocumentationTopic` contributions and focused regression tests. - [ ] Record completion evidence in the rollout matrix under `govoplan/docs/INTERFACE_SURFACE_INVENTORY.md`. ## Verification Run the module's targeted backend/WebUI tests, the manifest-shape check, and the consolidated focused check when shared contracts or optional integrations change.

zemion added the module/admin

area/webui labels 2026-08-03 08:08:41 +02:00

zemion commented

2026-08-03 08:45:17 +02:00

Codex State: progress

Summary

Implemented the module-lifecycle pattern slice at commit 6dbccd5.
The Modules surface now projects plan, preflight, request, daemon execution, and run evidence through the shared StageRail.
An installer request created before the current saved plan is excluded from current evidence; queueing exposes one deterministic actionable blocker and contextual Docs link.

Changed Files

webui/src/features/admin/ModuleManagementPanel.tsx
webui/src/features/admin/moduleInstallerWorkflow.ts
src/govoplan_admin/backend/manifest.py
README.md

Verification

npm run test:installer-workflow: 4 passed.
Core WebUI TypeScript and structural i18n audits passed.
Admin backend: 3 tests and 2 subtests passed.
Workspace manifest registry: 65/65 passed.

Next / Blocked

Keep open for the remaining Admin panels, keyboard/focus/responsive pass, and consequence/disabled-action inventory.

Suggested status label: status/in-progress

## Codex State: progress ### Summary - Implemented the module-lifecycle pattern slice at commit 6dbccd5. - The Modules surface now projects plan, preflight, request, daemon execution, and run evidence through the shared StageRail. - An installer request created before the current saved plan is excluded from current evidence; queueing exposes one deterministic actionable blocker and contextual Docs link. ### Changed Files - `webui/src/features/admin/ModuleManagementPanel.tsx` - `webui/src/features/admin/moduleInstallerWorkflow.ts` - `src/govoplan_admin/backend/manifest.py` - `README.md` ### Verification - `npm run test:installer-workflow: 4 passed.` - `Core WebUI TypeScript and structural i18n audits passed.` - `Admin backend: 3 tests and 2 subtests passed.` - `Workspace manifest registry: 65/65 passed.` ### Next / Blocked - Keep open for the remaining Admin panels, keyboard/focus/responsive pass, and consequence/disabled-action inventory. Suggested status label: `status/in-progress`

zemion commented

2026-08-03 11:31:05 +02:00

Codex State: done

Summary

Completed in d428f33 and recorded in meta at 6f896d9.

Changed Files

Migrated all Admin-contributed surfaces to shared controls, contextual Docs, explained disabled states, guarded consequential actions, localized surface metadata, and stable interface contracts.

Verification

Admin backend tests, installer workflow tests, Admin interface-pattern structural tests, consolidated focused checks, all 46 WebUI module permutations, and full-product bundle budgets pass.

## Codex State: done ### Summary - Completed in d428f33 and recorded in meta at 6f896d9. ### Changed Files - `Migrated all Admin-contributed surfaces to shared controls, contextual Docs, explained disabled states, guarded consequential actions, localized surface metadata, and stable interface contracts.` ### Verification - `Admin backend tests, installer workflow tests, Admin interface-pattern structural tests, consolidated focused checks, all 46 WebUI module permutations, and full-product bundle budgets pass.`

zemion closed this issue

2026-08-03 11:31:05 +02:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan-admin#8