[Task] Enforce German-reference localization and contextual-help coverage #284
Closed
opened 2026-08-05 16:21:21 +02:00 by zemion
·
23 comments
No Branch/Tag Specified
main
v0.1.46
v0.1.45
v0.1.44
v0.1.43
v0.1.42
v0.1.41
v0.1.40
v0.1.39
v0.1.38
v0.1.37
v0.1.36
v0.1.35
v0.1.34
v0.1.33
v0.1.32
v0.1.31
v0.1.30
v0.1.29
v0.1.28
v0.1.27
v0.1.26
v0.1.25
v0.1.24
v0.1.23
v0.1.22
v0.1.21
v0.1.20
v0.1.19
v0.1.18
v0.1.17
v0.1.16
v0.1.15
v0.1.14
v0.1.13
v0.1.12
v0.1.11
v0.1.8
v0.1.7
v0.1.6
v0.1.4
v0.1.3
v0.1.2
v0.1.1
v0.1.0
Labels
Clear labels
area/api
area/auth
area/db
area/devex
area/docs
area/governance
area/marketing
area/migrations
area/module-system
area/rbac
area/release
area/security
area/tenancy
area/webui
audit/complexity
audit/duplication
audit/false-positive
audit/needs-design
audit/quick-fix
audit/structural
codex/needs-human
codex/ready
module/access
module/addresses
module/admin
module/appointments
module/approvals
module/audit
module/calendar
module/campaign
module/cases
module/committee
module/connectors
module/core
module/dashboard
module/dataflow
module/datasources
module/decisions
module/dist-lists
module/dms
module/docs
module/encryption
module/erp
module/evaluation
module/files
module/fit-connect
module/forms
module/forms-runtime
module/helpdesk
module/identity
module/identity-trust
module/idm
module/ledger
module/mail
module/mandates
module/notifications
module/ops
module/organizations
module/parties
module/payments
module/permits
module/policy
module/poll
module/portal
module/postbox
module/projects
module/quick-access
module/records
module/reporting
module/risk-compliance
module/scheduling
module/search
module/services
module/tasks
module/templates
module/tenancy
module/tickets
module/views
module/voting
module/wiki
module/workflow
module/workflow-engine
module/xoev
module/xrechnung
module/xta-osci
source/backlog-import
source/security-audit
source/todo-scan
HTTP API contracts, routers, schemas, or API smoke behavior.
Authentication, sessions, access bootstrap, or login behavior.
Database sessions, models, transactions, or persistence primitives.
Local developer workflow, scripts, tests, tooling, or release helpers.
Durable documentation and project guidance.
Governance policy, audit, privacy, retention, or compliance behavior.
Public website, product messaging, publication copy, or legal page content.
Alembic migrations, schema bootstrap, or persistence evolution.
Module discovery, manifests, capabilities, routing, or optional integrations.
Permissions, roles, delegation, or authorization policy.
Versioning, release locks, tags, packaging, or dependency pins.
Security posture, static analysis, supply-chain hardening, or vulnerability remediation.
Tenant boundaries, provisioning, or tenant-scoped data behavior.
Shared WebUI shell, frontend components, routing, or frontend tests.
Complexity finding from Radon, Xenon, or equivalent maintainability scans.
Duplicated-code finding from jscpd or equivalent similarity scans.
Audit finding reviewed as a narrow false positive or acceptable risk.
Audit finding that needs an architectural or product decision before implementation.
Audit finding that appears narrow and directly fixable.
Audit finding that needs design, refactoring, or behavior review.
Needs an explicit human decision before Codex should implement.
Suitable for Codex to pick up with the existing issue context.
GovOPlaN access, identity, authentication, RBAC, and administration behavior.
GovOPlaN Addresses module behavior or integration.
GovOPlaN Admin module behavior or integration.
GovOPlaN Appointments module behavior or integration.
GovOPlaN Approvals module behavior or integration.
GovOPlaN Audit module behavior or integration.
GovOPlaN Calendar module behavior or integration.
GovOPlaN campaign module behavior or integration.
GovOPlaN Cases module behavior or integration.
GovOPlaN Committee module behavior or integration.
GovOPlaN Connectors module behavior or integration.
GovOPlaN core runner, shared primitives, shell, or extension points.
GovOPlaN Dashboard module behavior or integration.
GovOPlaN Dataflow module behavior or integration.
GovOPlaN governed datasource contracts, catalogs, and integrations.
GovOPlaN formal Decisions module behavior or integration.
GovOPlaN Distribution Lists module behavior or integration.
GovOPlaN Dms module behavior or integration.
GovOPlaN Docs module behavior or integration.
GovOPlaN Encryption key custody, cryptographic policy, and E2EE integration.
GovOPlaN Erp module behavior or integration.
GovOPlaN Evaluation module behavior or integration.
GovOPlaN files module behavior or integration.
GovOPlaN Fit Connect module behavior or integration.
GovOPlaN Forms module behavior or integration.
GovOPlaN Forms Runtime module behavior or integration.
GovOPlaN Helpdesk module behavior or integration.
GovOPlaN Identity module behavior or integration.
GovOPlaN Identity Trust module behavior or integration.
GovOPlaN Idm module behavior or integration.
GovOPlaN Ledger module behavior or integration.
GovOPlaN mail module behavior or integration.
GovOPlaN Mandates, jurisdiction, responsibility, and authority behavior or integration.
GovOPlaN Notifications module behavior or integration.
GovOPlaN Ops module behavior or integration.
GovOPlaN Organizations module behavior or integration.
GovOPlaN procedure Parties, representation, and delivery-authority behavior or integration.
GovOPlaN Payments module behavior or integration.
GovOPlaN Permits module behavior or integration.
GovOPlaN Policy module behavior or integration.
GovOPlaN Poll module behavior or integration.
GovOPlaN Portal module behavior or integration.
GovOPlaN Postbox module behavior or integration.
GovOPlaN Projects module behavior or integration.
GovOPlaN configurable task-local Quick Access behavior and integrations.
GovOPlaN Records and eAkte lifecycle behavior or integration.
GovOPlaN Reporting module behavior or integration.
GovOPlaN Risk Compliance module behavior or integration.
GovOPlaN Scheduling module behavior or integration.
GovOPlaN Search module behavior or integration.
GovOPlaN versioned institutional Services behavior or integration.
GovOPlaN Tasks module behavior or integration.
GovOPlaN Templates module behavior or integration.
GovOPlaN Tenancy module behavior or integration.
GovOPlaN Tickets module behavior or integration.
GovOPlaN governed task views, interface projections, and workflow view integration.
GovOPlaN Voting module behavior or integration.
GovOPlaN Wiki module behavior or integration.
GovOPlaN Workflow module behavior or integration.
GovOPlaN Workflow Engine runtime, persistence, or integration.
GovOPlaN Xoev module behavior or integration.
GovOPlaN Xrechnung module behavior or integration.
GovOPlaN Xta Osci module behavior or integration.
priority
p0
Immediate stop-the-line priority.
priority
p1
High priority for the next focused work window.
priority
p2
Normal planned priority.
priority
p3
Low priority or opportunistic cleanup.
Imported from markdown backlog, roadmap, plan, or TODO files.
Created from a structured security or code-quality audit report.
Imported from inline TODO/FIXME/HACK markers by the Gitea TODO importer.
status
blocked
Cannot progress without a decision, dependency, credential, or external change.
status
in-progress
Currently being worked.
status
needs-info
Needs clarifying input before implementation can proceed safely.
status
ready
Ready for implementation.
status
triage
Needs review, ownership, priority, or acceptance criteria.
type
bug
A reproducible defect, regression, or incorrect behavior.
type
debt
Cleanup, refactoring, risk reduction, or deferred engineering work.
type
docs
Documentation, process, or developer workflow work.
type
feature
New user-visible behavior or platform capability.
type
task
Implementation, maintenance, migration, or operational work.
type
user-story
End-to-end user journey or real-world process story used to steer product slices.
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: GovOPlaN/govoplan-core#284
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Outcome
German is the first-class reference locale for product acceptance, every declared UI field/action/page resolves an F1 context, and missing localization/help associations fail strict inventory checks rather than appearing at runtime.
Implemented baseline
const de/const endeclarations.Remaining work
Acceptance criteria
Documentation:
docs/LOCALIZATION_AND_HELP_QUALITY.md.Codex State: progress
Summary
Changed Files
src/govoplan_core/i18n.pysrc/govoplan_core/server/platform.pyalembic/versions/a36d8e4f9b12_german_reference_locale.pydocs/LOCALIZATION_AND_HELP_QUALITY.mdVerification
strict platform inventory: German reference complete; 0 missing translation keys; 1,247/1,247 fields resolve F1 contextGerman-default migration tests and explicit-English preservation tests passedtools/checks/check-focused.sh passedNext / Blocked
Suggested status label:
status/in-progressCodex State: started
Summary
Next / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan-core/webui/src/features/privacy/RetentionPolicyManagement.tsxgovoplan-core/webui/src/components/ConfirmDialog.tsxgovoplan-core/webui/src/types.tsgovoplan-core/docs/CONTEXTUAL_HELP_CONTRACT.mdgovoplan-policy/src/govoplan_policy/backend/manifest.pygovoplan-policy/webui/src/features/policy/RetentionPoliciesPanel.tsxgovoplan-policy/tests/test_policy_module_contract.pyVerification
Core interface-pattern and module-capability contract tests passed.Core production build passed, including Campaign embedding and full-product help resolution.Policy module-contract and WebUI interface-pattern tests passed.Manifest shape validation passed for all 67 manifests.Strict documentation inventory passed: 1,344/1,344 interface fields resolve through F1; German translations are complete.tools/checks/check-focused.sh passed backend checks, all 56 WebUI module permutations, the full-product build, and downstream module checks.Next / Blocked
Suggested status label:
status/in-progressCodex State: progress
Summary
Changed Files
govoplan-core: docs/CONTEXTUAL_HELP_CONTRACT.md; docs/LOCALIZATION_AND_HELP_QUALITY.md; webui/src/components/CredentialEnvelopeManager.tsx; webui/src/components/table/TableActionGroup.tsx; related contract testsgovoplan-access: src/govoplan_access/backend/manifest.py; tests/test_interface_documentation_contract.pyVerification
Core targeted interface, data-grid, module-capability, and full build checks passed.Access full test suite passed (65 tests); ruff check passed.Manifest shape and architecture checks passed for 67/67 modules.Strict platform inventory passed: 1,344/1,344 fields resolve F1 help, with complete German coverage and no missing translations, duplicates, stale surfaces, or endpoint mismatches.tools/checks/check-focused.sh passed, including all 56 WebUI module permutations and full-product bundle budgets.Next / Blocked
Suggested status label:
status/in-progressExtending this work with real-route browser coverage for semantic action bars, F1 focus/return, German reference wording, and narrow layouts on the maintained Core/Campaign/workspace journeys.
Browser-conformance and inventory milestone completed in
5a9e8f7,fbea74a, root6a74e53, and the related Dataflow/Datasources releases.Completed:
helpContextIdanddata-help-context-idassociations, including nearest form fields.The issue remains open deliberately: the richer exact-content queue is now 1,325 controls (down from 1,380 after correcting authored-context detection). That is progressive content enrichment, not a conformance failure, and should continue in bounded risk-prioritized batches.
Progress slice published: exact contextual help and complete German-reference documentation for the Access credential lifecycle.
Published artifacts:
2d1b1e3/v0.1.1954178ee/v0.1.2175103d4Coverage added:
Measured strict-inventory result:
Verification:
This is a bounded progress slice. The umbrella issue remains open for the next high-risk exact-help candidates.
Starting the next high-risk exact-help batch in Mail: legacy POP3 credential, transport, bounded-import, explicit-enable, source-deletion, and outcome-unknown controls, backed by complete German-reference Mail documentation.
Progress slice released in Mail v0.1.21.
Evidence:
This advances the umbrella but does not close it; other modules still need exact high-risk context promotion.
Docs-owned German/reference coverage is now complete and released in Docs v0.1.20.
Release evidence:
Core #284 remains open while the same contract is worked through the remaining owning modules.
The next German reference contract batch is released: REST v0.1.19 and SOAP v0.1.19 now have complete German public-reference coverage and no catalog gaps.
Evidence:
Core #284 remains open for the remaining modules.
Tasks v0.1.20 and Postbox v0.1.19 are released as the next German-reference contract batch.
Evidence:
Core #284 remains open for the remaining module-owned batches.
Public documentation coverage advanced with the released Portal v0.1.19, Views v0.1.19, and Quick Access v0.1.19 batch; workspace pin commit
e07b3487e300446b68153a03ae146d4882140bb1. All three now have complete German static baselines plus the required workflow/reference semantics and report zero catalog gaps. Aggregate coverage is 77/298 German-complete topics and 59 gap-bearing modules. Full focused verification passed: 68 manifests, 59 WebUI permutations, full-product budgets, 8/8 Playwright conformance, and downstream checks. Remote branches and annotated tags were verified exactly.Completed the autonomous seed-boundary public-documentation batch.
Released
v0.1.19for Assets (27cfe2e), Booking (1400a9f), Certificates (b50c15e), Consultation (aff4df9), Contracts (e75ec88), Evaluation (4d44357), Facilities (13131f8), Grants (4ca6535), Helpdesk (064ec61), Inspections (51935b1), Learning (a8f6e97), Permits (1ad0582), Procurement (0e35520), Resources (5ced341), Tickets (b4bb52d), Transparency (8f6cb0a), and Wiki (572cb91). Workspace pin integration: GovOPlaN/govoplancd498dc.Each deliberately non-invasive seed now supplies a complete German static topic, declares the topic as a
reference, records the unavailable-runtimeseed_boundaryconsequence, and has an owner regression for these guarantees. The public projection moved from 77/298 to 94/298 German-complete topics and from 59 to 42 modules with coverage gaps.Validation passed: all 17 owner suites; manifest shape/architecture checks for 68/68 modules; public catalog projection; full
tools/checks/check-focused.sh, including backend and migration matrices, 59 WebUI module permutations, full-product bundle budget, 8/8 Playwright conformance scenarios, and downstream type/structure checks. Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API.This does not claim runtime feature completion: Tickets #1 and Wiki #1 correctly remain open. The documentation umbrella remains open for the remaining 42 gap modules.
Completed the next decision-free, localization-only documentation batch.
Released Ops
v0.1.19(f4f0931), Pollv0.1.19(bf25e88), Auditv0.1.19(f71434e), and Workflowv0.1.21(fa0bdde). Workspace release requirements and developer meta-package pins are integrated in GovOPlaN/govoplan79c4cb0.All 12 existing topics now have complete German title, summary, and body translations. Their already-correct workflow/reference/system classifications and behavior boundaries were preserved. Workflow package surfaces were aligned by correcting its stale
__version__to0.1.21; no runtime semantics changed.The public projection moved from 94/298 to 106/298 German-complete topics and from 42 to 38 modules with coverage gaps. Owner suites passed (Ops 7, Poll 73 with one skip, Audit 19, Workflow 53), as did the 68/68 manifest/architecture checks and full
tools/checks/check-focused.sh: backend and migration matrices, shared UI contracts, 59 WebUI permutations, full-product bundle budget, 8/8 Playwright conformance scenarios, and downstream type/structure checks.Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API. Ops #2 and Workflow #14 remain open because this slice does not implement deployment controls or remove the compatibility facade. The documentation umbrella remains open for the remaining 38 gap modules.
Localization/help-quality progress released in Core v0.1.37 (
562d278), Docs v0.1.21 (12fe709), four owner-module v0.1.19 releases, website publication 9944fcc, and workspace v0.1.37 (85caa8d).This adds a versioned exact-shape structured-metadata localization contract and strict registry validation, locale-aware Docs/public projections, deterministic structured-coverage metrics, and a monotonic publication gate. Eight owner topics across Decisions, Mandates, Parties, and Services were completed in German; German reference coverage is now 131/313 topics and gap modules fell from 38 to 34. Structured German adoption begins at 4/177 localizable topics.
The full focused gate passed across all 68 manifests, 63 optional-module WebUI permutations, the full-product bundle, and 8/8 Playwright conformance tests including F1 focus/return, overlay semantics, and narrow layouts.
Keeping #284 open: field/action-specific German help for remaining high-risk controls, per-reference-journey browser coverage, and a release failure for generated English-only user-facing text remain outstanding.
German-reference/contextual-help migration advanced through Reporting v0.1.19 (f85e0fe) and Search v0.1.19 (6c5545a), composed at 41ca242 and published at d0635d4.
Both modules now provide complete German public topics plus explicit scope-conditioned workflows and structured German prerequisites, steps, limitations, operational consequences, verification, and DSAR consequence references. Coverage is now 135/313 German-complete topics, 8/181 structured-complete topics, and 32 gap modules.
The full focused gate passed, including all 68 manifests, 63 optional-module WebUI permutations, full-product budgets, and 8/8 Playwright conformance tests.
Keeping #284 open: remaining high-risk controls still need field/action-specific German help, reference-journey browser coverage remains incomplete, and generated English-only user-facing text is not yet a universal release failure.
German-reference and contextual-help coverage advanced in the owner-module batch released as Identity Trust v0.1.19, Payments v0.1.21, Projects v0.1.19, and Risk Compliance v0.1.19. Eight topics now have complete German title/summary/body and versioned structured German workflow/reference metadata; total structured coverage is 16/183. The Projects surface also gained an explicit focus-visible rule.
The full focused gate passed, including strict manifest/help checks, all 63 optional-module WebUI permutations, full-product bundle budgets, and all 8 Playwright conformance scenarios (F1 focus/return, overlay semantics, keyboard operation, and narrow layout). The task remains open for field/action-specific high-risk German help and the remaining untranslated public content.
German reference-debt wave published (2026-08-23).\n\nCoverage moved from the last published baseline to:\n- German-complete static topics: 143 -> 182 of 322\n- Missing German static topics: 170 -> 140\n- Modules with documented coverage gaps: 28 -> 20\n- Structured German workflow/reference contracts: 16 -> 39 of 189\n- Catalogued modules/topics: 68/313 -> 72/322\n\nPublished owner releases:\n- v0.1.19: approvals, dashboard, dist-lists, notifications, committee, encryption, forms-runtime, organizations\n- v0.1.20: dms, erp, fit-connect\n- v0.1.21: records, xrechnung\n\nThe translations cover permission-scoped workflows, settings, field semantics, limitations, operational consequences, and verification metadata. DMS, ERP, FIT-Connect, XRechnung, and Records no longer have public documentation gaps. The encryption text documents the implemented server-envelope/E2EE boundary without choosing a tenant policy.\n\nComposition/catalog commits:\n- GovOPlaN/govoplan@c50f699\n- add-ideas/addideas-govoplan-website@7b3ca3c\n\nVerification:\n- all affected owner test suites and Ruff checks passed\n- 72/72 manifest and architecture checks passed\n- website documentation check and production build passed\n- full focused workspace gate passed, including 63 WebUI permutations, full-product bundle budget, 8 Playwright conformance tests, and downstream UI structure tests\n\nRemaining gap modules: access, addresses, admin, calendar, campaigns, cases, connectors, dashboard, dataflow, datasources, files, forms, identity, idm, policy, scheduling, templates, tenancy, voting, workflow_engine.\n\nThe dashboard gap is intentionally still reported: German content and structured reference metadata are complete, but there is no route-specific permission contract from which to claim a scope-conditioned user workflow. This umbrella should remain open for the remaining public German and exact/contextual-help debt.
German reference localization burn-down — final progress (2026-08-23)
This supersedes the intermediate coverage figures posted earlier in this issue.
Remaining bounded debt
campaigns: 31 untranslated topics.files: 15 untranslated topics.connectors: 7 untranslated topics plus a user workflow and field/consequence reference.dataflow: 5 untranslated topics plus a user workflow and field/consequence reference.dashboard: fully German and structured, but still lacks a permission-conditioned user workflow. This is intentionally not fabricated: the current product contract has no route-specific Dashboard read scope, so resolving it requires either an explicit read permission or a decision that every authenticated user is in scope.Releases published
v0.1.21, Adminv0.1.20, Policyv0.1.21, Schedulingv0.1.20, Addressesv0.1.19, Calendarv0.1.20, Casesv0.1.21, Datasourcesv0.1.22, IDMv0.1.22, Formsv0.1.21, Identityv0.1.19, Templatesv0.1.19, Tenancyv0.1.19, Votingv0.1.19, and Workflow Enginev0.1.20.Verification and publication
fe83290d56a5862eabc84599d86795d2a49b3b1f.34bcbdda3348935f53a06f41b7ef7c50a6ed3db4.The umbrella remains open for the five explicitly listed modules and the separate structured-metadata migration. A native-speaker editorial review remains advisable, but no manual verification is required for release correctness.
German reference localization burn-down — completed static coverage (2026-08-23)
This supersedes both earlier progress comments from today; the translation-only residual wave has now also shipped.
Sole remaining module-level gap
dashboard: all 3 topics are German-complete and its two structured topics are complete. The remaining user-workflow flag requires a permission-model decision: either introduce an explicit Dashboard read scope or declare the Dashboard universally available to authenticated users. No scope was invented in documentation.Final residual releases
v0.1.23(d86894b): 7 translations, permission-conditioned workflow, field/consequence reference, structured German contract.v0.1.21(08c1ecb): 5 translations, permission-conditioned workflow, explicit reference archetypes, structured German contract.v0.1.21(74c2609): 15 translations.v0.1.25(b41f23c): 31 translations and corrected package-version alignment.These follow the 28 module releases listed in the preceding comment, for 32 module releases in the complete localization wave.
Verification and publication
a886a9b3def386fc9f533ea78028d4f58fcef302.040ff06961b4a843a24192259ec1f288766fe1b7.No manual verification is required for release correctness. A native-speaker editorial pass remains advisable. The umbrella should remain open only for the Dashboard scope decision and the separate 150-topic structured-metadata migration.
Published the completed structured-German and Dashboard-permission slice.
v0.1.20now has the grantable and enforceddashboard:dashboard:readscope, resolving the final permission-conditioned workflow gap.v0.1.38validates owner-provided structured translations; 45 owning modules now provide complete German structured metadata.This completes the structured-documentation/localization portion and closes Docs #20. Keeping Core #284 open for its deliberately broader residual scope: richer exact German help for the 1,459 review-candidate controls, prioritizing high-risk actions, plus owner-specific reference-journey coverage where warranted.
Implemented and released the high-risk contextual-help completion slice.
Evidence:
Published composition: Core v0.1.39 and workspace v0.1.39, with coordinated owner releases across Access, Addresses, Admin, Approvals, Calendar, Campaign, Committee, Connectors, Dataflow, Datasources, Distribution Lists, Docs, Files, Identity Trust, IDM, Mail, Organizations, Portal, Postbox, Records, Reporting, Risk Compliance, Templates, Tickets, Views, Wiki, and Workflow.