[User Story] Complete an assisted service-to-decision journey with an eAkte #42

New Issue

2026-08-05T16:21:20+02:00

zemion commented

2026-08-05 16:21:20 +02:00

User story

As a person who cannot or does not want to use a digital portal independently, I can complete the same institutional procedure by telephone, paper, in person, or assisted digital interaction without losing agency, accessibility, privacy, status visibility, or legal evidence.

Journey

A worker opens a purpose-bound assisted session and records channel, actor, represented party, authority basis, consent/confirmation, and source evidence.
Paper, telephone, in-person, offline, and portal inputs normalize into the same versioned intake contract while preserving provenance and confidence.
Forms Runtime, Cases, Workflow Engine, Approvals/Decisions, Templates, Campaign/Postbox, Files, and Records cooperate through capabilities.
The person can review or receive a channel-appropriate confirmation and later correct disputed transcription.
The final decision, communication, and evidence are filed into an eAkte with retention and access explanations.

Acceptance criteria

Complete one maintained procedure through both self-service and one assisted channel.
Business rules and decision authority are identical across channels; channel metadata affects evidence and accessibility, not substantive entitlement.
Draft/resume, handoff, representation, correction, failed delivery, and interruption are tested.
Sensitive screens support shoulder-surfing and shared-device controls.
German task guidance, contextual help, accessible browser evidence, and record filing are part of the fixture.

Architecture: docs/ASSISTED_AND_NON_DIGITAL_CHANNELS.md, govoplan-records/docs/EAKTE_ARCHITECTURE.md, and reference journey #14.

## User story As a person who cannot or does not want to use a digital portal independently, I can complete the same institutional procedure by telephone, paper, in person, or assisted digital interaction without losing agency, accessibility, privacy, status visibility, or legal evidence. ## Journey 1. A worker opens a purpose-bound assisted session and records channel, actor, represented party, authority basis, consent/confirmation, and source evidence. 2. Paper, telephone, in-person, offline, and portal inputs normalize into the same versioned intake contract while preserving provenance and confidence. 3. Forms Runtime, Cases, Workflow Engine, Approvals/Decisions, Templates, Campaign/Postbox, Files, and Records cooperate through capabilities. 4. The person can review or receive a channel-appropriate confirmation and later correct disputed transcription. 5. The final decision, communication, and evidence are filed into an eAkte with retention and access explanations. ## Acceptance criteria - Complete one maintained procedure through both self-service and one assisted channel. - Business rules and decision authority are identical across channels; channel metadata affects evidence and accessibility, not substantive entitlement. - Draft/resume, handoff, representation, correction, failed delivery, and interruption are tested. - Sensitive screens support shoulder-surfing and shared-device controls. - German task guidance, contextual help, accessible browser evidence, and record filing are part of the fixture. Architecture: `docs/ASSISTED_AND_NON_DIGITAL_CHANNELS.md`, `govoplan-records/docs/EAKTE_ARCHITECTURE.md`, and reference journey #14.

zemion added the module/forms-runtime module/cases

type

user-story

module/records module/portal area/governance module/workflow

area/security codex/ready area/webui labels 2026-08-05 16:21:20 +02:00

zemion commented

2026-08-06 12:47:35 +02:00

Codex State: progress

The service-to-decision package now requires the exact Forms, Files, Cases, Decisions and Records capabilities used by the reference path. Public governed intake, managed attachment evidence, formal decision creation, current-authority Search sources and exact eAkte filing are implemented and covered by the focused product matrix.

Commits: govoplan-core@b5f5be1, govoplan-files@aa9f90c, govoplan-forms-runtime@3c292b8, govoplan-cases@23f5091, govoplan-decisions@3845e06, govoplan-records@011c388, govoplan@69ba103.

The story remains open for the single resumable assisted Portal/Workflow experience and complete closure, delivery, correction, retention, recovery and archive-transfer drill.

