# Ironstar EventCatalog Documentation

> Event-driven architecture documentation for the Ironstar scientific data analysis platform. Discover domains, explore services and their dependencies, and understand the message contracts that connect our infrastructure.

## Events
- [Catalog Metadata Refreshed - CatalogMetadataRefreshed - 0.0.1 ](https://github.com/docs/events/CatalogMetadataRefreshed/0.0.1.mdx) - Raised when catalog metadata is refreshed, updating dataset list and schema versions.
- [Catalog Selected - CatalogSelected - 0.0.1 ](https://github.com/docs/events/CatalogSelected/0.0.1.mdx) - Raised when user selects a DuckLake catalog from the available catalogs list.
- [Chart Added - ChartAdded - 0.0.1 ](https://github.com/docs/events/ChartAdded/0.0.1.mdx) - Recorded when a Data Analyst adds a chart to a dashboard with position and size.
- [Chart Moved To Tab - ChartMovedToTab - 0.0.1 ](https://github.com/docs/events/ChartMovedToTab/0.0.1.mdx) - Recorded when a Data Analyst moves a chart from one tab to another within a dashboard.
- [Chart Removed - ChartRemoved - 0.0.1 ](https://github.com/docs/events/ChartRemoved/0.0.1.mdx) - Recorded when a Data Analyst removes a chart from a dashboard.
- [Dashboard Created - DashboardCreated - 0.0.1 ](https://github.com/docs/events/DashboardCreated/0.0.1.mdx) - Recorded when a Data Analyst creates a new dashboard with a name and initial layout.
- [Dashboard Renamed - DashboardRenamed - 0.0.1 ](https://github.com/docs/events/DashboardRenamed/0.0.1.mdx) - Recorded when a Data Analyst renames a dashboard.
- [LayoutDefaultsUpdated - LayoutDefaultsUpdated - 0.1.0 ](https://github.com/docs/events/LayoutDefaultsUpdated/0.1.0.mdx) - Layout defaults for new dashboards have been updated- [Query Session Cancelled - QuerySessionCancelled - 0.0.1 ](https://github.com/docs/events/QuerySessionCancelled/0.0.1.mdx) - Raised when a user cancels a running query.
- [Query Session Completed - QuerySessionCompleted - 0.0.1 ](https://github.com/docs/events/QuerySessionCompleted/0.0.1.mdx) - Raised when a query returns results successfully.
- [Query Session Failed - QuerySessionFailed - 0.0.1 ](https://github.com/docs/events/QuerySessionFailed/0.0.1.mdx) - Raised when a query encounters an error during execution.
- [Query Session Started - QuerySessionStarted - 0.0.1 ](https://github.com/docs/events/QuerySessionStarted/0.0.1.mdx) - Raised when a SQL query begins execution against a DuckLake dataset.
- [Saved Query Created - SavedQueryCreated - 0.0.1 ](https://github.com/docs/events/SavedQueryCreated/0.0.1.mdx) - Recorded when a Data Analyst saves a composed SQL statement with a name and dataset reference.
- [Saved Query Dataset Ref Updated - SavedQueryDatasetRefUpdated - 0.0.1 ](https://github.com/docs/events/SavedQueryDatasetRefUpdated/0.0.1.mdx) - Recorded when a Data Analyst updates the dataset reference of a saved query.
- [Saved Query Deleted - SavedQueryDeleted - 0.0.1 ](https://github.com/docs/events/SavedQueryDeleted/0.0.1.mdx) - Recorded when a Data Analyst deletes a saved query that is not required by active dashboards.
- [Saved Query Renamed - SavedQueryRenamed - 0.0.1 ](https://github.com/docs/events/SavedQueryRenamed/0.0.1.mdx) - Recorded when a Data Analyst renames an existing saved query.
- [Saved Query SQL Updated - SavedQuerySqlUpdated - 0.0.1 ](https://github.com/docs/events/SavedQuerySqlUpdated/0.0.1.mdx) - Recorded when a Data Analyst updates the SQL text of an existing saved query.
- [Session Created - SessionCreated - 0.0.1 ](https://github.com/docs/events/SessionCreated/0.0.1.mdx) - Emitted when a new authenticated session is created following successful OAuth callback.
- [Session Expired - SessionExpired - 0.0.1 ](https://github.com/docs/events/SessionExpired/0.0.1.mdx) - Emitted when a session's TTL elapses without activity and the session is expired.
- [Session Invalidated - SessionInvalidated - 0.0.1 ](https://github.com/docs/events/SessionInvalidated/0.0.1.mdx) - Emitted when a user explicitly logs out and their session is invalidated.
- [Session Refreshed - SessionRefreshed - 0.0.1 ](https://github.com/docs/events/SessionRefreshed/0.0.1.mdx) - Emitted when an active session's TTL is extended due to user activity.
- [Tab Added - TabAdded - 0.0.1 ](https://github.com/docs/events/TabAdded/0.0.1.mdx) - Recorded when a Data Analyst adds a new tab to organize charts within a dashboard.
- [Tab Removed - TabRemoved - 0.0.1 ](https://github.com/docs/events/TabRemoved/0.0.1.mdx) - Recorded when a Data Analyst removes a tab from a dashboard.
- [User Preferences Initialized - UserPreferencesInitialized - 0.0.1 ](https://github.com/docs/events/UserPreferencesInitialized/0.0.1.mdx) - Recorded when a new user without stored preferences initializes their preferences.
- [User Preferences Locale Set - UserPreferencesLocaleSet - 0.0.1 ](https://github.com/docs/events/UserPreferencesLocaleSet/0.0.1.mdx) - Recorded when a Data Analyst sets their preferred locale for UI localization.
- [User Preferences Theme Set - UserPreferencesThemeSet - 0.0.1 ](https://github.com/docs/events/UserPreferencesThemeSet/0.0.1.mdx) - Recorded when a Data Analyst sets the theme to Light, Dark, or System.
- [User Preferences UI State Updated - UserPreferencesUiStateUpdated - 0.0.1 ](https://github.com/docs/events/UserPreferencesUiStateUpdated/0.0.1.mdx) - Recorded when a Data Analyst updates stored UI state JSON (e.g., panel sizes, collapsed sections).
- [Visibility Changed - VisibilityChanged - 0.0.1 ](https://github.com/docs/events/VisibilityChanged/0.0.1.mdx) - Recorded when a workspace's visibility setting is changed.
- [Workspace Created - WorkspaceCreated - 0.0.1 ](https://github.com/docs/events/WorkspaceCreated/0.0.1.mdx) - Recorded when a new workspace is created with owner, name, and visibility settings.
- [WorkspaceDefaultCatalogCleared - WorkspaceDefaultCatalogCleared - 0.1.0 ](https://github.com/docs/events/WorkspaceDefaultCatalogCleared/0.1.0.mdx) - Default catalog selection has been removed- [WorkspaceDefaultCatalogSet - WorkspaceDefaultCatalogSet - 0.1.0 ](https://github.com/docs/events/WorkspaceDefaultCatalogSet/0.1.0.mdx) - Default catalog has been set for the workspace- [WorkspacePreferencesInitialized - WorkspacePreferencesInitialized - 0.1.0 ](https://github.com/docs/events/WorkspacePreferencesInitialized/0.1.0.mdx) - Workspace preferences aggregate has been created- [Workspace Renamed - WorkspaceRenamed - 0.0.1 ](https://github.com/docs/events/WorkspaceRenamed/0.0.1.mdx) - Recorded when a workspace's display name is changed.


## Commands
- [Add Chart - AddChart - 0.0.1 ](https://github.com/docs/commands/AddChart/0.0.1.mdx) - Command to add a chart visualization to an existing dashboard with position and size.
- [Add Tab - AddTab - 0.0.1 ](https://github.com/docs/commands/AddTab/0.0.1.mdx) - Command to add a new tab to a dashboard for grouping related charts.
- [Cancel Query - CancelQuery - 0.0.1 ](https://github.com/docs/commands/CancelQuery/0.0.1.mdx) - Cancels a running query execution.
- [ClearWorkspaceDefaultCatalog - ClearWorkspaceDefaultCatalog - 0.1.0 ](https://github.com/docs/commands/ClearWorkspaceDefaultCatalog/0.1.0.mdx) - Removes the default catalog selection from workspace preferences- [Create Dashboard - CreateDashboard - 0.0.1 ](https://github.com/docs/commands/CreateDashboard/0.0.1.mdx) - Command to create a new dashboard with a name for organizing and sharing insights.
- [Create Session - CreateSession - 0.0.1 ](https://github.com/docs/commands/CreateSession/0.0.1.mdx) - Command to create a new authenticated session after successful OAuth callback.
- [Create Workspace - CreateWorkspace - 0.0.1 ](https://github.com/docs/commands/CreateWorkspace/0.0.1.mdx) - Command to create a new workspace with owner, name, and visibility settings.
- [Delete Saved Query - DeleteSavedQuery - 0.0.1 ](https://github.com/docs/commands/DeleteSavedQuery/0.0.1.mdx) - Command to delete an obsolete saved query from the workspace.
- [Expire Session - ExpireSession - 0.0.1 ](https://github.com/docs/commands/ExpireSession/0.0.1.mdx) - Command to mark a session as expired when its TTL has elapsed without activity.
- [Initialize Preferences - InitializePreferences - 0.0.1 ](https://github.com/docs/commands/InitializePreferences/0.0.1.mdx) - Command to initialize preferences for a new user with sensible defaults.
- [InitializeWorkspacePreferences - InitializeWorkspacePreferences - 0.1.0 ](https://github.com/docs/commands/InitializeWorkspacePreferences/0.1.0.mdx) - Creates default preferences for a new workspace- [Invalidate Session - InvalidateSession - 0.0.1 ](https://github.com/docs/commands/InvalidateSession/0.0.1.mdx) - Command to explicitly invalidate a session when a user logs out.
- [Move Chart To Tab - MoveChartToTab - 0.0.1 ](https://github.com/docs/commands/MoveChartToTab/0.0.1.mdx) - Command to move a chart from one tab to another within a dashboard.
- [Refresh Catalog Metadata - RefreshCatalogMetadata - 0.0.1 ](https://github.com/docs/commands/RefreshCatalogMetadata/0.0.1.mdx) - Refreshes metadata for the active catalog from the DuckLake source.
- [Refresh Session - RefreshSession - 0.0.1 ](https://github.com/docs/commands/RefreshSession/0.0.1.mdx) - Command to extend an active session's TTL due to user activity.
- [Remove Chart - RemoveChart - 0.0.1 ](https://github.com/docs/commands/RemoveChart/0.0.1.mdx) - Command to remove a chart from a dashboard.
- [Remove Tab - RemoveTab - 0.0.1 ](https://github.com/docs/commands/RemoveTab/0.0.1.mdx) - Command to remove a tab from a dashboard.
- [Rename Dashboard - RenameDashboard - 0.0.1 ](https://github.com/docs/commands/RenameDashboard/0.0.1.mdx) - Command to change the display title of a dashboard.
- [Rename Saved Query - RenameSavedQuery - 0.0.1 ](https://github.com/docs/commands/RenameSavedQuery/0.0.1.mdx) - Command to change the display name of an existing saved query.
- [Rename Workspace - RenameWorkspace - 0.0.1 ](https://github.com/docs/commands/RenameWorkspace/0.0.1.mdx) - Command to change the display name of an existing workspace.
- [Save Query - SaveQuery - 0.0.1 ](https://github.com/docs/commands/SaveQuery/0.0.1.mdx) - Command to save a new query with a name, SQL text, and dataset reference.
- [Select Catalog - SelectCatalog - 0.0.1 ](https://github.com/docs/commands/SelectCatalog/0.0.1.mdx) - Selects a DuckLake catalog as the active context for query operations.
- [Set Locale - SetLocale - 0.0.1 ](https://github.com/docs/commands/SetLocale/0.0.1.mdx) - Command to set the user's preferred locale for UI localization.
- [Set Theme - SetTheme - 0.0.1 ](https://github.com/docs/commands/SetTheme/0.0.1.mdx) - Command to change the user's theme preference to Light, Dark, or System.
- [Set Visibility - SetVisibility - 0.0.1 ](https://github.com/docs/commands/SetVisibility/0.0.1.mdx) - Command to change the visibility setting of an existing workspace.
- [SetWorkspaceDefaultCatalog - SetWorkspaceDefaultCatalog - 0.1.0 ](https://github.com/docs/commands/SetWorkspaceDefaultCatalog/0.1.0.mdx) - Sets the default catalog for the workspace- [Start Query - StartQuery - 0.0.1 ](https://github.com/docs/commands/StartQuery/0.0.1.mdx) - Initiates SQL query execution against a DuckLake dataset.
- [Update Dataset Reference - UpdateDatasetReference - 0.0.1 ](https://github.com/docs/commands/UpdateDatasetReference/0.0.1.mdx) - Command to retarget a saved query to a different dataset.
- [UpdateLayoutDefaults - UpdateLayoutDefaults - 0.1.0 ](https://github.com/docs/commands/UpdateLayoutDefaults/0.1.0.mdx) - Persists default layout settings for new dashboard creation- [Update Saved Query SQL - UpdateSavedQuerySql - 0.0.1 ](https://github.com/docs/commands/UpdateSavedQuerySql/0.0.1.mdx) - Command to update the SQL text of an existing saved query.
- [Update UI State - UpdateUiState - 0.0.1 ](https://github.com/docs/commands/UpdateUiState/0.0.1.mdx) - Command to persist UI state changes (panel sizes, collapsed sections, etc.).


## Queries
- [Dataset Browser View - DatasetBrowserView - 0.0.1 ](https://github.com/docs/queries/DatasetBrowserView/0.0.1.mdx) - Returns dataset structure for browsing tables and columns.
- [Get Active Session - GetActiveSession - 0.0.1 ](https://github.com/docs/queries/GetActiveSession/0.0.1.mdx) - Query to retrieve the current active session for a user.
- [Get Catalog Details - GetCatalogDetails - 0.0.1 ](https://github.com/docs/queries/GetCatalogDetails/0.0.1.mdx) - Returns detailed metadata for the selected catalog including dataset list.
- [Get Current UI State - GetCurrentUiState - 0.0.1 ](https://github.com/docs/queries/GetCurrentUiState/0.0.1.mdx) - Query to retrieve the user's persisted UI state for layout restoration.
- [Get Dashboard Details - GetDashboardDetails - 0.0.1 ](https://github.com/docs/queries/GetDashboardDetails/0.0.1.mdx) - Query to retrieve metadata and summary information for a specific dashboard.
- [Get Dashboard Layout - GetDashboardLayout - 0.0.1 ](https://github.com/docs/queries/GetDashboardLayout/0.0.1.mdx) - Query to retrieve the complete layout configuration of a dashboard including charts and tabs.
- [Get Preferences - GetPreferences - 0.0.1 ](https://github.com/docs/queries/GetPreferences/0.0.1.mdx) - Query to retrieve the current user's preferences including theme and default catalog.
- [Get Query Editor State - GetQueryEditorState - 0.0.1 ](https://github.com/docs/queries/GetQueryEditorState/0.0.1.mdx) - Query to retrieve the current state of the query editor including active query and dataset.
- [Get Query Status - GetQueryStatus - 0.0.1 ](https://github.com/docs/queries/GetQueryStatus/0.0.1.mdx) - Returns the final status and results metadata for a completed query.
- [Get Saved Query Details - GetSavedQueryDetails - 0.0.1 ](https://github.com/docs/queries/GetSavedQueryDetails/0.0.1.mdx) - Query to retrieve full details of a specific saved query.
- [Get Session TTL - GetSessionTTL - 0.0.1 ](https://github.com/docs/queries/GetSessionTTL/0.0.1.mdx) - Query to retrieve the remaining time-to-live for an active session.
- [Get User Profile - GetUserProfile - 0.0.1 ](https://github.com/docs/queries/GetUserProfile/0.0.1.mdx) - Query to retrieve user profile information including preferences and authentication details.
- [Get Workspace Preferences - GetWorkspacePreferences - 0.0.1 ](https://github.com/docs/queries/GetWorkspacePreferences/0.0.1.mdx) - Query to retrieve workspace-scoped preferences including default catalog and layout defaults.
- [List Available Catalogs - ListAvailableCatalogs - 0.0.1 ](https://github.com/docs/queries/ListAvailableCatalogs/0.0.1.mdx) - Query to retrieve all catalogs available for selection as the user's default.
- [List Chart Definitions - ListChartDefinitions - 0.0.1 ](https://github.com/docs/queries/ListChartDefinitions/0.0.1.mdx) - Query to retrieve available chart definitions that can be added to dashboards.
- [List Dashboards - ListDashboards - 0.0.1 ](https://github.com/docs/queries/ListDashboards/0.0.1.mdx) - Query to retrieve all dashboards owned by or shared with the current user.
- [List Idle Sessions - ListIdleSessions - 0.0.1 ](https://github.com/docs/queries/ListIdleSessions/0.0.1.mdx) - Query to list sessions approaching expiration due to inactivity.
- [List Saved Queries - ListSavedQueries - 0.0.1 ](https://github.com/docs/queries/ListSavedQueries/0.0.1.mdx) - Query to retrieve all saved queries owned by the current user.
- [Load OAuth Callback Data - LoadOAuthCallbackData - 0.0.1 ](https://github.com/docs/queries/LoadOAuthCallbackData/0.0.1.mdx) - Query to retrieve and validate OAuth callback parameters for session creation.
- [Load Running Query Session - LoadRunningQuerySession - 0.0.1 ](https://github.com/docs/queries/LoadRunningQuerySession/0.0.1.mdx) - Returns the current state of a running query session.


## Services
- [Catalog Service - CatalogService - 0.0.1 ](https://github.com/docs/services/CatalogService/0.0.1.mdx) - Manages DuckLake catalog selection and metadata synchronization.
- [Dashboard Service - DashboardService - 0.0.1 ](https://github.com/docs/services/DashboardService/0.0.1.mdx) - Manages dashboard layout configuration including chart placements, tabs, and grid positioning.
- [Query Session Service - QuerySessionService - 0.0.1 ](https://github.com/docs/services/QuerySessionService/0.0.1.mdx) - Manages analytical query execution lifecycle from start through completion, failure, or cancellation.
- [Saved Query Service - SavedQueryService - 0.0.1 ](https://github.com/docs/services/SavedQueryService/0.0.1.mdx) - Manages user-defined reusable SQL queries with dataset references.
- [Session Service - SessionService - 0.0.1 ](https://github.com/docs/services/SessionService/0.0.1.mdx) - Handles OAuth authentication callbacks and session lifecycle management.
- [User Preferences Service - UserPreferencesService - 0.0.1 ](https://github.com/docs/services/UserPreferencesService/0.0.1.mdx) - Manages user-scoped settings (theme, locale, UI state) that apply globally across all workspaces.
- [Workspace Preferences Service - WorkspacePreferencesService - 0.0.1 ](https://github.com/docs/services/WorkspacePreferencesService/0.0.1.mdx) - Manages workspace-scoped settings: default catalog selection and layout defaults for new dashboards.
- [Workspace Service - WorkspaceService - 0.0.1 ](https://github.com/docs/services/WorkspaceService/0.0.1.mdx) - Manages workspace lifecycle including creation, naming, ownership, and visibility settings.


## Domains
- [Analytics - Analytics - 0.0.1 ](https://github.com/docs/domains/Analytics/0.0.1.mdx) - Core domain for scientific data analysis. Manages DuckLake catalog selection and query execution with chart visualization.
- [Core - Core - 0.0.1 ](https://github.com/docs/domains/Core/0.0.1.mdx) - Shared Kernel containing cross-cutting value objects used across all bounded contexts.
- [Session - Session - 0.0.1 ](https://github.com/docs/domains/Session/0.0.1.mdx) - Supporting domain managing OAuth-based authentication and session lifecycle.
Provides authenticated User identity to other bounded contexts via Shared Kernel pattern.
- [Workspace - Workspace - 0.0.1 ](https://github.com/docs/domains/Workspace/0.0.1.mdx) - Supporting domain for persistent workspace configuration. Manages workspaces containing dashboards, saved queries, and workspace preferences, plus user-scoped preferences.


## Flows
- [Dashboard Management - DashboardManagement - 0.0.1 ](https://github.com/docs/flows/DashboardManagement/0.0.1.mdx) - Dashboard CRUD operations from creation through chart and tab management to renaming.

- [Data Analysis Workflow - DataAnalysisWorkflow - 0.0.1 ](https://github.com/docs/flows/DataAnalysisWorkflow/0.0.1.mdx) - End-to-end golden path from OAuth authentication through catalog selection, query execution, and dashboard creation.

- [Query Execution - QueryExecution - 0.0.1 ](https://github.com/docs/flows/QueryExecution/0.0.1.mdx) - Analytics query workflow from catalog selection through metadata refresh to query execution and result handling.

- [Saved Query Management - SavedQueryManagement - 0.0.1 ](https://github.com/docs/flows/SavedQueryManagement/0.0.1.mdx) - Saved query CRUD operations from creation through SQL and dataset updates to deletion.

- [Session Lifecycle - SessionLifecycle - 0.0.1 ](https://github.com/docs/flows/SessionLifecycle/0.0.1.mdx) - Session state machine from creation through refresh cycles to termination via invalidation or expiration.

- [User Preferences Setup - UserPreferencesSetup - 0.0.1 ](https://github.com/docs/flows/UserPreferencesSetup/0.0.1.mdx) - User preferences configuration from initialization through theme and default catalog settings to UI state persistence.

- [Workspace Lifecycle - WorkspaceLifecycle - 0.0.1 ](https://github.com/docs/flows/WorkspaceLifecycle/0.0.1.mdx) - Workspace creation, configuration, and deletion lifecycle managing the container for dashboards and saved queries.


## Channels
- [Analytics Events Channel - events.analytics - 0.0.1 - protocol - zenoh](https://github.com/docs/channels/events.analytics/0.0.1.mdx) - Zenoh key expression pattern for Analytics domain events including catalog selection and query execution.
- [Session Events Channel - events.session - 0.0.1 - protocol - zenoh](https://github.com/docs/channels/events.session/0.0.1.mdx) - Zenoh key expression pattern for Session domain events including creation, refresh, and termination.
- [Workspace Events Channel - events.workspace - 0.0.1 - protocol - zenoh](https://github.com/docs/channels/events.workspace/0.0.1.mdx) - Zenoh key expression pattern for Workspace domain events including dashboards, saved queries, and user preferences.

## Ubiquitous Language
- Analytics Domain
    - [Catalog: - DuckLake catalog instance providing access to queryable datasets.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Dataset: - Queryable table within a DuckLake catalog.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Dataset Reference: - Composite identifier combining catalog URI and dataset name.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Query Session: - Lifecycle manager for interactive SQL query execution.](https://github.com/docs/domains/Analytics/language.mdx)
    - [SQL Query: - Type-safe wrapper for SQL query text submitted for execution.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Query Results: - Columnar result data returned from successful query execution.](https://github.com/docs/domains/Analytics/language.mdx)
    - [DuckLake: - Lakehouse catalog format providing versioned, queryable data storage.](https://github.com/docs/domains/Analytics/language.mdx)
    - [OLAP: - Online analytical processing for complex queries over large datasets.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Catalog URI: - Location identifier for a DuckLake catalog instance.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Catalog Metadata: - Schema information and statistics about datasets in a catalog.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Health Status: - Current availability state of a catalog connection.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Query ID: - Unique identifier for a specific query execution instance.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Error Message: - Diagnostic information from failed query execution.](https://github.com/docs/domains/Analytics/language.mdx)
    - [Chart Configuration: - Visualization settings for rendering query results.](https://github.com/docs/domains/Analytics/language.mdx)
- Core Domain
    - [Shared Kernel: - Domain-agnostic types shared across all bounded contexts.](https://github.com/docs/domains/Core/language.mdx)
    - [Timestamp: - Unix timestamp in milliseconds representing an instant in time.](https://github.com/docs/domains/Core/language.mdx)
    - [Duration: - Elapsed time in milliseconds between two points in time.](https://github.com/docs/domains/Core/language.mdx)
    - [Value Object: - Immutable type defined by attributes rather than identity.](https://github.com/docs/domains/Core/language.mdx)
    - [Cross-cutting Concern: - Functionality that spans multiple bounded contexts.](https://github.com/docs/domains/Core/language.mdx)
    - [Event Envelope: - Metadata wrapper containing timestamps and routing information for events.](https://github.com/docs/domains/Core/language.mdx)
    - [Sum Type: - Algebraic data type representing one of several mutually exclusive variants.](https://github.com/docs/domains/Core/language.mdx)
    - [Product Type: - Algebraic data type combining multiple fields into a single composite value.](https://github.com/docs/domains/Core/language.mdx)
    - [Decider: - Pure function triple (decide, evolve, initial_state) for aggregate behavior.](https://github.com/docs/domains/Core/language.mdx)
    - [Signal: - Time-varying value in functional reactive programming.](https://github.com/docs/domains/Core/language.mdx)
    - [Aggregate: - Consistency boundary grouping related entities and enforcing invariants.](https://github.com/docs/domains/Core/language.mdx)
    - [Projection: - Read model derived exclusively from the event stream.](https://github.com/docs/domains/Core/language.mdx)
    - [Event Sourcing: - Persistence pattern storing state changes as an immutable sequence of events.](https://github.com/docs/domains/Core/language.mdx)
- Session Domain
    - [Session: - Authenticated user session with TTL-based lifecycle management](https://github.com/docs/domains/Session/language.mdx)
    - [User: - OAuth-authenticated identity exported via Shared Kernel pattern](https://github.com/docs/domains/Session/language.mdx)
    - [OAuth Provider: - External authentication service (GitHub primary, Google planned)](https://github.com/docs/domains/Session/language.mdx)
    - [Composite Key: - User identity as (provider, externalId) tuple for stable references](https://github.com/docs/domains/Session/language.mdx)
    - [External ID: - Provider-assigned unique identifier stable across sessions](https://github.com/docs/domains/Session/language.mdx)
    - [Session ID: - Opaque identifier for session lifecycle tracking](https://github.com/docs/domains/Session/language.mdx)
    - [Session Token: - Bearer credential for authenticating HTTP requests](https://github.com/docs/domains/Session/language.mdx)
    - [Session Created: - Event recording successful OAuth callback and session establishment](https://github.com/docs/domains/Session/language.mdx)
    - [Session Expired: - Event recording automatic TTL-based session termination](https://github.com/docs/domains/Session/language.mdx)
    - [Session Invalidated: - Event recording explicit user logout](https://github.com/docs/domains/Session/language.mdx)
    - [Active Session View: - Read model projection for authentication checks](https://github.com/docs/domains/Session/language.mdx)
    - [Shared Kernel: - Pattern for exporting User identity to other bounded contexts](https://github.com/docs/domains/Session/language.mdx)
- Workspace Domain
    - [Workspace: - First-class aggregate root containing dashboards, queries, and workspace-scoped preferences](https://github.com/docs/domains/Workspace/language.mdx)
    - [Workspace Preferences: - Workspace-scoped settings including default catalog and layout defaults](https://github.com/docs/domains/Workspace/language.mdx)
    - [Visibility: - Access control setting with Public (all authenticated users) or Private (owner/members only) variants](https://github.com/docs/domains/Workspace/language.mdx)
    - [Dashboard: - Aggregate managing persistent visual layouts with chart placements and tabs](https://github.com/docs/domains/Workspace/language.mdx)
    - [Saved Query: - Named, reusable SQL query with dataset reference for analytics](https://github.com/docs/domains/Workspace/language.mdx)
    - [User Preferences: - User-scoped settings for theme, locale, and UI state that apply across all workspaces](https://github.com/docs/domains/Workspace/language.mdx)
    - [Theme: - Color scheme preference with Light, Dark, or System variants](https://github.com/docs/domains/Workspace/language.mdx)
    - [Grid Position: - Row and column coordinates for chart placement within a dashboard](https://github.com/docs/domains/Workspace/language.mdx)
    - [Tab Definition: - Named section within a dashboard for organizing related charts](https://github.com/docs/domains/Workspace/language.mdx)
    - [Chart Placement: - Associates a chart reference with position, size, and tab assignment](https://github.com/docs/domains/Workspace/language.mdx)
    - [UI State: - Opaque JSON blob persisting transient UI concerns across sessions](https://github.com/docs/domains/Workspace/language.mdx)
    - [Dataset Reference: - URI identifying a target dataset for query execution](https://github.com/docs/domains/Workspace/language.mdx)
    - [Chart Definition Reference: - Cross-context reference to ChartDefinition in Analytics domain](https://github.com/docs/domains/Workspace/language.mdx)
    - [Grid Size: - Width and height in grid units for chart bounding box](https://github.com/docs/domains/Workspace/language.mdx)
    - [Layout JSON: - Serialized dashboard structure encoding tabs and chart placements](https://github.com/docs/domains/Workspace/language.mdx)

## Containers (Databases, External Systems)


## Entities
- Analytics Domain
    - [Catalog](https://github.com/docs/entities/Catalog/0.0.1.mdx) - Aggregate root representing a DuckLake catalog with health monitoring and metadata refresh.

    - [Query Session](https://github.com/docs/entities/QuerySession/0.0.1.mdx) - Aggregate root managing the lifecycle of an interactive SQL query execution.

    - [Dataset](https://github.com/docs/entities/Dataset/0.0.1.mdx) - Value object representing a queryable table within a DuckLake catalog.

    - [CatalogRef](https://github.com/docs/entities/CatalogRef/0.0.1.mdx) - URI reference to a DuckLake catalog.

    - [QueryId](https://github.com/docs/entities/QueryId/0.0.1.mdx) - Unique identifier for a query execution session.

    - [SqlQuery](https://github.com/docs/entities/SqlQuery/0.0.1.mdx) - SQL query string wrapper for type-safe query execution.

    - [DatasetRef](https://github.com/docs/entities/DatasetRef/0.0.1.mdx) - Reference to a dataset within a DuckLake catalog.

    - [QueryResults](https://github.com/docs/entities/QueryResults/0.0.1.mdx) - Query execution result metadata.

    - [ErrorMessage](https://github.com/docs/entities/ErrorMessage/0.0.1.mdx) - Error message wrapper for failed query executions.

    - [ChartConfig](https://github.com/docs/entities/ChartConfig/0.0.1.mdx) - Complete chart specification combining type and rendering options.

    - [ChartType](https://github.com/docs/entities/ChartType/0.0.1.mdx) - Enumeration of supported visualization types.

    - [ChartOptions](https://github.com/docs/entities/ChartOptions/0.0.1.mdx) - Chart rendering options for visualization configuration.

    - [CatalogMetadata](https://github.com/docs/entities/CatalogMetadata/0.0.1.mdx) - Metadata about a DuckLake catalog including dataset inventory.

    - [DatasetInfo](https://github.com/docs/entities/DatasetInfo/0.0.1.mdx) - Summary information about a dataset within a catalog.

- Core Domain
    - [Timestamp](https://github.com/docs/entities/Timestamp/0.0.1.mdx) - Unix timestamp in milliseconds representing a point in time.

    - [Duration](https://github.com/docs/entities/Duration/0.0.1.mdx) - Elapsed time in milliseconds representing a span between two points in time.

- Session Domain
    - [Session](https://github.com/docs/entities/Session/0.0.1.mdx) - Aggregate root managing authenticated user sessions with TTL-based lifecycle.

    - [User](https://github.com/docs/entities/User/0.1.0.mdx) - Shared kernel entity representing an authenticated user identity across bounded contexts.
Identity is the composite key (provider, externalId) from OAuth authentication.

    - [SessionId](https://github.com/docs/entities/SessionId/0.0.1.mdx) - Unique identifier for an authenticated user session.

- Workspace Domain
    - [Workspace](https://github.com/docs/entities/Workspace/0.0.1.mdx) - Primary aggregate root for the Workspace domain, containing dashboards, saved queries, and workspace preferences.

    - [Dashboard](https://github.com/docs/entities/Dashboard/0.0.1.mdx) - Aggregate root managing persistent dashboard layouts with chart placements and tabs.

    - [Saved Query](https://github.com/docs/entities/SavedQuery/0.0.1.mdx) - Aggregate root representing a named, reusable SQL query with dataset reference.

    - [Workspace Preferences](https://github.com/docs/entities/WorkspacePreferences/0.0.1.mdx) - Aggregate managing workspace-scoped settings including default catalog and layout defaults.

    - [User Preferences](https://github.com/docs/entities/UserPreferences/0.0.1.mdx) - Aggregate root managing user-scoped settings that follow the user across all workspaces.

    - [DashboardId](https://github.com/docs/entities/DashboardId/0.0.1.mdx) - Unique identifier for a dashboard.

    - [ChartId](https://github.com/docs/entities/ChartId/0.0.1.mdx) - Unique identifier for a chart within a dashboard.

    - [TabId](https://github.com/docs/entities/TabId/0.0.1.mdx) - Unique identifier for a tab within a dashboard.

    - [SavedQueryId](https://github.com/docs/entities/SavedQueryId/0.0.1.mdx) - Unique identifier for a saved query.

    - [GridPosition](https://github.com/docs/entities/GridPosition/0.0.1.mdx) - Grid coordinates for chart placement within a dashboard.

    - [UiState](https://github.com/docs/entities/UiState/0.0.1.mdx) - Opaque JSON blob for persistent UI state.

    - [Theme](https://github.com/docs/entities/Theme/0.0.1.mdx) - User's preferred color scheme.


## Teams
- [engineering](https://github.com/docs/teams/engineering.mdx) - Engineering Team

## Users
- [placeholder](https://github.com/docs/users/placeholder.mdx) - Placeholder User