@processpuzzle/base-app 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -8,5 +8,17 @@
8
8
 
9
9
  `@processpuzzle/base-app` is the front-end building block of the ProcessPuzzle application shell. It provides the Angular shell (workspace layout, navigation, dockable panels, task surfaces) that hosts the other ProcessPuzzle Low-Code building blocks. The library complements the [`base-app-backend`](../../java-shared/base-app-backend/README.md) Spring Boot module that exposes application-level services such as user workspace and preferences.
10
10
 
11
+ ## Modules: translations and assets
12
+
13
+ The Module form has two sections that are not form fields — nothing in them is saved with the module — so they are disabled controls the form never
14
+ submits. **Translations** downloads the prepared files (one per supported language), takes the translated zip or file back, and shows how far each
15
+ language is covered. **Assets** lists the files the module brings along and adds or removes them one by one.
16
+
17
+ When a module is mounted, its transloco scope is registered with an inline loader that reads the uploaded translations (draft in the Preview, released
18
+ in the live app) over whatever the scope already ships, and every route title is translated under its `translocoId` or the derived
19
+ `<scope>.route.<path>`. The mount also provides a `MODULE_ASSET_CONTEXT`: a widget property saying `module:docs/welcome.md` — `markdownSrc` of the
20
+ markdown widget, `src` of the image widgets — is looked up among the module's own files, and relative images and links inside a module's markdown file
21
+ resolve against that file's path. See [the plan](../../../docs/module-refinement-plan.md).
22
+
11
23
  ## Status
12
24
  This library is currently a scaffold. The public API will grow as the application shell takes shape.
@@ -24,13 +24,68 @@
24
24
  "modules": "Module",
25
25
  "tabs": {
26
26
  "preview": "{{ entity }} - Vorschau"
27
- }
27
+ },
28
+ "translations": "Übersetzungen",
29
+ "translations_panel": {
30
+ "hint": "Eine Datei je unterstützter Sprache enthält die Texte der eigenen Seiten der Anwendung. Tragen Sie die Werte unter den Schlüsseln ein, die Ihre Widgets nennen, und laden Sie das Zip (oder eine einzelne Datei) wieder hoch.",
31
+ "download": "Alle herunterladen",
32
+ "upload": "Übersetzungen hochladen",
33
+ "save_first": "Speichern Sie zuerst die Anwendung; die Texte gehören zur gespeicherten Anwendung.",
34
+ "stored": "{{count}} Schlüssel gespeichert",
35
+ "none_stored": "Es sind noch keine Texte gespeichert.",
36
+ "key": "Schlüssel",
37
+ "text": "Text"
38
+ },
39
+ "assets": "Dateien",
40
+ "assets_panel": {
41
+ "hint": "Fügen Sie Dateien einzeln hinzu, etwa die Bilder der Anwendungsseiten. Widgets verweisen als app:<Pfad> auf eine Datei.",
42
+ "path": "Verweis",
43
+ "type": "Typ",
44
+ "size": "Größe",
45
+ "remove": "Entfernen",
46
+ "none": "Noch keine Dateien.",
47
+ "folder": "Ordner",
48
+ "upload": "Dateien hochladen",
49
+ "save_first": "Speichern Sie zuerst die Anwendung; Dateien gehören zur gespeicherten Anwendung."
50
+ },
51
+ "_tooltips": {
52
+ "id": "Eindeutig innerhalb Ihrer Organisation und unverändert in der URL der Anwendung verwendet. Kurz, kleingeschrieben und mit Bindestrichen, z. B. claims-app; ändern Sie sie später möglichst nicht. — Leitfaden: Anwendung",
53
+ "name": "Der Name der Anwendung, wie Benutzer ihn sehen, z. B. im Widget app-title. — Leitfaden: Anwendung",
54
+ "translocoId": "Optionaler Übersetzungsschlüssel; wenn gesetzt, wird er in anderen Sprachen anstelle des Namens angezeigt. — Leitfaden: Anwendung",
55
+ "description": "Eine Notiz für Sie und Ihre Designer-Kollegen; Benutzer sehen sie nicht. — Leitfaden: Anwendung",
56
+ "status": "DRAFT, solange die Definition Änderungen hat, die die Organisation nicht freigegeben hat, danach PUBLISHED. Vom System gesetzt. — Leitfaden: Speichern, Vorschau und Freigabe",
57
+ "version": "Erhöht sich bei jedem Speichern. Wird vom System gesetzt. — Leitfaden: Speichern, Vorschau und Freigabe",
58
+ "publishedVersion": "Die Version, die die Benutzer derzeit erhalten. Ändert sich erst, wenn die Organisation im Bereich Freigabe des Designers freigegeben wird. — Leitfaden: Speichern, Vorschau und Freigabe",
59
+ "updatedAt": "Wann die Definition zuletzt gespeichert wurde. Wird vom System gesetzt.",
60
+ "materialTheme": "Die Farbpalette der gesamten Anwendung. processpuzzle ist das Marken-Design; die anderen färben auch Kopfzeile, Seitennavigation, Karten und Schaltflächen um. — Leitfaden: Theme",
61
+ "colorScheme": "Hell, dunkel oder automatisch (folgt dem Betriebssystem des Benutzers). — Leitfaden: Theme",
62
+ "logoUrl": "Adresse des Logobilds, das das Widget app-logo anzeigt. — Leitfaden: Theme",
63
+ "faviconUrl": "Adresse des kleinen Symbols im Browser-Tab. — Leitfaden: Theme",
64
+ "tokenOverrides": "Feinabstimmung über dem Theme: ein --pp-…-Farbtoken und sein Wert, z. B. --pp-surface-sidenav = #0d1b2a. — Leitfaden: Theme",
65
+ "preset": "Wo die Navigation sitzt: in einem Seitenbereich links oder rechts oder in der Kopfzeile (top-nav). — Leitfaden: Layout",
66
+ "sidenavMode": "side: Bereich neben der Seite · over: Bereich über der Seite · push: Die Seite rückt beiseite, solange der Bereich geöffnet ist. — Leitfaden: Layout",
67
+ "contentMaxWidth": "Maximale Breite der Seiten als CSS-Länge, z. B. 1280px; leer bedeutet volle Breite. — Leitfaden: Layout",
68
+ "sidenavCollapsible": "Ob Benutzer den Navigationsbereich schließen können. — Leitfaden: Layout",
69
+ "sidenavOpenByDefault": "Ob der Navigationsbereich anfangs geöffnet ist. — Leitfaden: Layout",
70
+ "regions": "Der Rahmen um die Seiten: header, sidenav und footer, von jedem höchstens einer. — Leitfaden: Bereiche",
71
+ "routes": "Die Seiten der Anwendung, eine Zeile pro Seite. Legen Sie sie vor den Navigationseinträgen an, die auf sie verweisen. — Leitfaden: Routen",
72
+ "modules": "Separat erstellte Teile der Anwendung, deren Routen unter einem Basispfad erscheinen. — Leitfaden: Module",
73
+ "assets": "Dateien, die die Anwendung mitbringt, etwa die Bilder ihrer Seiten. Ein Widget verweist als app:<Pfad> darauf. — Leitfaden: Anwendungen",
74
+ "translations": "Die Texte der eigenen Seiten der Anwendung, etwa der Karten ihrer Startseite, eine Datei je Sprache. Schlüssel sind die, die Widgets unter ihrem translocoPrefix nennen. — Leitfaden: Anwendungen",
75
+ "contexts": "Entitäten, die man einmal wählt und in denen man dann arbeitet. Eine Seite nimmt per Kontext erforderlich teil."
76
+ },
77
+ "contexts": "Kontexte"
28
78
  },