## Codex State: progress The service-to-decision package now requires the exact Forms, Files, Cases, Decisions and Records capabilities used by the reference path. Public governed intake, managed attachment evidence, formal decision creation, current-authority Search sources and exact eAkte filing are implemented and covered by the focused product matrix. Commits: `govoplan-core@b5f5be1`, `govoplan-files@aa9f90c`, `govoplan-forms-runtime@3c292b8`, `govoplan-cases@23f5091`, `govoplan-decisions@3845e06`, `govoplan-records@011c388`, `govoplan@69ba103`. The story remains open for the single resumable assisted Portal/Workflow experience and complete closure, delivery, correction, retention, recovery and archive-transfer drill.

zemion commented

2026-08-06 14:12:23 +02:00

The normalized source ideas and user-story orientation are now preserved in govoplan/docs/PRODUCT_INPUT_REGISTER.md. This issue remains the canonical live work item for the corresponding outcome.

The normalized source ideas and user-story orientation are now preserved in `govoplan/docs/PRODUCT_INPUT_REGISTER.md`. This issue remains the canonical live work item for the corresponding outcome.

zemion commented

2026-08-06 16:17:46 +02:00

Codex State: progress

The service-to-decision fixture now persists a real Workflow Engine human handoff, closes and reopens the database session, discovers it through the public Tasks aggregation contract with typed assignment/source provenance and a resumable deep link, resolves the authoritative Workflow step, and proves the projection disappears.

Forms Runtime, Cases, Decisions, Records, Search, Workflow Engine, and Tasks continue to own their respective state. The three institutional journey tests and the consolidated focused gate pass. The story remains open for pinned-composition reconstruction and target archive evidence.

## Codex State: progress The service-to-decision fixture now persists a real Workflow Engine human handoff, closes and reopens the database session, discovers it through the public Tasks aggregation contract with typed assignment/source provenance and a resumable deep link, resolves the authoritative Workflow step, and proves the projection disappears. Forms Runtime, Cases, Decisions, Records, Search, Workflow Engine, and Tasks continue to own their respective state. The three institutional journey tests and the consolidated focused gate pass. The story remains open for pinned-composition reconstruction and target archive evidence.

zemion commented

2026-08-19 02:46:48 +02:00

Codex State: progress

Summary

Implemented the first executable authenticated assisted-intake slice in Forms Runtime (d83bb92), with workspace evidence in 69519a9.
Operators can start and resume a purpose-bound assisted session against an exact published Form revision; channel, parties, authority, responsible function, notice, language, accessibility needs, and source provenance are retained.
Submission now fails closed until append-only read-back/correction evidence matches the current revision, normalized values, attachments, and signatures; saving a correction invalidates earlier confirmation evidence.

Changed Files

govoplan-forms-runtime/src/govoplan_forms_runtime/backend/intake.py
govoplan-forms-runtime/webui/src/features/forms/AssistedIntakeDialog.tsx
govoplan/tests/test_institutional_service_journey.py

Verification

govoplan-forms-runtime: pytest/ruff full suite — 18 passed
govoplan: institutional service journey — 5 passed
govoplan: tools/checks/check-focused.sh — passed, including 56 WebUI permutations and 4 Playwright conformance tests

Next / Blocked

Add targeted digital/assisted keyboard and screen-reader browser coverage at desktop/mobile widths.
Promote mixed-source provenance editing in the operator UI and prove named archive/recovery evidence.

Suggested status label: status/in-progress

