Index

src/app/core/basic-datatypes/date/date.static.ts

_dateFormat
Type : unknown
Default value : signal("dd.MM.yyyy")
_datepickerFormat
Type : unknown
Default value : signal("DD.MM.YYYY")
_dateTimeFormat
Type : unknown
Default value : signal("dd.MM.yyyy HH:mm")
datepickerFormat
Type : Signal<string>
Default value : _datepickerFormat.asReadonly()

Current Moment.js format for Material Datepicker as a readonly signal (e.g., "DD.MM.YYYY"). We have to use different format for datepicker because Angular DatePipe and Moment.js use different format syntax: e.g. dd.MM.yyyy in DatePipe shows as 22.01.2026, but in Moment.js it would show as Th.01.2026.

defaultDateFormat
Type : Signal<string>
Default value : _dateFormat.asReadonly()

Current default shortDate format as a readonly signal (Angular DatePipe format, e.g., "dd.MM.yyyy")

defaultDateTimeFormat
Type : Signal<string>
Default value : _dateTimeFormat.asReadonly()

Current default datetime format as a readonly signal (Angular DatePipe format, e.g., "dd.MM.yyyy HH:mm")

src/app/core/database/pouchdb/pouchdb-errors.ts

ABORTED_REQUEST_NAME
Type : string
Default value : "AbortError"

PouchDB's name of a request to the server cut off by our timeout (see RemotePouchDatabase).

