[Debt] Migrate Policy WebUI to the interface pattern language #11

Closed
opened 2026-08-03 08:08:43 +02:00 by zemion · 1 comment
Owner

Context

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

Current generated inventory boundary:

  • Contributed surfaces: policy.admin.group-retention, policy.admin.system-retention, policy.admin.tenant-retention, policy.admin.user-retention

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-policy` 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: `policy.admin.group-retention`, `policy.admin.system-retention`, `policy.admin.tenant-retention`, `policy.admin.user-retention` 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/policy
type
debt
priority
p1
status
ready
codex/readyarea/webui
labels 2026-08-03 08:08:43 +02:00
Author
Owner

Codex State: done

Summary

  • Completed the bounded Policy WebUI migration. System, tenant, group and user retention sections now compose Core’s typed effective-policy editor; source paths, parent locks, missing targets and read-only authority remain explicit. System retention execution distinguishes dry-run from applied state, uses keyboard-explainable action blockers and shared destructive confirmation, and projects bounded outcomes through a filterable DataGrid instead of raw JSON.

Changed Files

  • Policy f964ed7; Core shared retention contract fa32cca; meta rollout evidence 0c06697.

Verification

  • 50 Policy backend/manifest tests; Policy interface-pattern structural gate; 65/65 manifest-shape check; full-product structural i18n/theme/TypeScript/Vite/bundle-budget build.

Next / Blocked

  • No Policy-owned interface work remains in this issue. Future policy-family editors must reuse the same effective-value, source-path, narrowing and consequence contract.
## Codex State: done ### Summary - Completed the bounded Policy WebUI migration. System, tenant, group and user retention sections now compose Core’s typed effective-policy editor; source paths, parent locks, missing targets and read-only authority remain explicit. System retention execution distinguishes dry-run from applied state, uses keyboard-explainable action blockers and shared destructive confirmation, and projects bounded outcomes through a filterable DataGrid instead of raw JSON. ### Changed Files - `Policy f964ed7; Core shared retention contract fa32cca; meta rollout evidence 0c06697.` ### Verification - `50 Policy backend/manifest tests; Policy interface-pattern structural gate; 65/65 manifest-shape check; full-product structural i18n/theme/TypeScript/Vite/bundle-budget build.` ### Next / Blocked - No Policy-owned interface work remains in this issue. Future policy-family editors must reuse the same effective-value, source-path, narrowing and consequence contract.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan-policy#11