29
79
  "app_region": {
30
80
  "_self": "Bereich",
31
81
  "type": "Typ",
32
82
  "navItems": "Navigationseinträge",
33
- "widgets": "Widgets"
83
+ "widgets": "Widgets",
84
+ "_tooltips": {
85
+ "type": "header (oben), sidenav (Navigationsbereich) oder footer (unten). Jeder Typ kann einmal verwendet werden. Statusbar (unter der Kopfzeile) zeigt die aktiven Kontexte. — Leitfaden: Bereiche",
86
+ "navItems": "Die Menüeinträge der Seitennavigation. Nur vom Bereich sidenav verwendet. — Leitfaden: Navigationseinträge",
87
+ "widgets": "Die Widgets der Kopf- oder Fußzeile, in dieser Reihenfolge in einer Zeile angeordnet. Mit einem spacer schieben Sie die folgenden nach rechts. — Leitfaden: Kopfzeile (header)"
88
+ }
34
89
  },
35
90
  "app_route": {
36
91
  "_self": "Route",
@@ -44,12 +99,35 @@
44
99
  "documentSlug": "Dokument-Slug",
45
100
  "entityName": "Entitätsname",
46
101
  "entityMode": "Entitätsmodus",
47
- "rsqlFilter": "RSQL-Filter"
102
+ "rsqlFilter": "RSQL-Filter",
103
+ "_tooltips": {
104
+ "path": "Die Adresse der Seite relativ zur Anwendung, ohne führenden Schrägstrich, z. B. claims/open. Ein Segment :name ist ein Parameter, z. B. claims/:id. — Leitfaden: Routen",
105
+ "title": "Der Titel der Seite. — Leitfaden: Routen",
106
+ "translocoId": "Optionaler Übersetzungsschlüssel des Titels, in anderen Sprachen anstelle des Titels angezeigt. — Leitfaden: Routen",
107
+ "icon": "Ein Material- oder FontAwesome-Symbolname. — Leitfaden: Routen",
108
+ "roles": "Die Rollen, die diese Seite öffnen dürfen; leer bedeutet jedes angemeldete Mitglied Ihrer Organisation. Noch nicht durchgesetzt. — Leitfaden: Rollen",
109
+ "kind": "Was die Seite zeigt: WIDGETS, ENTITY (generierte Liste und Formular einer Entität) oder DOCUMENT. Die Felder darunter gelten nur für die gewählte Art. — Leitfaden: Routen",
110
+ "widgets": "Nur WIDGETS: die Widgets der Seite, in dieser Reihenfolge untereinander angezeigt. — Leitfaden: Widgets",
111
+ "documentSlug": "Nur DOCUMENT: der Slug des anzuzeigenden Dokuments. Wird noch nicht dargestellt. — Leitfaden: Dokumente",
112
+ "entityName": "Nur ENTITY: der Name einer unter Entitäten definierten Entität; Liste und Formular werden für Sie generiert. — Leitfaden: Entitäten",
113
+ "entityMode": "Nur ENTITY: mit der Liste oder den Details eines Datensatzes öffnen. Gespeichert, aber noch nicht angewendet. — Leitfaden: Entitäten",
114
+ "rsqlFilter": "Nur ENTITY + LIST: ein Vorfilter wie status==OPEN. Gespeichert, aber noch nicht angewendet. — Leitfaden: Entitäten",
115
+ "requiresContext": "Name eines Kontexts dieser Anwendung. Die Seite liegt dann unter ctx/<name>/<id> und zeigt „Auswählen …“, solange keiner aktiv ist.",
116
+ "contextPath": "Das Attribut der Kontext-Entität, deren Sammlung diese Seite auflistet, z. B. zones. Braucht „Kontext erforderlich“; der Entitätsname ist dann der Typ der Einträge.",
117
+ "filterByContext": "Zeigt nur die Zeilen der aktiven Entität dieses Kontexts, mit einem Schalter für alle. Das Feld „Kontext erforderlich“ bleibt leer: die Seite funktioniert ohne Kontext."
118
+ },
119
+ "requiresContext": "Kontext erforderlich",
120
+ "contextPath": "Kontextpfad",
121
+ "filterByContext": "Nach Kontext filtern"
48
122
  },
49
123
  "app_module_mount": {
50
124
  "_self": "Modul-Einbindung",
51
125
  "moduleKey": "Modulschlüssel",
52
- "basePath": "Basispfad"
126
+ "basePath": "Basispfad",
127
+ "_tooltips": {
128
+ "moduleKey": "Der Schlüssel eines unter Module erstellten Moduls. — Leitfaden: Module",
129
+ "basePath": "Das Präfix, unter dem die Routen des Moduls erscheinen: Basispfad claims macht aus der Modulroute open claims/open. — Leitfaden: Module"
130
+ }
53
131
  },
54
132
  "app_nav_item": {
55
133
  "_self": "Navigationseintrag",
@@ -59,14 +137,29 @@
59
137
  "icon": "Symbol",
60
138
  "routePath": "Route",
61
139
  "roles": "Rollen",
62
- "children": "Untereinträge"
140
+ "children": "Untereinträge",
141
+ "_tooltips": {
142
+ "id": "Eindeutiger Bezeichner des Eintrags innerhalb des Menüs, z. B. nav-claims. — Leitfaden: Navigationseinträge",
143
+ "label": "Der Text des Menüeintrags. — Leitfaden: Navigationseinträge",
144
+ "translocoId": "Optionaler Übersetzungsschlüssel der Bezeichnung, in anderen Sprachen anstelle der Bezeichnung angezeigt. — Leitfaden: Navigationseinträge",
145
+ "icon": "Ein Material- oder FontAwesome-Symbolname. — Leitfaden: Navigationseinträge",
146
+ "routePath": "Der Pfad der Route, die dieser Eintrag öffnet, genau wie bei der Route angegeben. Leer lassen, um den Eintrag zu einer Gruppe seiner Untereinträge zu machen. — Leitfaden: Navigationseinträge",
147
+ "roles": "Die Rollen, die diesen Eintrag sehen dürfen; leer bedeutet jedes angemeldete Mitglied Ihrer Organisation. Noch nicht durchgesetzt. — Leitfaden: Rollen",
148
+ "children": "Die Einträge unter einem Gruppeneintrag. Nur sinnvoll, wenn Route leer ist. — Leitfaden: Navigationseinträge"
149
+ }
63
150
  },
64
151
  "app_widget": {
65
152
  "_self": "Widget",
66
153
  "id": "Id",
67
154
  "type": "Typ",
68
155
  "props": "Eigenschaften",
69
- "placement": "Platzierung"
156
+ "placement": "Platzierung",
157
+ "_tooltips": {
158
+ "id": "Eindeutig innerhalb seiner Seite oder seines Bereichs, z. B. widget-claims-grid. Ein Container-Widget verweist über diese Id auf andere Widgets. — Leitfaden: Widgets",
159
+ "type": "Welches Widget dies ist; angeboten werden nur die in dieser Installation verfügbaren Widgets. — Leitfaden: Widgets",
160
+ "props": "Die Einstellungen des Widgets. Das Formular passt sich dem gewählten Typ an. — Leitfaden: Widgets",
161
+ "placement": "STANDALONE: dort angezeigt, wo es aufgeführt ist. REFERENCED: nur innerhalb des Container-Widgets angezeigt, das seine Id aufführt. — Leitfaden: Widgets"
162
+ }
70
163
  },
