fix: address administration layout and navigation issues #28 #29 #30 #31

2026-09-12 18:16:52 +02:00
parent f52bf22e05
commit c7e5f295e6
25 changed files with 286 additions and 90 deletions
@@ -8,6 +8,19 @@ declare providers, model allowlists, defaults, embeddings, dimensions, or vector
 Do not edit `deploy/pi/models.json`, `deploy/pi/settings.json`, files under `generated/`, or
 provider/model environment defaults. Those former sources are retired.

+## Host instructions in Administration
+
+The **Pi configuration** navigation button opens **Pi management**. Its Host maintenance
+section selects the installation host's Linux, macOS, or Windows tab automatically; the
+browser's operating system does not affect it. Selecting another tab is still possible.
+
+The host CLI includes `THT_HOST_PLATFORM` in the generated Compose projection using the OS
+on which it runs. Generate projections on the destination host, not on another computer,
+and do not edit generated files. Without this projection (older deployments or native
+development), the backend reports its own OS; a Linux Docker container cannot discover
+whether the physical host is macOS or Windows. Run the updated host CLI's normal
+configuration reload on the destination installation to regenerate this information.
+
 ## Minimal catalog

 ```yaml
@@ -0,0 +1,42 @@
+# Administration follow-up: Gitea #28–#31
+
+Baseline approved by the user: `f52bf22e` on `codex/prototype-administration-pages`.
+Existing Admin, Core, sessions, and unified-model work is outside this review diff.
+
+## Ticket acceptance
+
+- [#28](https://git.tylconsulting.it/mptyl/ThothII/issues/28): Workspace page has four
+  tabs, in order: Preparation, Specific actions, About, Authentication. Every area's
+  content remains vertically accessible, with scrolling where required.
+- [#29](https://git.tylconsulting.it/mptyl/ThothII/issues/29): Database opens at the
+  existing database list instead of automatically editing a connection. Owner comment:
+  remove the “Workspace preparation” footer and restore the table's original available
+  space and margins. Tables and columns remain accessible through the original grid actions.
+- [#30](https://git.tylconsulting.it/mptyl/ThothII/issues/30): Pi fills the available
+  height minus its margins, scrolls overflowing content, and initially opens the tab
+  for the installation OS (Linux on a Linux server, macOS or Windows otherwise).
+- [#31](https://git.tylconsulting.it/mptyl/ThothII/issues/31): Keep “management” in page
+  titles, remove it from Admin buttons; use “Pi configuration” for Pi.
+
+## Scope and compatibility
+
+The global workspace/model gate, operation locks, original Core, session navigation,
+and unsaved-change guards are retained. The list currently retains the existing global
+workspace scope; an asynchronous question asks whether the user wants to broaden this
+to all workspaces. No cross-workspace operations are introduced without that decision.
+
+Workspace tab panels stay mounted, preserving secret drafts and diagnostics. Pi platform
+selection stays mounted across the two Pi sections and does not replace a manual choice
+when status refreshes. OS information is projected by the host CLI, not inferred from
+the browser. Older unprojected installations fall back to the backend runtime OS; see
+the [operator guide](../general/pi-configuration.md#host-instructions-in-administration).
+
+## Verification
+
+TDD seams: AppShell navigation and public management-page behavior with MSW API fixtures;
+the existing public Pi service and host projection contracts cover OS transport.
+Red tests were observed before adding tabs, restoring list entry, selecting OS tabs,
+projecting the host platform, and shortening navigation labels.
+
+Verification results and independent Standards/Spec reviews are recorded below when complete.
+Docker has not been rebuilt for this follow-up; the read-only QA preview uses the changed source.