skip to content
docsspec
github

Settings and setup

Where each kind of setting lives in zaentrum. It follows the design system's settings and setup pattern: every setting has exactly one place where it is changed.

KindWhereWho changes it
A person's preferences, such as languageEach app's own settings today; one place in the account menu is plannedEach person
The platform: apps, spaces, tiles, peopleSettings: registry and peopleAdmins
How an addon is installedSettings → registry → addons: the values of its chart. The operator applies them and may restart the addon (ADR-0011)Admins
An addon's own setupInside the addon, reached from its setup checklist (ADR-0010)Admins

Settings, registry, addons: acquire's containers and its setup checklist

  • One row for each setup section the addon declares, with its state in the addon's own words: ready, needs setup or degraded.
  • The summary counts and names; it never shows a value or a password: “2 download clients, 1 unreachable”.
  • “configure” opens that section inside the addon's own console, the only place it is changed.
  • The portal stores none of it: the checklist asks the addon each time it is shown, with the admin's own sign-in (ADR-0010).
  • Whether the addon runs is the platform's view, its containers; whether it is set up is the addon's. A section isn't “ready” while the part it needs is down.

Until an admin marks the platform as set up, the home page shows a first-run checklist above the tiles, to admins only.