71
164
  "module_definition": {
72
165
  "_self": "Modul",
@@ -77,10 +170,134 @@
77
170
  "translocoScope": "Transloco-Bereich",
78
171
  "version": "Version",
79
172
  "updatedAt": "Geändert am",
80
- "routes": "Routen"
173
+ "routes": "Routen",
174
+ "translations": "Übersetzungen",
175
+ "translations_panel": {
176
+ "hint": "Eine Datei je unterstützter Sprache enthält alle übersetzbaren Texte des Moduls und die Texte, die seine Widgets unter dem Scope des Moduls nennen. Übersetzen Sie die Werte, behalten Sie die Schlüssel und laden Sie das Zip (oder eine einzelne Datei) wieder hoch.",
177
+ "language": "Sprache",
178
+ "translated": "Übersetzt",
179
+ "download": "Dateien herunterladen",
180
+ "upload": "Übersetzungen hochladen",
181
+ "save_first": "Speichern Sie zuerst das Modul; die Dateien werden aus dem gespeicherten Modul erstellt.",
182
+ "stored": "{{count}} Schlüssel gespeichert",
183
+ "additional": "{{count}} Widget-Texte behalten",
184
+ "missing": "{{count}} Schlüssel fehlen",
185
+ "untranslated": "{{count}} noch gleich dem Original"
186
+ },
187
+ "assets": "Dateien",
188
+ "assets_panel": {
189
+ "hint": "Fügen Sie Dateien einzeln hinzu; eine Markdown-Datei kann die anderen relativ verlinken. Widgets verweisen als module:<Pfad> auf eine Datei.",
190
+ "path": "Verweis",
191
+ "type": "Typ",
192
+ "size": "Größe",
193
+ "remove": "Entfernen",
194
+ "none": "Noch keine Dateien.",
195
+ "folder": "Ordner",
196
+ "upload": "Dateien hochladen",
197
+ "save_first": "Speichern Sie zuerst das Modul; Dateien gehören zum gespeicherten Modul."
198
+ },
199
+ "_tooltips": {
200
+ "id": "Eindeutig innerhalb Ihrer Organisation; Anwendungen binden das Modul über diesen Schlüssel ein. Darf sich nicht ändern, sobald das Modul verwendet wird. — Leitfaden: Module",
201
+ "name": "Der Name des Moduls. — Leitfaden: Module",
202
+ "translocoId": "Optionaler Übersetzungsschlüssel des Namens. — Leitfaden: Module",
203
+ "description": "Eine Notiz für Sie und Ihre Designer-Kollegen. — Leitfaden: Module",
204
+ "translocoScope": "Der Bereich, unter dem die Übersetzungen des Moduls geladen werden; leer bedeutet der Schlüssel. — Leitfaden: Module",
205
+ "version": "Erhöht sich bei jedem Speichern. Wird vom System gesetzt.",
206
+ "updatedAt": "Wann das Modul zuletzt gespeichert wurde. Wird vom System gesetzt.",
207
+ "routes": "Die Seiten des Moduls. Ihre Pfade sind relativ zum Basispfad, unter dem das Modul eingebunden ist. — Leitfaden: Module",
208
+ "translations": "Laden Sie die Übersetzungsdateien des Moduls herunter, übersetzen Sie sie offline und laden Sie sie wieder hoch. — Leitfaden: Module",
209
+ "assets": "Dateien, die das Modul mitbringt – Markdown-Seiten, Bilder. Ein Widget verweist als module:<Pfad> darauf. — Leitfaden: Module"
210
+ }
211
+ },
212
+ "concepts": {
213
+ "title": "Wie eine dynamische Anwendung aufgebaut ist",
214
+ "intro": "Eine <b>Anwendung</b> wird in ProcessPuzzle nicht programmiert – sie wird <b>beschrieben</b>. Alles, was Sie hier eingeben (der Rahmen, das Menü, die Seiten und was jede Seite zeigt), wird als Daten gespeichert, und die Anwendungsoberfläche baut daraus zur Laufzeit die laufende Anwendung auf. Um die Anwendung zu ändern, bearbeiten Sie ihre Definition und veröffentlichen sie erneut; es muss nichts neu gebaut oder neu ausgeliefert werden.",
215
+ "assembling": {
216
+ "title": "Ihre Anwendung Schritt für Schritt zusammenstellen",
217
+ "body": "<ol><li><b>Anwendung anlegen</b> – geben Sie ihr eine Id und einen Namen.</li><li><b>Aussehen wählen</b> – ein Material-Theme, ein Farbschema und eine Layout-Vorlage.</li><li><b>Seiten hinzufügen</b> – eine <b>Route</b> pro Seite; legen Sie fest, was jede davon zeigt: Widgets, eine Entität oder ein Dokument.</li><li><b>Rahmen bauen</b> – fügen Sie die Bereiche <b>header</b>, <b>sidenav</b> und <b>footer</b> hinzu; füllen Sie header und footer mit Widgets und die sidenav mit Navigationseinträgen, die auf Ihre Routen verweisen.</li><li><b>Prüfen</b> Sie das Ergebnis im Tab <b>Vorschau</b>.</li><li><b>Geben Sie sie frei</b> – im Bereich <b>Freigabe</b> des Designers –, damit die Benutzer die neue Version erhalten.</li></ol><p>Routen kommen bewusst vor der Navigation: Ein Navigationseintrag verweist über ihren Pfad auf eine Route, daher lässt er sich am einfachsten anlegen, wenn die Route bereits existiert.</p>"
218
+ },
219
+ "application": {
220
+ "title": "Anwendung",
221
+ "body": "<p>Der oberste Datensatz, der alles andere enthält. Ihre <b>Id</b> ist innerhalb Ihrer Organisation eindeutig und wird unverändert in der URL der Anwendung verwendet. Wählen Sie daher einen kurzen Wert in Kleinbuchstaben mit Bindestrichen, z. B. <code>claims-app</code>, und ändern Sie ihn später möglichst nicht. Der <b>Name</b> ist das, was die Benutzer sehen, zum Beispiel im Widget <code>app-title</code>; die optionale <b>Transloco-Id</b> ist ein Übersetzungsschlüssel, der anstelle des Namens verwendet wird, wenn die Anwendung in anderen Sprachen angezeigt wird. Die <b>Beschreibung</b> ist für Sie und Ihre Designer-Kollegen gedacht.</p>"
222
+ },
223
+ "theme": {
224
+ "title": "Theme",
225
+ "body": "<p>Bestimmt die Farben der gesamten Anwendung.</p><ul><li><b>Material-Theme</b> – <code>processpuzzle</code> ist das Marken-Design und die Voreinstellung; die anderen sind Angular-Material-Paletten, und jede davon färbt auch header, sidenav, Karten und Schaltflächen passend ein.</li><li><b>Farbschema</b> – hell, dunkel oder automatisch (richtet sich nach dem Betriebssystem des Benutzers).</li><li><b>Logo-URL</b> und <b>Favicon-URL</b> – die Bilder, die das Widget <code>app-logo</code> und der Browser-Tab anzeigen.</li><li><b>Token-Überschreibungen</b> – Feinabstimmung zusätzlich zum Theme: ein <code>--pp-…</code>-Farbtoken und sein Wert, z. B. <code>--pp-surface-sidenav</code> → <code>#0d1b2a</code>.</li></ul><p>Was Sie hier wählen, ist die <i>Voreinstellung</i> der Anwendung. Wenn Sie ein Widget <code>themes-button</code> im header platzieren, kann jeder Benutzer ein eigenes Theme wählen, das dann für ihn gespeichert wird.</p>"
226
+ },
227
+ "layout": {
228
+ "title": "Layout",
229
+ "body": "<p>Bestimmt, wo die Bereiche rund um die Seiten liegen.</p><ul><li><b>Layout-Vorlage</b> – <code>sidenav-left</code> oder <code>sidenav-right</code> zeigen die Navigation in einer Seitenleiste; <code>top-nav</code> zeigt sie stattdessen in der Kopfzeile.</li><li><b>Modus der Seitennavigation</b> – <code>side</code> hält die Leiste neben der Seite, <code>over</code> legt sie über die Seite, <code>push</code> schiebt die Seite beiseite, solange die Leiste geöffnet ist.</li><li><b>Seitennavigation einklappbar</b> / <b>Seitennavigation standardmäßig geöffnet</b> – ob die Benutzer die Leiste schließen können und ob sie anfangs geöffnet ist.</li><li><b>Maximale Inhaltsbreite</b> – eine CSS-Länge wie <code>1280px</code>, die Seiten auf breiten Bildschirmen gut lesbar hält; leer bedeutet volle Breite.</li></ul>"
230
+ },
231
+ "regions": {
232
+ "title": "Bereiche – der Rahmen um die Seiten",
233
+ "body": "<p>Ein Bereich ist ein fester Teil des Bildschirms, der an seinem Platz bleibt, während die Benutzer zwischen den Seiten wechseln. Es gibt drei Typen, und eine Anwendung hat von jedem höchstens einen: <b>header</b> (oben), <b>sidenav</b> (die Navigationsleiste) und <b>footer</b> (unten). Header und footer enthalten <b>Widgets</b>; die sidenav enthält <b>Navigationseinträge</b>. Die Fläche in der Mitte ist kein Bereich: Sie zeigt die <b>Route</b>, auf der sich der Benutzer gerade befindet. Ein Bereich, den Sie weglassen, wird einfach nicht angezeigt.</p>"
234
+ },
235
+ "header": {
236
+ "title": "Kopfzeile (header)",
237
+ "body": "<p>Die Leiste am oberen Rand der Anwendung. Ihre Widgets werden in einer Zeile von links nach rechts angeordnet, in der Reihenfolge, in der sie aufgeführt sind. Typischer Inhalt sind <code>app-logo</code> und <code>app-title</code> links, ein <code>spacer</code>, der alles danach nach rechts schiebt, und ein <code>themes-button</code> ganz rechts. Logo und Titel sind gewöhnliche Widgets, die die Logo-URL und den Namen der Anwendung lesen – Sie entscheiden also, ob und wo sie erscheinen. Beim Layout <code>top-nav</code> werden auch die Navigationseinträge in der Kopfzeile angezeigt.</p>"
238
+ },
239
+ "footer": {
240
+ "title": "Fußzeile (footer)",
241
+ "body": "<p>Die Leiste am unteren Rand der Anwendung. Sie funktioniert genau wie die Kopfzeile – eine Reihe von Widgets in der aufgeführten Reihenfolge, mit einem <code>spacer</code>, um sie auseinanderzuschieben – und eignet sich gut für Copyright-Hinweise, Kontaktdaten oder Links. Sie bleibt auch dann am unteren Bildschirmrand, wenn eine Seite kurz ist.</p>"
242
+ },
243
+ "navigation": {
244
+ "title": "Navigationseinträge",
245
+ "body": "<p>Die Einträge des Menüs, die dem Bereich <b>sidenav</b> hinzugefügt werden. Jeder hat eine <b>Bezeichnung</b> (optional über seine <b>Transloco-Id</b> übersetzt), ein <b>Symbol</b> (der Name eines Material- oder FontAwesome-Symbols) und eine <b>Route</b>: den <b>Pfad</b> der Route, die er öffnet, genau so geschrieben wie bei der Route, z. B. <code>claims/open</code>. Ein Eintrag ohne Route ist eine <b>Gruppe</b>: Er klappt die Einträge auf und zu, die Sie unter seinen <b>Untereinträgen</b> hinzufügen – so lassen sich Menüs verschachteln. Ein Pfad, zu dem es noch keine Route gibt, ist nur eine Warnung – er kann zu einem Modul gehören, das noch nicht erstellt wurde.</p>"
246
+ },
247
+ "routes": {
248
+ "title": "Routen – die Seiten",
249
+ "body": "<p>Jede Seite der Anwendung ist eine Route.</p><ul><li><b>Pfad</b> – die Adresse der Seite relativ zur Anwendung, ohne führenden Schrägstrich: <code>claims</code>, <code>claims/open</code>. Ein Segment <code>:name</code> ist ein Parameter, z. B. <code>claims/:id</code>.</li><li><b>Titel</b>, <b>Transloco-Id</b> und <b>Symbol</b> – wie die Seite benannt und dargestellt wird.</li><li><b>Zeigt</b> – was die Seite anzeigt: <code>WIDGETS</code>, <code>ENTITY</code> oder <code>DOCUMENT</code>. Die Felder darunter gelten nur für die gewählte Art.</li></ul><p>Routen sind eine flache Liste. Sie verschachteln sie nie von Hand: <code>claims</code> und <code>claims/open</code> sind zwei getrennte Einträge, und die Anwendungsoberfläche erkennt anhand ihrer Pfade, dass die eine unter der anderen liegt.</p>"
250
+ },
251
+ "widgets": {
252
+ "title": "Widgets – die Bausteine",
253
+ "body": "<p>Ein Widget ist ein fertiger Baustein der Benutzeroberfläche – ein Logo, ein Titel, ein Abstandhalter, eine Theme-Auswahl, ein Raster von Entitäten, ein Dokumentbetrachter und mehr. Widgets werden in Kopf- und Fußzeile verwendet sowie auf <code>WIDGETS</code>-Routen, wo sie untereinander gestapelt werden. Die Reihenfolge in der Liste ist die Reihenfolge auf dem Bildschirm.</p><ul><li><b>Id</b> – eindeutig innerhalb ihrer Seite oder ihres Bereichs, z. B. <code>widget-claims-grid</code>.</li><li><b>Typ</b> – um welches Widget es sich handelt; angeboten werden nur die Widgets, die in dieser Installation verfügbar sind.</li><li><b>Eigenschaften</b> – die Einstellungen des Widgets. Das Formular passt sich dem gewählten Typ an und zeigt nur die Einstellungen, die dieser Typ kennt.</li><li><b>Platzierung</b> – <code>STANDALONE</code>-Widgets werden dort angezeigt, wo sie aufgeführt sind. Ein Container-Widget (etwa ein Kartenraster) ordnet andere Widgets an, indem es deren Ids in seinen Eigenschaften aufführt; markieren Sie diese als <code>REFERENCED</code>, damit sie innerhalb des Containers erscheinen und nicht ein zweites Mal für sich allein.</li></ul>"
254
+ },
255
+ "entities": {
256
+ "title": "Entitäten – Datenseiten ohne Gestaltungsaufwand",
257
+ "body": "<p>Eine <code>ENTITY</code>-Route zeigt eine Art von Geschäftsdaten – Schadensfälle, Kunden, Bestellungen –, ohne dass eine Seite gestaltet werden muss. Setzen Sie den <b>Entitätsnamen</b> auf den Namen einer Entität, die im Designer unter <b>Entitäten</b> definiert ist, und das Framework erzeugt daraus anhand der Attribute der Entität eine durchsuchbare Liste und ein Detailformular, zusammen mit den für sie definierten Validierungsregeln. Von dort aus können Benutzer Datensätze öffnen, anlegen, bearbeiten und löschen.</p><p><b>Entitätsmodus</b> (<code>LIST</code> oder <code>DETAILS</code>) und <b>RSQL-Filter</b> (ein Vorfilter wie <code>status==OPEN</code>) werden mit der Route gespeichert, aber noch nicht angewendet: Die Seite öffnet derzeit immer die vollständige Liste.</p>"
258
+ },
259
+ "documents": {
260
+ "title": "Dokumente",
261
+ "body": "<p>Eine <code>DOCUMENT</code>-Route zeigt ein Dokument – Inhalt aus Text, Bildern, Datenwerten und Widgets, erstellt im Designer unter <b>Dokumente</b>. Setzen Sie den <b>Dokument-Slug</b> auf den Slug des Dokuments. Das Darstellen eines Dokuments als Seite ist noch nicht verfügbar, daher zeigt die Vorschau an dieser Stelle einen kurzen Hinweis; um Dokumentinhalte schon heute anzuzeigen, verwenden Sie eine <code>WIDGETS</code>-Route mit einem Widget <code>document-viewer</code>.</p>"
262
+ },
263
+ "modules": {
264
+ "title": "Module",
265
+ "body": "<p>Eine größere Anwendung lässt sich in <b>Module</b> aufteilen. Ein Modul wird separat unter <b>Module</b> erstellt und enthält eigene Routen; sein <b>Schlüssel</b> darf sich nicht mehr ändern, sobald das Modul verwendet wird. Eine Anwendung bindet ein Modul über eine <b>Modul-Einbindung</b> ein: Der <b>Modulschlüssel</b> benennt das Modul, und der <b>Basispfad</b> ist das Präfix, unter dem seine Routen erscheinen – bindet man ein Modul unter <code>claims</code> ein, wird aus seiner Route <code>open</code> die Route <code>claims/open</code>. Ein Modul kann keine weiteren Module einbinden; es gibt nur eine Ebene.</p>"
266
+ },
267
+ "roles": {
268
+ "title": "Rollen",
269
+ "body": "<p>Routen und Navigationseinträge können die <b>Rollen</b> nennen, die sie verwenden dürfen. Bleibt die Liste leer, darf jedes angemeldete Mitglied Ihrer Organisation sie verwenden. Rollen werden mit der Definition gespeichert, aber die Vorschau schränkt anhand von ihnen noch nichts ein.</p>"
270
+ },
271
+ "lifecycle": {
272
+ "title": "Speichern, Vorschau und Freigabe",
273
+ "body": "<p>Eine neue Anwendung beginnt als <b>Entwurf</b>. <b>Speichern</b> sichert Ihre Änderungen; der Reiter <b>Vorschau</b> zeigt dann die gespeicherte Definition genau so, wie die laufende Anwendung sie darstellt, einschließlich Theme – prüfen Sie sie dort, bevor Sie weitermachen. Die Benutzer sehen davon noch nichts: Die laufende Anwendung verwendet nur <b>freigegebene</b> Definitionen. Öffnen Sie den Bereich <b>Freigabe</b> des Designers, um alles zu sehen, was Sie geändert haben – diese Anwendung, ihre Module und die anderen Definitionen, die sie verwendet –, und <b>veröffentlichen</b> Sie alles zusammen; die gespeicherte Version wird zur <b>veröffentlichten Version</b>. Sie können danach weiter bearbeiten und speichern; die Benutzer sehen die Änderungen erst nach der nächsten Freigabe.</p>"
274
+ }
81
275
  },
