Generic tree and settings screens

This page covers the remaining generic screens of the web app: the hierarchy screen built from TreeViewMeta, the module settings screen built from a settings section's tabs, and three screens of the Settings app (general preferences, record retention, and changed records). Lists and cards are on generic list and generic detail.

Scope and source¶

• Defined in: webapp/js/gen-tree.js (makeGenTree), webapp/js/gen-settings.js (makeGenSettings, requestSettingsTab), webapp/js/general.js (renderGeneral), webapp/js/retention.js (renderRetentionSettings), webapp/js/changed.js (makeChangedRecords)
• Count: 1 tree section and 9 settings sections in module metadata (counted with grep -rn 'view_type="tree"' and grep -rn 'view_type="settings"' over src/cluster_erp/modules)

Tree screen¶

makeGenTree(moduleName, entityKey) renders a view_type: "tree" section (webapp/js/gen-tree.js:21, webapp/js/module-app.js:117-118).

The tree loads the entity's list once with limit: 500 and nests it in the browser. Roots whose parent no longer exists are still shown at depth 0 (webapp/js/gen-tree.js:41-82). A node tap opens the read-only record card; the parent is a normal form field, so moving a node is an edit (webapp/js/gen-tree.js:98-118). Adding under a node pre-fills the parent field (webapp/js/gen-tree.js:84-96). Create, update, and delete depend on <entity_type>.create, .update, and .delete (webapp/js/gen-tree.js:34-36).

Module settings screen¶

makeGenSettings(moduleName, tabKeys) renders a view_type: "settings" section. Each key in tabs is an entity key of the module (webapp/js/gen-settings.js:27-74).

Settings of system apps that have no app of their own appear under Settings › System Apps (settings.system_apps) through SYSTEM_APP_SETTINGS (webapp/js/home.js:3446-3461, webapp/js/home.js:3717).

Settings app rows¶

The Settings app is built by settingsRows(), which is also the source of settings search targets (webapp/js/home.js:3475-3527).

The log screens and the mail screens are on mail and profile screens. The licence screen is described on app store, licensing, and entitlements.

General preferences¶

renderGeneral(c) shows the theme (light or dark), the row density (three tiers), and the time zone. The common time zones come first, then every zone the browser supports (webapp/js/general.js:13-63, webapp/js/prefs.js:11-36). Theme and time zone are stored in the browser; density is also stored in the user account. See themes, tokens, and accessibility and user UI state.

Record retention¶

renderRetentionSettings(c) reads GET /records/retention/ and shows the retention period in years with the minimum and maximum the server returns (webapp/js/retention.js:19-33). Save checks the range in the browser and sends PUT /records/retention/ with retention_years (webapp/js/retention.js:35-50). The server's upper bound is RETENTION_MAX_YEARS = 250 (src/cluster_erp/modules/records/retention/models.py:15). Retention and purge are described on records module.

Changed records¶

makeChangedRecords(pushView) is the read-only window on the change history (webapp/js/changed.js:1-7, webapp/js/changed.js:127). It calls GET /logs/change-history/tables once and GET /logs/change-history/ with limit, offset, search, table_name, action, date_from, and date_to. The date range starts at the first day of the current month (webapp/js/changed.js:127-160). The history itself is described on change history.

Constraints and validation¶

• A tree with more than 500 nodes is cut at 500, because the screen requests one page of that size (webapp/js/gen-tree.js:46).
• A settings tab key that is not an entity of the module is skipped (webapp/js/gen-settings.js:34-41).
• Browser tests: web-client/_e2e_settings_full.mjs, web-client/_e2e_density.mjs.

Terms introduced¶

Related pages¶

• Web app platform
• Metadata rendering
• Generic list
• Logs module
• Records module

Verified against commit 92f8051 on 2026-11-13.