[Epic] Product-wide UI/UX review and design-principle rollout #56
Open
opened 2026-09-08 18:31:59 +02:00 by zemion
·
2 comments
No Branch/Tag Specified
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#56
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.
Objective and current status
Review and improve every GovOPlaN module and the Core/shared shell against one evolving, centrally documented visual and interaction language. Prioritize usability defects, inconsistent interactions and shared-component corrections before broader feature development. Every module review starts pending; the current heading-help icon pass is partial preparation, not a completed review.
The authoritative workspace catalog and source manifests identify 77 review tracks: 73 implemented scopes (Core/shared shell plus 72 manifest-backed modules) and 4 catalogued, currently README-only placeholders (Appointments, Ledger, XÖV and XTA/OSCI). Placeholders receive separate readiness/future-UI tracks; they are neither implemented nor reviewed. Meta coordinates this epic; Meta and the public website are not counted as business modules. Modules without a standalone WebUI must still review their admin/configuration, documentation, errors and contributed operator/public interfaces.
Canonical design principles: Core UI design principles. Durable execution process and inventory: Meta UI review program. These source documents are being prepared in the current working tree; this epic does not claim they are released.
Active focus and order
The sequence is a coordination queue, not a claim that reviews have started or finished. Record the next active module, exact surfaces under review, findings, fixes, tests, manual checks and blockers in its linked issue.
Principles and retroactive application
Every child maintains an applicability / application / evidence / exception matrix. Changing a principle is not complete until already-reviewed modules have recorded evidence of continued conformance or an explicitly linked follow-up (and reopening where appropriate). Track affected modules, reviewed principle revision, migration work and tests; never silently leave older reviews green.
Module review checklist
Implemented scopes — pending review
core/govoplan-core; pending.access/govoplan-access; pending.addresses/govoplan-addresses; pending.admin/govoplan-admin; pending.approvals/govoplan-approvals; pending.assets/govoplan-assets; pending.audit/govoplan-audit; pending.booking/govoplan-booking; pending.calendar/govoplan-calendar; pending.campaigns/govoplan-campaign; pending.cases/govoplan-cases; pending.certificates/govoplan-certificates; pending.committee/govoplan-committee; pending.connectors/govoplan-connectors; pending.consultation/govoplan-consultation; pending.contracts/govoplan-contracts; pending.dashboard/govoplan-dashboard; pending.dataflow/govoplan-dataflow; pending.datasources/govoplan-datasources; pending.decisions/govoplan-decisions; pending.dist_lists/govoplan-dist-lists; pending.dms/govoplan-dms; pending.docs/govoplan-docs; pending.encryption/govoplan-encryption; pending.erp/govoplan-erp; pending.evaluation/govoplan-evaluation; pending.facilities/govoplan-facilities; pending.files/govoplan-files; pending.fit_connect/govoplan-fit-connect; pending.forms/govoplan-forms; pending.forms_runtime/govoplan-forms-runtime; pending.grants/govoplan-grants; pending.helpdesk/govoplan-helpdesk; pending.identity/govoplan-identity; pending.identity_trust/govoplan-identity-trust; pending.idm/govoplan-idm; pending.inspections/govoplan-inspections; pending.learning/govoplan-learning; pending.mail/govoplan-mail; pending.mandates/govoplan-mandates; pending.notifications/govoplan-notifications; pending.ops/govoplan-ops; pending.organizations/govoplan-organizations; pending.parties/govoplan-parties; pending.payments/govoplan-payments; pending.permits/govoplan-permits; pending.policy/govoplan-policy; pending.poll/govoplan-poll; pending.portal/govoplan-portal; pending.postbox/govoplan-postbox; pending.procurement/govoplan-procurement; pending.projects/govoplan-projects; pending.quick_access/govoplan-quick-access; pending.records/govoplan-records; pending.reporting/govoplan-reporting; pending.resources/govoplan-resources; pending.rest/govoplan-rest; pending.risk_compliance/govoplan-risk-compliance; pending.scheduling/govoplan-scheduling; pending.search/govoplan-search; pending.services/govoplan-services; pending.soap/govoplan-soap; pending.tasks/govoplan-tasks; pending.templates/govoplan-templates; pending.tenancy/govoplan-tenancy; pending.tickets/govoplan-tickets; pending.transparency/govoplan-transparency; pending.views/govoplan-views; pending.voting/govoplan-voting; pending.wiki/govoplan-wiki; pending.workflow/govoplan-workflow; pending.workflow_engine/govoplan-workflow-engine; pending.xrechnung/govoplan-xrechnung; pending.Catalogued placeholders — pending readiness / future UI review
catalog:govoplan-appointments/govoplan-appointments; pending.catalog:govoplan-ledger/govoplan-ledger; pending.catalog:govoplan-xoev/govoplan-xoev; pending.catalog:govoplan-xta-osci/govoplan-xta-osci; pending.Closure and evidence gate
Gitea issues are the canonical living state and evidence log. The source inventory and process document are durable navigation/process artifacts, not a second progress tracker.
Partial implementation evidence — initial UI-01 rollout
Implemented locally; uncommitted and unpushed. All 77 module review tracks remain pending. This is preparation and partial evidence, not a completed product-wide or module-by-module review.
docs/UI_DESIGN_PRINCIPLES.mdand supplies shared heading/label help primitives, including page/card/dialog/admin/workspace headings and widget-card title association.Affected pending reviews
Verification
Verified rollout checks (shared evidence, not a complete manual review of this module):
Additional verified actual-module evidence: at a 3085 px viewport, Dashboard display, configuration and return-to-display each kept the documentation book 6 px from its associated heading. Clean Cancel worked. The diagnostic browser recorded zero errors and no business writes; only diagnostic login/logout occurred.
The rollout also added 18 missing heading translations across 14 modules. These are focused German-parity fixes, not a declaration that every module's UI review is complete.
Broader-gate limitation: the wider focused gate, including the 63 optional-module build matrix, was still running at this evidence snapshot. This comment does not claim that the entire focused gate passed.
The review bootstrap was separately verified read-only: all 77 issues open/pending; all epic links and backlinks present; all nine-rule matrices pending; rerun finds 77 existing issues, zero missing and creates zero duplicates. The automation and documentation-structure checks passed 17 tests.
Remaining work
Verification addendum — partial UI-01 rollout
This updates the broader-gate status in the earlier partial-implementation evidence.
tools/checks/check-focused.shrun: passed (exit 0) — local verification log:/mnt/DATA/tmp/govoplan-ui-review-20260908-1EveCs/focused.log; trailing module checks also passed.git diff --checkloop: passed (exit 0).These checks verify the bounded implementation, not the complete usability of every module. All module reviews and their checkboxes remain pending. Source remains local, uncommitted and unpushed; no release or deployment is claimed. Campaign’s UI-02 compact settings overview/scoped edit dialogs remain a separate pending implementation and review slice.