## Codex State: progress ### Summary - Implemented the first executable authenticated assisted-intake slice in Forms Runtime (d83bb92), with workspace evidence in 69519a9. - Operators can start and resume a purpose-bound assisted session against an exact published Form revision; channel, parties, authority, responsible function, notice, language, accessibility needs, and source provenance are retained. - Submission now fails closed until append-only read-back/correction evidence matches the current revision, normalized values, attachments, and signatures; saving a correction invalidates earlier confirmation evidence. ### Changed Files - `govoplan-forms-runtime/src/govoplan_forms_runtime/backend/intake.py` - `govoplan-forms-runtime/webui/src/features/forms/AssistedIntakeDialog.tsx` - `govoplan/tests/test_institutional_service_journey.py` ### Verification - `govoplan-forms-runtime: pytest/ruff full suite — 18 passed` - `govoplan: institutional service journey — 5 passed` - `govoplan: tools/checks/check-focused.sh — passed, including 56 WebUI permutations and 4 Playwright conformance tests` ### Next / Blocked - Add targeted digital/assisted keyboard and screen-reader browser coverage at desktop/mobile widths. - Promote mixed-source provenance editing in the operator UI and prove named archive/recovery evidence. Suggested status label: `status/in-progress`

zemion commented

2026-08-24 14:22:54 +02:00

Implemented and published the next Anwohnerparkausweis acceptance slice.

Published releases:

Forms Runtime 29470d9, tag v0.1.20: editable per-field assisted-intake provenance (source, confidence, source/declaration reference), restoration from the current revision, first-draft save from a started session, responsive action toolbar, German catalog coverage, and updated operator/admin documentation.
Core 08c3e47, tag v0.1.41: production Forms Runtime mounted in the browser-conformance harness; desktop/mobile German self-service and assisted journeys; keyboard sequence, exact accessible-name, axe WCAG 2.1 A/AA, submit/draft payload, mixed provenance, and overflow assertions. Also fixes shared help focusability, tooltip semantics, and status-badge contrast.
Workspace ed6790c, tag v0.1.41: package metadata and resident-permit evidence updated; automated acceptance criteria raised from 8 to 10.

Verification:

full focused gate green
72/72 manifest shapes
28 Forms Runtime tests
128 Core backend tests
63 optional-module WebUI production permutations within bundle budgets
full-product initial bundle 504.2 KiB raw / 159.1 KiB gzip (budgets 512/160)
12/12 Playwright conformance tests, including both resident journeys at 1280x900 and 390x844
dialog focus, theme, Core interface, AST/layout/primitive/foundation and module-specific UI contracts green

This closes the automated digital/assisted browser-coverage and mixed-source provenance gaps. The story remains open because physical screen-reader spot checks and archive/recovery evidence (including named archive target) are still outstanding; the fixture now distinguishes those manual targets explicitly.

Implemented and published the next Anwohnerparkausweis acceptance slice. Published releases: - Forms Runtime `29470d9`, tag `v0.1.20`: editable per-field assisted-intake provenance (source, confidence, source/declaration reference), restoration from the current revision, first-draft save from a started session, responsive action toolbar, German catalog coverage, and updated operator/admin documentation. - Core `08c3e47`, tag `v0.1.41`: production Forms Runtime mounted in the browser-conformance harness; desktop/mobile German self-service and assisted journeys; keyboard sequence, exact accessible-name, axe WCAG 2.1 A/AA, submit/draft payload, mixed provenance, and overflow assertions. Also fixes shared help focusability, tooltip semantics, and status-badge contrast. - Workspace `ed6790c`, tag `v0.1.41`: package metadata and resident-permit evidence updated; automated acceptance criteria raised from 8 to 10. Verification: - full focused gate green - 72/72 manifest shapes - 28 Forms Runtime tests - 128 Core backend tests - 63 optional-module WebUI production permutations within bundle budgets - full-product initial bundle 504.2 KiB raw / 159.1 KiB gzip (budgets 512/160) - 12/12 Playwright conformance tests, including both resident journeys at 1280x900 and 390x844 - dialog focus, theme, Core interface, AST/layout/primitive/foundation and module-specific UI contracts green This closes the automated digital/assisted browser-coverage and mixed-source provenance gaps. The story remains open because physical screen-reader spot checks and archive/recovery evidence (including named archive target) are still outstanding; the fixture now distinguishes those manual targets explicitly.

zemion referenced this issue

2026-09-08 05:27:53 +02:00

User story: permit-to-payment guided public administration process #9

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan#42