82
- "publish": {
83
- "button": "Veröffentlichen",
84
- "tooltip": "Die gespeicherte Definition veröffentlichen: ihre Version wird zur veröffentlichten Version"
276
+ "app_context": {
277
+ "_self": "Kontext",
278
+ "name": "Name",
279
+ "entityName": "Entitätsname",
280
+ "parent": "Übergeordnet",
281
+ "basePath": "Basispfad",
282
+ "persist": "Merken",
283
+ "pickerSearchFields": "Suchfelder der Auswahl",
284
+ "pickerRecent": "Zuletzt in der Auswahl",
285
+ "displayLabel": "Anzeigetext",
286
+ "displayBadge": "Anzeige-Badge",
287
+ "displayExtra": "Zusatztext",
288
+ "confirmSwitchStates": "Zustände mit Rückfrage",
289
+ "_tooltips": {
290
+ "name": "Name und URL-Segment des Kontexts: Seiten liegen unter ctx/<name>/<id>.",
291
+ "entityName": "Der Entitätstyp, den man einmal wählt und in dem man dann arbeitet, z. B. Race.",
292
+ "parent": "Der Kontext, in dem dieser verschachtelt ist. Ein anderer Elternkontext hebt diesen auf.",
293
+ "basePath": "Pfad, unter dem die Seiten des Kontexts liegen, z. B. /conduct. Leer bedeutet Wurzel der Anwendung.",
294
+ "persist": "url merkt die Wahl nur in der Adresse; url-local-storage merkt sich zusätzlich den letzten auf diesem Gerät.",
295
+ "pickerSearchFields": "Die Attribute, die die Auswahl durchsucht. Leer bedeutet Titelattribut.",
296
+ "pickerRecent": "Wie viele zuletzt verwendete Einträge oben angeboten werden. Standard 3.",
297
+ "displayLabel": "Der Text in der Statusleiste mit {{Attribut}}-Platzhaltern. Leer bedeutet Titelattribut.",
298
+ "displayBadge": "Ein Attribut als Badge daneben; state steht für das Zustandsattribut.",
299
+ "displayExtra": "Ein zweiter, dezenter Text mit {{Attribut}}-Platzhaltern.",
300
+ "confirmSwitchStates": "Zustände, in denen das Verlassen der Entität erst nachfragt."
301
+ }
85
302
  }
86
303
  }
