Release govoplan-voting v0.1.21: unify interface contracts and documentation

pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-voting"
-version = "0.1.20"
+version = "0.1.21"
 description = "Governed voting, ballot assurance, tally, and certification for GovOPlaN."
 readme = "README.md"
 requires-python = ">=3.12"
 authors = [{ name = "GovOPlaN" }]
-dependencies = ["govoplan-core>=0.1.18", "govoplan-access>=0.1.18"]
+dependencies = ["govoplan-core>=0.1.45", "govoplan-access>=0.1.18"]
 
 [tool.setuptools.packages.find]
 where = ["src"]

src/govoplan_voting/__init__.py

@@ -1,3 +1,3 @@
 """GovOPlaN Voting module."""
 
-__version__ = "0.1.20"
+__version__ = "0.1.21"

src/govoplan_voting/backend/manifest.py

@@ -55,7 +55,7 @@ from govoplan_voting.backend.local_confidential_provider import (
 
 MODULE_ID = "voting"
 MODULE_NAME = "Voting"
-MODULE_VERSION = "0.1.20"
+MODULE_VERSION = "0.1.21"
 READ_SCOPE = "voting:ballot:read"
 MANAGE_SCOPE = "voting:ballot:manage"
 CAST_SCOPE = "voting:ballot:cast"
@@ -323,6 +323,21 @@ manifest = ModuleManifest(
     ),
     tenant_summary_providers=(_tenant_summary,),
     documentation=(
+        DocumentationTopic(
+            id="voting.workspace-layout",
+            title="Voting workspace layout",
+            summary="Find workspace actions and read consistently arranged content.",
+            body="Reload and New ballot remain in the workspace-wide top bar, even when a ballot is selected or the catalogue is empty. Reload sits immediately before New. Ballot actions such as opening, casting, certification, challenge, and annulment stay with the selected ballot. New ballot stays visible but disabled without management permission. The shared layout changes no electorate or assurance policy; administrators retain the existing separate management, casting, certification, and administrative grants.",
+            layer="static",
+            documentation_types=("user", "admin"),
+            audience=("user", "module_admin", "operator"),
+            order=5,
+            translations={"de": {
+                "title": "Abstimmungen: Aufbau des Arbeitsbereichs",
+                "summary": "Arbeitsbereichsaktionen finden und einheitlich angeordnete Inhalte lesen.",
+                "body": "Neu laden und Neue Abstimmung bleiben in der arbeitsbereichsweiten oberen Leiste, auch bei ausgewählter Abstimmung oder leerem Katalog. Neu laden steht unmittelbar vor Neu. Öffnen, Stimmabgabe, Zertifizierung, Anfechtung und Annullierung bleiben bei der ausgewählten Abstimmung. Neue Abstimmung bleibt ohne Verwaltungsrecht sichtbar, aber deaktiviert. Das gemeinsame Layout verändert weder Wählerschaft noch Zusicherung; die getrennten Verwaltungs-, Stimmabgabe-, Zertifizierungs- und Administrationsrechte bleiben bestehen.",
+            }},
+        ),
         DocumentationTopic(
             id="voting.data-subject-requests",
             title="Voting data-subject requests",

webui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/voting-webui",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "private": true,
   "type": "module",
   "main": "src/index.ts",
@@ -14,7 +14,7 @@
     "./styles/voting.css": "./src/styles/voting.css"
   },
   "peerDependencies": {
-    "@govoplan/core-webui": "^0.1.18",
+    "@govoplan/core-webui": "^0.1.45",
     "lucide-react": "^1.23.0",
     "react": ">=19.2.7 <20",
     "react-dom": ">=19.2.7 <20"

webui/src/features/voting/VotingPage.tsx

@@ -18,6 +18,7 @@ import { ActionBlockerHint,
   StatePanel,
   StatusBadge,
   WorkspaceActionBar,
+  WorkspaceFrame,
   WorkspaceLayout,
   hasScope,
   i18nMessage,
@@ -150,7 +151,15 @@ export default function VotingPage({ settings, auth }: PlatformRouteContext) {
   }
 
   return (
-    <main className="voting-page">
+    <WorkspaceFrame as="main" className="voting-page" label="Ballots" interfaceId="voting.workspace" helpContextId="voting.workspace" helpModuleId="voting">
+      <WorkspaceActionBar
+        scope="workspace"
+        variant="collection"
+        refreshable
+        reloadAction={{ onReload: () => void loadList().catch((reason) => setError(message(reason, "Ballots could not be loaded."))), loading: loading || busy, label: "Refresh ballots" }}
+        createAction={<Button variant="primary" disabled={!canManage || busy} disabledReason={busy ? VOTING_I18N.busy : !canManage ? VOTING_I18N.manageReason : undefined} onClick={() => setEditing("new")}><Plus size={16} aria-hidden="true" />New ballot</Button>}
+        helpAction={<DocumentationHelpLink reference={VOTING_DOCUMENTATION} />}
+      />
       <WorkspaceLayout
         variant="split"
         primarySize="default"
@@ -165,15 +174,6 @@ export default function VotingPage({ settings, auth }: PlatformRouteContext) {
         helpContextId="voting.workspace"
         helpModuleId="voting"
         primary={<>
-          <WorkspaceActionBar
-            scope="collection-pane"
-            variant="collection"
-            refreshable
-            reloadAction={{ onReload: () => void loadList(), loading: loading || busy, label: "Refresh ballots" }}
-            className="voting-toolbar"
-            createAction={<Button variant="primary" disabled={!canManage} disabledReason={!canManage ? VOTING_I18N.manageReason : undefined} onClick={() => setEditing("new")}><Plus size={16} aria-hidden="true" />New ballot</Button>}
-            helpAction={<DocumentationHelpLink reference={VOTING_DOCUMENTATION} />}
-          />
           <PageScrollViewport className="voting-list-viewport">
             {loading && <LoadingIndicator label="Loading ballots" />}
             {!loading && items.length === 0 && <StatePanel size="compact" description="No ballots." />}
@@ -317,7 +317,7 @@ export default function VotingPage({ settings, auth }: PlatformRouteContext) {
           void cast();
         }}
       />
-    </main>
+    </WorkspaceFrame>
   );
 }