[Feature] Provide task-local quick actions with governed return context #285

Closed
opened 2026-08-06 14:10:35 +02:00 by zemion · 3 comments
Owner

Outcome

A person can launch common module-owned actions such as composing Mail/Postbox content, filling a Template, or manipulating Files without losing the current task, case, record, or Workflow context.

Acceptance criteria

  • Define a versioned contribution contract for bounded quick actions, availability, input references, return references, help, and required permissions.
  • Render contributed actions through central overlay/workspace components; ordinary UI does not expose provider or module internals.
  • Keep validation, policy, persistence, recovery, and audit in the owning module.
  • Preserve unsaved host-page state and support explicit completion, cancellation, and deep-link fallback.
  • Allow Views and Workflow Engine to focus or recommend actions without granting authority.
  • Prove optional-module permutations and keyboard/focus/responsive behavior.
  • Add German-reference user and administrator documentation.

Source orientation: govoplan/docs/PRODUCT_INPUT_REGISTER.md.

## Outcome A person can launch common module-owned actions such as composing Mail/Postbox content, filling a Template, or manipulating Files without losing the current task, case, record, or Workflow context. ## Acceptance criteria - Define a versioned contribution contract for bounded quick actions, availability, input references, return references, help, and required permissions. - Render contributed actions through central overlay/workspace components; ordinary UI does not expose provider or module internals. - Keep validation, policy, persistence, recovery, and audit in the owning module. - Preserve unsaved host-page state and support explicit completion, cancellation, and deep-link fallback. - Allow Views and Workflow Engine to focus or recommend actions without granting authority. - Prove optional-module permutations and keyboard/focus/responsive behavior. - Add German-reference user and administrator documentation. Source orientation: `govoplan/docs/PRODUCT_INPUT_REGISTER.md`.
Author
Owner

Progress: commit 32c234f defines the bounded tool metadata/runtime contribution contract and optional shell host. govoplan-quick-access@3fbbb84 supplies the keyboard/responsive overlay, focus return, host-page preservation, and full-page fallbacks. Initial owner renderers build without module-to-module imports.

Remaining: a separately versioned active task/case/record/Workflow launch and return-reference contract, explicit completion/cancellation outcomes, and owner-side context reauthorization evidence. This issue remains open for that behavioral contract.

Progress: commit `32c234f` defines the bounded tool metadata/runtime contribution contract and optional shell host. `govoplan-quick-access@3fbbb84` supplies the keyboard/responsive overlay, focus return, host-page preservation, and full-page fallbacks. Initial owner renderers build without module-to-module imports. Remaining: a separately versioned active task/case/record/Workflow launch and return-reference contract, explicit completion/cancellation outcomes, and owner-side context reauthorization evidence. This issue remains open for that behavioral contract.
zemion added
status
in-progress
and removed
status
ready
labels 2026-08-06 19:15:45 +02:00
Author
Owner

Resuming implementation: complete the versioned accepted-context/produced-reference/help contract, owner-side reauthorization evidence, explicit completion/cancellation outcomes, Views/Workflow focus hints, and browser proof in the maintained Case journey.

Resuming implementation: complete the versioned accepted-context/produced-reference/help contract, owner-side reauthorization evidence, explicit completion/cancellation outcomes, Views/Workflow focus hints, and browser proof in the maintained Case journey.
Author
Owner

Implemented and pushed.\n\nDelivered:\n- Versioned Quick Access contribution, launch-context v2/reference v1, and explicit result v1 contracts.\n- Global/active-object availability, accepted and returned reference kinds, owner help contexts, same-tenant and declared-kind result validation, safe relative deep links, and fail-closed unknown versions/outcomes.\n- Explicit completion/cancellation; closing the drawer is not treated as success. Host routes remain mounted, preserving unsaved work, with focus restoration and full-page fallback.\n- Exact immutable View revisions can recommend or focus tools as presentation only; unusable focus safely falls back to the effective rail.\n- Concrete Files quick action reauthorizes the recent-file list and returns an exact file-version reference after explicit selection.\n- English/German user and administrator documentation plus narrow-viewport/focus browser conformance.\n\nCommits: Core ffaab54, Quick Access 5a90618, Files 21122e0, Views 877dced.\n\nVerification: focused workspace suite passed, Quick Access backend tests passed, Core launch/result tests passed, quick-access-only and provider permutations passed, and browser conformance passed.

Implemented and pushed.\n\nDelivered:\n- Versioned Quick Access contribution, launch-context v2/reference v1, and explicit result v1 contracts.\n- Global/active-object availability, accepted and returned reference kinds, owner help contexts, same-tenant and declared-kind result validation, safe relative deep links, and fail-closed unknown versions/outcomes.\n- Explicit completion/cancellation; closing the drawer is not treated as success. Host routes remain mounted, preserving unsaved work, with focus restoration and full-page fallback.\n- Exact immutable View revisions can recommend or focus tools as presentation only; unusable focus safely falls back to the effective rail.\n- Concrete Files quick action reauthorizes the recent-file list and returns an exact file-version reference after explicit selection.\n- English/German user and administrator documentation plus narrow-viewport/focus browser conformance.\n\nCommits: Core `ffaab54`, Quick Access `5a90618`, Files `21122e0`, Views `877dced`.\n\nVerification: focused workspace suite passed, Quick Access backend tests passed, Core launch/result tests passed, quick-access-only and provider permutations passed, and browser conformance passed.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan-core#285