@@ -24,13 +24,68 @@
24
24
  "modules": "Modules",
25
25
  "tabs": {
26
26
  "preview": "{{ entity }} - preview"
27
- }
27
+ },
28
+ "translations": "Translations",
29
+ "translations_panel": {
30
+ "hint": "One file per supported language holds the texts of the application's own pages. Fill in the values under the keys your widgets name, and upload the zip (or a single file) again.",
31
+ "download": "Download all",
32
+ "upload": "Upload translations",
33
+ "save_first": "Save the application first; the texts belong to the saved application.",
34
+ "stored": "{{count}} keys stored",
35
+ "none_stored": "No texts are stored yet.",
36
+ "key": "Key",
37
+ "text": "Text"
38
+ },
39
+ "assets": "Assets",
40
+ "assets_panel": {
41
+ "hint": "Add files one by one; pictures and other files of the application itself. Widgets refer to a file as app:<path>.",
42
+ "path": "Reference",
43
+ "type": "Type",
44
+ "size": "Size",
45
+ "remove": "Remove",
46
+ "none": "No assets yet.",
47
+ "folder": "Folder",
48
+ "upload": "Upload files",
49
+ "save_first": "Save the application first; assets belong to the saved application."
50
+ },
51
+ "_tooltips": {
52
+ "id": "Unique within your organization and used verbatim in the application's URL. Short, lower-case and hyphenated, e.g. claims-app; avoid changing it later. — Guide: Application",
53
+ "name": "The application's name as users see it, e.g. in the app-title widget. — Guide: Application",
54
+ "translocoId": "Optional translation key; when set, it is shown instead of the Name in other languages. — Guide: Application",
55
+ "description": "A note for you and your fellow designers; users do not see it. — Guide: Application",
56
+ "status": "DRAFT while the definition has changes the organization has not released, PUBLISHED once released. Set by the system. — Guide: Save, preview and release",
57
+ "version": "Increases with every save. Set by the system. — Guide: Save, preview and release",
58
+ "publishedVersion": "The version users currently get. Changes only when the organization is released from the designer's Release section. — Guide: Save, preview and release",
59
+ "updatedAt": "When the definition was last saved. Set by the system.",
60
+ "materialTheme": "The colour palette of the whole application. processpuzzle is the brand look; the others also recolour header, sidenav, cards and buttons. — Guide: Theme",
61
+ "colorScheme": "Light, dark, or auto (follows the user's operating system). — Guide: Theme",
62
+ "logoUrl": "Address of the logo image shown by the app-logo widget. — Guide: Theme",
63
+ "faviconUrl": "Address of the small icon shown in the browser tab. — Guide: Theme",
64
+ "tokenOverrides": "Fine-tuning on top of the theme: a --pp-… colour token and its value, e.g. --pp-surface-sidenav = #0d1b2a. — Guide: Theme",
65
+ "preset": "Where the navigation sits: in a side panel on the left or right, or in the header row (top-nav). — Guide: Layout",
66
+ "sidenavMode": "side: panel beside the page · over: panel over the page · push: the page slides aside while the panel is open. — Guide: Layout",
67
+ "contentMaxWidth": "Maximum width of the pages as a CSS length, e.g. 1280px; empty means full width. — Guide: Layout",
68
+ "sidenavCollapsible": "Whether users can close the navigation panel. — Guide: Layout",
69
+ "sidenavOpenByDefault": "Whether the navigation panel starts open. — Guide: Layout",
70
+ "regions": "The frame around the pages: header, sidenav and footer, at most one of each. — Guide: Regions",
71
+ "routes": "The pages of the application, one row per page. Add them before the navigation items that point at them. — Guide: Routes",
72
+ "modules": "Separately authored parts of the application whose routes appear under a base path. — Guide: Modules",
73
+ "assets": "Files the application brings along, such as the pictures of its pages. A widget refers to one as app:<path>. — Guide: Applications",
74
+ "translations": "The texts of the application's own pages, such as the cards of its home page, one file per language. Keys are whatever the widgets name under their translocoPrefix. — Guide: Applications",
75
+ "contexts": "Entities the user selects once and then works inside. A page opts in with Requires Context."
76
+ },
77
+ "contexts": "Contexts"
28
78
  },