LOCAL_STORAGE_ERROR_NAMES
Type : unknown
Default value : new Set([ // PouchDB's "idb" adapter could not open or use IndexedDB "indexed_db_went_bad", ])

What counts as the device's local database being broken (local-storage): nothing in our code to fix per occurrence, and once it happens every later database access of the page load fails as well (see report-once.ts).

LOCAL_STORAGE_ERROR_PATTERNS
Type : []
Default value : [ // IndexedDB closed underneath PouchDB (e.g. by another tab upgrading it) "database connection is closing", // the IndexedDB has another schema than the adapter expects "object store was not found", 'Incorrect adapter: you should specify the "idb" adapter', // Chrome failing to open the IndexedDB files on disk "Internal error opening backing store", ]
PROGRAMMING_ERROR_NAMES
Type : unknown
Default value : new Set([ "TypeError", "RangeError", "ReferenceError", "SyntaxError", ])

Programming errors: in a local-storage call they still point to a bug (e.g. a document too deeply nested to store), not to a broken database.

WRITE_CONFLICT_TEXT
Type : string
Default value : "document update conflict"

PouchDB's wording of a rejected write, for errors that lost their 409 status.

src/app/core/database/pouchdb/indexeddb-sequence-check.ts

ABORTED_TRANSACTION_REASON
Type : string
Default value : "transaction was aborted"

PouchDB's reason for a write whose IndexedDB transaction was aborted, whatever the cause.

DOC_STORE
Type : string
Default value : "docs"

The indexeddb adapter's object stores, metadata record and index (see pouchdb-adapter-indexeddb).

META_RECORD_ID
Type : string
Default value : "meta"
META_STORE
Type : string
Default value : "meta"
SEQ_INDEX
Type : string
Default value : "seq"

src/app/core/permissions/permission-types.ts

actions
Type : unknown
Default value : [...CRUD_ACTIONS, "manage"] as const

The list of action strings that can be used for permissions

ADMIN_APP_ROLE
Type : string
Default value : "admin_app"

The realm role that grants access to the administration features, as checked by the admin routes' UserRoleGuard configuration.

CRUD_ACTIONS
Type : unknown
Default value : ["read", "create", "update", "delete"] as const

The individual CRUD actions, in the order they are displayed as columns of the permission UIs.

DEFAULT_SECTION_KEY
Type : string
Default value : "_default"

Section keys in DatabaseRules that carry special semantics instead of mapping a user role. The underscore prefix marks them as internal so they cannot collide with a realm role name.

PUBLIC_SECTION_KEY
Type : string
Default value : "_public"
RESERVED_ROLE_PREFIX
Type : string
Default value : "_"

A user role starting with this prefix is reserved and never resolved.

RESERVED_RULE_CONFIG_KEYS
Type : miscellaneous
Default value : [ DEFAULT_SECTION_KEY, PUBLIC_SECTION_KEY, ]

All section keys that must never be resolved as if they were user role names, even if a realm role with the same name exists.

A new key added here does not automatically stop inheriting the "_default" rules; see inheritsDefaultRules.

SYSTEM_DEFAULT_RULE_REASON
Type : miscellaneous
Default value : "[system-default]"

Marker written into a rule's reason by the backend for rules it manages itself to guarantee a baseline. Such rules must not be rewritten by an admin UI.

src/app/core/language/active-locale.ts

activeLocale
Type : string
Default value : DEFAULT_LANGUAGE
validLocaleIds
Type : readonly string[]
Default value : AVAILABLE_LOCALE_IDS

src/app/features/attendance/demo-data/demo-activity-generator.service.ts

ACTIVITY_TYPES
Type : unknown
Default value : [ defaultInteractionTypes.find((t) => t.id === "SCHOOL_CLASS"), defaultInteractionTypes.find((t) => t.id === "COACHING_CLASS"), ].filter((t): t is InteractionType => t !== undefined)

src/app/features/matching-entities/add-default-matching-view.ts

addDefaultMatchingView
Type : ConfigMigration
Default value : (key, configPart) => { if (configPart?.["_id"] !== "Config:CONFIG_ENTITY" || !configPart?.["data"]) { // add only at top-level of config return configPart; } if (!configPart["data"]["view:matching"]) { configPart["data"]["view:matching"] = { component: "MatchingEntities" }; } return configPart; }

Add default view:matching MatchingEntities config to avoid having to add this fixed view to every deployment's config

src/app/child-dev-project/notes/add-default-note-views.ts

addDefaultNoteViews
Type : ConfigMigration
Default value : (key, configPart) => { // add only at top-level of config if (configPart?.["_id"] === "Config:CONFIG_ENTITY" && configPart?.["data"]) { addDefaultNoteViewsToConfig(configPart["data"]); } return configPart; }

Add default Note view configs (list and details) to avoid breaking note views with a default config from AdminModule

defaultNoteListView
Type : object
Default value : { component: "EntityList", config: { entityType: "Note", title: $localize`:title of the note list view:Notes & Reports`, clickMode: "popup-details", columns: ["date", "subject", "category", "authors", "relatedEntities"], filters: [ { id: "warningLevel" }, { id: "date", default: 1 }, { id: "category" }, { id: "authors" }, ], }, }

src/app/features/reporting/add-default-reporting-view.ts

addDefaultReportingView
Type : ConfigMigration
Default value : (key, configPart) => { if (configPart?.["_id"] !== "Config:CONFIG_ENTITY" || !configPart?.["data"]) { // add only at top-level of config return configPart; } if (!configPart["data"]["view:report"]) { configPart["data"]["view:report"] = { component: "Reporting" }; } return configPart; }

Add default view:report Reporting config to avoid having to add this fixed view to every deployment's config

src/app/features/todos/add-default-todo-views.ts

addDefaultTodoViews
Type : ConfigMigration
Default value : (key, configPart) => { if (configPart?.["_id"] !== "Config:CONFIG_ENTITY" || !configPart?.["data"]) { // add only at top-level of config return configPart; } const configData = configPart["data"]; const viewConfigKey = `view:${Todo.route.substring(1) /* remove leading slash */}`; // List View if (!configData[viewConfigKey]) { // add standard list view configData[viewConfigKey] = JSON.parse(JSON.stringify(defaultTodoListView)); } else { // add prebuilt filter to existing list view const existingFilters = configData[viewConfigKey].config.filters || []; if (!existingFilters.some((f) => f.id === todoDueStatusFilter.id)) { // reference the prebuilt filter only, its options are provided by the app existingFilters.push({ id: todoDueStatusFilter.id, type: todoDueStatusFilter.type, }); } configData[viewConfigKey].config.filters = existingFilters; } // Details View if (!configData[viewConfigKey + "/:id"]) { configData[viewConfigKey + "/:id"] = JSON.parse( JSON.stringify(defaultTodoDetailsView), ); } return configPart; }

Add default view:note/:id NoteDetails config to avoid breaking note details with a default config from AdminModule

defaultTodoDetailsView
Type : object
Default value : { component: "EntityDetails", config: { entityType: Todo.ENTITY_TYPE, panels: [ { title: "Overview", components: [ { title: "", component: "Form", config: { fieldGroups: [ { fields: [ "subject", "deadline", "startDate", "description", "assignedTo", "relatedEntities", "repetitionInterval", "completed", ], }, ], }, }, ], }, ], }, }
defaultTodoListView
Type : object
Default value : { component: "EntityList", config: { entityType: "Todo", columns: [ "deadline", "subject", "assignedTo", "startDate", "relatedEntities", "completed", ], filters: [ { id: "assignedTo", default: PLACEHOLDERS.CURRENT_USER }, { id: "todo-due-status", type: "prebuilt" }, ], defaultSort: { active: "deadline", direction: "asc" }, clickMode: "popup-details", showInactive: true, }, }
todoDueStatusFilter
Type : PrebuiltFilterConfig<Todo>
Default value : { id: "todo-due-status", type: "prebuilt", label: $localize`Tasks due`, options: [ { key: "current", label: $localize`:Filter-option for todos:Currently Active`, filter: { $and: [ TODO_NOT_COMPLETED_FILTER, { $or: [ { startDate: { $exists: false, }, }, { startDate: { $lte: moment().format("YYYY-MM-DD"), $gt: "", }, }, { deadline: { $lte: moment().format("YYYY-MM-DD"), $gt: "", }, }, ], }, ], } as DataFilter<Todo>, }, { key: "overdue", label: $localize`:Filter-option for todos:Overdue`, filter: { $and: [ TODO_NOT_COMPLETED_FILTER, { deadline: { $lte: moment().format("YYYY-MM-DD"), $gt: "" } }, ], } as DataFilter<Todo>, }, { key: "completed", label: $localize`:Filter-option for todos:Completed`, filter: TODO_COMPLETED_FILTER, }, { key: "open", label: $localize`:Filter-option for todos:All Open`, filter: TODO_NOT_COMPLETED_FILTER, }, { key: "any", label: $localize`Any`, filter: {} }, ], singleSelectOnly: true, default: "current", }

Special filter with pre-defined categories of Todo items.

src/app/core/admin/admin-entity-list/admin-entity-list-settings.ts

ADMIN_ENTITY_LIST_SETTINGS
Type : miscellaneous
Default value : new InjectionToken<string[]>( "AdminEntityListSettings", )

Further settings for the admin editor of a list view, provided by feature modules as the name of a component in the ComponentRegistry:

Example :
{ provide: ADMIN_ENTITY_LIST_SETTINGS, useValue: "MyFeatureListSettings", multi: true }

The editor shows each of them above the filters and sets these inputs of the component:

  • entityConstructor: the record type of the list;
  • config: the EntityListConfig of the list, which the component updates in place (as the other parts of the editor do).

src/app/features/api-client/api-client.service.ts

API_CLIENT_ID_PREFIX
Type : miscellaneous
Default value : "api-"

Every API client's client id starts with this (the backend only manages such clients).

src/app/core/config/config.app-initializer.ts

APP_INITIALIZER_PROPAGATE_CONFIG_UPDATES
Type : unknown
Default value : provideAppInitializer( () => { const configService = inject(ConfigService); const routerService = inject(RouterService); const entityConfigService = inject(EntityConfigService); const router = inject(Router); const destroyRef = inject(DestroyRef); const componentRegistry = inject(ComponentRegistry); // Re-trigger services that depend on the config when something changes configService.configUpdates .pipe(takeUntilDestroyed(destroyRef)) // especially for tests, this ensures cleanup .subscribe(() => { routerService.initRouting(); entityConfigService.setupEntitiesFromConfig(); const url = router.parseUrl(router.url); router.navigateByUrl(url, { skipLocationChange: true }); // Preload all dynamic component chunks in the background for offline availability preloadDynamicComponents(componentRegistry, destroyRef); }); }, )
preloadScheduled
Type : unknown
Default value : false

Preload all components registered in the ComponentRegistry so their JS chunks are cached by the service worker and available offline even before the user has visited every page.

Runs once in an idle callback to avoid blocking the main thread after login.

src/app/features/attendance/attendance.module.ts

ATTENDANCE_DOWNLOAD_GROUP
Type : EntityActionGroup
Default value : { id: "attendance-downloads", label: $localize`:entity context menu:Download attendance lists`, icon: "download", }

src/app/features/attendance/model/attendance-status.ts

ATTENDANCE_STATUS_CONFIG_ID
Type : string
Default value : "attendance-status"

the id through which the available attendance status types can be loaded from the ConfigService.

NullAttendanceStatusType
Type : AttendanceStatusType
Default value : { id: "", label: "", shortName: "", countAs: AttendanceLogicalStatus.IGNORE, }

Null object representing an unknown attendance status.

This allows easier handling of attendance status logic because exceptional checks for undefined are not necessary.

src/app/features/attendance/attendance-components.ts

attendanceComponents
Type : ComponentTuple[]
Default value : [ [ "AttendanceManager", () => import("./add-day-attendance/attendance-manager/attendance-manager.component").then( (c) => c.AttendanceManagerComponent, ), ], [ "AddDayAttendance", () => import("./add-day-attendance/roll-call-setup/roll-call-setup.component").then( (c) => c.RollCallSetupComponent, ), ], [ "RollCall", () => import("./add-day-attendance/roll-call/roll-call.component").then( (c) => c.RollCallComponent, ), ], [ "GroupedChildAttendance", () => import("./analysis/grouped-child-attendance/grouped-child-attendance.component").then( (c) => c.GroupedChildAttendanceComponent, ), ], [ "ActivityAttendanceSection", () => import("./analysis/activity-attendance-section/activity-attendance-section.component").then( (c) => c.ActivityAttendanceSectionComponent, ), ], [ "AttendanceWeekDashboard", () => import("./attendance-week-dashboard/attendance-week-dashboard.component").then( (c) => c.AttendanceWeekDashboardComponent, ), ], [ "EditLegacyAttendance", () => import("./deprecated/edit-legacy-attendance.component").then( (c) => c.EditLegacyAttendanceComponent, ), ], [ "EditAttendance", () => import("./edit-attendance/edit-attendance.component").then( (c) => c.EditAttendanceComponent, ), ], [ "DisplayAttendance", () => import("./display-attendance/display-attendance.component").then( (c) => c.DisplayAttendanceComponent, ), ], [ "AttendanceWeekDashboardSettings", () => import("./attendance-week-dashboard/attendance-week-dashboard-settings.component/attendance-week-dashboard-settings.component").then( (c) => c.AttendanceWeekDashboardSettingsComponent, ), ], ]

src/app/features/change-history/audit-filter.ts

AUDIT_BASE_FILTER
Type : miscellaneous
Default value : { // naming the sort field keeps the query self-describing: it says which index // answers it. Not strictly required - the data source pins `use_index`, and // CouchDB serves the sort from it even with the field unconstrained - so this // is documentation more than necessity timestamp: { $gt: null }, // a baseline is not a change but a snapshot the system captured, written with // the same timestamp and author as the first real change to that record - // listing it would duplicate that change's row and attribute the record's // whole field list to whoever happened to edit it first. // `$ne` rather than a list of the wanted operations, so an operation added // later shows up instead of being silently dropped. operation: { $ne: BASELINE_OPERATION }, } as DataFilter<AuditRecord>

The part of the change log's query that is not the user's to choose.

Applied under every filter selection rather than as one of the options, so clearing the filters cannot widen it.

RANGE_END
Type : string
Default value : "ï¿°"

sorts after every string, so it closes an _id prefix range

src/app/features/change-history/model/audit-record.ts

AUDIT_ID_TRAILING_PARTS
Type : number
Default value : 4

How many :-separated parts trail the changed record's id in an audit record's id, which the backend builds as AuditRecord:<record id>:<ISO timestamp>:<rev>.

Four, not two: an ISO timestamp carries two colons of its own (2026-08-01T10:00:00.000Z), so it accounts for three of them, plus one for the revision.

src/app/features/change-history/audit-reference-index.ts

AUDIT_REFERENCE_INDEX_ID
Type : string
Default value : "audit-references"

design document id, without the _design/ prefix

AUDIT_REFERENCE_MAP
Type : unknown
Default value : `function (doc) { if (!doc || !doc.timestamp || doc.operation === "${BASELINE_OPERATION}") { return; } // "Type:id" with no whitespace; the leading letter rules out ISO timestamps var ID_PATTERN = /^[A-Za-z][A-Za-z0-9_]*:[^\\s]+$/; // URI schemes that match the pattern but are never entity references. // Keys are prefixed, as are those of "found" below, so that a lookup can // never hit an inherited Object.prototype member ("constructor:1" would // otherwise read as a known scheme and be dropped). var NON_ENTITY_SCHEMES = { $http: 1, $https: 1, $ftp: 1, $file: 1, $data: 1, $blob: 1, $mailto: 1, $tel: 1, $urn: 1, $ws: 1, $wss: 1 }; // guards against one pathological document (a large config, a data URI) // bloating the index or stalling the indexer var MAX_REFS = 500; var MAX_DEPTH = 12; var MAX_ID_LENGTH = 200; // keys are prefixed so that no value can collide with an Object.prototype member var found = {}; var count = 0; function add(value) { if (count >= MAX_REFS) { return; } if (typeof value !== "string" || value.length > MAX_ID_LENGTH) { return; } if (!ID_PATTERN.test(value) || value.indexOf("//") >= 0) { return; } var scheme = value.substring(0, value.indexOf(":")).toLowerCase(); if (NON_ENTITY_SCHEMES["$" + scheme]) { return; } if (!found["$" + value]) { found["$" + value] = true; count++; } } function walk(value, depth) { if (count >= MAX_REFS || depth > MAX_DEPTH) { return; } if (typeof value === "string") { add(value); } else if (value && typeof value === "object") { for (var key in value) { if (Object.prototype.hasOwnProperty.call(value, key)) { walk(value[key], depth + 1); } } } } add(doc.entityId); walk(doc.diff, 0); for (var id in found) { emit([id.substring(1), doc.timestamp]); } }`

Emits [referencedId, timestamp] for every entity id an audit record touches.

"Touches" is both directions: the changed record itself (entityId) and every entity id appearing anywhere in the recorded diff — a create snapshot, or an update delta, which carries the removed value alongside the added one, so a reference that was taken away is found just as well as one that was added.

BASELINE_OPERATION records are skipped, as they are in the log's other query: a baseline is a snapshot rather than a change, and indexing its full field list would report every record that merely held a reference at that moment as having changed it — for a demo dataset, one child's participation in hundreds of past events.

The ids are matched syntactically (Type:id), since a view has no access to the entity schema. That is deliberately permissive: a spurious key is only ever dead weight in the index (nobody searches for mailto:…), while a missed one would silently drop a real result. Entity types created through the admin UI are camelCase (see generateIdFromLabel), so the type part must not be restricted to PascalCase.

A delete contributes only its own entityId: a deletion replicates as a tombstone stripped of content, so the record's references are simply not in the diff.

AUDIT_REFERENCE_VIEW
Type : unknown
Default value : `${AUDIT_REFERENCE_INDEX_ID}/by_reference`

the query name to pass to Database.query()

src/app/core/language/available-locales.ts

AVAILABLE_LOCALE_IDS
Type : readonly string[]
Default value : AVAILABLE_LOCALES.map( (locale) => locale.id, )
AVAILABLE_LOCALES
Type : unknown
Default value : [ { id: "en-US", label: "English (en)" }, { id: "de", label: "Deutsch / German (de)" }, { id: "fr", label: "Français / French (fr)" }, { id: "es", label: "Español / Spanish (es)" }, { id: "ar", label: "العربية / Arabic (ar)" }, ] as const

The locales the app can be used in.

Separate from languages.ts because that builds a ConfigurableEnum, which extends Entity - and Entity needs the locale ids itself.

src/app/core/language/languages.ts

availableLocales
Type : miscellaneous
Default value : new ConfigurableEnum(LOCALE_ENUM_ID, [ ...AVAILABLE_LOCALES, ])

A readonly array of all locales available

LOCALE_ENUM_ID
Type : string
Default value : "locales"

src/app/features/change-history/change-history.types.ts

BASELINE_NOTE
Type : unknown
Default value : $localize`:Change history baseline note:Record state captured when change logging was enabled. Edits made before this point aren't recorded.`

Explanation for the synthetic "initial snapshot" entry, shown both inline in its diff and as the badge tooltip (single source of truth).

BASELINE_OPERATION
Type : miscellaneous
Default value : "baseline"

The backend operation of a baseline record: the full-snapshot anchor written alongside the first audited change of a pre-existing record, so that record's history has a starting state to replay from.

It is not a change anyone made, which is why the change log excludes it (see buildChangeHistoryQuery) while the per-record history still builds on it.

CHANGE_OPERATIONS
Type : unknown
Default value : [ "baseline", "create", "update", "delete", ] as const

The kind of change an audit event represents, named exactly as the audit backend emits it, so the stored value is also the one displayed and filtered on. Only the badge's wording is past tense, which is a label rather than a second vocabulary to map back and forth.

(A future "edit-mode tag" may add imported/merge; until the backend emits them, the badge falls back to update.)

FILTERABLE_OPERATIONS
Type : ChangeOperation[]
Default value : [ "create", "update", "delete", ]

The operations a user can filter the change log by, in the order the filter offers them.

baseline is deliberately absent: the log never lists snapshots, so offering it would only ever return nothing (see buildChangeHistoryQuery).

OPERATION_LABELS
Type : Record<ChangeOperation, string>
Default value : { baseline: $localize`:Change action badge:Initial snapshot`, create: $localize`:Change action badge:Created`, update: $localize`:Change action badge:Updated`, delete: $localize`:Change action badge:Deleted`, }

The past-tense wording for each operation, shared by the badge and the filter's options so the two cannot drift apart.

src/app/core/common-components/basic-autocomplete/basic-autocomplete.component.ts

BASIC_AUTOCOMPLETE_COMPONENT_IMPORTS
Type : []
Default value : [ ReactiveFormsModule, MatInputModule, MatAutocompleteModule, MatCheckboxModule, NgTemplateOutlet, MatChipInput, MatChipGrid, MatChipRow, FaDynamicIconComponent, MatTooltip, MatChipRemove, DragDropModule, CdkVirtualScrollViewport, CdkVirtualForOf, CdkFixedSizeVirtualScroll, KeepPanelOpenOnSelectDirective, ]

src/app/core/admin/admin-entity/admin-entity-general-settings/conditional-color-config/conditional-color-config.component.ts

blankSectionCondition
Type : unknown
Default value : () => ({ $or: [{}] })

The condition of a section that has no filled-in row yet. A section's condition is never empty, because an empty condition marks the static color.

src/app/core/logging/logging-test-utils.ts

brokenIndexedDb
Type : unknown
Default value : () => Object.assign(new Error("unknown"), { name: "indexed_db_went_bad", status: 500, reason: "The requested version (5) is less than the existing version (21793192942062).", })

PouchDB's error once the IndexedDB of the device is broken (AAM-DIGITAL-7CQ).

browserError
Type : unknown
Default value : (name: string, message: string) => Object.assign(new Error(message), { name })

A raw browser error, e.g. IndexedDB closed underneath PouchDB (AAM-DIGITAL-5WD).

failedFetch
Type : unknown
Default value : () => new ConnectivityError("Failed to fetch from DB", { cause: new TypeError("Failed to fetch"), })

What the remote database throws for a request without response.

withStack
Type : object
Default value : { frames: [{ filename: "app.ts" }] }

src/bootstrap-pwa-install.ts

canInstallDirectly
Type : Promise | undefined

Resolves once/if it is possible to directly install the app

deferredInstallPrompt
Type : BeforeInstallPromptEvent | undefined

The deferred beforeinstallprompt event, to be triggered on user request

installPromptListener
Type : unknown | undefined

The registered listener, kept so resetPWAInstallListener can remove it again

src/app/child-dev-project/children/demo-data-generators/fixtures/centers.ts

centersUnique
Type : ConfigurableEnumValue[]
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:center", ).values
centersWithProbability
Type : unknown
Default value : [0, 0, 1, 2].map((i) => centersUnique[i])

src/app/features/change-history/change-history-list/change-history-list.component.ts

CHANGE_HISTORY_DATE_RANGES
Type : DateRangeFilterConfigOption[]
Default value : [ { startOffsets: [{ amount: 0, unit: "weeks" }], endOffsets: [{ amount: 0, unit: "weeks" }], label: $localize`:Change log date filter:Current week`, }, { startOffsets: [{ amount: 0, unit: "months" }], endOffsets: [{ amount: 0, unit: "months" }], label: $localize`:Change log date filter:Current month`, }, { startOffsets: [{ amount: -1, unit: "months" }], endOffsets: [{ amount: -1, unit: "months" }], label: $localize`:Change log date filter:Last month`, }, { startOffsets: [{ amount: 0, unit: "quarter" }], endOffsets: [{ amount: 0, unit: "quarter" }], label: $localize`:Change log date filter:Current quarter`, }, { startOffsets: [{ amount: 0, unit: "years" }], endOffsets: [{ amount: 0, unit: "years" }], label: $localize`:Change log date filter:Current year`, }, ]

Presets offered by the date-range filter, alongside the two date inputs the shared filter also provides. Same shape and periods as the reports screen, so "last month" means the same thing in both places.

src/app/features/change-history/change-history-components.ts

changeHistoryComponents
Type : ComponentTuple[]
Default value : [ [ "ChangeHistoryActionBadge", () => import("./change-history-action-badge/change-history-action-badge.component").then( (c) => c.ChangeHistoryActionBadgeComponent, ), ], [ "ChangeHistoryChangedFields", () => import("./change-history-changed-fields/change-history-changed-fields.component").then( (c) => c.ChangeHistoryChangedFieldsComponent, ), ], [ "DisplayAuditTimestamp", () => import("./display-audit-timestamp/display-audit-timestamp.component").then( (c) => c.DisplayAuditTimestampComponent, ), ], [ "DisplayAuditRecord", () => import("./display-audit-record/display-audit-record.component").then( (c) => c.DisplayAuditRecordComponent, ), ], [ "DisplayAuditUser", () => import("./display-audit-user/display-audit-user.component").then( (c) => c.DisplayAuditUserComponent, ), ], ]

src/app/features/change-history/change-history.routing.ts

changeHistoryRoutes
Type : Routes
Default value : [ { path: "", // loaded on demand: this module itself stays eager, because its constructor // registers the per-record history action for every entity details view, // but the log is a rarely visited admin screen and need not be bundled with it loadComponent: () => "import(\"./change-history-list/change-history-list.component\").then(\n\ (c) => c.ChangeHistoryListComponent,\n\ )", canActivate: [EntityPermissionGuard], data: { entityType: "AuditRecord", requiredPermissionOperation: "read", }, }, ]

Routes of the change log, mounted by the app at /change-history.

Owned by this feature rather than the admin module, so the admin routing does not have to import from features/. Gated on read access to the audit data itself, which is the permission the entry point in the entity list offers it on - so the link and the route agree on who gets in.

src/app/child-dev-project/children/children-components.ts

childrenComponents
Type : ComponentTuple[]
Default value : [ [ "DisplayParticipantsCount", () => import("./display-participants-count/display-participants-count.component").then( (c) => c.DisplayParticipantsCountComponent, ), ], ]

src/app/core/logging/uncaught-error-classification.ts

CHUNK_LOAD_FAILURE_PATTERNS
Type : []
Default value : [ // Chrome/Edge: "Failed to fetch dynamically imported module: <url>" // Firefox: "error loading dynamically imported module: <url>" "dynamically imported module", "Importing a module script failed", // Safari ]

Wordings of a lazily loaded application chunk that could not be fetched: the device is offline, or a new deployment replaced the chunk the running app asks for.

EXPECTED_FAILURES
Type : unknown
Default value : new Set<ErrorClassification>([ "connectivity", "session-expired", "not-permitted", "write-conflict", ])

src/app/features/location/geo-location.ts

CITY_FIELDS
Type : unknown
Default value : [ "city", "town", "village", "suburb", "municipality", ] as const

Fields OpenStreetMap may use for the place a person would name as their town, ordered from the most specific to the widest area. Many places have no city at all: an address in a Dublin suburb, for example, only carries suburb.

src/bootstrap-reset.ts

CLOSE_OTHER_TABS_NOTICE_ID
Type : string
Default value : "reset-close-other-tabs-notice"

id of the notice on the loading screen, see showCloseOtherTabsNotice

LAST_SYNC_KEY_PREFIX
Type : string
Default value : "LAST_SYNC_"

localStorage key prefix under which SyncedPouchDatabase records when a database last completed a sync (one key per database).

RESET_PENDING_KEY
Type : string
Default value : "__RESET_PENDING"

sessionStorage key used to signal that a reset is pending. Set before a page reload; checked on the next bootstrap in runPendingReset.

src/app/core/basic-datatypes/schema-embed/schema-embed-export-columns.ts

COLUMN_PART_SEPARATOR
Type : string
Default value : " - "

Separator between the parts of an inner field exported in several columns, e.g. "2020-01-01 - 2020-12-31".

ENTRY_SEPARATOR
Type : string
Default value : "; "

Separator between the entries of an array field, e.g. "Passport, 12345; ID Card, 678".

VALUE_SEPARATOR
Type : string
Default value : ", "

Separator between the values of one entry, e.g. "Passport, 12345".

src/app/core/basic-datatypes/schema-embed/display-schema-embed-array/display-schema-embed-array.component.ts

columnsCache
Type : unknown
Default value : new WeakMap<FormFieldConfig, FormFieldConfig[]>()

Resolved columns per field config (see DisplaySchemaEmbedArrayComponent.columns)

src/app/features/attendance/attendance-permission.guard.ts

COMPONENT_PERMISSIONS
Type : Record<string, { configKey: "activityTypes" | "eventTypes"; operation: EntityActionPermission }>
Default value : { AttendanceManager: { configKey: "activityTypes", operation: "read", }, AddDayAttendance: { configKey: "eventTypes", operation: "create" }, RollCall: { configKey: "eventTypes", operation: "create" }, }

Maps component name to the service signal property and required operation for permission checks.

src/app/dynamic-components.ts

componentRegistry
Type : unknown
Default value : new ComponentRegistry()

src/app/core/default-values/x-dynamic-placeholder/dynamic-placeholder-value.service.ts

CONDITION_LIST_OPERATORS
Type : []
Default value : ["$or", "$and", "$nor"]

operators combining a list of conditions, each of which is a condition on its own

UNRESOLVED
Type : unknown
Default value : Symbol("unresolved")

marks a value that cannot be resolved, because it references an empty field

src/app/core/config/dynamic-routing/route-paths.ts

CONFIG_ENTITY_ROUTE_PREFIX
Type : string
Default value : "c"

Stable URL prefix used for entity routes loaded from runtime config.

src/bootstrap-environment.ts

CONFIG_JSON_MAX_RELOAD_ATTEMPTS
Type : number
Default value : 1
CONFIG_JSON_RELOAD_ATTEMPTS_KEY
Type : string
Default value : "config_json_reload_attempts"

sessionStorage key tracking how many times we've auto-reloaded due to a failure loading config.json, so a persistent failure (e.g. offline) doesn't reload-loop and flood error monitoring.

src/app/core/admin/setup-wizard/setup-wizard-config.ts

CONFIG_SETUP_WIZARD_ID
Type : unknown
Default value : "Config:" + SETUP_WIZARD_CONFIG_KEY
SETUP_WIZARD_CONFIG_KEY
Type : string
Default value : "SetupWizard"

id of the SetupWizard Config entity, without the entity type prefix

SETUP_WIZARD_ROUTE
Type : string
Default value : "/admin/setup-wizard"

src/app/core/config/config-migrations.ts

configMigrations
Type : ConfigMigration[]
Default value : [ migrateDashboardDefaultEntityType, ]

All temporary config migrations that fix legacy data formats. Applied by both ConfigService (Angular app) and the admin CLI (latest-config-formats). Order matters: earlier migrations may produce output consumed by later ones.

Once a migration has been applied to all systems through the CLI, remove it from here.

DASHBOARDS_DEFAULTING_TO_CHILD
Type : []
Default value : [ "ChildrenCountDashboard", "EntityCountDashboard", "NotesDashboard", ]

Dashboard widgets that used to implicitly count / list "Child" records if no entity type was configured.

migrateDashboardDefaultEntityType
Type : ConfigMigration
Default value : ( key, configPart, ) => { if (DASHBOARDS_DEFAULTING_TO_CHILD.includes(configPart?.component)) { configPart.config ||= {}; configPart.config.entityType ??= "Child"; } return configPart; }

src/app/features/conflict-resolution/auto-resolution/conflict-resolution-strategy.ts

CONFLICT_RESOLUTION_STRATEGY
Type : unknown
Default value : new InjectionToken< ConflictResolutionStrategy[] >("ConflictResolutionStrategy")

Use this token to provide (and thereby register) custom implementations of ConflictResolutionStrategy.

{ provide: CONFLICT_RESOLUTION_STRATEGY, useClass: MyConflictResolutionStrategy, multi: true }

see ConflictResolutionModule

src/app/features/conflict-resolution/conflict-resolution-components.ts

conflictResolutionComponents
Type : ComponentTuple[]
Default value : [ [ "ConflictResolution", () => import("./conflict-resolution-list/conflict-resolution-list.component").then( (c) => c.ConflictResolutionListComponent, ), ], ]

src/app/utils/backend-response.ts

CONNECTIVITY_ERROR_STATUS
Type : unknown
Default value : new Set([0, 502, 503, 504])

HTTP statuses of a request that never reached the application's backend: 0 for one that got no response at all, the others reported by an infrastructure component in front of it.

EXPIRED_TOKEN_REASON
Type : string
Default value : "exp not in future"

CouchDB's reason for rejecting a request whose JWT exp claim has passed.

FAILED_FETCH_PATTERNS
Type : []
Default value : [ "Failed to fetch", // Chrome "NetworkError", // Firefox ("NetworkError when attempting to fetch resource") "Load failed", // Safari "Network request failed", "network timeout", ]

The browsers' wordings of a fetch that got no response at all, for an error that carries neither a status nor a telling name.

NOT_PERMITTED_TEXT
Type : string
Default value : "not permitted"

Text the permission backend uses when the current user may not access a document or type.

ROUTE_PATH_SEGMENT
Type : unknown
Default value : /^(_?[a-z][a-z_-]*|v\d+)$/i

A path segment naming a route rather than a record: a word (e.g. _bulk_docs) or an API version.

src/app/core/logging/logging.service.ts

CONSOLE_METHODS
Type : Record<LogLevel, "debug" | "info" | "warn" | "error">
Default value : { [LogLevel.DEBUG]: "debug", [LogLevel.INFO]: "info", [LogLevel.WARN]: "warn", [LogLevel.ERROR]: "error", }
Logging
Type : miscellaneous
Default value : new LoggingService()
SENTRY_LEVELS
Type : Partial<Record<LogLevel, Sentry.SeverityLevel>>
Default value : { [LogLevel.WARN]: "warning", [LogLevel.ERROR]: "error", }

Only warn and error are reported (see LoggingService.log).

src/app/core/core-components.ts

coreComponents
Type : ComponentTuple[]
Default value : [ [ "DisplayConfigurableEnum", () => import("./basic-datatypes/configurable-enum/display-configurable-enum/display-configurable-enum.component").then( (c) => c.DisplayConfigurableEnumComponent, ), ], [ "EditConfigurableEnum", () => import("./basic-datatypes/configurable-enum/edit-configurable-enum/edit-configurable-enum.component").then( (c) => c.EditConfigurableEnumComponent, ), ], [ "Form", () => import("./entity-details/form/form.component").then( (c) => c.FormComponent, ), ], [ "EditEntity", () => import("./basic-datatypes/entity/edit-entity/edit-entity.component").then( (c) => c.EditEntityComponent, ), ], [ "DisplayEntity", () => import("./basic-datatypes/entity/display-entity/display-entity.component").then( (c) => c.DisplayEntityComponent, ), ], [ "EntityBlock", () => import("./basic-datatypes/entity/entity-block/entity-block.component").then( (c) => c.EntityBlockComponent, ), ], [ "EditTextWithAutocomplete", () => import("./common-components/edit-text-with-autocomplete/edit-text-with-autocomplete.component").then( (c) => c.EditTextWithAutocompleteComponent, ), ], [ "EditAge", () => import("./basic-datatypes/date-with-age/edit-age/edit-age.component").then( (c) => c.EditAgeComponent, ), ], [ "EditText", () => import("./basic-datatypes/string/edit-text/edit-text.component").then( (c) => c.EditTextComponent, ), ], [ "EditTranslatableText", () => import("./config/translatable-text-input/translatable-text-input.component").then( (c) => c.TranslatableTextInputComponent, ), ], [ "EditBoolean", () => import("./basic-datatypes/boolean/edit-boolean/edit-boolean.component").then( (c) => c.EditBooleanComponent, ), ], [ "EditDate", () => import("./basic-datatypes/date/edit-date/edit-date.component").then( (c) => c.EditDateComponent, ), ], [ "EditDateRange", () => import("./basic-datatypes/date-range/edit-date-range/edit-date-range.component").then( (c) => c.EditDateRangeComponent, ), ], [ "EditMonth", () => import("./basic-datatypes/month/edit-month/edit-month.component").then( (c) => c.EditMonthComponent, ), ], [ "EditLongText", () => import("./basic-datatypes/string/edit-long-text/edit-long-text.component").then( (c) => c.EditLongTextComponent, ), ], [ "EditPhoto", () => import("../features/file/edit-photo/edit-photo.component").then( (c) => c.EditPhotoComponent, ), ], [ "EditNumber", () => import("./basic-datatypes/number/edit-number/edit-number.component").then( (c) => c.EditNumberComponent, ), ], [ "DisplayDescriptionOnly", () => import("./common-components/description-only/display-description-only/display-description-only.component").then( (c) => c.DisplayDescriptionOnlyComponent, ), ], [ "DisplayCheckmark", () => import("./basic-datatypes/boolean/display-checkmark/display-checkmark.component").then( (c) => c.DisplayCheckmarkComponent, ), ], [ "DisplayText", () => import("./basic-datatypes/string/display-text/display-text.component").then( (c) => c.DisplayTextComponent, ), ], [ "DisplayTranslatableText", () => import("./config/display-translatable-text/display-translatable-text.component").then( (c) => c.DisplayTranslatableTextComponent, ), ], [ "DisplayLongText", () => import("./basic-datatypes/string/display-long-text/display-long-text.component").then( (c) => c.DisplayLongTextComponent, ), ], [ "DisplayDate", () => import("./basic-datatypes/date/display-date/display-date.component").then( (c) => c.DisplayDateComponent, ), ], [ "DisplayEntityType", () => import("./entity/display-entity-type/display-entity-type.component").then( (c) => c.DisplayEntityTypeComponent, ), ], [ "DisplayDateRange", () => import("./basic-datatypes/date-range/display-date-range/display-date-range.component").then( (c) => c.DisplayDateRangeComponent, ), ], [ "DisplayMonth", () => import("./basic-datatypes/month/display-month/display-month.component").then( (c) => c.DisplayMonthComponent, ), ], [ "ReadonlyFunction", () => import("./common-components/display-readonly-function/readonly-function.component").then( (c) => c.ReadonlyFunctionComponent, ), ], [ "DisplayPercentage", () => import("./basic-datatypes/number/display-percentage/display-percentage.component").then( (c) => c.DisplayPercentageComponent, ), ], [ "DisplayDynamicPercentage", () => import("./basic-datatypes/number/display-dynamic-percentage/display-calculated-value.component").then( (c) => c.DisplayCalculatedValueComponent, ), ], [ "DisplayCalculatedValue", () => import("./basic-datatypes/number/display-dynamic-percentage/display-calculated-value.component").then( (c) => c.DisplayCalculatedValueComponent, ), ], [ "DisplayUnit", () => import("./basic-datatypes/number/display-unit/display-unit.component").then( (c) => c.DisplayUnitComponent, ), ], [ "DisplayAge", () => import("./basic-datatypes/date-with-age/display-age/display-age.component").then( (c) => c.DisplayAgeComponent, ), ], [ "UserSecurity", () => import("./user/entity-user/entity-user.component").then( (c) => c.EntityUserComponent, ), ], [ "Dashboard", () => import("./dashboard/dashboard/dashboard.component").then( (c) => c.DashboardComponent, ), ], [ "EntityList", () => import("./entity-list/entity-list/entity-list.component").then( (c) => c.EntityListComponent, ), ], [ "EntityDetails", () => import("./entity-details/entity-details/entity-details.component").then( (c) => c.EntityDetailsComponent, ), ], [ "RelatedEntities", () => import("./entity-details/related-entities/related-entities.component").then( (c) => c.RelatedEntitiesComponent, ), ], [ "DisplayRelatedEmbeddedField", () => import("./entity-details/related-entities/display-related-embedded-field/display-related-embedded-field.component").then( (c) => c.DisplayRelatedEmbeddedFieldComponent, ), ], [ "EmbeddedArrayData", () => import("./entity-details/embedded-array-data/embedded-array-data.component").then( (c) => c.EmbeddedArrayDataComponent, ), ], [ "RelatedTimePeriodEntities", () => import("./entity-details/related-time-period-entities/related-time-period-entities.component").then( (c) => c.RelatedTimePeriodEntitiesComponent, ), ], [ "RelatedEntitiesWithSummary", () => import("./entity-details/related-entities-with-summary/related-entities-with-summary.component").then( (c) => c.RelatedEntitiesWithSummaryComponent, ), ], [ "EditEntityType", () => import("./entity/edit-entity-type/edit-entity-type.component").then( (c) => c.EditEntityTypeComponent, ), ], [ "EditUrl", () => import("./basic-datatypes/string/edit-url/edit-url.component").then( (c) => c.EditUrlComponent, ), ], [ "DisplayUrl", () => import("./basic-datatypes/string/display-url/display-url.component").then( (c) => c.DisplayUrlComponent, ), ], [ "EditEmail", () => import("./basic-datatypes/string/edit-email/edit-email.component").then( (c) => c.EditEmailComponent, ), ], [ "DisplayEmail", () => import("./basic-datatypes/string/display-email/display-email.component").then( (c) => c.DisplayEmailComponent, ), ], [ "EditAvailableLocales", () => import("./language/edit-available-locales/edit-available-locales.component").then( (c) => c.EditAvailableLocalesComponent, ), ], [ "EditDateFormat", () => import("./basic-datatypes/date/edit-date-format/edit-date-format.component").then( (c) => c.EditDateFormatComponent, ), ], [ "EditColor", () => import("./common-components/color-input/color-input.component").then( (c) => c.ColorInputComponent, ), ], [ "EditJson", () => import("./admin/json-editor/edit-json/edit-json.component").then( (c) => c.EditJsonComponent, ), ], [ "FreeTextFilter", () => import("./common-components/entities-table/free-text-filter/free-text-filter.component").then( (c) => c.FreeTextFilterComponent, ), ], [ "EditSchemaEmbedArray", () => import("./basic-datatypes/schema-embed/edit-schema-embed-array/edit-schema-embed-array.component").then( (c) => c.EditSchemaEmbedArrayComponent, ), ], [ "DisplaySchemaEmbedArray", () => import("./basic-datatypes/schema-embed/display-schema-embed-array/display-schema-embed-array.component").then( (c) => c.DisplaySchemaEmbedArrayComponent, ), ], ]

src/app/core/permissions/permission-action-labels.ts

CRUD_ACTION_COLUMNS
Type : CrudActionColumn[]
Default value : CRUD_ACTIONS.map( (action) => ({ action, label: CRUD_ACTION_LABELS[action], }), )

the actions with their labels, in display order

CRUD_ACTION_LABELS
Type : Record<CrudAction, string>
Default value : { read: $localize`:Permission column header:Read`, create: $localize`:Permission column header:Create`, update: $localize`:Permission column header:Update`, delete: $localize`:Permission column header:Delete`, }

User-facing name of each action, so that the role administration and the per-feature dialog label their columns identically.

MANAGE_ALL_LABEL
Type : unknown
Default value : $localize`:Permission column header:Manage (all)`

the CASL "manage" action, which covers every other action

src/app/core/filter/filters/filters.ts

CURRENT_RECORD_PLACEHOLDER_PREFIX
Type : string
Default value : "$current_record."

Prefix of a placeholder in a condition value that stands for the value of a field of the record currently being edited, e.g. "$current_record.location".

EMPTY_FILTER_OPTION_KEY
Type : string
Default value : "__empty__"

src/app/core/entity-details/related-time-period-entities/related-time-period-entities.component.ts

CURRENTLY_ACTIVE_COLOR
Type : string
Default value : "#90ee9040"

highlight color for the entry that covers the current date

currentlyActiveIndicator
Type : FormFieldConfig
Default value : { id: "currentlyActive", label: $localize`:Label for the currently active status|e.g. Currently active:Currently`, viewComponent: "ReadonlyFunction", hideFromTable: true, description: $localize`:Tooltip for the status of currently active or not:Only added to linked record if active. Change the start or end date to modify this status.`, additional: (csr: ChildSchoolRelation) => csr.isActiveAt(new Date()) ? $localize`:Indication for the currently active status of an entry:active` : $localize`:Indication for the currently inactive status of an entry:not active`, }

src/app/utils/custom-number-validators.ts

CustomNumberValidators
Type : { isNumber: ValidatorFn }
Default value : { /** * Angular Validator to verify value is a valid number. */ isNumber: (control: AbstractControl) => { if (control.value && Number.isNaN(Number(control.value))) { return { isNumber: "invalid" }; } else { return null; } }, }

Container for custom Angular Validator functions.

src/app/core/database/pouchdb/database-exception.ts

DATABASE_ERRORS
Type : miscellaneous
Default value : { connectivity: ConnectivityError, "server-error": ServerError, "not-permitted": NotPermittedError, "session-expired": SessionExpiredError, "write-conflict": WriteConflictError, "local-storage": LocalStorageError, }

The typed error that a raw error of the database of each classification is converted into.

IDENTIFYING_PROPERTIES
Type : unknown
Default value : new Set(["name", "message", "stack", "cause"])

Own properties of PouchDB's errors (and of the copies its createError() makes) that are not taken over, as they identify the DatabaseException itself: e.g. "not_found" as name, or the original cause of a copied typed error.

src/app/core/language/date-adapter-with-formatting.ts

DATE_FORMATS
Type : MatDateFormats
Default value : { // in addition to the customDate pipe // we need to add dateInput and override the method because we are not using DatePipe here, we are using moment.js // and all date picker inputs are using moment.js, and this will ensure that dates are always displayed in our default format. parse: { get dateInput() { return datepickerFormat(); }, }, display: { ...MAT_NATIVE_DATE_FORMATS.display, get dateInput() { return datepickerFormat(); }, }, }

Extend MAT_NATIVE_DATE_FORMATS to also support parsing. dateInput uses a getter so it always reflects the current global date format from date.static.

src/app/core/database/pouchdb/bulk-write-batches.ts

DEFAULT_BULK_WRITE_LIMITS
Type : BulkWriteLimits
Default value : { maxBytes: 4 * 1024 * 1024, maxDocuments: 500, }
UTF8_ENCODER
Type : unknown
Default value : new TextEncoder()

Shared encoder for jsonByteLength (creating one per document is wasteful).

src/app/core/common-components/conditions-editor/conditions-combinator.ts

DEFAULT_COMBINATOR
Type : Combinator
Default value : "all"

Combinator of a condition that does not exist yet. "all" is the safe default: in permissions "any" would widen access when a second row is added, where "all" narrows it.

hasValue
Type : unknown
Default value : (value: any): boolean => { const { positive } = splitNegation(value); const operand = isPlainObject(positive) && "$eq" in positive ? positive.$eq : positive; return ( operand !== null && operand !== undefined && !(Array.isArray(operand) && operand.length === 0) ); }

Whether a row's value is set: not null, undefined or an empty list. Negating an empty value leaves it just as empty, so an "is not" row that is still waiting for its value does not count.

isCompleteRow
Type : unknown
Default value : (row: any): boolean => isPlainObject(row) && Object.keys(row).length > 0 && Object.values(row).every(hasValue)

A row is complete once its field has a value.

isPlainObject
Type : unknown
Default value : (value: any): boolean => !!value && typeof value === "object" && !Array.isArray(value)

src/app/core/language/language-statics.ts

DEFAULT_LANGUAGE
Type : miscellaneous
Default value : "en-US"
LANGUAGE_LOCAL_STORAGE_KEY
Type : string
Default value : "locale"
LANGUAGE_OWNER_LOCAL_STORAGE_KEY
Type : string
Default value : "localeOwner"

Id of the account whose own language setting put the current locale in place. Absent if the locale was picked on this device or is the system default.

RTL_LANGUAGES
Type : unknown
Default value : new Set([ "ar", "ckb", "dv", "fa", "he", "iw", "nqo", "ps", "sd", "ug", "ur", "yi", ])

Copied from CDK's RTL_LOCALE_PATTERN (@angular/cdk/bidi), which is not exported.

src/app/core/permissions/reserved-roles.ts

DEFAULT_ROLE
Type : ReservedRoleInfo
Default value : { key: DEFAULT_SECTION_KEY, label: $localize`:Reserved role name of the "_default" role:Default`, appliesTo: $localize`applies to any logged-in user, in addition to their roles`, description: $localize`Base permissions that apply to every logged-in user, combined with their other roles`, icon: "lock", }

The "_default" role, whose permissions every logged-in user has in addition to the permissions of their own roles.

PUBLIC_ROLE
Type : ReservedRoleInfo
Default value : { key: PUBLIC_SECTION_KEY, label: $localize`:Reserved role name of the "_public" role:Public`, appliesTo: $localize`applies to visitors who are not logged in`, description: $localize`Permissions that apply before login (e.g. public registration forms)`, icon: "globe", }

The "_public" role, whose permissions apply to visitors before login.

RESERVED_ROLES
Type : ReservedRoleInfo[]
Default value : [DEFAULT_ROLE, PUBLIC_ROLE]

The reserved roles with their user-facing name and description, so that all places explaining them to the user (roles overview, permission matrix, permission dialogs) use the same wording.

Ordered as they should be listed to the user.

src/app/core/config/default-config/default-attendance-status-types.ts

defaultAttendanceStatusTypes
Type : unknown
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:attendance-status", ).values as AttendanceStatusType[]

src/app/core/basic-datatypes/date/date-range-filter/date-range-filter-panel/date-range-filter-panel.component.ts

defaultDateFilters
Type : DateRangeFilterConfigOption[]
Default value : [ { label: $localize`:Filter label:Today`, }, { startOffsets: [{ amount: 0, unit: "weeks" }], endOffsets: [{ amount: 0, unit: "weeks" }], label: $localize`:Filter label:This week`, }, { startOffsets: [{ amount: -1, unit: "weeks" }], label: $localize`:Filter label:Since last week`, }, { startOffsets: [{ amount: 0, unit: "months" }], endOffsets: [{ amount: 0, unit: "months" }], label: $localize`:Filter label:This month`, }, { startOffsets: [{ amount: -1, unit: "months" }], endOffsets: [{ amount: -1, unit: "months" }], label: $localize`:Filter label:Last month`, }, ]

src/app/core/config/default-config/default-interaction-types.ts

defaultInteractionTypes
Type : unknown
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:" + INTERACTION_TYPE_CONFIG_ID, ).values as InteractionType[]

src/app/features/public-form/edit-prefilled-values/edit-prefilled-values.component.ts

defaultValueCompleteValidator
Type : ValidatorFn
Default value : ( control: AbstractControl, ): ValidationErrors | null => { const val: DefaultValueConfig = control.value; if (!val) { return { incompleteDefaultValue: true }; } if (val.mode && !val.config) { return { incompleteDefaultValue: true }; } if ( val.config && typeof val.config === "object" && "value" in val.config && (val.config as { value: unknown }).value == null ) { return { incompleteDefaultValue: true }; } return null; }

src/app/core/default-values/standard-default-value-strategies.ts

defaultValueStrategyProviders
Type : []
Default value : [ { provide: DefaultValueStrategy, useClass: StaticDefaultValueService, multi: true, }, { provide: DefaultValueStrategy, useClass: DynamicPlaceholderValueService, multi: true, }, { provide: DefaultValueStrategy, useClass: InheritedValueService, multi: true, }, ]

Standard default-value strategies that are used in the application. Add further providers to your modules or the AppModule to extend.

src/app/core/common-components/confirmation-dialog/confirmation-dialog/confirmation-dialog.component.ts

DELETE_CONFIRMATION_KEYWORD
Type : miscellaneous
Default value : $localize`:Keyword to be typed by the user to confirm deleting data:delete`

The keyword a user has to type to confirm an action that deletes data irreversibly.

OkButton
Type : ConfirmationDialogButton[]
Default value : [ { text: $localize`:Confirmation dialog OK:OK`, click() { // Intentionally blank // To react to emissions from this button, use the `MatDialogRef.beforeClosed()` hook }, dialogResult: true, }, ]
YesNoButtons
Type : ConfirmationDialogButton[]
Default value : [ { text: $localize`:Confirmation dialog Yes:Yes`, click() { // Intentionally blank // To react to emissions from this button, use the `MatDialogRef.beforeClosed()` hook }, dialogResult: true, }, { text: $localize`:Confirmation dialog No:No`, click() { // Intentionally blank // To react to emissions from this button, use the `MatDialogRef.beforeClosed()` hook }, dialogResult: false, }, ]
YesNoCancelButtons
Type : ConfirmationDialogButton[]
Default value : [ { text: $localize`:Confirmation dialog Yes:Yes`, click() { // Intentionally blank // To react to emissions from this button, use the `MatDialogRef.beforeClosed()` hook }, dialogResult: true, }, { text: $localize`:Confirmation dialog No:No`, click() { // Intentionally blank // To react to emissions from this button, use the `MatDialogRef.beforeClosed()` hook }, dialogResult: false, }, { text: $localize`:Confirmation dialog Cancel:Cancel`, click() { // Intentionally blank // To react to emissions from this button, use the `MatDialogRef.beforeClosed()` hook }, dialogResult: undefined, }, ]

src/app/core/demo-data/demo-data.module.ts

demoDataGeneratorProviders
Type : []
Default value : [ ...DemoUserGeneratorService.provider(), ...DemoChildGenerator.provider({ count: 120 }), ...DemoSchoolGenerator.provider({ count: 8 }), ...DemoChildSchoolRelationGenerator.provider(), ...DemoActivityGeneratorService.provider(), ...DemoActivityEventsGeneratorService.provider({ forNLastYears: 1 }), ...DemoNoteGeneratorService.provider({ minNotesPerChild: 2, maxNotesPerChild: 6, groupNotes: 3, }), ...DemoAserGeneratorService.provider(), ...DemoEducationalMaterialGeneratorService.provider({ minCount: 3, maxCount: 8, }), ...DemoHealthCheckGeneratorService.provider(), ...DemoHistoricalDataGenerator.provider({ minCountAttributes: 2, maxCountAttributes: 5, }), ...DemoTodoGeneratorService.provider(), ]

src/app/child-dev-project/children/demo-data-generators/fixtures/dropout-types.ts

dropoutTypes
Type : []
Default value : [ // multiple entries for the same value increase its probability $localize`:Dropout type:Finished School or Training`, $localize`:Dropout type:Dropout`, $localize`:Dropout type:Continues Education without project`, $localize`:Dropout type:Moved away`, ]

src/app/core/common-components/entity-form/dynamic-form-validators/form-validator-config.ts

DYNAMIC_VALIDATORS
Type : unknown
Default value : [ /** type: number */ "min", /** type: number */ "max", /** type: string/date */ "minDate", /** type: string/date */ "maxDate", /** type: number */ "minAge", /** type: number */ "maxAge", /** type: boolean */ "required", /** type: boolean; validate field value is unique among entities of same type */ "uniqueId", /** type: boolean */ "readonlyAfterSet", /** type: string or regex */ "pattern", /** type: WithinParentConfig; warns (without blocking saving) when a date range goes beyond the one of a linked parent */ "withinParent", /** * type: DataFilter; for fields referencing another entity type: * a Mango/MongoDB style query condition that the referenced records have to match * to be offered for selection in this field. * * Condition values can refer to fields of the record being edited * through a placeholder like `"$current_record.location"`, including its unsaved changes. * If such a referenced field is empty, the rows of the condition referencing it are not applied * (with the "any" combinator, `$or`, the whole condition then is not applied). * The same applies if there is no single record, like in bulk edit. * * A placeholder can also refer to a field of a record that the edited record links to (one level only), * like `"$current_record.parentAction.locations"`: the values of all records linked in `parentAction`. * For example `{ "_id": { "$in": ["$current_record.parentAction.locations"] } }` only offers the locations of the parent. * A linked record that cannot be loaded (e.g. without read permission) counts as not linked. * * Only applies to a field referencing a single record type and edited with the entity dropdown * (or an edit component using it), not if a form layout sets another `editComponent`. * A `schema-embed` field (e.g. `attendance`) takes it in the config of its embedded * entity field (e.g. `additional.participant.validators.selectionCondition`). * * Records that do not match can still be shown by the user on request, * and already selected records are kept even if they do not match (anymore). * A selected record that does not match is only a warning: users can still save after confirming it * (not checked for an embedded field like the participants of `attendance`). * The warning only appears when the user changed this field or a field the condition refers to * (e.g. a new `location` that existing links do not match), not on every save of a record linked before. * Selected records that do not match are still marked with a warning icon at the field. */ "selectionCondition", ] as const

The keys of the validators of the core module in a FormValidatorConfig, to type configs written in code. Each is implemented by a registered FieldValidator.

WARNING_ONLY_KEY
Type : string
Default value : "_warningOnly"

key of the setting in a FormValidatorConfig listing the validators that are only a warning

src/app/core/config/dynamic-components/dynamic-component.decorator.ts

DynamicComponent
Type : unknown
Default value : (_name: string) => (_: ComponentType<any>) => undefined

Decorator to annotate a class that serves as dynamic component A dynamic component can be referenced from the config with the name defined on the decorator.

IMPORTANT: The component also needs to be added to the ...Components list of the respective module.

src/app/features/de-duplication/de-duplication-module.ts

dynamicComponents
Type : unknown[]
Default value : [ [ "BulkMergeRecordsComponent", () => import("./bulk-merge-records/bulk-merge-records.component").then( (c) => c.BulkMergeRecordsComponent, ), ], [ "ReviewDuplicates", () => import("./review-duplicates/review-duplicates.component").then( (c) => c.ReviewDuplicatesComponent, ), ], ]

src/app/features/public-form/public-form.module.ts

dynamicComponents
Type : unknown[]
Default value : [ [ "EditPublicFormColumns", () => import("app/features/public-form/edit-public-form-columns/edit-public-form-columns.component").then( (c) => c.EditPublicFormColumnsComponent, ), ], [ "EditPrefilledValuesComponent", () => import("app/features/public-form/edit-prefilled-values/edit-prefilled-values.component").then( (c) => c.EditPrefilledValuesComponent, ), ], [ "EditPublicformRoute", () => import("app/features/public-form/edit-publicform-route/edit-publicform-route.component").then( (c) => c.EditPublicformRouteComponent, ), ], [ "EditPublicFormRelatedEntitiesComponent", () => import("app/features/public-form/edit-public-form-related-entities/edit-public-form-related-entities.component").then( (c) => c.EditPublicFormRelatedEntitiesComponent, ), ], [ "PublicFormPermissionWarning", () => import("app/features/public-form/public-form-permission-warning/public-form-permission-warning.component").then( (c) => c.PublicFormPermissionWarningComponent, ), ], [ "PublicFormFormatWarning", () => import("app/features/public-form/public-form-format-warning/public-form-format-warning.component").then( (c) => c.PublicFormFormatWarningComponent, ), ], ]
viewConfigs
Type : ViewConfig[]
Default value : [ // List View { _id: "view:" + PublicFormConfig.route, component: "EntityList", config: { entityType: PublicFormConfig.ENTITY_TYPE, columns: ["title", "description", "entity"], filters: [{ id: "entity" }], } as EntityListConfig, }, // Details View { _id: "view:" + PublicFormConfig.route + "/:id", component: "EntityDetails", config: { entityType: PublicFormConfig.ENTITY_TYPE, panels: [ { title: $localize`:PublicFormConfig admin form panel:General Setting`, components: [ { component: "Form", config: { fieldGroups: [ { fields: [ { id: "public_form_format_warning", viewComponent: "PublicFormFormatWarning", }, "route", "title", "description", ], }, { fields: [ { id: "permissions_remark", viewComponent: "DisplayDescriptionOnly", label: $localize`:PublicFormConfig admin form:If you want external people filling this form without logging in, the _Permission System_ also has to allow **"public"** users to create new records of this type.<br> If you are seeing problems submitting the form, please contact your **technical support team**.`, }, "entity", { id: "public_form_permission_warning", viewComponent: "PublicFormPermissionWarning", }, "logo", "showSubmitAnotherButton", ], }, ], }, }, ], }, { title: $localize`:PublicFormConfig admin form panel:Configure Fields`, components: [ { component: "Form", config: { fieldGroups: [ { fields: ["columns"], }, ], }, }, ], }, { title: $localize`:PublicFormConfig admin form panel:Configure Pre-filled Values`, components: [ { component: "Form", config: { fieldGroups: [ { fields: [ { id: "prefilled_description", viewComponent: "DisplayDescriptionOnly", label: $localize`:PublicFormConfig admin form:You can configure some fields to be always be set to a certain value when this form is submitted. For example, make a "status" field always be set to "new" so that you can easily filter the new records submitted by external users; or make a "signed up on" date field to always show the current date. If you add the same field(s) in the "Configure Fields" section to show to the user, this pre-filled value can be changed by the person filling the form.`, }, "prefilled", { id: "linked_entities_description", viewComponent: "DisplayDescriptionOnly", label: $localize`:PublicFormConfig admin form:**Collect replies of this form linked to individual records**<br> <br>You can use forms with a special "magic link" to collect responses from participants that are already registered in your system. By sending out an individual link to each person, the form response(s) from that person can be linked into their profile. For example, you can collect feedback or an evaluation survey and relate each submission to the specific participant or organisation that gave it.<br>The system supports linking to multiple entity types. For example, you can encode IDs of a person and activity in the magic link to collect feedback for that specific context. To set this up, select multiple fields below. Currently, such multi-ID URLs need to be generated outside of this system, however.`, }, "linkedEntities", ], }, ], }, }, ], }, ], } as EntityDetailsConfig, }, ]

src/app/features/skill/skill.module.ts

dynamicComponents
Type : unknown[]
Default value : [ [ "EditExternalProfileLink", () => import("./link-external-profile/edit-external-profile-link.component").then( (c) => c.EditExternalProfileLinkComponent, ), ], [ "BulkLinkExternalProfiles", () => import("./bulk-link-external-profiles/bulk-link-external-profiles.component").then( (c) => c.BulkLinkExternalProfilesComponent, ), ], ]

src/app/features/template-export/template-export.module.ts

dynamicComponents
Type : unknown[]
Default value : [ [ "EditTemplateExportFile", () => import("./template-export-file-datatype/edit-template-export-file.component").then( (c) => c.EditTemplateExportFileComponent, ), ], ]
viewConfigs
Type : ViewConfig[]
Default value : [ // List View { _id: "view:" + TemplateExport.route, component: "EntityList", config: { entityType: TemplateExport.ENTITY_TYPE, columns: ["title", "description", "applicableForEntityTypes"], filters: [{ id: "applicableForEntityTypes" }], } as EntityListConfig, }, // Details View { _id: "view:" + TemplateExport.route + "/:id", component: "EntityDetails", config: { entityType: TemplateExport.ENTITY_TYPE, panels: [ { components: [ { component: "Form", config: { fieldGroups: [ { fields: [ "title", "description", "applicableForEntityTypes", "arrayReport", ], }, { fields: [ { id: "template_explanation", viewComponent: "DisplayDescriptionOnly", label: $localize`:TemplateExport:Upload a specially prepared template file here. The file can contain placeholders that will be replaced with actual data when a file is generated for a selected record. For example {d.name} will be replaced with the value in the "name" field of the given record. See the documentation of the [carbone system](https://carbone.io/documentation.html#substitutions) for more information. The placeholder keys must match the field "Field ID" of the record data structure in Aam Digital. You can find this in the Admin UI form builder (Edit Data Structure -> Details View) and edit a specific field to view its details. In addition to the selected record, you can also use fields of the currently logged-in user's own record by prefixing them with "c.user." (e.g. {c.user.name}). This works both in the template file and in the file name pattern. Template files can be in most office document formats (odt, docx, ods, xlsx, odp, pptx) or PDF.`, }, "templateFile", "targetFileName", ], }, ], }, }, ], }, ], } as EntityDetailsConfig, }, ]

src/app/features/todos/todos.module.ts

dynamicComponents
Type : unknown[]
Default value : [ [ "TodosRelatedToEntity", () => import("./todos-related-to-entity/todos-related-to-entity.component").then( (c) => c.TodosRelatedToEntityComponent, ), ], [ "TodosDashboard", () => import("./todos-dashboard/todos-dashboard.component").then( (c) => c.TodosDashboardComponent, ), ], [ "EditRecurringInterval", () => import("./recurring-interval/edit-recurring-interval/edit-recurring-interval.component").then( (c) => c.EditRecurringIntervalComponent, ), ], [ "DisplayRecurringInterval", () => import("./recurring-interval/display-recurring-interval/display-recurring-interval.component").then( (c) => c.DisplayRecurringIntervalComponent, ), ], [ "EditTodoCompletion", () => import("./todo-completion/edit-todo-completion/edit-todo-completion.component").then( (c) => c.EditTodoCompletionComponent, ), ], [ "DisplayTodoCompletion", () => import("./todo-completion/display-todo-completion/display-todo-completion.component").then( (c) => c.DisplayTodoCompletionComponent, ), ], [ "TodosDashboardSettings", () => import("./todos-dashboard-settings.component/todos-dashboard-settings.component").then( (c) => c.TodosDashboardSettingsComponent, ), ], ]

src/app/features/template-export/template-export.entity.ts

EDITABLE_OUTPUT_FORMATS
Type : []
Default value : ["docx", "xlsx", "pptx", "odt", "ods", "odp"]

Template file formats in which the template engine can also generate the filled-in file, so users can get an editable document instead of a PDF. Legacy formats (.doc, .xls, .ppt) are left out, as they would need a conversion.

src/app/core/entity/schema/embedded-schema-field.util.ts

EMBEDDED_FIELD_ID_SEPARATOR
Type : string
Default value : "."

Separator used to build an id referencing a property nested inside an embedded field, e.g. "childrenAttendance.participant" references the "participant" property of the entries of the embedded field "childrenAttendance".

src/app/core/basic-datatypes/configurable-enum/configurable-enum.types.ts

EMPTY
Type : ConfigurableEnumValue
Default value : { id: "", label: "", }

src/app/core/admin/admin-role-permissions/role-details/admin-role-details.component.ts

emptyModel
Type : unknown
Default value : (): MatrixModel => ({ rows: [], unsupportedRules: [] })

fresh empty matrix model; a factory (not a shared const) so callers can never alias a mutable object

src/app/core/config/config-validation/config-validation.service.ts

ENTITY_CONFIG_PREFIX
Type : string
Default value : "entity:"
NAVIGATION_MENU_CONFIG_ID
Type : string
Default value : "navigationMenu"

src/app/core/export/readable-entity-name.ts

ENTITY_NOT_FOUND_PLACEHOLDER
Type : miscellaneous
Default value : "<not_found>"

Placeholder exported for a referenced entity that does not exist (or cannot be read).

EXPORT_BATCH_SIZE
Type : number
Default value : 20

Maximum number of rows (and of values within one row) that are resolved in parallel during an export. Resolving referenced entities can require a database request per value; running them all at once exhausts the browser's resources on large lists (net::ERR_INSUFFICIENT_RESOURCES), making some of the requests fail.

src/app/core/permissions/ability/testing-entity-ability-factory.ts

entityAbilityFactory
Type : unknown
Default value : () => { let ability = new EntityAbility(); ability.update([{ subject: "all", action: "manage" }]); return ability; }

src/app/utils/storybook-base.module.ts

entityFormStorybookDefaultParameters
Type : object
Default value : { controls: { exclude: ["_columns", "_cols", "enumValueToString"], }, }

src/app/core/entity/database-entity.decorator.ts

entityRegistry
Type : unknown
Default value : new EntityRegistry((key, constructor) => { if (!(new constructor() instanceof Entity)) { throw Error( `Tried to register an entity-type that is not a subclass of Entity\n` + `type: ${key}; constructor: ${constructor}`, ); } })

src/environments/environment.prod.ts

environment
Type : object
Default value : { production: true, appVersion: "0.0.0", // replaced automatically during docker build repositoryId: "Aam-Digital/ndb-core", remoteLoggingDsn: undefined as string | undefined, remoteLoggingEnvironment: undefined as string | undefined, demo_mode: true, session_type: SessionType.mock, webmaster_email: undefined, userAdminApi: undefined, realm: undefined, clientId: undefined, DB_PROXY_PREFIX: "/db", API_PROXY_PREFIX: "/api", notificationsConfig: undefined, SaaS: false, userSupportEnabled: false, use_indexeddb_adapter: true, translationsCdnUrl: "https://aam-digital.github.io/ndb-core/locale", default_data_source: undefined as string | undefined, session_type_choice: true, multiLingualConfigEnabled: false, }

see environment.ts for explanations

src/environments/environment.ts

environment
Type : object
Default value : { production: false, appVersion: "0.0.0", // replaced automatically during docker build repositoryId: "Aam-Digital/ndb-core", /** * The DSN of the remote monitoring (Sentry) project to report warnings and errors to. * Not set by default, so remote logging is off: deployments set it in their `config.json`. */ remoteLoggingDsn: undefined as string | undefined, /** * The `environment` that remote monitoring files this deployment's events under. * Defaults to "production" for production builds - set it in the `config.json` * of test, demo or preview deployments, so that their events can be told apart. */ remoteLoggingEnvironment: undefined as string | undefined, demo_mode: true, session_type: SessionType.mock, /** Contact email for the webmaster/operator of this instance, used e.g. as Nominatim usage-policy email. Set via config.json on production. */ webmaster_email: undefined, /** Keycloak API for user management */ userAdminApi: undefined, // loaded from `assets/keycloak.json` during bootstrap /** Keycloak realm for user management */ realm: undefined, // loaded from `assets/keycloak.json` during bootstrap /** Keycloak client id of the app (used e.g. for the "back to application" link in action emails) */ clientId: undefined, // loaded from `assets/keycloak.json` during bootstrap /** Path for the reverse proxy that forwards to the database - configured in `default.conf` */ DB_PROXY_PREFIX: "/db", /** Path for the reverse proxy that forwards to backend services APIs - configured in `default.conf` */ API_PROXY_PREFIX: "/api", /** see FirebaseConfiguration and assets/firebase-config.json */ notificationsConfig: undefined, /** Whether the system is hosted Software-as-a-Service, therefore enabling subscription-related UI */ SaaS: true, /** Has the system a subscription with access to personal user support? */ userSupportEnabled: false, /** * Use the newer "indexeddb" PouchDB adapter (and Keycloak-UUID-based local database names) * instead of the legacy "idb" adapter. * When true (default), existing local databases on the old adapter are migrated * (see IndexeddbMigrationService). * Set to false via config.json to opt out and keep using the legacy adapter. */ use_indexeddb_adapter: true, /** CDN URL for loading translation files at runtime. Empty string disables CDN loading. */ translationsCdnUrl: "https://aam-digital.github.io/ndb-core/locale", /** * Default data source used for all lists of entities, * unless a list config overrides it. * see src/app/core/common-components/entities-table/README.md */ default_data_source: undefined as string | undefined, /** * Whether the system is multi-language: admins can configure texts in several * languages, and users can switch the app's language (in their profile and on public * forms). Off in prod and enabled per system. * * If off, the translation editing UI is hidden (texts already stored per language are * still resolved), and everyone uses the default language from the site settings: * a user's own language and one picked on the device are ignored. * * If on, the translation editing UI is still hidden while only the default language * is enabled in the site settings (see `SiteSettingsService.translationsEnabled`). */ multiLingualConfigEnabled: true, /** * Whether users are allowed to choose between synced and online-only mode on the login page. * When false, the toggle is hidden and the session_type configured here is enforced. * Defaults to true (users can choose). */ session_type_choice: true, }

Central environment that allows to configure differences between a "dev" and a "prod" build. For deployments, the assets/config.json can be used to override these settings as well.

The file contents for the current environment will overwrite these during build. The build system defaults to the dev environment which uses environment.ts, but if you do ng build --env=prod then environment.prod.ts will be used instead. The list of which env maps to which file can be found in .angular-cli.json.

src/app/core/logging/error-classification.ts

ERROR_CLASSIFICATIONS
Type : unknown
Default value : [ "connectivity", "session-expired", "not-permitted", "local-storage", "server-error", "write-conflict", ] as const

What kind of failure an error is, declared by its TypedError class (see classifyError); what remote monitoring does with each is REPORTING_POLICY. Foreign errors are converted into typed errors where they enter the app, by the module they belong to, which also defines the typed classes it creates (each documents what its kind of failure is).

src/app/core/demo-data/faker.ts

faker
Type : unknown
Default value : new CustomFaker({ locale: [en_IN, en], seed: 1 })

(Extended) faker module

src/app/features/file/file-components.ts

fileComponents
Type : ComponentTuple[]
Default value : [ [ "EditFile", () => import("./edit-file/edit-file.component").then( (c) => c.EditFileComponent, ), ], [ "ViewFile", () => import("./view-file/view-file.component").then( (c) => c.ViewFileComponent, ), ], ]

src/app/features/notification/firebase-messaging.service.ts

FIREBASE_SDK
Type : unknown
Default value : new InjectionToken<() => Promise<FirebaseSdk>>( "FIREBASE_SDK", { providedIn: "root", factory: () => async () => { const [app, messaging] = await Promise.all([ import("firebase/app"), import("firebase/messaging"), ]); return { ...messaging, initializeApp: app.initializeApp }; }, }, )

Loads the parts of the Firebase SDK used here (as a separate chunk).

src/app/core/entity/entity-mapper/entity-mapper.service.ts

FULL_LOAD_PAGE_SIZE
Type : number
Default value : 500

Number of documents fetched per request when paging through a complete result set (see EntityMapperService.findAllType).

src/app/child-dev-project/children/model/genders.ts

genders
Type : ConfigurableEnumValue[]
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:genders", ).values

src/app/features/location/geo.service.ts

GERMAN_ADDRESS_FORMAT_COUNTRY
Type : string
Default value : "de"

Country whose addresses are written as "Street 12, 12345 City", the format GeoService.reformatDisplayName produces.

src/app/child-dev-project/children/demo-data-generators/health-check/height-weight.ts

heightRangeForAge
Type : unknown
Default value : new Map<number, any>([ [2, { min: 78, max: 91 }], [2.5, { min: 83, max: 97 }], [3, { min: 86, max: 101 }], [3.5, { min: 89, max: 105 }], [4, { min: 93, max: 109 }], [4.5, { min: 96, max: 113 }], [5, { min: 99, max: 117 }], [5.5, { min: 102, max: 121 }], [6, { min: 105, max: 125 }], [6.5, { min: 108, max: 129 }], [7, { min: 111, max: 132 }], [7.5, { min: 114, max: 136 }], [8, { min: 116, max: 138 }], [8.5, { min: 119, max: 142 }], [9, { min: 121, max: 145 }], [9.5, { min: 123, max: 148 }], [10, { min: 125, max: 150 }], [10.5, { min: 127, max: 154 }], [11, { min: 130, max: 157 }], [11.5, { min: 133, max: 161 }], [12, { min: 136, max: 164 }], [12.5, { min: 140, max: 167 }], [13, { min: 144, max: 170 }], [13.5, { min: 146, max: 171 }], [14, { min: 148, max: 172 }], [14.5, { min: 148, max: 173 }], [15, { min: 150, max: 174 }], [15.5, { min: 152, max: 174 }], [16, { min: 154, max: 175 }], [16.5, { min: 156, max: 176 }], [17, { min: 158, max: 177 }], [17.5, { min: 158, max: 177 }], [18, { min: 158, max: 177 }], [18.5, { min: 158, max: 177 }], ])
weightRangeForAge
Type : unknown
Default value : new Map<number, any>([ [2, { min: 10, max: 15 }], [2.5, { min: 10, max: 16 }], [3, { min: 11, max: 17 }], [3.5, { min: 11, max: 19 }], [4, { min: 12, max: 20 }], [4.5, { min: 13, max: 22 }], [5, { min: 14, max: 24 }], [5.5, { min: 15, max: 26 }], [6, { min: 15, max: 28 }], [6.5, { min: 16, max: 30 }], [7, { min: 17, max: 32 }], [7.5, { min: 18, max: 35 }], [8, { min: 19, max: 38 }], [8.5, { min: 20, max: 40 }], [9, { min: 21, max: 44 }], [9.5, { min: 22, max: 47 }], [10, { min: 23, max: 50 }], [10.5, { min: 25, max: 54 }], [11, { min: 26, max: 58 }], [11.5, { min: 28, max: 61 }], [12, { min: 29, max: 65 }], [12.5, { min: 31, max: 68 }], [13, { min: 33, max: 71 }], [13.5, { min: 34, max: 74 }], [14, { min: 36, max: 77 }], [14.5, { min: 38, max: 79 }], [15, { min: 40, max: 80 }], [15.5, { min: 42, max: 85 }], [16, { min: 44, max: 90 }], [16.5, { min: 46, max: 95 }], [17, { min: 48, max: 100 }], [17.5, { min: 48, max: 100 }], [18, { min: 48, max: 100 }], [18.5, { min: 48, max: 100 }], ])

src/app/features/change-history/change-history-normalize.ts

HIDDEN_FIELDS
Type : unknown
Default value : new Set([ "_id", "_rev", "_revisions", "created", "updated", ])

Doc fields that are internal/metadata and never shown as user-facing field changes.

src/app/core/common-components/fa-dynamic-icon/fa-icon-utils.ts

iconAliases
Type : unknown
Default value : new Map<string, IconDefinition>([ ["calendar-check-o", faCalendarCheck], ["file-text", faFileAlt], ["question", faQuestionCircle], ["line-chart", faChartLine], ["calendar", faCalendarAlt], ["users", faUsers], ])

A map to prevent old configs from breaking.

resolveIconDefinition
Type : unknown
Default value : ( icon: string | null | undefined, iconLibrary: FaIconLibrary, ): IconDefinition | undefined => { if (!icon) { return undefined; } const trimmedIcon = icon.trim(); if (!trimmedIcon) { return undefined; } const aliasDefinition = iconAliases.get(trimmedIcon); if (aliasDefinition) { return aliasDefinition; } const iconAndDef = trimmedIcon.split(" "); if (iconAndDef.length === 1) { return iconLibrary.getIconDefinition("fas", trimmedIcon as IconName); } return iconLibrary.getIconDefinition( iconAndDef[0] as IconPrefix, iconAndDef[1] as IconName, ); }

src/app/features/location/map-utils.ts

iconDefault
Type : unknown
Default value : L.icon({ iconRetinaUrl, iconUrl, shadowUrl, iconSize: [25, 41], iconAnchor: [12, 41], popupAnchor: [1, -34], tooltipAnchor: [16, -28], shadowSize: [41, 41], })
iconRetinaUrl
Type : string
Default value : "assets/marker-icon-2x.png"
iconUrl
Type : string
Default value : "assets/marker-icon.png"
shadowUrl
Type : string
Default value : "assets/marker-shadow.png"

src/app/core/import/import.module.ts

IMPORT_ACTIONS_GROUP
Type : EntityActionGroup
Default value : { id: "import-related", label: $localize`:entity context menu:Import related`, icon: "file-import", }
importComponents
Type : ComponentTuple[]
Default value : [ [ "Import", () => import("./import/import.component").then((c) => c.ImportComponent), ], [ "DateImportConfig", () => import("../basic-datatypes/date/date-import-config/date-import-config.component").then( (c) => c.DateImportConfigComponent, ), ], [ "DateImportDialog", () => import("../basic-datatypes/date/date-import-config/date-import-dialog.component").then( (c) => c.DateImportDialogComponent, ), ], [ "DiscreteImportConfig", () => import("../basic-datatypes/discrete/discrete-import-config/discrete-import-config.component").then( (c) => c.DiscreteImportConfigComponent, ), ], [ "DiscreteImportDialog", () => import("../basic-datatypes/discrete/discrete-import-config/discrete-import-dialog.component").then( (c) => c.DiscreteImportDialogComponent, ), ], [ "EntityImportConfig", () => import("../basic-datatypes/entity/entity-import-config/entity-import-config.component").then( (c) => c.EntityImportConfigComponent, ), ], ]

src/app/core/import/import/import-sample-raw-data.ts

IMPORT_SAMPLE_ADDITIONAL_ACTIONS
Type : AdditionalImportAction[]
Default value : [ /*{ type: "School", id: IMPORT_SAMPLE_LINKABLE_DATA.find((e) => e.getType() === "School").getId( true, ), }, { type: "RecurringActivity", id: IMPORT_SAMPLE_LINKABLE_DATA.find( (e) => e.getType() === "RecurringActivity", ).getId(), },*/ ]
IMPORT_SAMPLE_COLUMN_MAPPING
Type : ColumnMapping[]
Default value : Object.keys( IMPORT_SAMPLE_RAW_DATA[0], ).map((k) => ({ column: k, }))
IMPORT_SAMPLE_LINKABLE_DATA
Type : Entity[]
Default value : [ Object.assign(createEntityOfType("School"), { name: "Sample School" }), Object.assign(createEntityOfType("School"), { name: "ABCD School" }), Object.assign(createEntityOfType("RecurringActivity"), { title: "Activity X", }), Object.assign(createEntityOfType("RecurringActivity"), { title: "Activity Y", }), ]
IMPORT_SAMPLE_PREVIOUS_IMPORTS
Type : ImportMetadata[]
Default value : [ ImportMetadata.create({ created: { by: TEST_USER, at: new Date("2022-12-27") }, createdEntities: ["1", "2", "3"], config: { entityType: "Child", columnMapping: IMPORT_SAMPLE_COLUMN_MAPPING, }, }), ImportMetadata.create({ created: { by: TEST_USER, at: new Date("2023-01-04") }, createdEntities: ["1", "3"], config: { entityType: "School", columnMapping: [] }, }), ]
IMPORT_SAMPLE_RAW_DATA
Type : any[]
Default value : [ { name: "John Doe", birthDate: "2001-01-31", gender: "M", remarks: "foo bar", }, { name: "Jane Doe", birthDate: "2001-01-31", gender: "F", remarks: "abcde", }, ]

Sample raw data that can be used in Storybook and tests.

src/app/child-dev-project/notes/dashboard-widgets/important-notes-dashboard/important-notes-index.service.ts

INDEX_ID_PREFIX
Type : string
Default value : "importantNotesDashboard"
VIEW_NAME
Type : string
Default value : "importantNotes"
WARNING_LEVEL_ENUM_ID
Type : string
Default value : "warning-levels"

src/app/features/dashboard-widgets/birthday-dashboard-widget/birthday-dashboard/birthday-dashboard-index.service.ts

INDEX_ID_PREFIX
Type : string
Default value : "birthdayDashboard"
VIEW_NAME
Type : string
Default value : "birthday"

src/app/child-dev-project/notes/model/interaction-type.interface.ts

INTERACTION_TYPE_CONFIG_ID
Type : string
Default value : "interaction-type"

ID of the Note category ConfigurableEnumValue in the config database.

src/app/core/admin/admin-role-permissions/role-permissions.service.ts

INTERNAL_ROLES
Type : miscellaneous
Default value : [ UserAdminService.ACCOUNT_MANAGER_ROLE, "no-email-2fa", ]

Technical roles that serve a special function in the authentication server (e.g. granting account-management API access, or opting a user out of email 2FA). They must not be deleted from this admin UI, and their description is managed elsewhere, so it stays read-only here. They may still carry additional permission rules like any other role.

ROLES_ADMIN_ROUTE
Type : string
Default value : "/admin/user-roles"

Base route of the role management admin UI, to link to a role's details from elsewhere. Mirrors the "user-roles" paths registered in admin.routing.ts.

src/app/core/language/language.service.ts

INVALID_LOCALE_REPORTED_KEY
Type : string
Default value : "invalid_locale_reported"

sessionStorage key marking that an invalid locale was already reported in this browser session

src/app/core/session/auth/keycloak/keycloak-auth.service.ts

KEYCLOAK_OPERATION_TIMEOUT_MS
Type : miscellaneous
Default value : 15_000

Hard upper bound on individual Keycloak network operations (init, token refresh). Picked well above expected RTT but short enough that a hung proxy/upstream surfaces a clear failure to the user.

LOGIN_RETRY_DELAYS_MS
Type : []
Default value : [1_000, 3_000]

Backoff schedule for explicit user-initiated login retries.

RESPONSE_BODY_EXCERPT_LENGTH
Type : number
Default value : 300

Length of the excerpt kept from a response body that is not OAuth error JSON.

RESPONSE_BODY_READ_TIMEOUT_MS
Type : number
Default value : 2_000

Upper bound for reading an error response body, so logging never stalls a login.

TOKEN_MIN_VALIDITY_SECONDS
Type : number
Default value : 30

Minimum remaining lifetime (in seconds) requested when refreshing the token in the background. Matches keycloak-js's updateToken(minValidity) argument.

TOKEN_REFRESH_RETRY_DELAYS_MS
Type : []
Default value : [2_000, 5_000]

Backoff schedule for background token refreshes (OnTokenExpired). Kept short — if the background refresh keeps failing, the next API call's 401 will trigger an explicit login, so there is no point retrying for many seconds and stalling the user's request.

src/app/child-dev-project/notes/deprecated/legacy-note-fields.ts

LABEL_LANGUAGES
Type : unknown
Default value : ["en", "de", "fr"] as const

languages the app has translations for (see the labels below)

LEGACY_NOTE_ATTENDANCE_FIELD
Type : { field: string; definition: EntitySchemaField }
Default value : { field: "childrenAttendance", definition: { dataType: "event-attendance-map", additional: { participant: { dataType: "entity", additional: ["Child"], }, }, anonymize: "retain", }, }

Snapshot of the deprecated childrenAttendance field that used to be declared on the Note class.

Unlike the link fields above this one was never shown in a view and never had a label: it was edited through the EditLegacyAttendance component of the children field and read by the roll-call UI of event types based on Note.

Systems that still rely on it have the definition written into their own entity:Note config by the v4-upgrade-note-legacy-child-school-fields CLI migration.

LEGACY_NOTE_FIELDS
Type : LegacyNoteField[]
Default value : [ { field: "children", entityType: "Child", definition: { dataType: "entity", isArray: true, additional: "Child", entityReferenceRole: "composite", editComponent: "EditLegacyAttendance", anonymize: "retain", }, labels: { en: "Participants", de: "Teilnehmer:innen", fr: "Participants" }, }, { field: "schools", entityType: "School", definition: { dataType: "entity", isArray: true, additional: "School", entityReferenceRole: "composite", anonymize: "retain", }, labels: { en: "Groups", de: "Gruppen", fr: "Groupes" }, }, ]

Snapshot of the @DatabaseFields that used to be declared on the Note class (in the order of the previous default bottomForm).

Note no longer defines these in code. Systems that still rely on them have the definitions written into their own entity:Note config by the v4-upgrade-note-legacy-child-school-fields CLI migration, which is the only production code using this snapshot.

(This module must stay free of runtime imports, as it is shared with the CLI - see cli/tsconfig.json.)

src/app/child-dev-project/children/demo-data-generators/fixtures/languages.ts

languages
Type : []
Default value : [ // multiple entries for the same value increase its probability "Hindi", "Hindi", "Hindi", "Urdu", "Bengali", "Bengali", "", ]

src/app/utils/media/screen-size-observer.service.ts

LG
Type : string
Default value : "992px"
MD
Type : string
Default value : "768px"
MOBILE_THRESHOLD
Type : ScreenSize
Default value : ScreenSize.sm

The screen size where anything smaller and this size itself is considered mobile while anything strictly larger is considered desktop.

SM
Type : string
Default value : "576px"
XL
Type : string
Default value : "1200px"
XXL
Type : string
Default value : "1400px"

src/app/core/basic-datatypes/entity/selection-condition.ts

linkedRecordsSources
Type : unknown
Default value : new WeakMap< AbstractControl, LinkedRecordsSource >()

src/app/core/common-components/entities-table/data-source/entities-table-data-source.ts

LOAD_ERROR_CAUSES
Type : Partial<Record<ErrorClassification, LoadErrorCause>>
Default value : { "not-permitted": "notPermitted", "session-expired": "sessionExpired", }

The cause named in the toast for a failed load, by its classification.

src/app/core/database/pouchdb/pouch-database.ts

LOCAL_DB_REVS_LIMIT
Type : number
Default value : 100

How many revisions of a document's history a local database keeps (PouchDB's revs_limit, default 1000).

The indexeddb adapter stores the revision tree as a nested object, and the browser overflows its stack writing one with many hundred revisions (#4631). Documents synced from the server are stemmed to this limit on write. A local document edited more often than this between two syncs comes back as a conflict on the server, which this limit makes very unlikely.

SECOND_QUERY_BOOKMARK
Type : string
Default value : "q2:"

Marks a bookmark of the second query (see PouchDatabase.find).

src/app/utils/di-tokens.ts

LOCAL_STORAGE_TOKEN
Type : miscellaneous
Default value : new InjectionToken<Storage>( "Window localStorage object", { providedIn: "root", factory: () => localStorage }, )

Use this instead of referencing localStorage directly.

Tests otherwise have to stub Storage.prototype, which belongs to the worker process rather than the module registry — Vitest's isolate does not undo it, so an unrestored stub leaks into every later spec file and makes unrelated tests read a fake localStorage. Injecting a fake avoids that entirely.

LOCATION_TOKEN
Type : unknown
Default value : new InjectionToken<Location>( "Window location object", )
NAVIGATOR_TOKEN
Type : unknown
Default value : new InjectionToken<Navigator>( "Window navigator object", )
WINDOW_TOKEN
Type : unknown
Default value : new InjectionToken<Window>("Window object")

Use this instead of directly referencing the window object for better testability

src/app/features/location/location-components.ts

locationComponents
Type : ComponentTuple[]
Default value : [ [ "EditLocation", () => import("./edit-location/edit-location.component").then( (c) => c.EditLocationComponent, ), ], [ "ViewLocation", () => import("./view-location/view-location.component").then( (c) => c.ViewLocationComponent, ), ], [ "DisplayDistance", () => import("./view-distance/view-distance.component").then( (c) => c.ViewDistanceComponent, ), ], [ "LocationImportConfig", () => import("./location-import-config/location-import-config.component").then( (c) => c.LocationImportConfigComponent, ), ], ]

src/app/features/location/location-import-config/location-import-config.component.ts

LOOKUP_WARNING_THRESHOLD
Type : number
Default value : 50

src/app/features/location/map-config.ts

MAP_CONFIG_KEY
Type : string
Default value : "appConfig:map"

src/app/core/common-components/entity-form/dynamic-form-validators/permission-condition-validators.ts

MATCH_ACTION
Type : string
Default value : "match"
MATCH_SUBJECT
Type : string
Default value : "PermissionConditionCheck"

src/app/features/matching-entities/matching-entities-components.ts

matchingEntitiesComponents
Type : ComponentTuple[]
Default value : [ [ "MatchingEntities", () => import("./matching-entities/matching-entities.component").then( (c) => c.MatchingEntitiesComponent, ), ], [ "AdminMatchingEntities", () => import("./admin-matching-entities/admin-matching-entities.component").then( (c) => c.AdminMatchingEntitiesComponent, ), ], ]

src/app/child-dev-project/children/demo-data-generators/educational-material/materials.ts

materials
Type : ConfigurableEnumValue[]
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:materials", ).values

src/app/child-dev-project/children/demo-data-generators/aser/skill-levels.ts

mathLevels
Type : ConfigurableEnumConfig<SkillLevel>
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:math-levels", ).values
readingLevels
Type : ConfigurableEnumConfig<SkillLevel>
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:reading-levels", ).values

src/app/core/language/TranslatableMatPaginator.ts

matRangeLabelIntl
Type : unknown
Default value : (page: number, pageSize: number, length: number) => { if (length === 0 || pageSize === 0) { return $localize`:@@paginator.zeroRange:0 in ${length}`; } length = Math.max(length, 0); const startIndex = page * pageSize; // If the start index exceeds the list length, do not try and fix the end index to the end. const endIndex = startIndex < length ? Math.min(startIndex + pageSize, length) : startIndex + pageSize; return $localize`:@@paginator.rangeOfLabel:${ startIndex + 1 } - ${endIndex} of ${length}`; }

src/app/core/admin/admin-role-permissions/permission-matrix.ts

MATRIX_ACTIONS
Type : EntityActionPermission[]
Default value : [ "read", "create", "update", "delete", "manage", ]

src/app/features/inherited-field/automated-field-update/affected-entities-calculation.ts

MAX_CALCULATIONS_PER_RECORD
Type : number
Default value : 1000

Safety limit for the calculation of the affected entities, in case their values do not settle (e.g. in a loop): how often the same record is calculated again, regardless of how many records are reached in total.

MAX_HIERARCHY_LEVELS
Type : number
Default value : 10

Number of levels above the changed entity that are included in one update dialog.

src/app/features/inherited-field/automated-field-update/automated-field-update-config.service.ts

MAX_ENTITIES_TO_REVIEW
Type : number
Default value : 100

Above this number of affected records, the dialog to review them can take long to show, so the user is asked first

src/app/core/logging/report-once.ts

MAX_INCIDENT_EVENTS
Type : number
Default value : 1

The connectivity issue only once per page load: when the connection drops, every pending request fails at the same moment. The same for a broken local database: once the device's IndexedDB is broken (the local-storage classification), every later database access of the page load fails as well - loading the config, the permission rules, the sync, each view.

MAX_REPEATED_SENTRY_EVENTS
Type : number
Default value : 5

How often an issue is reported per page load, against error loops (e.g. an error on every change detection) flooding monitoring and the quota.

reportedErrors
Type : unknown
Default value : new WeakSet<object>()

Error objects (and their causes) already part of an event of this page load.

sentryEventCounts
Type : unknown
Default value : new Map<string, number>()

src/app/core/database/pouchdb/remote-pouch-database.ts

MAX_RESPONSE_BODY_LENGTH
Type : number
Default value : 500

src/app/core/admin/admin-menu/menu-item-for-admin-ui.ts

menuItemTree
Type : FlatTreeAdapter<MenuItemForAdminUi>
Default value : { id: (item) => item.uniqueId, children: (item) => item.subMenu ?? [], withChildren: (item, subMenu) => ({ ...item, subMenu }), }

Edit the menu as a flat, indented list (see flat-tree): every menu item can hold nested sub-items.

src/app/core/database/indexeddb-migration.service.ts

MIN_INDEXEDDB_ADAPTER_VERSION
Type : unknown
Default value : 10 ** 13

The IndexedDB version of DBs of the "indexeddb" adapter (the "idb" adapter uses 5)

src/app/features/skill/skill-api/skill-api-mock.ts

mockSkillApi
Type : object
Default value : { getExternalProfiles: (): Observable<ExternalProfileResponseDto> => of({ pagination: { currentPage: 1, pageSize: 5, totalPages: 2, totalElements: 6, }, results: faker.helpers.multiple( () => createSkillApiDummyData(faker.string.numeric()), { count: { min: 0, max: 5 } }, ), }).pipe(delay(faker.number.int({ min: 500, max: 1500 }))), generateDefaultSearchParams: () => ({ fullName: "John Doe", }), getExternalProfileById: (id: string) => of(createSkillApiDummyData(id)).pipe( delay(faker.number.int({ min: 500, max: 1500 })), ), async isSkillApiEnabled() { return false; }, }

src/app/core/basic-datatypes/month/edit-month/edit-month.component.ts

MY_FORMATS
Type : object
Default value : { parse: { dateInput: "YYYY-MM", }, display: { dateInput: "YYYY-MM", monthYearLabel: "YYYY MMM", dateA11yLabel: "LL", monthYearA11yLabel: "YYYY MMMM", }, }

src/app/core/logging/sentry-grouping.ts

NETWORK_ERROR_FINGERPRINT
Type : string
Default value : "network-error"

The fingerprint of the one issue collecting all connectivity failures.

NETWORK_FAILURE
Type : string
Default value : "network failure"

Stands in for a connectivity failure, which every browser words differently.

VOLATILE_VALUE_PATTERNS
Type : unknown[]
Default value : [ // a response body quoted into the message, e.g. an error page of the proxy [/ with body ["'][\s\S]*$/i, ""], [/https?:\/\/\S+/gi, "<url>"], [ /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, "<uuid>", ], [/\b\d+-[0-9a-f]{32}\b/gi, "<rev>"], // legacy entity ids embedding a username (`User:some.person`); not "TypeError: ..." [/\b[A-Z][A-Za-z]{2,}:[A-Za-z0-9._<>-]+/g, "<entityId>"], [/\d+/g, "<n>"], ]

Values that vary between occurrences of one problem, masked before a message is used as a grouping key. The more specific patterns have to run first.

src/app/core/permissions/permission-checkbox/permission-checkbox.component.ts

nextLockDescriptionId
Type : number
Default value : 0

src/app/features/public-form/edit-publicform-route/edit-publicform-route.component.ts

noSpecialUrlChars
Type : ValidatorFn
Default value : (control: AbstractControl) => { const value: string = control.value; if (value && !/^[a-zA-Z\d\-_]+$/.test(value)) { return { pattern: { errorMessage: $localize`The link ID may only contain lowercase letters, digits, hyphens and underscores`, }, }; } return null; }

src/app/core/filter/not-archived-filter.ts

NOT_ARCHIVED_FILTER
Type : object
Default value : { $or: [{ inactive: { $ne: true } }, { inactive: { $exists: false } }], }

Select records that are not archived.

The inactive flag is only written when a record gets archived, so for the vast majority of records the property is missing entirely. A plain { inactive: { $ne: true } } does not reliably match those in a database query, so the missing case is spelled out as its own condition.

src/app/child-dev-project/notes/demo-data/notes_group-stories.ts

noteGroupStories
Type : []
Default value : [ { category: defaultInteractionTypes.find((t) => t.id === "GUARDIAN_MEETING"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Guardians Meeting`, text: $localize`:Note demo text: Our regular monthly meeting. Find the agenda and minutes in our meeting folder. `, }, { category: defaultInteractionTypes.find((t) => t.id === "GUARDIAN_MEETING"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Guardians Meeting`, text: $localize`:Note demo text: Our regular monthly meeting. Find the agenda and minutes in our meeting folder. `, }, { category: defaultInteractionTypes.find((t) => t.id === "COACHING_CLASS"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Children Meeting`, text: $localize`:Note demo text: Our regular monthly meeting. Find the agenda and minutes in our meeting folder. `, }, { category: defaultInteractionTypes.find((t) => t.id === "COACHING_CLASS"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Children Meeting`, text: $localize`:Note demo text: Our regular monthly meeting. Find the agenda and minutes in our meeting folder. `, }, { category: defaultInteractionTypes.find((t) => t.id === "COACHING_CLASS"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Drug Prevention Workshop`, text: $localize`:Note demo text: Expert conducted a two day workshop on drug prevention. `, }, ]

src/app/child-dev-project/notes/demo-data/notes_individual-stories.ts

noteIndividualStories
Type : []
Default value : [ { category: defaultInteractionTypes.find((t) => t.id === "VISIT"), warningLevel: warningLevels.find((level) => level.id === "WARNING"), subject: $localize`:Note demo subject:Mother sick`, text: $localize`:Note demo text: Visited family after we heard that mother is seriously ill. She cannot get up. Children are taking care of housework. Told her to see doctor. We should follow up next week. `, }, { category: defaultInteractionTypes.find((t) => t.id === "GUARDIAN_TALK"), warningLevel: warningLevels.find((level) => level.id === "WARNING"), subject: $localize`:Note demo subject:Discussed school change`, text: $localize`:Note demo text: Discussed future of the child with the parents. They agree that changing school can be a good option. Will discuss further together with the child. `, }, { category: defaultInteractionTypes.find((t) => t.id === "GUARDIAN_TALK"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Follow up for school absence`, text: $localize`:Note demo text: Called to ask for reason about absence. Mother made excuses but promised to send the child tomorrow. `, }, { category: defaultInteractionTypes.find((t) => t.id === "GUARDIAN_TALK"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Absent because ill`, text: $localize`:Note demo text: Mother has called in the morning. Child cannot come to class because of fever. `, }, { category: defaultInteractionTypes.find((t) => t.id === "GUARDIAN_TALK"), warningLevel: warningLevels.find((level) => level.id === "URGENT"), subject: $localize`:Note demo subject:Absence without information`, text: $localize`:Note demo text: Child was not in school whole last week again. When calling the mother she didn't know about it. Need to follow up urgently to discuss with the child and the guardians. `, }, { category: defaultInteractionTypes.find((t) => t.id === "VISIT"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:School is happy about progress`, text: $localize`:Note demo text: Visited the school and talked to the class teacher and principal. They are happy about the progress and behaviour. `, }, { category: defaultInteractionTypes.find((t) => t.id === "VISIT"), warningLevel: warningLevels.find((level) => level.id === "WARNING"), subject: $localize`:Note demo subject:Needs to work more for school`, text: $localize`:Note demo text: Discussed the child's progress with coaching teacher. He is still a weak student and needs more support. We should consider arranging an extra class for him. Discuss next social worker meeting. `, }, { category: defaultInteractionTypes.find((t) => t.id === "INCIDENT"), warningLevel: warningLevels.find((level) => level.id === "URGENT"), subject: $localize`:Note demo subject:Fight at school`, text: $localize`:Note demo text: Principal called us today. Our student got into a fight and was suspended for a week. Need to follow up with the child and discuss the matter. `, }, { category: defaultInteractionTypes.find((t) => t.id === "INCIDENT"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Special help for family`, text: $localize`:Note demo text: Since the father has lost his job the family is struggling to survive. After home visits and discussion in our team we decided to refer them to a special support programme. `, }, { category: defaultInteractionTypes.find((t) => t.id === "INCIDENT"), warningLevel: warningLevels.find((level) => level.id === "OK"), subject: $localize`:Note demo subject:Chance to repeat class`, text: $localize`:Note demo text: Child has failed this school year as she did not go to school regularly. After a long discussion with the child and her parents we agreed to support her to repeat the class and she promised to attend school regularly. `, }, { category: defaultInteractionTypes.find((t) => t.id === "NOTE"), warningLevel: warningLevels.find((level) => level.id === "WARNING"), subject: $localize`:Note demo subject:Distracted in class`, text: $localize`:Note demo text: Teacher has let us know that he is very unfocused during class these days. Discussed with him - there are a lot of problems in the family currently. `, }, { category: defaultInteractionTypes.find((t) => t.id === "NOTE"), warningLevel: warningLevels.find((level) => level.id === "WARNING"), subject: $localize`:Note demo subject:Disturbing class`, text: $localize`:Note demo text: She refused to listen to the teacher was disturbing the class. Did counselling session with her. `, }, ]

src/app/child-dev-project/notes/notes.service.ts

NOTES_BY_AUTHORS_VIEW
Type : object
Default value : { map: `(doc) => { if (!doc._id.startsWith("${Note.ENTITY_TYPE}")) return; if (!Array.isArray(doc.authors)) return; doc.authors.forEach(val => emit(val)); }`, }

Index view of notes by their authors (query key: the author's entity ID).

Currently not registered in the notes_index design doc, because nothing queries it and every registered view has to be built on each device.

src/app/child-dev-project/notes/notes-components.ts

notesComponents
Type : ComponentTuple[]
Default value : [ [ "NotesDashboard", () => import("./dashboard-widgets/notes-dashboard/notes-dashboard.component").then( (c) => c.NotesDashboardComponent, ), ], [ "NotesRelatedToEntity", () => import("./notes-related-to-entity/notes-related-to-entity.component").then( (c) => c.NotesRelatedToEntityComponent, ), ], [ "ImportantNotesDashboard", () => import("./dashboard-widgets/important-notes-dashboard/important-notes-dashboard.component").then( (c) => c.ImportantNotesDashboardComponent, ), ], [ "NoteDetails", () => import("./note-details/note-details.component").then( (c) => c.NoteDetailsComponent, ), ], [ "ImportantNotesDashboardSettings", () => import("./dashboard-widgets/important-notes-dashboard-settings.component/important-notes-dashboard-settings.component").then( (c) => c.ImportantNotesDashboardSettingsComponent, ), ], [ "NotesDashboardSettings", () => import("./dashboard-widgets/notes-dashboard-settings.component/notes-dashboard-settings.component").then( (c) => c.NotesDashboardSettingsComponent, ), ], ]

src/app/features/change-history/change-history-action-badge/change-history-action-badge.component.ts

OPERATION_META
Type : Record<ChangeOperation, OperationMeta>
Default value : { baseline: { icon: "clock-rotate-left", label: OPERATION_LABELS.baseline, background: "#ECEFF1", color: "#4a525c", tooltip: BASELINE_NOTE, }, create: { icon: "circle-plus", label: OPERATION_LABELS.create, background: "#E6F4EA", color: "#1E6C33", }, update: { icon: "pen-to-square", label: OPERATION_LABELS.update, background: "#CCEFFF", color: "#1565C0", }, delete: { icon: "trash", label: OPERATION_LABELS.delete, background: "#FBE2DE", color: "#B23A2C", }, }

Display metadata per operation. The labels are past tense while the keys are the backend's own operation names, so the wording stays a label rather than a second vocabulary the rest of the feature has to map back and forth.

Orange is reserved for app chrome, so even imported would use an orange-tint background with deep-orange text — never the brand primary fill.

src/app/core/basic-datatypes/date/date-range-filter/date-range-filter-panel/date-range-utils.ts

periodRangeOptions
Type : DateRangeFilterConfigOption[]
Default value : [ { startOffsets: [{ amount: 0, unit: "months" }], endOffsets: [{ amount: 0, unit: "months" }], label: $localize`:Filter label: Current month`, }, { startOffsets: [{ amount: -1, unit: "months" }], endOffsets: [{ amount: -1, unit: "months" }], label: $localize`:Filter label: Last month`, }, { startOffsets: [{ amount: 0, unit: "quarter" }], endOffsets: [{ amount: 0, unit: "quarter" }], label: $localize`:Filter label: Current quarter`, }, { startOffsets: [{ amount: -1, unit: "quarters" }], endOffsets: [{ amount: -1, unit: "quarters" }], label: $localize`:Filter label: Last quarter`, }, { startOffsets: [{ amount: 0, unit: "years" }], endOffsets: [{ amount: 0, unit: "years" }], label: $localize`:Filter label: Current year`, }, { startOffsets: [{ amount: -1, unit: "years" }], endOffsets: [{ amount: -1, unit: "years" }], label: $localize`:Filter label: Last year`, }, ]

Ranges of whole months, quarters and years (the current and the last one), offered e.g. when selecting the period of a report or the dates of a date range field.

src/app/core/permissions/ability/entity-ability.ts

permissionConditionsMatcher
Type : ConditionsMatcher<MongoQuery>
Default value : buildMongoQueryMatcher({ $or, $and, $nor, $not }, { or, and, nor, not })

CASL's default matcher registers only field operators ($eq, $in, $elemMatch, ...). Without the logical operators a rule like { $or: [...] } is parsed as a field literally named "$or" and therefore matches no document at all, so permissions built with them would silently grant nothing.

Exported so that anything else deciding whether a rule's conditions are met (e.g. the per-field form validators) reaches the same verdict as the ability enforcing them.

src/app/core/site-settings/site-settings.service.ts

PRE_LOGIN_UNAVAILABLE_STATUSES
Type : unknown
Default value : new Set([401, 403, 404])

Statuses with which pre-login access to the site settings is unavailable by design.

src/app/core/config/dynamic-routing/view-config.interface.ts

PREFIX_VIEW_CONFIG
Type : string
Default value : "view:"

The prefix which is used to find the ViewConfig's in the config file

src/app/features/public-form/public-forms.service.ts

PUBLIC_FORM_LINKS_GROUP
Type : EntityActionGroup
Default value : { id: "public-form-links", label: $localize`:entity context menu:Copy Custom Form link`, icon: "link", }

src/app/features/public-form/public-form-route.ts

PUBLIC_FORM_ROUTE
Type : string
Default value : "public-form"

Top-level route segment under which public (anonymous) forms are served.

Kept in a module without imports of its own, because the app bootstrap needs this value (see bootstrap-environment.ts) and must not load the public form components and their dependencies while doing so.

src/app/features/public-form/public-form-routing.ts

publicFormRoutes
Type : Routes
Default value : [ { path: "form/:id", component: PublicFormComponent, }, { path: "submission-success", component: SubmissionSuccessComponent }, ]

src/app/child-dev-project/children/demo-data-generators/observations/rating-answers.ts

ratingAnswers
Type : ConfigurableEnumValue[]
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:rating-answer", ).values

src/app/features/inherited-field/automated-field-update/automated-field-update.component.ts

RECALCULATION_DELAY_MS
Type : number
Default value : 300

How long to wait for further changes of the user before the entities above are updated

src/app/utils/related-entities-default-config.ts

RELATED_ENTITIES_DEFAULT_CONFIGS
Type : Record<string, { entityType: string; columns?: FormFieldConfig[] }>
Default value : { NotesRelatedToEntity: { entityType: "Note", columns: [ { id: "date", visibleFrom: "xs" }, { id: "subject", visibleFrom: "xs" }, { id: "text", visibleFrom: "md" }, { id: "authors", visibleFrom: "md" }, { id: "warningLevel", visibleFrom: "md" }, ], }, TodosRelatedToEntity: { entityType: "Todo", columns: [ { id: "deadline" }, { id: "subject" }, { id: "startDate" }, { id: "assignedTo" }, { id: "description", visibleFrom: "xl" }, { id: "repetitionInterval", visibleFrom: "xl" }, { id: "relatedEntities", hideFromTable: true }, { id: "completed", hideFromForm: true }, ], }, }
RELATED_ENTITY_OVERRIDES
Type : Record<string, Partial<RelatedEntitiesComponentConfig>>
Default value : { EducationalMaterial: { component: "RelatedEntitiesWithSummary", }, }

src/app/child-dev-project/children/demo-data-generators/fixtures/religions.ts

religions
Type : []
Default value : [ // multiple entries for the same value increase its probability $localize`:religion:Hindu`, $localize`:religion:Hindu`, $localize`:religion:Hindu`, $localize`:religion:Muslim`, $localize`:religion:Muslim`, $localize`:religion:Christian`, $localize`:religion:Sikh`, "", "", ]

src/app/features/reporting/reporting.module.ts

reportAdminViewConfigs
Type : ViewConfig[]
Default value : [ { _id: "view:" + ReportEntity.route, component: "EntityList", config: { entityType: ReportEntity.ENTITY_TYPE, columns: ["title", "mode", "description"], } as EntityListConfig, }, // Details / edit view { _id: "view:" + ReportEntity.route + "/:id", component: "EntityDetails", config: { entityType: ReportEntity.ENTITY_TYPE, panels: [ { components: [ { component: "Form", config: { fieldGroups: [ { fields: [ { id: "report_explanation", viewComponent: "DisplayDescriptionOnly", label: $localize`:ReportConfig:Configure a report that users can run to generate aggregated statistics or data exports. See [Analyzing data through advanced reports](https://chatwoot.help/hc/aam-digital/articles/1782889956-analyzing-data-through-advanced-reports) for how to set up and use reports.`, }, "title", "mode", "description", "transformations", ], }, { fields: ["reportDefinition"] }, ], }, }, ], }, ], } as EntityDetailsConfig, }, ]

Admin list + details views to manage ReportEntity configs, registered the same way as other "Templates and Forms" entities (e.g. EmailTemplate).

src/app/features/reporting/edit-report-definition/report-definition-ui-node.ts

reportDefinitionTree
Type : FlatTreeAdapter<ReportDefinitionUiNode>
Default value : { id: (node) => node.uniqueId, children: (node) => node.items, withChildren: (node, items) => ({ ...node, items }), }

Edit the definition as a flat, indented list: only groups can hold nested items, queries are always leaves.

src/app/core/logging/sentry-event-processing.ts

REPORTED_ERROR_PROPERTIES
Type : []
Default value : [ "entityId", "status", "reason", "name", "action", "entityType", ]
REPORTING_POLICY
Type : Partial<Record<ErrorClassification, { drop?: boolean; adjust?: void }>>
Default value : { // into the shared `network-error` issue at level warning (see `groupSentryEvent`), // once per page load (see `reportOnce`); while offline it is expected connectivity: { drop: () => !navigator.onLine }, // the user is told; the code waiting for the data is not at fault "session-expired": { drop: () => true }, // a caught one is logged at debug (see `isExpectedFailure`): this one was not // handled or is wrapped in a named error, usually a permission-configuration // state (e.g. a public form failing on every submission because the public role // may not create the record) "not-permitted": { adjust: (event) => (event.level = "warning") }, // normal for an offline-first app: the user is told by the form and it is // counted in usage analytics instead "write-conflict": { drop: () => true }, // one incident per page load (see `report-once.ts`) "local-storage": { adjust: (event) => (event.tags = { ...event.tags, incident: "local-db" }), }, }

What is done with an event by the classification of the failure it reports (see error-classification.ts). Failures without a classification are reported as they are, grouped as described in the README.

src/app/features/reporting/report-config.ts

ReportEntity
Type : unknown
Default value : ReportConfig as EntityConstructor<ReportEntity>

This allows the ReportEntity to also be used as a constructor or in the EntityMapper

src/app/features/reporting/reporting-components.ts

reportingComponents
Type : ComponentTuple[]
Default value : [ [ "Reporting", () => import("./reporting/reporting.component").then( (c) => c.ReportingComponent, ), ], [ "EditReportMode", () => import("./edit-report-mode/edit-report-mode.component").then( (c) => c.EditReportModeComponent, ), ], [ "EditReportPeriodToggle", () => import("./edit-report-period-toggle/edit-report-period-toggle.component").then( (c) => c.EditReportPeriodToggleComponent, ), ], [ "EditSqlQuery", () => import("./edit-sql-query/sql-code-editor.component").then( (c) => c.SqlCodeEditorComponent, ), ], [ "EditReportDefinition", () => import("./edit-report-definition/edit-report-definition.component").then( (c) => c.EditReportDefinitionComponent, ), ], ]

src/app/core/admin/admin.routing.ts

ROLE_MANAGEMENT_ROLES
Type : []
Default value : ["account_manager", ADMIN_APP_ROLE]

src/app/route-target.ts

RouteTarget
Type : unknown
Default value : (_name: string) => (_) => undefined

Marks a class to be the target when routing. Use this by adding the annotation @RouteTarget("...") to a component. The name provided to the annotation can then be used in the configuration.

IMPORTANT: The component also needs to be added to the ...Components list of the respective module.

src/app/core/user/user.routing.ts

routing
Type : ModuleWithProviders<RouterModule>
Default value : RouterModule.forChild(routes)

RoutingModule for UserModule related routes. Separating these routes from the main AppModule routing allows lazy-loading of modules.

src/app/features/api-client/api-client-scopes.ts

SCOPE_DOCUMENTATION
Type : Record<string, string>
Default value : { reporting_read: "https://github.com/Aam-Digital/aam-services/blob/main/docs/modules/reporting.md#api-access-to-reports", reporting_write: "https://github.com/Aam-Digital/aam-services/blob/main/docs/modules/reporting.md#api-access-to-reports", third_party_authentication: "https://github.com/Aam-Digital/aam-services/blob/main/docs/modules/third-party-authentication.md#usage", }

Documentation for the external system's developers, per client scope.

SCOPE_LABELS
Type : Record<string, string>
Default value : { reporting_read: $localize`:API client scope:Read reports and their results`, reporting_write: $localize`:API client scope:Calculate reports and get notified of changes (webhooks)`, third_party_authentication: $localize`:API client scope:Sign in users from the external system (single sign-on)`, }

Human-readable labels of the client scopes the backend offers for API clients. Scopes not listed here are shown with the description provided by the backend.

SINGLE_SIGN_ON_SCOPE
Type : string
Default value : "third_party_authentication"

The client scope that allows an external system to sign in as any user of the system.

src/app/core/common-components/entity-form/dynamic-form-validators/dynamic-validators.service.ts

SETTING_PREFIX
Type : string
Default value : "_"

keys of a validators config starting with this are settings (e.g. _warningOnly), not validators

src/app/core/common-components/entities-table/entities-table-sort.store.ts

SORT_BY_PARAM
Type : string
Default value : "_sortBy"

URL query params of the sort (with the "_" prefix of view state other than filters, see UrlStateService)

SORT_ORDER_PARAM
Type : string
Default value : "_sortOrder"

src/app/features/reporting/reporting/reporting.component.ts

STALE_THRESHOLD_SECONDS
Type : number
Default value : 60

A shown calculation older than this (seconds) is treated as stale/outdated.

src/app/core/common-components/entity-form/dynamic-form-validators/standard-field-validators.ts

standardFieldValidatorProviders
Type : Provider[]
Default value : [ RequiredValidator, MinValidator, MaxValidator, PatternValidator, MinDateValidator, MaxDateValidator, MinAgeValidator, MaxAgeValidator, UniqueIdValidator, ReadonlyAfterSetValidator, WithinParentValidator, SelectionConditionValidator, ].map((useClass) => ({ provide: FieldValidator, useClass, multi: true }))

The validation rules of the core module. Add further providers to your modules to extend.

src/app/core/common-components/entities-table/data-source/paginated-data-source.ts

STORED_BY_ID_DATATYPES
Type : []
Default value : ["configurable-enum", "entity"]

datatypes whose value is stored as the referenced id alone

src/app/core/basic-datatypes/schema-embed/schema-embed-array-entry-change.ts

storedEntries
Type : unknown
Default value : new WeakSet<object>()

Entries known to be stored in their record, even if they changed since (e.g. edited in a form of the record that is not saved yet). Entries are plain objects without an id of their own, so they are tracked by identity.

src/app/features/todos/model/demo-todo-generator.service.ts

stories
Type : Partial[]
Default value : [ { subject: $localize`:demo todo record:get signed agreement`, description: $localize`:demo todo record:We have fixed all the details but still have to put it in writing.`, }, { subject: $localize`:demo todo record:follow up`, description: $localize`:demo todo record:Call to follow up on the recent developments.`, }, { subject: $localize`:demo todo record:call family`, description: $localize`:demo todo record:Check about the latest incident.`, }, { subject: $localize`:demo todo record:plan career counselling`, description: $localize`:demo todo record:Personalized plan for the next discussion has to be prepared.`, }, ]

src/app/core/filter/string-filter/string-filter.component.ts

STRING_FILTER_DEBOUNCE_MS
Type : number
Default value : 400

Delay (ms) before a changed search text is applied, so that typing does not trigger a filter update (and, for server-side data sources, a DB request) on every single keystroke.

src/app/core/user/demo-user-generator.service.ts

TEST_USER
Type : string
Default value : "demo"

src/app/features/attendance/display-attendance/display-attendance.component.ts

THRESHOLD_URGENT
Type : number
Default value : 0.6

Thresholds for attendance percentage coloring.

THRESHOLD_WARNING
Type : number
Default value : 0.8

src/app/features/todos/recurring-interval/time-interval.ts

timeunitLabelMap
Type : Map<unitOfTime.Base, string>
Default value : new Map([ ...timeUnitsPrimary.map( (e) => [e.unit, e.label] as [unitOfTime.Base, string], ), // alternative spellings ["year", $localize`:time unit:years`], ["y", $localize`:time unit:years`], ["month", $localize`:time unit:months`], ["m", $localize`:time unit:months`], ["week", $localize`:time unit:weeks`], ["w", $localize`:time unit:weeks`], ["day", $localize`:time unit:days`], ["d", $localize`:time unit:days`], ])
timeUnitsPrimary
Type : literal type[]
Default value : [ { unit: "days", label: $localize`:time unit:days` }, { unit: "weeks", label: $localize`:time unit:weeks` }, { unit: "months", label: $localize`:time unit:months` }, { unit: "years", label: $localize`:time unit:years` }, ]

src/app/features/todos/model/todo-filters.ts

TODO_COMPLETED_FILTER
Type : unknown
Default value : { $and: [{ completed: { $exists: true } }, { completed: { $ne: null } }], } as DataFilter<Todo>

Select Todo records that have been completed.

TODO_NOT_COMPLETED_FILTER
Type : unknown
Default value : { $or: [{ completed: { $exists: false } }, { completed: { $eq: null } }], } as DataFilter<Todo>

Select Todo records that have not been completed.

TodoService.uncompleteTodo resets completed to null instead of removing the property, so records without the property and records holding null both have to be matched. Each branch is an object (rather than a plain null value) so that the filter can also be used as the initial filter of a list, where FilterService inspects it to prefill new records.

src/app/core/filter/filters/translatableTextFilter.ts

TRANSLATION_KEYS
Type : readonly string[]
Default value : [ ...new Set( AVAILABLE_LOCALE_IDS.flatMap((locale) => [locale, baseLanguage(locale)]), ), ]

The keys a translation map can use, as accepted by isTranslatableText.

src/app/utils/typed-http-error.interceptor.ts

TYPED_HTTP_ERRORS
Type : Record<HttpErrorClassification, { type: TypedError; message: string }>
Default value : { connectivity: { type: ConnectivityError, message: "Failed to fetch from" }, "server-error": { type: ServerError, message: "Server error response from" }, "not-permitted": { type: NotPermittedError, message: "Request not permitted by", }, "session-expired": { type: SessionExpiredError, message: "Session expired for request to", }, "write-conflict": { type: WriteConflictError, message: "Write conflict response from", }, }

The typed error of each classification, and its message. Static, as the message of a classified error is its issue title and grouping key: the url (with ids and query parameters, which may hold personal data) goes into the error's details, without the query (and as requestPath with ids masked, which tells server errors of different endpoints apart).

typedHttpErrorInterceptor
Type : miscellaneous
Default value : (request, next) => isBackendRequest(request.url) ? next(request).pipe( catchError((err) => from(withReadableBody(err)).pipe( switchMap((failure) => throwError(() => toTypedHttpError(failure, request)), ), ), ), ) : next(request)

Where failed responses of our own backend (the database and API proxies) enter the app through HttpClient: a classified failure is converted into its typed error (see TYPED_HTTP_ERRORS), with the HttpErrorResponse as its cause and its status kept.

Other failures (e.g. a 400 or 404 the caller handles) stay an HttpErrorResponse, as do responses of other services (Keycloak, the address lookup, ...), whose statuses mean something else and which their callers handle themselves. Callers read the response (e.g. its body) of either with failedHttpResponse().

src/app/core/permissions/permissions-config.service.ts

UNDO_DURATION_MS
Type : number
Default value : 8000

how long the "Undo" action stays available after a permissions change

src/app/core/common-components/entity-form/unique-property-validator/unique-property-validator.ts

UNIQUE_PROPERTY_ERROR_KEY
Type : miscellaneous
Default value : "uniqueProperty"

src/app/features/de-duplication/duplicate-detection.service.ts

UNMATCHABLE_DATATYPES
Type : unknown
Default value : new Set([ "location", "time-interval", "event-attendance-map", "attendance", "schema-embed", ])

Datatypes whose value normalizeValue cannot reduce to a comparable string, so that selecting such a field could only ever produce zero matches.

src/app/core/analytics/usage-analytics-config.ts

USAGE_ANALYTICS_CONFIG_ID
Type : string
Default value : "appConfig:usage-analytics"

src/app/features/email-client/email-client.module.ts

viewConfigs
Type : ViewConfig[]
Default value : [ { _id: "view:" + EmailTemplate.route, component: "EntityList", config: { entityType: EmailTemplate.ENTITY_TYPE, columns: ["subject", "body", "availableForEntityTypes", "category"], } as EntityListConfig, }, // Details View { _id: "view:" + EmailTemplate.route + "/:id", component: "EntityDetails", config: { entityType: EmailTemplate.ENTITY_TYPE, panels: [ { components: [ { component: "Form", config: { fieldGroups: [ { fields: ["subject", "body"], }, { fields: ["availableForEntityTypes", "category"], }, ], }, }, ], }, ], } as EntityDetailsConfig, }, ]

src/app/child-dev-project/warning-level.ts

warningLevels
Type : Ordering.EnumValue[]
Default value : demoEnums.find( (e) => e._id === "ConfigurableEnum:warning-levels", ).values

results matching ""

    No results matching ""