Skip to main content

Configuration Table Catalog (Studio → DB → Renderer)

This catalog maps studio designers and runtime renderers to their typical configuration tables. Exact column names vary by migration history; align with data-model-conventions.md.

Designers ↔ persistence

Studio mode (StudioRouter)Typical SQL table(s)Renderer consumers
page-designerapp_page_configs (entity route prf_code: page_configs)Page renderer, dialogs embedding forms
dataview-designerapp_dataview_configsUnifiedDataViewer
workflow-designerapp_workflow_configs (+ runtime instance tables)Workflow execution UI, approvals
scrumboard-designerapp_scrumboard_configsScrumboard runtime
document-studioapt_files, apt_* doc hierarchy tablesDocumentViewer / studio preview

Spelling: platform uses scrumboard, not scrumbiard.

Canonical entity codes (frontend source of truth)

These are the intended entity_code values for /api/entity/:entity_code/* calls. The constant PAGE_CONFIGS_ENTITY_CODE is exported from axiom-genesis-frontend/src/services/node-config.service.ts (same as ENTITY_CODES.PAGESpage_configs prf_code). Use it for:

  • Workflow NODE_CONFIG_* schema rows (same physical table as many page/form configs).
  • Any new code that loads page config by pgc_code via get_by_filter.
ArtifactSQL table (typical)Entity code for generic CRUDNotes
Page / form config rowsapp_page_configsENTITY_CODES.PAGESpage_configs (prf_code in app_object_profiles; physical table app_page_configs)Use src/constants/entity.constants.ts everywhere (studio save, renderers, workflow NODE_CONFIG fetches via PAGE_CONFIGS_ENTITY_CODE re-export). Primary key field remains pgc_id.
Dataview configapp_dataview_configsdataview_configs
Workflow definitionapp_workflow_configsworkflow_configsMatches studio save branch in UnifiedDataViewer.
Scrumboard configapp_scrumboard_configsscrumboard_configs

Rule for agents: The URL / recordService first argument must match app_object_profiles.prf_code (entity_code), not app_object_registries.obj_code. Use prf_obj_code = obj_code to join profile → registry. Before adding another frontend alias, confirm which prf_code row is active for that tenant/profile in app_object_profiles.

Renderer entity code hints

UnifiedDataViewer resolves designer types to entity codes for embedded save operations — mapping:

  • Page designer → page_configs (prf_code)
  • Workflow designer → workflow_configs
  • Scrumboard designer → scrumboard_configs
  • Dataview designer → dataview_configs

Source: axiom-genesis-frontend/src/components/workspace/viewer/dataviewer/UnifiedDataViewer.tsx (designer-type switch).

Agents must treat these strings as hints: verify against app_object_registries for the target deployment.

Other configuration tables (observed in DB introspection)

From read-only introspection (scripts/db-readonly-introspection.js against dev DB), dbo tables included:

  • app_dashboard_configs
  • app_navigation_configs
  • app_templates
  • app_connections
  • app_roles
  • app_applications, app_subscriptions, app_config_versions

These typically align with:

  • Dashboard renderer / workspace dashboard routes
  • Dynamic navigation (navigation.service.ts)
  • Integration connectors for datasource picks in studio

Dashboard & navigation

  • Navigation: configured rows consumed when building menus (fn_get_app_navigation_configs_by_tenant_role entity route in frontend services).
  • Dashboard: widget layout JSON stored in dashboard config tables; rendered under workspace dashboard routes.

When adding features, prefer adding JSON schema inside existing config columns plus registry/profile updates over adding bespoke tables.