29
79
  "app_region": {
30
80
  "_self": "Region",
31
81
  "type": "Type",
32
82
  "navItems": "Nav Items",
33
- "widgets": "Widgets"
83
+ "widgets": "Widgets",
84
+ "_tooltips": {
85
+ "type": "header (top), sidenav (navigation panel) or footer (bottom). Each type can be used once. Statusbar (below the header) shows the active contexts. — Guide: Regions",
86
+ "navItems": "The menu entries of the sidenav. Used only by the sidenav region. — Guide: Navigation items",
87
+ "widgets": "The widgets of the header or footer, laid out in one row in this order. Use a spacer to push the following ones to the right. — Guide: Header"
88
+ }
34
89
  },
35
90
  "app_route": {
36
91
  "_self": "Route",
@@ -44,12 +99,35 @@
44
99
  "documentSlug": "Document Slug",
45
100
  "entityName": "Entity Name",
46
101
  "entityMode": "Entity Mode",
47
- "rsqlFilter": "Rsql Filter"
102
+ "rsqlFilter": "Rsql Filter",
103
+ "_tooltips": {
104
+ "path": "The page's address relative to the application, without a leading slash, e.g. claims/open. A :name segment is a parameter, e.g. claims/:id. — Guide: Routes",
105
+ "title": "The page's title. — Guide: Routes",
106
+ "translocoId": "Optional translation key of the title, shown instead of it in other languages. — Guide: Routes",
107
+ "icon": "A Material or FontAwesome icon name. — Guide: Routes",
108
+ "roles": "The roles allowed to open this page; empty means any signed-in member of your organization. Not enforced yet. — Guide: Roles",
109
+ "kind": "What the page shows: WIDGETS, ENTITY (generated list and form of an entity) or DOCUMENT. The fields below apply to the chosen kind only. — Guide: Routes",
110
+ "widgets": "WIDGETS only: the widgets of the page, shown one under the other in this order. — Guide: Widgets",
111
+ "documentSlug": "DOCUMENT only: the slug of the document to show. Not rendered yet. — Guide: Documents",
112
+ "entityName": "ENTITY only: the name of an entity defined under Entities; its list and form are generated for you. — Guide: Entities",
113
+ "entityMode": "ENTITY only: open on the list or on a record's details. Stored, not applied yet. — Guide: Entities",
114
+ "rsqlFilter": "ENTITY + LIST only: a pre-filter such as status==OPEN. Stored, not applied yet. — Guide: Entities",
115
+ "requiresContext": "Name of a context of this application. The page is then served below ctx/<name>/<id> and shows a \"Select a …\" prompt while none is active.",
116
+ "contextPath": "The attribute of the context's entity whose collection this page lists, e.g. zones. Needs Requires Context; the entity name is then the type of the items.",
117
+ "filterByContext": "Lists only the active entity's rows of this context, with a toggle to show all. Leave the Requires Context field empty: the page works without one."
118
+ },
119
+ "requiresContext": "Requires Context",
120
+ "contextPath": "Context Path",
121
+ "filterByContext": "Filter By Context"
48
122
  },
49
123
  "app_module_mount": {
50
124
  "_self": "Module Mount",
51
125
  "moduleKey": "Module Key",
52
- "basePath": "Base Path"
126
+ "basePath": "Base Path",
127
+ "_tooltips": {
128
+ "moduleKey": "The Key of a module authored under Modules. — Guide: Modules",
129
+ "basePath": "The prefix the module's routes appear under: base path claims turns the module's route open into claims/open. — Guide: Modules"
130
+ }
53
131
  },
54
132
  "app_nav_item": {
55
133
  "_self": "Nav Item",
@@ -59,14 +137,29 @@
59
137
  "icon": "Icon",
60
138
  "routePath": "Route",
61
139
  "roles": "Roles",
62
- "children": "Children"
140
+ "children": "Children",
141
+ "_tooltips": {
142
+ "id": "Unique identifier of the entry within the menu, e.g. nav-claims. — Guide: Navigation items",
143
+ "label": "The text of the menu entry. — Guide: Navigation items",
144
+ "translocoId": "Optional translation key of the label, shown instead of it in other languages. — Guide: Navigation items",
145
+ "icon": "A Material or FontAwesome icon name. — Guide: Navigation items",
146
+ "routePath": "The Path of the route this entry opens, exactly as written on the route. Leave empty to make the entry a group of its children. — Guide: Navigation items",
147
+ "roles": "The roles allowed to see this entry; empty means any signed-in member of your organization. Not enforced yet. — Guide: Roles",
148
+ "children": "The entries under a group entry. Only meaningful when Route is empty. — Guide: Navigation items"
149
+ }
63
150
  },
64
151
  "app_widget": {
65
152
  "_self": "Widget",
66
153
  "id": "Id",
67
154
  "type": "Type",
68
155
  "props": "Props",
69
- "placement": "Placement"
156
+ "placement": "Placement",
157
+ "_tooltips": {
158
+ "id": "Unique within its page or region, e.g. widget-claims-grid. A container widget refers to other widgets by this id. — Guide: Widgets",
159
+ "type": "Which widget this is; only the widgets available in this installation are offered. — Guide: Widgets",
160
+ "props": "The widget's settings. The form adapts to the chosen type. — Guide: Widgets",
161
+ "placement": "STANDALONE: shown where it is listed. REFERENCED: shown only inside the container widget that lists its id. — Guide: Widgets"
162
+ }
70
163
  },
71
164
  "module_definition": {
72
165
  "_self": "Module",
@@ -77,10 +170,134 @@
77
170
  "translocoScope": "Transloco Scope",
78
171
  "version": "Version",
79
172
  "updatedAt": "Updated At",
80
- "routes": "Routes"
173
+ "routes": "Routes",
174
+ "translations": "Translations",
175
+ "translations_panel": {
176
+ "hint": "One file per supported language holds every translatable text of the module, and the texts its widgets name under the module's scope. Translate the values, keep the keys, and upload the zip (or a single file) again.",
177
+ "language": "Language",
178
+ "translated": "Translated",
179
+ "download": "Download files",
180
+ "upload": "Upload translations",
181
+ "save_first": "Save the module first; the files are prepared from the saved module.",
182
+ "stored": "{{count}} keys stored",
183
+ "additional": "{{count}} widget texts kept",
184
+ "missing": "{{count}} keys missing",
185
+ "untranslated": "{{count}} still equal to the original"
186
+ },
187
+ "assets": "Assets",
188
+ "assets_panel": {
189
+ "hint": "Add files one by one; a markdown file can link the others relatively. Widgets refer to a file as module:<path>.",
190
+ "path": "Reference",
191
+ "type": "Type",
192
+ "size": "Size",
193
+ "remove": "Remove",
194
+ "none": "No assets yet.",
195
+ "folder": "Folder",
196
+ "upload": "Upload files",
197
+ "save_first": "Save the module first; assets belong to the saved module."
198
+ },
199
+ "_tooltips": {
200
+ "id": "Unique within your organization; applications mount the module by this key. Must not change once the module is in use. — Guide: Modules",
201
+ "name": "The module's name. — Guide: Modules",
202
+ "translocoId": "Optional translation key of the name. — Guide: Modules",
203
+ "description": "A note for you and your fellow designers. — Guide: Modules",
204
+ "translocoScope": "The scope the module's translations are loaded under; empty means the Key. — Guide: Modules",
205
+ "version": "Increases with every save. Set by the system.",
206
+ "updatedAt": "When the module was last saved. Set by the system.",
207
+ "routes": "The module's pages. Their paths are relative to the base path the module is mounted at. — Guide: Modules",
208
+ "translations": "Download the module’s translation files, translate them off-line and upload them again. — Guide: Modules",
209
+ "assets": "Files the module brings along — markdown pages, images. A widget refers to one as module:<path>. — Guide: Modules"
210
+ }
211
+ },
212
+ "concepts": {
213
+ "title": "How a dynamic application is put together",
214
+ "intro": "An <b>Application</b> in ProcessPuzzle is not programmed — it is <b>described</b>. Everything you enter here (the frame, the menu, the pages and what each page shows) is stored as data, and the application shell builds the running application from that description at run time. Changing the application means editing its definition and publishing it again; nothing has to be rebuilt or redeployed.",
215
+ "assembling": {
216
+ "title": "Assembling your application, step by step",
217
+ "body": "<ol><li><b>Create the application</b> — give it an Id and a Name.</li><li><b>Choose its look</b> — a Material theme, a colour scheme and a layout preset.</li><li><b>Add the pages</b> — one <b>Route</b> per page, and decide what each one renders: widgets, an entity or a document.</li><li><b>Build the frame</b> — add the <b>header</b>, <b>sidenav</b> and <b>footer</b> regions; fill the header and footer with widgets and the sidenav with navigation items pointing at your routes.</li><li><b>Check it</b> on the <b>Preview</b> tab.</li><li><b>Release</b> it from the designer's <b>Release</b> section, so that users get the new version.</li></ol><p>Routes come before navigation on purpose: a navigation item points at a route by its path, so it is easiest to write once the route exists.</p>"
218
+ },
219
+ "application": {
220
+ "title": "Application",
221
+ "body": "<p>The top-level record that holds everything else. Its <b>Id</b> is unique within your organization and is used verbatim in the application's URL, so pick a short, lower-case, hyphenated value such as <code>claims-app</code> and avoid changing it later. The <b>Name</b> is what users see, for example in the <code>app-title</code> widget; the optional <b>Transloco Id</b> is a translation key used instead of the Name when the application is shown in other languages. The <b>Description</b> is for you and your fellow designers.</p>"
222
+ },
223
+ "theme": {
224
+ "title": "Theme",
225
+ "body": "<p>Decides the colours of the whole application.</p><ul><li><b>Material Theme</b> — <code>processpuzzle</code> is the brand look and the default; the others are Angular Material palettes, and each of them recolours the header, sidenav, cards and buttons as well.</li><li><b>Color Scheme</b> — light, dark, or auto (follows the user's operating system).</li><li><b>Logo Url</b> and <b>Favicon Url</b> — the images shown by the <code>app-logo</code> widget and in the browser tab.</li><li><b>Token Overrides</b> — fine-tuning on top of the theme: a <code>--pp-…</code> colour token and its value, e.g. <code>--pp-surface-sidenav</code> → <code>#0d1b2a</code>.</li></ul><p>What you choose here is the application's <i>default</i>. If you place a <code>themes-button</code> widget in the header, each user can pick a theme of their own, which is then remembered for them.</p>"
226
+ },
227
+ "layout": {
228
+ "title": "Layout",
229
+ "body": "<p>Decides where the regions sit around the pages.</p><ul><li><b>Layout Preset</b> — <code>sidenav-left</code> or <code>sidenav-right</code> put the navigation in a side panel; <code>top-nav</code> puts it in the header row instead.</li><li><b>Sidenav Mode</b> — <code>side</code> keeps the panel beside the page, <code>over</code> lays it over the page, <code>push</code> slides the page aside while the panel is open.</li><li><b>Sidenav Collapsible</b> / <b>Sidenav Open By Default</b> — whether users can close the panel, and whether it starts open.</li><li><b>Content Max Width</b> — a CSS length such as <code>1280px</code> that keeps pages readable on wide screens; empty means full width.</li></ul>"
230
+ },
231
+ "regions": {
232
+ "title": "Regions — the frame around the pages",
233
+ "body": "<p>A region is a fixed part of the screen that stays in place while users move between pages. There are three types, and an application has at most one of each: <b>header</b> (top), <b>sidenav</b> (the navigation panel) and <b>footer</b> (bottom). Header and footer contain <b>widgets</b>; the sidenav contains <b>navigation items</b>. The area in the middle is not a region: it shows whichever <b>route</b> the user is on. A region you leave out simply does not appear.</p>"
234
+ },
235
+ "header": {
236
+ "title": "Header",
237
+ "body": "<p>The bar across the top of the application. Its widgets are laid out in one row, left to right, in the order they are listed. Typical content is <code>app-logo</code> and <code>app-title</code> on the left, a <code>spacer</code> that pushes everything after it to the right, and a <code>themes-button</code> at the far right. The logo and title are ordinary widgets that read the application's Logo Url and Name, so you decide whether and where they appear. With the <code>top-nav</code> layout the navigation items are shown in the header row as well.</p>"
238
+ },
239
+ "footer": {
240
+ "title": "Footer",
241
+ "body": "<p>The bar across the bottom of the application. It works exactly like the header — a row of widgets in the order listed, with a <code>spacer</code> to push them apart — and is a good place for copyright notes, contact details or links. It stays at the bottom of the screen even when a page is short.</p>"
242
+ },
243
+ "navigation": {
244
+ "title": "Navigation items",
245
+ "body": "<p>The entries of the menu, added to the <b>sidenav</b> region. Each one has a <b>Label</b> (optionally translated through its <b>Transloco Id</b>), an <b>Icon</b> (a Material or FontAwesome icon name) and a <b>Route</b>: the <b>Path</b> of the route it opens, written exactly as on the route, e.g. <code>claims/open</code>. An item without a route is a <b>group</b>: it opens and closes the items you add under its <b>Children</b>, so menus can be nested. A path that names no route yet is only a warning — it may belong to a module that has not been written yet.</p>"
246
+ },
247
+ "routes": {
248
+ "title": "Routes — the pages",
249
+ "body": "<p>Every page of the application is a route.</p><ul><li><b>Path</b> — the page's address relative to the application, without a leading slash: <code>claims</code>, <code>claims/open</code>. A <code>:name</code> segment is a parameter, e.g. <code>claims/:id</code>.</li><li><b>Title</b>, <b>Transloco Id</b> and <b>Icon</b> — how the page is named and shown.</li><li><b>Renders</b> — what the page shows: <code>WIDGETS</code>, <code>ENTITY</code> or <code>DOCUMENT</code>. The fields below it apply to the chosen kind only.</li></ul><p>Routes are a flat list. You never nest them by hand: <code>claims</code> and <code>claims/open</code> are two separate entries, and the shell works out from their paths that one lies under the other.</p>"
250
+ },
251
+ "widgets": {
252
+ "title": "Widgets — the building blocks",
253
+ "body": "<p>A widget is a ready-made piece of user interface — a logo, a title, a spacer, a theme picker, a grid of entities, a document viewer and more. Widgets are used in the header and the footer, and on <code>WIDGETS</code> routes, where they are stacked one under the other. The order in the list is the order on the screen.</p><ul><li><b>Id</b> — unique within its page or region, e.g. <code>widget-claims-grid</code>.</li><li><b>Type</b> — which widget it is; only the widgets available in this installation are offered.</li><li><b>Props</b> — the widget's settings. The form adapts to the chosen type and shows only the settings that type understands.</li><li><b>Placement</b> — <code>STANDALONE</code> widgets are shown where they are listed. A container widget (such as a card grid) arranges other widgets by listing their ids in its props; mark those as <code>REFERENCED</code>, so they appear inside the container and not a second time on their own.</li></ul>"
254
+ },
255
+ "entities": {
256
+ "title": "Entities — data pages without design work",
257
+ "body": "<p>An <code>ENTITY</code> route shows one kind of business data — claims, customers, orders — without any page having to be designed. Set <b>Entity Name</b> to the name of an entity defined under <b>Entities</b> in the designer, and the framework generates a searchable list and a details form for it from the entity's attributes, together with the validation rules defined for it. From there users open, create, edit and delete records.</p><p><b>Entity Mode</b> (<code>LIST</code> or <code>DETAILS</code>) and <b>Rsql Filter</b> (a pre-filter such as <code>status==OPEN</code>) are stored with the route but not applied yet: the page currently always opens on the full list.</p>"
258
+ },
259
+ "documents": {
260
+ "title": "Documents",
261
+ "body": "<p>A <code>DOCUMENT</code> route shows a document — content composed of text, images, data values and widgets, authored in the <b>Documents</b> designer. Set <b>Document Slug</b> to the slug of the document. Rendering a document as a page is not available yet, so the Preview shows a short notice in its place; to show document content today, use a <code>WIDGETS</code> route with a <code>document-viewer</code> widget.</p>"
262
+ },
263
+ "modules": {
264
+ "title": "Modules",
265
+ "body": "<p>A larger application can be split into <b>modules</b>. A module is authored separately, under <b>Modules</b>, and holds routes of its own; its <b>Key</b> must not change once the module is in use. An application includes a module through a <b>Module Mount</b>: <b>Module Key</b> names the module, and <b>Base Path</b> is the prefix its routes appear under — mounting a module under <code>claims</code> turns its route <code>open</code> into <code>claims/open</code>. A module cannot mount other modules; one level is all there is.</p>"
266
+ },
267
+ "roles": {
268
+ "title": "Roles",
269
+ "body": "<p>Routes and navigation items can name the <b>Roles</b> allowed to use them. Leaving the list empty means any signed-in member of your organization. Roles are stored with the definition, but the Preview does not restrict anything by them yet.</p>"
270
+ },
271
+ "lifecycle": {
272
+ "title": "Save, preview and release",
273
+ "body": "<p>A new application starts as a <b>Draft</b>. <b>Save</b> stores your changes; the <b>Preview</b> tab then shows the saved definition exactly as the running application renders it, theme included — check it there before going further. Users get none of it yet: the running application uses only <b>released</b> definitions. Open the designer's <b>Release</b> section to see everything you changed — this application, its modules and the other definitions it uses — and <b>Publish</b> them together; the saved version becomes the <b>Published Version</b>. You can keep editing and saving afterwards; users see the changes only once you release again.</p>"
274
+ }
81
275
  },
82
- "publish": {
83
- "button": "Publish",
84
- "tooltip": "Publish the saved definition: its version becomes the published version"
276
+ "app_context": {
277
+ "_self": "Context",
278
+ "name": "Name",
279
+ "entityName": "Entity Name",
280
+ "parent": "Parent",
281
+ "basePath": "Base Path",
282
+ "persist": "Persist",
283
+ "pickerSearchFields": "Picker Search Fields",
284
+ "pickerRecent": "Picker Recent",
285
+ "displayLabel": "Display Label",
286
+ "displayBadge": "Display Badge",
287
+ "displayExtra": "Display Extra",
288
+ "confirmSwitchStates": "Confirm Switch States",
289
+ "_tooltips": {
290
+ "name": "The context's name and URL segment: its pages are served below ctx/<name>/<id>.",
291
+ "entityName": "The entity type the user picks once and then works inside, e.g. Race.",
292
+ "parent": "The context this one is nested in. Choosing another parent clears this context.",
293
+ "basePath": "The path the context's pages are mounted under, e.g. /conduct. Empty means the application root.",
294
+ "persist": "url keeps the choice in the address only; url-local-storage also remembers the last one on this device.",
295
+ "pickerSearchFields": "The attributes the picker searches. Empty means the title attribute.",
296
+ "pickerRecent": "How many recently used entries the picker offers on top. Default 3.",
297
+ "displayLabel": "The text shown in the status bar, with {{attribute}} placeholders. Empty means the title attribute.",
298
+ "displayBadge": "An attribute shown as a badge next to it; state stands for the state attribute.",
299
+ "displayExtra": "A second, quieter text, with {{attribute}} placeholders.",
300
+ "confirmSwitchStates": "States in which leaving the entity asks for confirmation first."
301
+ }
85
302
  }
86
303
  }