Skip to content

The open alternative to Salesforce, designed for AI.

feat(view): seed a user-owned initial view per object alongside the INDEX view (#25416)

Thomas Trompette2cb6c6da94e8
diff --git a/packages/twenty-client-sdk/src/metadata/generated/schema.graphql b/packages/twenty-client-sdk/src/metadata/generated/schema.graphql
index 6e0ad88a9ef..c4f50379c4d 100644
--- a/packages/twenty-client-sdk/src/metadata/generated/schema.graphql
+++ b/packages/twenty-client-sdk/src/metadata/generated/schema.graphql
@@ -1997,6 +1997,7 @@ enum FeatureFlagKey {
IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED
IS_RECORD_CREATION_FORM_ENABLED
IS_RECORD_SHARING_ENABLED
+ IS_INITIAL_OBJECT_VIEW_ENABLED
IS_WEBHOOK_RATE_LIMIT_ENABLED
}
diff --git a/packages/twenty-client-sdk/src/metadata/generated/schema.ts b/packages/twenty-client-sdk/src/metadata/generated/schema.ts
index 86ae7bfc8cc..30e7fec223d 100644
--- a/packages/twenty-client-sdk/src/metadata/generated/schema.ts
+++ b/packages/twenty-client-sdk/src/metadata/generated/schema.ts
@@ -1607,7 +1607,7 @@ export interface FeatureFlag {
__typename: 'FeatureFlag'
}
-export type FeatureFlagKey = 'IS_APP_CLAIMING_ENABLED' | 'IS_UNIQUE_INDEXES_ENABLED' | 'IS_CONFIGURABLE_SEARCH_FIELDS_ENABLED' | 'IS_JSON_FILTER_ENABLED' | 'IS_MESSAGE_CAMPAIGN_ENABLED' | 'IS_JUNCTION_RELATIONS_ENABLED' | 'IS_REST_METADATA_API_NEW_FORMAT_DIRECT' | 'IS_LOGIC_FUNCTION_PREBUILT_MODE_ENABLED' | 'IS_WORKFLOW_CORE_INDEX_PAGE_ENABLED' | 'IS_API_RATE_LIMIT_V2_ENABLED' | 'IS_MESSAGE_CALENDAR_TARGET_READ_ENABLED' | 'IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED' | 'IS_RECORD_CREATION_FORM_ENABLED' | 'IS_RECORD_SHARING_ENABLED' | 'IS_WEBHOOK_RATE_LIMIT_ENABLED'
+export type FeatureFlagKey = 'IS_APP_CLAIMING_ENABLED' | 'IS_UNIQUE_INDEXES_ENABLED' | 'IS_CONFIGURABLE_SEARCH_FIELDS_ENABLED' | 'IS_JSON_FILTER_ENABLED' | 'IS_MESSAGE_CAMPAIGN_ENABLED' | 'IS_JUNCTION_RELATIONS_ENABLED' | 'IS_REST_METADATA_API_NEW_FORMAT_DIRECT' | 'IS_LOGIC_FUNCTION_PREBUILT_MODE_ENABLED' | 'IS_WORKFLOW_CORE_INDEX_PAGE_ENABLED' | 'IS_API_RATE_LIMIT_V2_ENABLED' | 'IS_MESSAGE_CALENDAR_TARGET_READ_ENABLED' | 'IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED' | 'IS_RECORD_CREATION_FORM_ENABLED' | 'IS_RECORD_SHARING_ENABLED' | 'IS_INITIAL_OBJECT_VIEW_ENABLED' | 'IS_WEBHOOK_RATE_LIMIT_ENABLED'
export interface WorkspaceUrls {
customUrl?: Scalars['String']
@@ -10758,6 +10758,7 @@ export const enumFeatureFlagKey = {
IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED: 'IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED' as const,
IS_RECORD_CREATION_FORM_ENABLED: 'IS_RECORD_CREATION_FORM_ENABLED' as const,
IS_RECORD_SHARING_ENABLED: 'IS_RECORD_SHARING_ENABLED' as const,
+ IS_INITIAL_OBJECT_VIEW_ENABLED: 'IS_INITIAL_OBJECT_VIEW_ENABLED' as const,
IS_WEBHOOK_RATE_LIMIT_ENABLED: 'IS_WEBHOOK_RATE_LIMIT_ENABLED' as const
}
diff --git a/packages/twenty-front/src/generated-admin/graphql.ts b/packages/twenty-front/src/generated-admin/graphql.ts
index 820c2ef227d..3ea5d512feb 100644
--- a/packages/twenty-front/src/generated-admin/graphql.ts
+++ b/packages/twenty-front/src/generated-admin/graphql.ts
@@ -426,6 +426,7 @@ export enum FeatureFlagKey {
IS_API_RATE_LIMIT_V2_ENABLED = 'IS_API_RATE_LIMIT_V2_ENABLED',
IS_APP_CLAIMING_ENABLED = 'IS_APP_CLAIMING_ENABLED',
IS_CONFIGURABLE_SEARCH_FIELDS_ENABLED = 'IS_CONFIGURABLE_SEARCH_FIELDS_ENABLED',
+ IS_INITIAL_OBJECT_VIEW_ENABLED = 'IS_INITIAL_OBJECT_VIEW_ENABLED',
IS_JSON_FILTER_ENABLED = 'IS_JSON_FILTER_ENABLED',
IS_JUNCTION_RELATIONS_ENABLED = 'IS_JUNCTION_RELATIONS_ENABLED',
IS_LOGIC_FUNCTION_PREBUILT_MODE_ENABLED = 'IS_LOGIC_FUNCTION_PREBUILT_MODE_ENABLED',
diff --git a/packages/twenty-front/src/generated-metadata/graphql.ts b/packages/twenty-front/src/generated-metadata/graphql.ts
index 4d804b810bd..0cc51b8525a 100644
--- a/packages/twenty-front/src/generated-metadata/graphql.ts
+++ b/packages/twenty-front/src/generated-metadata/graphql.ts
@@ -2046,6 +2046,7 @@ export enum FeatureFlagKey {
IS_API_RATE_LIMIT_V2_ENABLED = 'IS_API_RATE_LIMIT_V2_ENABLED',
IS_APP_CLAIMING_ENABLED = 'IS_APP_CLAIMING_ENABLED',
IS_CONFIGURABLE_SEARCH_FIELDS_ENABLED = 'IS_CONFIGURABLE_SEARCH_FIELDS_ENABLED',
+ IS_INITIAL_OBJECT_VIEW_ENABLED = 'IS_INITIAL_OBJECT_VIEW_ENABLED',
IS_JSON_FILTER_ENABLED = 'IS_JSON_FILTER_ENABLED',
IS_JUNCTION_RELATIONS_ENABLED = 'IS_JUNCTION_RELATIONS_ENABLED',
IS_LOGIC_FUNCTION_PREBUILT_MODE_ENABLED = 'IS_LOGIC_FUNCTION_PREBUILT_MODE_ENABLED',
diff --git a/packages/twenty-server/src/database/commands/upgrade-version-command/2-41/2-41-upgrade-version-command.module.ts b/packages/twenty-server/src/database/commands/upgrade-version-command/2-41/2-41-upgrade-version-command.module.ts
index e98e49bcb99..64546527dd8 100644
--- a/packages/twenty-server/src/database/commands/upgrade-version-command/2-41/2-41-upgrade-version-command.module.ts
+++ b/packages/twenty-server/src/database/commands/upgrade-version-command/2-41/2-41-upgrade-version-command.module.ts
@@ -6,12 +6,13 @@ import { CorrectStandardFieldAcronymCasingCommand } from 'src/database/commands/
import { BackfillWorkspaceWorkflowIdOnWorkflowsCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789350000002-backfill-workspace-workflow-id-on-workflows.command';
import { BackfillCoreVersionPointersCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789370101009-backfill-core-version-pointers.command';
import { MakeStandardChildObjectsInheritedCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789373200001-make-standard-child-objects-inherited.command';
-import { BackfillTimelineActivityMessageCampaignIndexesCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789461462000-backfill-timeline-activity-message-campaign-indexes.command';
import { MakeNotesAndTasksInheritTheirTargetsCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789373200002-make-notes-and-tasks-inherit-their-targets.command';
+import { BackfillTimelineActivityMessageCampaignIndexesCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789461462000-backfill-timeline-activity-message-campaign-indexes.command';
import { MoveMessageCampaignCommandsToCampaignFlagCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789468244000-move-message-campaign-commands-to-campaign-flag.command';
import { RemoveSeeActiveVersionCommandMenuItemCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789470915878-remove-see-active-version-command-menu-item.command';
import { NormalizeWorkflowRecordCrudRichTextFieldsCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789482628000-normalize-workflow-record-crud-rich-text-fields.command';
import { BackfillDeterministicPermissionUniversalIdentifiersCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789553327000-backfill-deterministic-permission-universal-identifiers.command';
+import { SeedObjectInitialViewCommand } from 'src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789565000000-seed-object-initial-view.command';
import { ApplicationModule } from 'src/engine/core-modules/application/application.module';
import { WorkflowVersionCoreModule } from 'src/engine/core-modules/workflow/workflow-version-core.module';
import { FieldMetadataEntity } from 'src/engine/metadata-modules/field-metadata/field-metadata.entity';
@@ -19,6 +20,7 @@ import { WorkspaceSchemaManagerModule } from 'src/engine/twenty-orm/workspace-sc
import { WorkspaceCacheModule } from 'src/engine/workspace-cache/workspace-cache.module';
import { WorkspaceMigrationRunnerModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/workspace-migration-runner.module';
import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration.module';
+import { WorkspaceSchemaMigrationRunnerActionHandlersModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module';
@Module({
imports: [
@@ -29,6 +31,7 @@ import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace
WorkspaceMigrationModule,
WorkspaceMigrationRunnerModule,
WorkspaceSchemaManagerModule,
+ WorkspaceSchemaMigrationRunnerActionHandlersModule,
WorkflowVersionCoreModule,
],
providers: [
@@ -42,6 +45,7 @@ import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace
RemoveSeeActiveVersionCommandMenuItemCommand,
NormalizeWorkflowRecordCrudRichTextFieldsCommand,
BackfillDeterministicPermissionUniversalIdentifiersCommand,
+ SeedObjectInitialViewCommand,
],
})
export class V2_41_UpgradeVersionCommandModule {}
diff --git a/packages/twenty-server/src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789565000000-seed-object-initial-view.command.ts b/packages/twenty-server/src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789565000000-seed-object-initial-view.command.ts
new file mode 100644
index 00000000000..e73c8684b09
--- /dev/null
+++ b/packages/twenty-server/src/database/commands/upgrade-version-command/2-41/2-41-workspace-command-1789565000000-seed-object-initial-view.command.ts
@@ -0,0 +1,113 @@
+import { Command } from 'nest-commander';
+
+import { ProvisionedWorkspaceCommandRunner } from 'src/database/commands/command-runners/provisioned-workspace.command-runner';
+import { WorkspaceIteratorService } from 'src/database/commands/command-runners/workspace-iterator.service';
+import { type RunOnWorkspaceArgs } from 'src/database/commands/command-runners/workspace.command-runner';
+import { ApplicationService } from 'src/engine/core-modules/application/application.service';
+import { RegisteredWorkspaceCommand } from 'src/engine/core-modules/upgrade/decorators/registered-workspace-command.decorator';
+import { findFlatEntitiesByApplicationId } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entities-by-application-id.util';
+import { computeMissingInitialObjectViewOperations } from 'src/engine/metadata-modules/view/utils/compute-missing-initial-object-view-operations.util';
+import { WorkspaceCacheService } from 'src/engine/workspace-cache/services/workspace-cache.service';
+import { WorkspaceMigrationBuilderException } from 'src/engine/workspace-manager/workspace-migration/exceptions/workspace-migration-builder-exception';
+import { WorkspaceMigrationValidateBuildAndRunService } from 'src/engine/workspace-manager/workspace-migration/services/workspace-migration-validate-build-and-run-service';
+
+@RegisteredWorkspaceCommand('2.41.0', 1789565000000)
+@Command({
+ name: 'upgrade:2-41:seed-object-initial-view',
+ description:
+ 'Seed one user-owned initial table view per object by copying its INDEX view field layout, hidden behind IS_INITIAL_OBJECT_VIEW_ENABLED and idempotent on deterministic identifiers.',
+})
+export class SeedObjectInitialViewCommand extends ProvisionedWorkspaceCommandRunner {
+ constructor(
+ protected readonly workspaceIteratorService: WorkspaceIteratorService,
+ private readonly workspaceCacheService: WorkspaceCacheService,
+ private readonly applicationService: ApplicationService,
+ private readonly workspaceMigrationValidateBuildAndRunService: WorkspaceMigrationValidateBuildAndRunService,
+ ) {
+ super(workspaceIteratorService);
+ }
+
+ override async runOnWorkspace({
+ workspaceId,
+ options,
+ }: RunOnWorkspaceArgs): Promise<void> {
+ const { flatObjectMetadataMaps, flatViewMaps, flatViewFieldMaps } =
+ await this.workspaceCacheService.getOrRecompute(workspaceId, [
+ 'flatObjectMetadataMaps',
+ 'flatViewMaps',
+ 'flatViewFieldMaps',
+ ]);
+
+ const { twentyStandardFlatApplication, workspaceCustomFlatApplication } =
+ await this.applicationService.findWorkspaceTwentyStandardAndCustomApplicationOrThrow(
+ { workspaceId },
+ );
+
+ const seedOperations = computeMissingInitialObjectViewOperations({
+ flatObjectMetadatas: [
+ twentyStandardFlatApplication.id,
+ workspaceCustomFlatApplication.id,
+ ].flatMap((applicationId) =>
+ findFlatEntitiesByApplicationId({
+ applicationId,
+ flatEntityMaps: flatObjectMetadataMaps,
+ }),
+ ),
+ flatViewMaps,
+ flatViewFieldMaps,
+ initialViewApplicationUniversalIdentifier:
+ workspaceCustomFlatApplication.universalIdentifier,
+ });
+
+ const totalCreateCount =
+ seedOperations.viewsToCreate.length +
+ seedOperations.viewFieldsToCreate.length;
+
+ if (options.dryRun ?? false) {
+ this.logger.log(
+ `[DRY RUN] Would seed ${totalCreateCount} initial-view entities for workspace ${workspaceId}`,
+ );
+
+ return;
+ }
+
+ if (totalCreateCount === 0) {
+ this.logger.log(`No initial view to seed for workspace ${workspaceId}`);
+
+ return;
+ }
+
+ const result =
+ await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunLegacyWorkspaceMigration(
+ {
+ isSystemBuild: true,
+ workspaceId,
+ applicationUniversalIdentifier:
+ workspaceCustomFlatApplication.universalIdentifier,
+ allFlatEntityOperationByMetadataName: {
+ view: {
+ flatEntityToCreate: seedOperations.viewsToCreate,
+ flatEntityToDelete: [],
+ flatEntityToUpdate: [],
+ },
+ viewField: {
+ flatEntityToCreate: seedOperations.viewFieldsToCreate,
+ flatEntityToDelete: [],
+ flatEntityToUpdate: [],
+ },
+ },
+ },
+ );
+
+ if (result.status === 'fail') {
+ throw new WorkspaceMigrationBuilderException(
+ result,
+ `Multiple validation errors occurred while seeding initial object views for workspace ${workspaceId}`,
+ );
+ }
+
+ this.logger.log(
+ `Seeded ${totalCreateCount} initial-view entities for workspace ${workspaceId}`,
+ );
+ }
+}
diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-system-view-to-create.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-system-view-to-create.util.spec.ts
index 11fa9dcbcc1..1704edd55df 100644
--- a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-system-view-to-create.util.spec.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/__tests__/compute-system-view-to-create.util.spec.ts
@@ -14,7 +14,7 @@ const objectMetadata = {
};
describe('computeSystemViewToCreate', () => {
- it.each([ViewKey.INDEX, SYSTEM_VIEW_KEYS.FIELDS_WIDGET])(
+ it.each([SYSTEM_VIEW_KEYS.INDEX, SYSTEM_VIEW_KEYS.FIELDS_WIDGET])(
'should derive the %s view universal identifier from the object',
(viewKey) => {
const result = computeSystemViewToCreate({
diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-same-batch-view-field-position-by-field-universal-identifier.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-same-batch-view-field-position-by-field-universal-identifier.util.ts
index b6282b26ee4..d1f666fbe26 100644
--- a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-same-batch-view-field-position-by-field-universal-identifier.util.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-same-batch-view-field-position-by-field-universal-identifier.util.ts
@@ -2,8 +2,8 @@ import { type AllFlatEntityOperationRecordByMetadataName } from 'src/engine/meta
import {
computeDefaultViewFieldPositionByFieldUniversalIdentifier,
type ViewFieldLabelIdentifierPolicy,
-} from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-default-view-field-position-by-field-universal-identifier.util';
-import { computeViewFieldPositionInputFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-view-field-position-input-flat-field-metadatas.util';
+} from 'src/engine/metadata-modules/view/utils/compute-default-view-field-position-by-field-universal-identifier.util';
+import { computeViewFieldPositionInputFlatFieldMetadatas } from 'src/engine/metadata-modules/view/utils/compute-view-field-position-input-flat-field-metadatas.util';
import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';
export type ParentFlatObjectMetadataForViewFields = {
diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-fields-for-created-object-view.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-fields-for-created-object-view.util.ts
index 3cae4cee4f4..24b99441e3a 100644
--- a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-fields-for-created-object-view.util.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-fields-for-created-object-view.util.ts
@@ -2,9 +2,9 @@ import { type AllFlatEntityOperationRecordByMetadataName } from 'src/engine/meta
import {
computeDefaultViewFieldPositionByFieldUniversalIdentifier,
type ViewFieldLabelIdentifierPolicy,
-} from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-default-view-field-position-by-field-universal-identifier.util';
+} from 'src/engine/metadata-modules/view/utils/compute-default-view-field-position-by-field-universal-identifier.util';
import { computeSystemViewFieldsToCreate } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-fields-to-create.util';
-import { computeViewFieldPositionInputFlatFieldMetadatas } from 'src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-view-field-position-input-flat-field-metadatas.util';
+import { computeViewFieldPositionInputFlatFieldMetadatas } from 'src/engine/metadata-modules/view/utils/compute-view-field-position-input-flat-field-metadatas.util';
import { type UniversalFlatObjectMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-object-metadata.type';
import { type UniversalFlatViewField } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view-field.type';
diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-to-create.util.ts b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-to-create.util.ts
index 843bb732e7f..2c80679d304 100644
--- a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-to-create.util.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-system-view-to-create.util.ts
@@ -4,16 +4,11 @@ import {
type SystemViewKey,
} from 'twenty-shared/application';
import { VIEW_TYPE_DEFAULT_ICONS } from 'twenty-shared/constants';
-import {
- ViewKey,
- ViewOpenRecordIn,
- ViewType,
- ViewVisibility,
-} from 'twenty-shared/types';
-import { v4 } from 'uuid';
+import { ViewKey, ViewType } from 'twenty-shared/types';
import { INDEX_VIEW_NAME } from 'src/engine/metadata-modules/view/constants/index-view-name.constant';
import { type UniversalFlatObjectMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-object-metadata.type';
+import { buildBaseUniversalFlatView } from 'src/engine/metadata-modules/view/utils/build-base-universal-flat-view.util';
import { type UniversalFlatView } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view.type';
type SystemViewObjectMetadata = Pick<
@@ -55,50 +50,23 @@ export const computeSystemViewToCreate = ({
}): UniversalFlatView & { id: string } => {
const { type, icon, computeName } =
SYSTEM_VIEW_PROPERTIES_BY_VIEW_KEY[viewKey];
- const createdAt = new Date().toISOString();
- return {
- id: v4(),
+ return buildBaseUniversalFlatView({
objectMetadataUniversalIdentifier: objectMetadata.universalIdentifier,
+ applicationUniversalIdentifier,
+ universalIdentifier: getSystemViewUniversalIdentifier({
+ objectMetadataApplicationUniversalIdentifier:
+ applicationUniversalIdentifier,
+ objectUniversalIdentifier: objectMetadata.universalIdentifier,
+ viewKey,
+ }),
name: computeName(objectMetadata),
// Only INDEX is a persisted key; FIELDS_WIDGET exists solely in the
// universal identifier derivation.
key: viewKey === SYSTEM_VIEW_KEYS.INDEX ? ViewKey.INDEX : null,
icon,
type,
- createdAt,
- updatedAt: createdAt,
- deletedAt: null,
- isCustom: true,
- anyFieldFilterValue: null,
- calendarFieldMetadataUniversalIdentifier: null,
- calendarEndFieldMetadataUniversalIdentifier: null,
- calendarLayout: null,
- isCompact: false,
- shouldHideEmptyGroups: false,
- kanbanColumnWidth: null,
- kanbanAggregateOperation: null,
- kanbanAggregateOperationFieldMetadataUniversalIdentifier: null,
- mainGroupByFieldMetadataUniversalIdentifier: null,
- openRecordIn: ViewOpenRecordIn.SIDE_PANEL,
position: 0,
- universalIdentifier: getSystemViewUniversalIdentifier({
- objectMetadataApplicationUniversalIdentifier:
- applicationUniversalIdentifier,
- objectUniversalIdentifier: objectMetadata.universalIdentifier,
- viewKey,
- }),
- visibility: ViewVisibility.WORKSPACE,
- createdByUserWorkspaceId: null,
- isActive: true,
isSystemSideEffect: true,
- universalOverrides: null,
- viewFieldUniversalIdentifiers: [],
- viewFieldGroupUniversalIdentifiers: [],
- viewFilterUniversalIdentifiers: [],
- viewGroupUniversalIdentifiers: [],
- viewFilterGroupUniversalIdentifiers: [],
- viewSortUniversalIdentifiers: [],
- applicationUniversalIdentifier,
- };
+ });
};
diff --git a/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.module.ts b/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.module.ts
index b07d4633498..77424aff188 100644
--- a/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.module.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.module.ts
@@ -1,11 +1,12 @@
import { Module } from '@nestjs/common';
+import { FeatureFlagModule } from 'src/engine/core-modules/feature-flag/feature-flag.module';
import { MinimalMetadataResolver } from 'src/engine/metadata-modules/minimal-metadata/minimal-metadata.resolver';
import { MinimalMetadataService } from 'src/engine/metadata-modules/minimal-metadata/minimal-metadata.service';
import { WorkspaceCacheModule } from 'src/engine/workspace-cache/workspace-cache.module';
@Module({
- imports: [WorkspaceCacheModule],
+ imports: [FeatureFlagModule, WorkspaceCacheModule],
providers: [MinimalMetadataResolver, MinimalMetadataService],
exports: [MinimalMetadataService],
})
diff --git a/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.service.ts b/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.service.ts
index ff675e20338..b1e7be88294 100644
--- a/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.service.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/minimal-metadata/minimal-metadata.service.ts
@@ -5,11 +5,13 @@ import {
type AllMetadataName,
} from 'twenty-shared/metadata';
import { type APP_LOCALES, SOURCE_LOCALE } from 'twenty-shared/translations';
-import { ViewVisibility } from 'twenty-shared/types';
+import { FeatureFlagKey, ViewVisibility } from 'twenty-shared/types';
import { isDefined, uncapitalize } from 'twenty-shared/utils';
import { I18nService } from 'src/engine/core-modules/i18n/i18n.service';
import { ALL_FLAT_ENTITY_MAPS_PROPERTIES } from 'src/engine/metadata-modules/flat-entity/constant/all-flat-entity-maps-properties.constant';
+import { FeatureFlagService } from 'src/engine/core-modules/feature-flag/services/feature-flag.service';
+import { isInitialObjectView } from 'src/engine/metadata-modules/view/utils/is-initial-object-view.util';
import { type CollectionHashDTO } from 'src/engine/metadata-modules/minimal-metadata/dtos/collection-hash.dto';
import { MinimalMetadataDTO } from 'src/engine/metadata-modules/minimal-metadata/dtos/minimal-metadata.dto';
import { MinimalObjectMetadataDTO } from 'src/engine/metadata-modules/minimal-metadata/dtos/minimal-object-metadata.dto';
@@ -38,6 +40,7 @@ export class MinimalMetadataService {
constructor(
private readonly workspaceCacheService: WorkspaceCacheService,
private readonly i18nService: I18nService,
+ private readonly featureFlagService: FeatureFlagService,
) {}
async getMinimalMetadata({
@@ -140,10 +143,20 @@ export class MinimalMetadataService {
};
});
+ const isInitialObjectViewEnabled =
+ await this.featureFlagService.isFeatureEnabled(
+ FeatureFlagKey.IS_INITIAL_OBJECT_VIEW_ENABLED,
+ workspaceId,
+ );
+
const views: MinimalViewDTO[] = Object.values(
flatViewMaps.byUniversalIdentifier,
)
.filter(isDefined)
+ .filter(
+ (flatView) =>
+ isInitialObjectViewEnabled || !isInitialObjectView(flatView),
+ )
.filter((flatView) => flatView.workspaceId === workspaceId)
.filter((flatView) => flatView.deletedAt === null)
.filter(
diff --git a/packages/twenty-server/src/engine/metadata-modules/object-metadata/object-metadata.service.ts b/packages/twenty-server/src/engine/metadata-modules/object-metadata/object-metadata.service.ts
index aaad8c98374..9ba97530d14 100644
--- a/packages/twenty-server/src/engine/metadata-modules/object-metadata/object-metadata.service.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/object-metadata/object-metadata.service.ts
@@ -13,6 +13,7 @@ import { findFlatEntityByUniversalIdentifierOrThrow } from 'src/engine/metadata-
import { findFlatEntityByUniversalIdentifier } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-universal-identifier.util';
import { findManyFlatEntityByIdInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-many-flat-entity-by-id-in-flat-entity-maps-or-throw.util';
import { FlatIndexMetadata } from 'src/engine/metadata-modules/flat-index-metadata/types/flat-index-metadata.type';
+import { computeInitialObjectViewOperationsOnObjectCreation } from 'src/engine/metadata-modules/view/utils/compute-initial-object-view-operations-on-object-creation.util';
import { FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
import { FlatObjectMetadata } from 'src/engine/metadata-modules/flat-object-metadata/types/flat-object-metadata.type';
import { fromCreateObjectInputToFlatObjectMetadataAndFlatFieldMetadatasToCreate } from 'src/engine/metadata-modules/flat-object-metadata/utils/from-create-object-input-to-flat-object-metadata-and-flat-field-metadatas-to-create.util';
@@ -396,6 +397,17 @@ export class ObjectMetadataService {
workspaceCustomFlatApplication.universalIdentifier,
});
+ const isWorkspaceCustomApplicationBuild =
+ resolvedOwnerFlatApplication.universalIdentifier ===
+ workspaceCustomFlatApplication.universalIdentifier;
+
+ const initialObjectViewOperations = isWorkspaceCustomApplicationBuild
+ ? computeInitialObjectViewOperationsOnObjectCreation({
+ flatObjectMetadataToCreate,
+ callerFlatFieldMetadatasToCreate: flatFieldMetadataToCreateOnObject,
+ })
+ : undefined;
+
const validateAndBuildResult =
await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunWorkspaceMigration(
{
@@ -415,6 +427,23 @@ export class ObjectMetadataService {
flatEntityToDelete: [],
flatEntityToUpdate: [],
},
+ ...(isDefined(initialObjectViewOperations)
+ ? {
+ view: {
+ flatEntityToCreate: [
+ initialObjectViewOperations.flatInitialViewToCreate,
+ ],
+ flatEntityToDelete: [],
+ flatEntityToUpdate: [],
+ },
+ viewField: {
+ flatEntityToCreate:
+ initialObjectViewOperations.flatInitialViewFieldsToCreate,
+ flatEntityToDelete: [],
+ flatEntityToUpdate: [],
+ },
+ }
+ : {}),
...(isDefined(flatNavigationMenuItemToCreate)
? {
navigationMenuItem: {
diff --git a/packages/twenty-server/src/engine/metadata-modules/view-permissions/view-permissions.module.ts b/packages/twenty-server/src/engine/metadata-modules/view-permissions/view-permissions.module.ts
index dae267557dd..93d18068dd8 100644
--- a/packages/twenty-server/src/engine/metadata-modules/view-permissions/view-permissions.module.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/view-permissions/view-permissions.module.ts
@@ -2,6 +2,7 @@ import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { ApplicationModule } from 'src/engine/core-modules/application/application.module';
+import { FeatureFlagModule } from 'src/engine/core-modules/feature-flag/feature-flag.module';
import { I18nModule } from 'src/engine/core-modules/i18n/i18n.module';
import { WorkspaceManyOrAllFlatEntityMapsCacheModule } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module';
import { PermissionsModule } from 'src/engine/metadata-modules/permissions/permissions.module';
@@ -23,6 +24,7 @@ import { CreateViewPermissionGuard } from 'src/engine/metadata-modules/view-perm
@Module({
imports: [
+ FeatureFlagModule,
TypeOrmModule.forFeature([
ViewEntity,
ViewFieldEntity,
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/constants/initial-object-view-position.constant.ts b/packages/twenty-server/src/engine/metadata-modules/view/constants/initial-object-view-position.constant.ts
new file mode 100644
index 00000000000..ed2c3eaef82
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/constants/initial-object-view-position.constant.ts
@@ -0,0 +1 @@
+export const INITIAL_OBJECT_VIEW_POSITION = 1;
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/services/view.service.ts b/packages/twenty-server/src/engine/metadata-modules/view/services/view.service.ts
index eb6bc52965b..2b04be06ee3 100644
--- a/packages/twenty-server/src/engine/metadata-modules/view/services/view.service.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/view/services/view.service.ts
@@ -1,10 +1,12 @@
import { Injectable } from '@nestjs/common';
-import { ViewType, ViewVisibility } from 'twenty-shared/types';
+import { FeatureFlagKey, ViewType, ViewVisibility } from 'twenty-shared/types';
import { isDefined } from 'twenty-shared/utils';
import { ApplicationService } from 'src/engine/core-modules/application/application.service';
import { WorkspaceManyOrAllFlatEntityMapsCacheService } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.service';
+import { FeatureFlagService } from 'src/engine/core-modules/feature-flag/services/feature-flag.service';
+import { isInitialObjectView } from 'src/engine/metadata-modules/view/utils/is-initial-object-view.util';
import { findFlatEntityByIdInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps-or-throw.util';
import { findFlatEntityByIdInFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps.util';
import { findFlatEntityByUniversalIdentifierOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-universal-identifier-or-throw.util';
@@ -45,6 +47,7 @@ export class ViewService {
private readonly workspaceMigrationValidateBuildAndRunService: WorkspaceMigrationValidateBuildAndRunService,
private readonly flatEntityMapsCacheService: WorkspaceManyOrAllFlatEntityMapsCacheService,
private readonly applicationService: ApplicationService,
+ private readonly featureFlagService: FeatureFlagService,
) {}
async createOne({
@@ -419,8 +422,18 @@ export class ViewService {
},
);
+ const isInitialObjectViewEnabled =
+ await this.featureFlagService.isFeatureEnabled(
+ FeatureFlagKey.IS_INITIAL_OBJECT_VIEW_ENABLED,
+ workspaceId,
+ );
+
return Object.values(flatViewMaps.byUniversalIdentifier)
.filter(isDefined)
+ .filter(
+ (flatView) =>
+ isInitialObjectViewEnabled || !isInitialObjectView(flatView),
+ )
.filter((flatView) => flatView.workspaceId === workspaceId)
.filter(
(flatView) =>
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-initial-object-view-fields-to-create.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-initial-object-view-fields-to-create.util.spec.ts
new file mode 100644
index 00000000000..660cb8717e7
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-initial-object-view-fields-to-create.util.spec.ts
@@ -0,0 +1,113 @@
+import { getViewFieldUniversalIdentifier } from 'twenty-shared/application';
+import { FieldMetadataType } from 'twenty-shared/types';
+
+import { type AllFlatEntityOperationRecordByMetadataName } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-operation-record-by-metadata-name.type';
+import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';
+
+import { computeInitialObjectViewFieldsToCreate } from 'src/engine/metadata-modules/view/utils/compute-initial-object-view-fields-to-create.util';
+
+const applicationUniversalIdentifier = 'a1a2a3a4-a5a6-4000-8000-000000000001';
+const objectUniversalIdentifier = 'b1b2b3b4-b5b6-4000-8000-000000000002';
+const initialViewUniversalIdentifier = 'c1c2c3c4-c5c6-4000-8000-000000000003';
+const labelIdentifierFieldMetadataUniversalIdentifier =
+ 'd1d2d3d4-d5d6-4000-8000-000000000004';
+const callerFieldUniversalIdentifier = 'e1e2e3e4-e5e6-4000-8000-000000000005';
+
+const makeCallerField = (
+ universalIdentifier: string,
+ name: string,
+): UniversalFlatFieldMetadata =>
+ ({
+ universalIdentifier,
+ objectMetadataUniversalIdentifier: objectUniversalIdentifier,
+ applicationUniversalIdentifier,
+ name,
+ label: name,
+ type: FieldMetadataType.TEXT,
+ isActive: true,
+ isSystem: false,
+ isSystemSideEffect: false,
+ isUIEditable: true,
+ isNullable: true,
+ createdAt: '2026-01-01T00:00:00.000Z',
+ updatedAt: '2026-01-01T00:00:00.000Z',
+ deletedAt: null,
+ }) as unknown as UniversalFlatFieldMetadata;
+
+const sourceFlatObjectMetadata = {
+ applicationUniversalIdentifier,
+ universalIdentifier: objectUniversalIdentifier,
+ labelIdentifierFieldMetadataUniversalIdentifier,
+};
+
+const allFlatEntityOperationRecordByMetadataName: AllFlatEntityOperationRecordByMetadataName =
+ {
+ fieldMetadata: {
+ flatEntityToCreate: {
+ [labelIdentifierFieldMetadataUniversalIdentifier]: makeCallerField(
+ labelIdentifierFieldMetadataUniversalIdentifier,
+ 'name',
+ ),
+ [callerFieldUniversalIdentifier]: makeCallerField(
+ callerFieldUniversalIdentifier,
+ 'amount',
+ ),
+ },
+ flatEntityToUpdate: {},
+ flatEntityToDelete: {},
+ },
+ };
+
+describe('computeInitialObjectViewFieldsToCreate', () => {
+ it('should include caller fields from the same batch, label identifier first', () => {
+ const initialViewFields = computeInitialObjectViewFieldsToCreate({
+ sourceFlatObjectMetadata,
+ initialViewUniversalIdentifier,
+ allFlatEntityOperationRecordByMetadataName,
+ });
+
+ const fieldUniversalIdentifiers = initialViewFields.map(
+ (initialViewField) => initialViewField.fieldMetadataUniversalIdentifier,
+ );
+
+ expect(fieldUniversalIdentifiers).toContain(callerFieldUniversalIdentifier);
+ expect(
+ initialViewFields.find(
+ (initialViewField) => initialViewField.position === 0,
+ )?.fieldMetadataUniversalIdentifier,
+ ).toBe(labelIdentifierFieldMetadataUniversalIdentifier);
+ });
+
+ it('should include system fields alongside caller fields', () => {
+ const initialViewFields = computeInitialObjectViewFieldsToCreate({
+ sourceFlatObjectMetadata,
+ initialViewUniversalIdentifier,
+ allFlatEntityOperationRecordByMetadataName,
+ });
+
+ expect(initialViewFields.length).toBeGreaterThan(2);
+ });
+
+ it('should emit user-owned view fields keyed under the object application', () => {
+ const initialViewFields = computeInitialObjectViewFieldsToCreate({
+ sourceFlatObjectMetadata,
+ initialViewUniversalIdentifier,
+ allFlatEntityOperationRecordByMetadataName,
+ });
+
+ for (const initialViewField of initialViewFields) {
+ expect(initialViewField.isSystemSideEffect).toBe(false);
+ expect(initialViewField.viewUniversalIdentifier).toBe(
+ initialViewUniversalIdentifier,
+ );
+ expect(initialViewField.universalIdentifier).toBe(
+ getViewFieldUniversalIdentifier({
+ applicationUniversalIdentifier,
+ viewUniversalIdentifier: initialViewUniversalIdentifier,
+ fieldMetadataUniversalIdentifier:
+ initialViewField.fieldMetadataUniversalIdentifier,
+ }),
+ );
+ }
+ });
+});
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-initial-object-view-to-create.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-initial-object-view-to-create.util.spec.ts
new file mode 100644
index 00000000000..ea5d5378290
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-initial-object-view-to-create.util.spec.ts
@@ -0,0 +1,55 @@
+import { getInitialObjectViewUniversalIdentifier } from 'src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util';
+import { ViewType } from 'twenty-shared/types';
+
+import { computeInitialObjectViewToCreate } from 'src/engine/metadata-modules/view/utils/compute-initial-object-view-to-create.util';
+
+describe('computeInitialObjectViewToCreate', () => {
+ const applicationUniversalIdentifier = '20202020-1c25-4d02-bf25-6aeccf7ea419';
+ const objectMetadata = {
+ universalIdentifier: '20202020-b374-4779-a561-80086cb2e17f',
+ labelPlural: 'Companies',
+ };
+
+ it('should be owned by the user rather than the engine', () => {
+ const initialView = computeInitialObjectViewToCreate({
+ objectMetadata,
+ applicationUniversalIdentifier,
+ });
+
+ expect(initialView.isSystemSideEffect).toBe(false);
+ expect(initialView.key).toBeNull();
+ });
+
+ it('should be a table view named after the object', () => {
+ const initialView = computeInitialObjectViewToCreate({
+ objectMetadata,
+ applicationUniversalIdentifier,
+ });
+
+ expect(initialView.type).toBe(ViewType.TABLE);
+ expect(initialView.name).toBe('All Companies');
+ });
+
+ it('should use the deterministic initial identifier', () => {
+ const initialView = computeInitialObjectViewToCreate({
+ objectMetadata,
+ applicationUniversalIdentifier,
+ });
+
+ expect(initialView.universalIdentifier).toBe(
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier: applicationUniversalIdentifier,
+ objectUniversalIdentifier: objectMetadata.universalIdentifier,
+ }),
+ );
+ });
+
+ it('should sort after a view initial at position zero', () => {
+ const initialView = computeInitialObjectViewToCreate({
+ objectMetadata,
+ applicationUniversalIdentifier,
+ });
+
+ expect(initialView.position).toBeGreaterThan(0);
+ });
+});
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-missing-initial-object-view-operations.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-missing-initial-object-view-operations.util.spec.ts
new file mode 100644
index 00000000000..12007781d3b
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/compute-missing-initial-object-view-operations.util.spec.ts
@@ -0,0 +1,259 @@
+import { getViewFieldUniversalIdentifier } from 'twenty-shared/application';
+import { type AggregateOperations, ViewKey } from 'twenty-shared/types';
+
+import { computeMissingInitialObjectViewOperations } from 'src/engine/metadata-modules/view/utils/compute-missing-initial-object-view-operations.util';
+import { getInitialObjectViewUniversalIdentifier } from 'src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util';
+
+const WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER =
+ '5f4a1c1e-0000-4000-8000-000000000001';
+const PET_OBJECT_UNIVERSAL_IDENTIFIER = '5f4a1c1e-0000-4000-8000-000000000002';
+const PET_INDEX_VIEW_UNIVERSAL_IDENTIFIER =
+ '5f4a1c1e-0000-4000-8000-000000000003';
+const NAME_FIELD_UNIVERSAL_IDENTIFIER = '5f4a1c1e-0000-4000-8000-000000000004';
+const AGE_FIELD_UNIVERSAL_IDENTIFIER = '5f4a1c1e-0000-4000-8000-000000000005';
+const NAME_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER =
+ '5f4a1c1e-0000-4000-8000-000000000006';
+const AGE_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER =
+ '5f4a1c1e-0000-4000-8000-000000000007';
+
+const INITIAL_VIEW_UNIVERSAL_IDENTIFIER =
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier:
+ WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER,
+ objectUniversalIdentifier: PET_OBJECT_UNIVERSAL_IDENTIFIER,
+ });
+
+type ObjectFixture = {
+ universalIdentifier: string;
+ labelPlural: string;
+ isRemote: boolean;
+ isSystem: boolean;
+ viewUniversalIdentifiers: string[];
+};
+
+type ViewFixture = {
+ universalIdentifier: string;
+ key: ViewKey | null;
+ deletedAt: string | null;
+ viewFieldUniversalIdentifiers: string[];
+};
+
+type ViewFieldFixture = {
+ universalIdentifier: string;
+ fieldMetadataUniversalIdentifier: string;
+ viewUniversalIdentifier: string;
+ viewFieldGroupUniversalIdentifier: string | null;
+ isVisible: boolean;
+ size: number;
+ position: number;
+ aggregateOperation: AggregateOperations | null;
+ isActive: boolean;
+ isSystemSideEffect: boolean;
+ universalOverrides: null;
+ createdAt: string;
+ updatedAt: string;
+ deletedAt: string | null;
+ applicationUniversalIdentifier: string;
+};
+
+const PET_OBJECT: ObjectFixture = {
+ universalIdentifier: PET_OBJECT_UNIVERSAL_IDENTIFIER,
+ labelPlural: 'Pets',
+ isRemote: false,
+ isSystem: false,
+ viewUniversalIdentifiers: [PET_INDEX_VIEW_UNIVERSAL_IDENTIFIER],
+};
+
+const PET_OBJECT_WITH_INITIAL_VIEW: ObjectFixture = {
+ ...PET_OBJECT,
+ viewUniversalIdentifiers: [
+ PET_INDEX_VIEW_UNIVERSAL_IDENTIFIER,
+ INITIAL_VIEW_UNIVERSAL_IDENTIFIER,
+ ],
+};
+
+const PET_INDEX_VIEW: ViewFixture = {
+ universalIdentifier: PET_INDEX_VIEW_UNIVERSAL_IDENTIFIER,
+ key: ViewKey.INDEX,
+ deletedAt: null,
+ viewFieldUniversalIdentifiers: [
+ NAME_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER,
+ AGE_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER,
+ ],
+};
+
+const buildIndexViewFieldFixture = ({
+ universalIdentifier,
+ fieldMetadataUniversalIdentifier,
+ position,
+}: {
+ universalIdentifier: string;
+ fieldMetadataUniversalIdentifier: string;
+ position: number;
+}): ViewFieldFixture => ({
+ universalIdentifier,
+ fieldMetadataUniversalIdentifier,
+ viewUniversalIdentifier: PET_INDEX_VIEW_UNIVERSAL_IDENTIFIER,
+ viewFieldGroupUniversalIdentifier: null,
+ isVisible: true,
+ size: 180,
+ position,
+ aggregateOperation: null,
+ isActive: true,
+ isSystemSideEffect: true,
+ universalOverrides: null,
+ createdAt: '2024-01-01T00:00:00.000Z',
+ updatedAt: '2024-01-01T00:00:00.000Z',
+ deletedAt: null,
+ applicationUniversalIdentifier: 'some-standard-application',
+});
+
+const buildMaps = ({
+ objects,
+ views,
+ viewFields,
+}: {
+ objects: ObjectFixture[];
+ views: ViewFixture[];
+ viewFields: ViewFieldFixture[];
+}) => ({
+ flatObjectMetadatas: objects,
+ flatViewMaps: {
+ byUniversalIdentifier: Object.fromEntries(
+ views.map((view) => [view.universalIdentifier, view]),
+ ),
+ },
+ flatViewFieldMaps: {
+ byUniversalIdentifier: Object.fromEntries(
+ viewFields.map((viewField) => [viewField.universalIdentifier, viewField]),
+ ),
+ },
+});
+
+const NAME_INDEX_VIEW_FIELD = buildIndexViewFieldFixture({
+ universalIdentifier: NAME_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER,
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 0,
+});
+
+const AGE_INDEX_VIEW_FIELD = buildIndexViewFieldFixture({
+ universalIdentifier: AGE_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER,
+ fieldMetadataUniversalIdentifier: AGE_FIELD_UNIVERSAL_IDENTIFIER,
+ position: 1,
+});
+
+describe('computeMissingInitialObjectViewOperations', () => {
+ it('seeds one view and copies the INDEX layout for an object without an initial view', () => {
+ const { viewsToCreate, viewFieldsToCreate } =
+ computeMissingInitialObjectViewOperations({
+ ...buildMaps({
+ objects: [PET_OBJECT],
+ views: [PET_INDEX_VIEW],
+ viewFields: [NAME_INDEX_VIEW_FIELD, AGE_INDEX_VIEW_FIELD],
+ }),
+ initialViewApplicationUniversalIdentifier:
+ WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER,
+ });
+
+ expect(viewsToCreate).toHaveLength(1);
+ expect(viewsToCreate[0]).toMatchObject({
+ universalIdentifier: INITIAL_VIEW_UNIVERSAL_IDENTIFIER,
+ name: 'All Pets',
+ key: null,
+ isSystemSideEffect: false,
+ applicationUniversalIdentifier:
+ WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER,
+ });
+
+ expect(viewFieldsToCreate).toHaveLength(2);
+ expect(viewFieldsToCreate.map((viewField) => viewField.position)).toEqual([
+ 0, 1,
+ ]);
+ expect(viewFieldsToCreate[0]).toMatchObject({
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ viewUniversalIdentifier: INITIAL_VIEW_UNIVERSAL_IDENTIFIER,
+ isSystemSideEffect: false,
+ applicationUniversalIdentifier:
+ WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER,
+ universalIdentifier: getViewFieldUniversalIdentifier({
+ applicationUniversalIdentifier:
+ WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER,
+ viewUniversalIdentifier: INITIAL_VIEW_UNIVERSAL_IDENTIFIER,
+ fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+ }),
+ });
+ expect(
+ viewFieldsToCreate.every(
+ (viewField) =>
+ viewField.universalIdentifier !==
+ NAME_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER &&
+ viewField.universalIdentifier !==
+ AGE_INDEX_VIEW_FIELD_UNIVERSAL_IDENTIFIER,
+ ),
+ ).toBe(true);
+ });
+
+ it('produces nothing when the initial view already exists, live or soft-deleted', () => {
+ const buildExistingInitialView = (
+ deletedAt: string | null,
+ ): ViewFixture => ({
+ universalIdentifier: INITIAL_VIEW_UNIVERSAL_IDENTIFIER,
+ key: null,
+ deletedAt,
+ viewFieldUniversalIdentifiers: [],
+ });
+
+ for (const deletedAt of [null, '2024-01-01T00:00:00.000Z']) {
+ const { viewsToCreate, viewFieldsToCreate } =
+ computeMissingInitialObjectViewOperations({
+ ...buildMaps({
+ objects: [PET_OBJECT_WITH_INITIAL_VIEW],
+ views: [PET_INDEX_VIEW, buildExistingInitialView(deletedAt)],
+ viewFields: [NAME_INDEX_VIEW_FIELD, AGE_INDEX_VIEW_FIELD],
+ }),
+ initialViewApplicationUniversalIdentifier:
+ WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER,
+ });
+
+ expect(viewsToCreate).toHaveLength(0);
+ expect(viewFieldsToCreate).toHaveLength(0);
+ }
+ });
+
+ it('skips objects without a live INDEX view, remote objects and system objects', () => {
+ const remoteObject: ObjectFixture = {
+ universalIdentifier: '5f4a1c1e-0000-4000-8000-000000000008',
+ labelPlural: 'Remotes',
+ isRemote: true,
+ isSystem: false,
+ viewUniversalIdentifiers: [],
+ };
+ const objectWithoutIndexView: ObjectFixture = {
+ universalIdentifier: '5f4a1c1e-0000-4000-8000-000000000009',
+ labelPlural: 'Orphans',
+ isRemote: false,
+ isSystem: false,
+ viewUniversalIdentifiers: [],
+ };
+ const systemObject: ObjectFixture = {
+ ...PET_OBJECT,
+ universalIdentifier: '5f4a1c1e-0000-4000-8000-000000000010',
+ labelPlural: 'Systems',
+ isSystem: true,
+ };
+
+ const { viewsToCreate, viewFieldsToCreate } =
+ computeMissingInitialObjectViewOperations({
+ ...buildMaps({
+ objects: [remoteObject, objectWithoutIndexView, systemObject],
+ views: [PET_INDEX_VIEW],
+ viewFields: [NAME_INDEX_VIEW_FIELD, AGE_INDEX_VIEW_FIELD],
+ }),
+ initialViewApplicationUniversalIdentifier:
+ WORKSPACE_CUSTOM_APPLICATION_UNIVERSAL_IDENTIFIER,
+ });
+
+ expect(viewsToCreate).toHaveLength(0);
+ expect(viewFieldsToCreate).toHaveLength(0);
+ });
+});
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/get-initial-object-view-universal-identifier.util.spec.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/get-initial-object-view-universal-identifier.util.spec.ts
new file mode 100644
index 00000000000..56bc28dbffb
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/__tests__/get-initial-object-view-universal-identifier.util.spec.ts
@@ -0,0 +1,52 @@
+import { getInitialObjectViewUniversalIdentifier } from 'src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util';
+import { getSystemViewUniversalIdentifier } from 'twenty-shared/application';
+
+describe('getInitialObjectViewUniversalIdentifier', () => {
+ const viewApplicationUniversalIdentifier =
+ '20202020-1c25-4d02-bf25-6aeccf7ea419';
+ const objectUniversalIdentifier = '20202020-b374-4779-a561-80086cb2e17f';
+
+ it('should be stable for the same object', () => {
+ expect(
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier,
+ objectUniversalIdentifier,
+ }),
+ ).toBe(
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier,
+ objectUniversalIdentifier,
+ }),
+ );
+ });
+
+ it('should differ from the INDEX view identifier of the same object', () => {
+ expect(
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier,
+ objectUniversalIdentifier,
+ }),
+ ).not.toBe(
+ getSystemViewUniversalIdentifier({
+ objectMetadataApplicationUniversalIdentifier:
+ viewApplicationUniversalIdentifier,
+ objectUniversalIdentifier,
+ viewKey: 'INDEX',
+ }),
+ );
+ });
+
+ it('should differ across objects', () => {
+ expect(
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier,
+ objectUniversalIdentifier,
+ }),
+ ).not.toBe(
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier,
+ objectUniversalIdentifier: '20202020-e674-48e5-a542-72570eee7213',
+ }),
+ );
+ });
+});
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/build-base-universal-flat-view.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/build-base-universal-flat-view.util.ts
new file mode 100644
index 00000000000..b764137a629
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/build-base-universal-flat-view.util.ts
@@ -0,0 +1,67 @@
+import { ViewOpenRecordIn, ViewVisibility } from 'twenty-shared/types';
+import { v4 } from 'uuid';
+
+import { type UniversalFlatView } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view.type';
+
+export const buildBaseUniversalFlatView = ({
+ objectMetadataUniversalIdentifier,
+ applicationUniversalIdentifier,
+ universalIdentifier,
+ name,
+ key,
+ icon,
+ type,
+ position,
+ isSystemSideEffect,
+}: Pick<
+ UniversalFlatView,
+ | 'objectMetadataUniversalIdentifier'
+ | 'applicationUniversalIdentifier'
+ | 'universalIdentifier'
+ | 'name'
+ | 'key'
+ | 'icon'
+ | 'type'
+ | 'position'
+ | 'isSystemSideEffect'
+>): UniversalFlatView & { id: string } => {
+ const createdAt = new Date().toISOString();
+
+ return {
+ id: v4(),
+ objectMetadataUniversalIdentifier,
+ name,
+ key,
+ icon,
+ type,
+ createdAt,
+ updatedAt: createdAt,
+ deletedAt: null,
+ isCustom: true,
+ anyFieldFilterValue: null,
+ calendarFieldMetadataUniversalIdentifier: null,
+ calendarEndFieldMetadataUniversalIdentifier: null,
+ calendarLayout: null,
+ isCompact: false,
+ shouldHideEmptyGroups: false,
+ kanbanColumnWidth: null,
+ kanbanAggregateOperation: null,
+ kanbanAggregateOperationFieldMetadataUniversalIdentifier: null,
+ mainGroupByFieldMetadataUniversalIdentifier: null,
+ openRecordIn: ViewOpenRecordIn.SIDE_PANEL,
+ position,
+ universalIdentifier,
+ visibility: ViewVisibility.WORKSPACE,
+ createdByUserWorkspaceId: null,
+ isActive: true,
+ isSystemSideEffect,
+ universalOverrides: null,
+ viewFieldUniversalIdentifiers: [],
+ viewFieldGroupUniversalIdentifiers: [],
+ viewFilterUniversalIdentifiers: [],
+ viewGroupUniversalIdentifiers: [],
+ viewFilterGroupUniversalIdentifiers: [],
+ viewSortUniversalIdentifiers: [],
+ applicationUniversalIdentifier,
+ };
+};
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/build-initial-view-field-flat-entity.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/build-initial-view-field-flat-entity.util.ts
new file mode 100644
index 00000000000..4ab5635b736
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/build-initial-view-field-flat-entity.util.ts
@@ -0,0 +1,47 @@
+import { getViewFieldUniversalIdentifier } from 'twenty-shared/application';
+
+import { type UniversalFlatViewField } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view-field.type';
+
+export const buildInitialViewFieldFlatEntity = ({
+ applicationUniversalIdentifier,
+ initialViewUniversalIdentifier,
+ fieldMetadataUniversalIdentifier,
+ isVisible,
+ size,
+ position,
+ aggregateOperation,
+ isActive,
+ createdAt,
+}: Pick<
+ UniversalFlatViewField,
+ | 'applicationUniversalIdentifier'
+ | 'fieldMetadataUniversalIdentifier'
+ | 'isVisible'
+ | 'size'
+ | 'position'
+ | 'aggregateOperation'
+ | 'isActive'
+> & {
+ initialViewUniversalIdentifier: string;
+ createdAt: string;
+}): UniversalFlatViewField => ({
+ fieldMetadataUniversalIdentifier,
+ viewUniversalIdentifier: initialViewUniversalIdentifier,
+ viewFieldGroupUniversalIdentifier: null,
+ createdAt,
+ updatedAt: createdAt,
+ deletedAt: null,
+ universalIdentifier: getViewFieldUniversalIdentifier({
+ applicationUniversalIdentifier,
+ viewUniversalIdentifier: initialViewUniversalIdentifier,
+ fieldMetadataUniversalIdentifier,
+ }),
+ isVisible,
+ size,
+ position,
+ aggregateOperation,
+ isActive,
+ isSystemSideEffect: false,
+ universalOverrides: null,
+ applicationUniversalIdentifier,
+});
diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-default-view-field-position-by-field-universal-identifier.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-default-view-field-position-by-field-universal-identifier.util.ts
similarity index 100%
rename from packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-default-view-field-position-by-field-universal-identifier.util.ts
rename to packages/twenty-server/src/engine/metadata-modules/view/utils/compute-default-view-field-position-by-field-universal-identifier.util.ts
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-fields-to-create.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-fields-to-create.util.ts
new file mode 100644
index 00000000000..487690b687a
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-fields-to-create.util.ts
@@ -0,0 +1,61 @@
+import { type AllFlatEntityOperationRecordByMetadataName } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-operation-record-by-metadata-name.type';
+import { DEFAULT_VIEW_FIELD_SIZE } from 'src/engine/metadata-modules/flat-view-field/constants/default-view-field-size.constant';
+import { buildInitialViewFieldFlatEntity } from 'src/engine/metadata-modules/view/utils/build-initial-view-field-flat-entity.util';
+import { computeDefaultViewFieldPositionByFieldUniversalIdentifier } from 'src/engine/metadata-modules/view/utils/compute-default-view-field-position-by-field-universal-identifier.util';
+import { computeViewFieldPositionInputFlatFieldMetadatas } from 'src/engine/metadata-modules/view/utils/compute-view-field-position-input-flat-field-metadatas.util';
+import { type UniversalFlatObjectMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-object-metadata.type';
+import { type UniversalFlatViewField } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view-field.type';
+
+export const computeInitialObjectViewFieldsToCreate = ({
+ sourceFlatObjectMetadata,
+ initialViewUniversalIdentifier,
+ allFlatEntityOperationRecordByMetadataName,
+}: {
+ sourceFlatObjectMetadata: Pick<
+ UniversalFlatObjectMetadata,
+ | 'applicationUniversalIdentifier'
+ | 'universalIdentifier'
+ | 'labelIdentifierFieldMetadataUniversalIdentifier'
+ >;
+ initialViewUniversalIdentifier: string;
+ allFlatEntityOperationRecordByMetadataName: AllFlatEntityOperationRecordByMetadataName;
+}): UniversalFlatViewField[] => {
+ const {
+ applicationUniversalIdentifier,
+ universalIdentifier: objectMetadataUniversalIdentifier,
+ labelIdentifierFieldMetadataUniversalIdentifier,
+ } = sourceFlatObjectMetadata;
+
+ const { systemFlatFieldMetadatas, callerFlatFieldMetadatas } =
+ computeViewFieldPositionInputFlatFieldMetadatas({
+ applicationUniversalIdentifier,
+ objectMetadataUniversalIdentifier,
+ labelIdentifierFieldMetadataUniversalIdentifier,
+ allFlatEntityOperationRecordByMetadataName,
+ });
+
+ const positionByFieldUniversalIdentifier =
+ computeDefaultViewFieldPositionByFieldUniversalIdentifier({
+ systemFlatFieldMetadatas,
+ callerFlatFieldMetadatas,
+ labelIdentifierFieldMetadataUniversalIdentifier,
+ labelIdentifierPolicy: 'displayedFirst',
+ });
+
+ const createdAt = new Date().toISOString();
+
+ return [...positionByFieldUniversalIdentifier.entries()].map(
+ ([fieldMetadataUniversalIdentifier, position]) =>
+ buildInitialViewFieldFlatEntity({
+ applicationUniversalIdentifier,
+ initialViewUniversalIdentifier,
+ fieldMetadataUniversalIdentifier,
+ isVisible: true,
+ size: DEFAULT_VIEW_FIELD_SIZE,
+ position,
+ aggregateOperation: null,
+ isActive: true,
+ createdAt,
+ }),
+ );
+};
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-operations-on-object-creation.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-operations-on-object-creation.util.ts
new file mode 100644
index 00000000000..449980733cb
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-operations-on-object-creation.util.ts
@@ -0,0 +1,49 @@
+import { computeInitialObjectViewFieldsToCreate } from 'src/engine/metadata-modules/view/utils/compute-initial-object-view-fields-to-create.util';
+import { computeInitialObjectViewToCreate } from 'src/engine/metadata-modules/view/utils/compute-initial-object-view-to-create.util';
+import { fromArrayToUniqueKeyRecord } from 'twenty-shared/utils';
+
+import { type UniversalFlatFieldMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-field-metadata.type';
+import { type UniversalFlatObjectMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-object-metadata.type';
+import { type UniversalFlatView } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view.type';
+import { type UniversalFlatViewField } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view-field.type';
+
+export const computeInitialObjectViewOperationsOnObjectCreation = ({
+ flatObjectMetadataToCreate,
+ callerFlatFieldMetadatasToCreate,
+}: {
+ flatObjectMetadataToCreate: Pick<
+ UniversalFlatObjectMetadata,
+ | 'applicationUniversalIdentifier'
+ | 'universalIdentifier'
+ | 'labelPlural'
+ | 'labelIdentifierFieldMetadataUniversalIdentifier'
+ >;
+ callerFlatFieldMetadatasToCreate: UniversalFlatFieldMetadata[];
+}): {
+ flatInitialViewToCreate: UniversalFlatView;
+ flatInitialViewFieldsToCreate: UniversalFlatViewField[];
+} => {
+ const { applicationUniversalIdentifier } = flatObjectMetadataToCreate;
+
+ const flatInitialViewToCreate = computeInitialObjectViewToCreate({
+ objectMetadata: flatObjectMetadataToCreate,
+ applicationUniversalIdentifier,
+ });
+
+ const flatInitialViewFieldsToCreate = computeInitialObjectViewFieldsToCreate({
+ sourceFlatObjectMetadata: flatObjectMetadataToCreate,
+ initialViewUniversalIdentifier: flatInitialViewToCreate.universalIdentifier,
+ allFlatEntityOperationRecordByMetadataName: {
+ fieldMetadata: {
+ flatEntityToCreate: fromArrayToUniqueKeyRecord({
+ array: callerFlatFieldMetadatasToCreate,
+ uniqueKey: 'universalIdentifier',
+ }),
+ flatEntityToUpdate: {},
+ flatEntityToDelete: {},
+ },
+ },
+ });
+
+ return { flatInitialViewToCreate, flatInitialViewFieldsToCreate };
+};
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-to-create.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-to-create.util.ts
new file mode 100644
index 00000000000..a067c869780
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-initial-object-view-to-create.util.ts
@@ -0,0 +1,35 @@
+import { getInitialObjectViewUniversalIdentifier } from 'src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util';
+import { VIEW_TYPE_DEFAULT_ICONS } from 'twenty-shared/constants';
+import { ViewType } from 'twenty-shared/types';
+
+import { buildBaseUniversalFlatView } from 'src/engine/metadata-modules/view/utils/build-base-universal-flat-view.util';
+import { INITIAL_OBJECT_VIEW_POSITION } from 'src/engine/metadata-modules/view/constants/initial-object-view-position.constant';
+import { type UniversalFlatObjectMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-object-metadata.type';
+import { type UniversalFlatView } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view.type';
+
+type InitialObjectViewObjectMetadata = Pick<
+ UniversalFlatObjectMetadata,
+ 'universalIdentifier' | 'labelPlural'
+>;
+
+export const computeInitialObjectViewToCreate = ({
+ objectMetadata,
+ applicationUniversalIdentifier,
+}: {
+ applicationUniversalIdentifier: string;
+ objectMetadata: InitialObjectViewObjectMetadata;
+}): UniversalFlatView & { id: string } =>
+ buildBaseUniversalFlatView({
+ objectMetadataUniversalIdentifier: objectMetadata.universalIdentifier,
+ applicationUniversalIdentifier,
+ universalIdentifier: getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier: applicationUniversalIdentifier,
+ objectUniversalIdentifier: objectMetadata.universalIdentifier,
+ }),
+ name: `All ${objectMetadata.labelPlural}`,
+ key: null,
+ icon: VIEW_TYPE_DEFAULT_ICONS[ViewType.TABLE],
+ type: ViewType.TABLE,
+ position: INITIAL_OBJECT_VIEW_POSITION,
+ isSystemSideEffect: false,
+ });
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-missing-initial-object-view-operations.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-missing-initial-object-view-operations.util.ts
new file mode 100644
index 00000000000..795cfdd10ca
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-missing-initial-object-view-operations.util.ts
@@ -0,0 +1,135 @@
+import { getInitialObjectViewUniversalIdentifier } from 'src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util';
+import { ViewKey } from 'twenty-shared/types';
+import { isDefined } from 'twenty-shared/utils';
+
+import { buildInitialViewFieldFlatEntity } from 'src/engine/metadata-modules/view/utils/build-initial-view-field-flat-entity.util';
+import { computeInitialObjectViewToCreate } from 'src/engine/metadata-modules/view/utils/compute-initial-object-view-to-create.util';
+import { type UniversalFlatObjectMetadata } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-object-metadata.type';
+import { type UniversalFlatViewField } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view-field.type';
+import { type UniversalFlatView } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view.type';
+
+type SeedInputFlatObjectMetadata = Pick<
+ UniversalFlatObjectMetadata,
+ | 'universalIdentifier'
+ | 'labelPlural'
+ | 'isRemote'
+ | 'isSystem'
+ | 'viewUniversalIdentifiers'
+>;
+
+type SeedInputFlatView = Pick<
+ UniversalFlatView,
+ 'key' | 'deletedAt' | 'viewFieldUniversalIdentifiers'
+>;
+
+type SeedInputFlatViewField = Pick<
+ UniversalFlatViewField,
+ | 'fieldMetadataUniversalIdentifier'
+ | 'isVisible'
+ | 'size'
+ | 'position'
+ | 'aggregateOperation'
+ | 'isActive'
+>;
+
+type SeedInputFlatEntityMaps = {
+ flatViewMaps: {
+ byUniversalIdentifier: Record<string, SeedInputFlatView | undefined>;
+ };
+ flatViewFieldMaps: {
+ byUniversalIdentifier: Record<string, SeedInputFlatViewField | undefined>;
+ };
+};
+
+export type SeedOperations = {
+ viewsToCreate: UniversalFlatView[];
+ viewFieldsToCreate: UniversalFlatViewField[];
+};
+
+export const computeMissingInitialObjectViewOperations = ({
+ flatObjectMetadatas,
+ flatViewMaps,
+ flatViewFieldMaps,
+ initialViewApplicationUniversalIdentifier,
+}: SeedInputFlatEntityMaps & {
+ flatObjectMetadatas: SeedInputFlatObjectMetadata[];
+ initialViewApplicationUniversalIdentifier: string;
+}): SeedOperations => {
+ const seedOperations: SeedOperations = {
+ viewsToCreate: [],
+ viewFieldsToCreate: [],
+ };
+
+ const createdAt = new Date().toISOString();
+
+ for (const flatObjectMetadata of flatObjectMetadatas) {
+ if (flatObjectMetadata.isRemote || flatObjectMetadata.isSystem) {
+ continue;
+ }
+
+ const flatIndexView = flatObjectMetadata.viewUniversalIdentifiers
+ .map(
+ (viewUniversalIdentifier) =>
+ flatViewMaps.byUniversalIdentifier[viewUniversalIdentifier],
+ )
+ .find(
+ (flatView) =>
+ isDefined(flatView) &&
+ flatView.key === ViewKey.INDEX &&
+ !isDefined(flatView.deletedAt),
+ );
+
+ if (!isDefined(flatIndexView)) {
+ continue;
+ }
+
+ const initialViewUniversalIdentifier =
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier:
+ initialViewApplicationUniversalIdentifier,
+ objectUniversalIdentifier: flatObjectMetadata.universalIdentifier,
+ });
+
+ const existingInitialFlatView =
+ flatViewMaps.byUniversalIdentifier[initialViewUniversalIdentifier];
+
+ if (isDefined(existingInitialFlatView)) {
+ continue;
+ }
+
+ seedOperations.viewsToCreate.push(
+ computeInitialObjectViewToCreate({
+ objectMetadata: flatObjectMetadata,
+ applicationUniversalIdentifier:
+ initialViewApplicationUniversalIdentifier,
+ }),
+ );
+
+ for (const viewFieldUniversalIdentifier of flatIndexView.viewFieldUniversalIdentifiers) {
+ const flatViewField =
+ flatViewFieldMaps.byUniversalIdentifier[viewFieldUniversalIdentifier];
+
+ if (!isDefined(flatViewField)) {
+ continue;
+ }
+
+ seedOperations.viewFieldsToCreate.push(
+ buildInitialViewFieldFlatEntity({
+ applicationUniversalIdentifier:
+ initialViewApplicationUniversalIdentifier,
+ initialViewUniversalIdentifier,
+ fieldMetadataUniversalIdentifier:
+ flatViewField.fieldMetadataUniversalIdentifier,
+ isVisible: flatViewField.isVisible,
+ size: flatViewField.size,
+ position: flatViewField.position,
+ aggregateOperation: flatViewField.aggregateOperation,
+ isActive: flatViewField.isActive,
+ createdAt,
+ }),
+ );
+ }
+ }
+
+ return seedOperations;
+};
diff --git a/packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-view-field-position-input-flat-field-metadatas.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/compute-view-field-position-input-flat-field-metadatas.util.ts
similarity index 100%
rename from packages/twenty-server/src/engine/metadata-modules/metadata-side-effect/handlers/utils/compute-view-field-position-input-flat-field-metadatas.util.ts
rename to packages/twenty-server/src/engine/metadata-modules/view/utils/compute-view-field-position-input-flat-field-metadatas.util.ts
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util.ts
new file mode 100644
index 00000000000..e1fe6a8d23c
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util.ts
@@ -0,0 +1,16 @@
+import { computeDeterministicUuid } from 'twenty-shared/application';
+
+const INITIAL_OBJECT_VIEW_KEY = 'INITIAL' as const;
+
+export const getInitialObjectViewUniversalIdentifier = ({
+ viewApplicationUniversalIdentifier,
+ objectUniversalIdentifier,
+}: {
+ viewApplicationUniversalIdentifier: string;
+ objectUniversalIdentifier: string;
+}): string =>
+ computeDeterministicUuid({
+ entityNamespace: 'view',
+ value: `${objectUniversalIdentifier}:${INITIAL_OBJECT_VIEW_KEY}`,
+ applicationUniversalIdentifier: viewApplicationUniversalIdentifier,
+ });
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/utils/is-initial-object-view.util.ts b/packages/twenty-server/src/engine/metadata-modules/view/utils/is-initial-object-view.util.ts
new file mode 100644
index 00000000000..f7e80f7956f
--- /dev/null
+++ b/packages/twenty-server/src/engine/metadata-modules/view/utils/is-initial-object-view.util.ts
@@ -0,0 +1,17 @@
+import { getInitialObjectViewUniversalIdentifier } from 'src/engine/metadata-modules/view/utils/get-initial-object-view-universal-identifier.util';
+
+import { type UniversalFlatView } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/types/universal-flat-view.type';
+
+export const isInitialObjectView = (
+ flatView: Pick<
+ UniversalFlatView,
+ | 'universalIdentifier'
+ | 'applicationUniversalIdentifier'
+ | 'objectMetadataUniversalIdentifier'
+ >,
+): boolean =>
+ flatView.universalIdentifier ===
+ getInitialObjectViewUniversalIdentifier({
+ viewApplicationUniversalIdentifier: flatView.applicationUniversalIdentifier,
+ objectUniversalIdentifier: flatView.objectMetadataUniversalIdentifier,
+ });
diff --git a/packages/twenty-server/src/engine/metadata-modules/view/view.module.ts b/packages/twenty-server/src/engine/metadata-modules/view/view.module.ts
index df38e3d5f0d..ae7be0bb413 100644
--- a/packages/twenty-server/src/engine/metadata-modules/view/view.module.ts
+++ b/packages/twenty-server/src/engine/metadata-modules/view/view.module.ts
@@ -2,6 +2,7 @@ import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { ApplicationModule } from 'src/engine/core-modules/application/application.module';
+import { FeatureFlagModule } from 'src/engine/core-modules/feature-flag/feature-flag.module';
import { I18nModule } from 'src/engine/core-modules/i18n/i18n.module';
import { ApplicationTranslationCatalogModule } from 'src/engine/metadata-modules/application-translation-catalog/application-translation-catalog.module';
import { WorkspaceManyOrAllFlatEntityMapsCacheModule } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module';
@@ -27,6 +28,7 @@ import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace
@Module({
imports: [
+ FeatureFlagModule,
ApplicationTranslationCatalogModule,
TypeOrmModule.forFeature([ViewEntity]),
ViewPermissionsModule,
diff --git a/packages/twenty-server/src/engine/workspace-manager/dev-seeder/core/utils/seed-feature-flags.util.ts b/packages/twenty-server/src/engine/workspace-manager/dev-seeder/core/utils/seed-feature-flags.util.ts
index 6d973d445cf..8c1c54b5433 100644
--- a/packages/twenty-server/src/engine/workspace-manager/dev-seeder/core/utils/seed-feature-flags.util.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/dev-seeder/core/utils/seed-feature-flags.util.ts
@@ -12,6 +12,7 @@ const DEFAULT_SEEDED_FEATURE_FLAGS: Partial<Record<FeatureFlagKey, boolean>> = {
[FeatureFlagKey.IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED]: false,
[FeatureFlagKey.IS_RECORD_CREATION_FORM_ENABLED]: false,
[FeatureFlagKey.IS_RECORD_SHARING_ENABLED]: false,
+ [FeatureFlagKey.IS_INITIAL_OBJECT_VIEW_ENABLED]: false,
};
type SeedFeatureFlagsArgs = {
diff --git a/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/services/twenty-standard-application.service.ts b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/services/twenty-standard-application.service.ts
index 66085d12bd5..c85c704ed84 100644
--- a/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/services/twenty-standard-application.service.ts
+++ b/packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/services/twenty-standard-application.service.ts
@@ -3,7 +3,9 @@ import { Injectable } from '@nestjs/common';
import { ApplicationService } from 'src/engine/core-modules/application/application.service';
import { MetadataFlatEntity } from 'src/engine/metadata-modules/flat-entity/types/metadata-flat-entity.type';
import { getMetadataFlatEntityMapsKey } from 'src/engine/metadata-modules/flat-entity/utils/get-metadata-flat-entity-maps-key.util';
+import { findManyFlatEntityByUniversalIdentifierInUniversalFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-many-flat-entity-by-universal-identifier-in-universal-flat-entity-maps.util';
import { getSubFlatEntityMapsByApplicationIdsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/get-sub-flat-entity-maps-by-application-ids-or-throw.util';
+import { computeMissingInitialObjectViewOperations } from 'src/engine/metadata-modules/view/utils/compute-missing-initial-object-view-operations.util';
import { WorkspaceOrmManager } from 'src/engine/twenty-orm/workspace-orm.manager';
import { WorkspaceCacheService } from 'src/engine/workspace-cache/services/workspace-cache.service';
import { TWENTY_STANDARD_ALL_METADATA_NAME } from 'src/engine/workspace-manager/twenty-standard-application/constants/twenty-standard-all-metadata-name.constant';
@@ -100,5 +102,81 @@ export class TwentyStandardApplicationService {
'Multiple validation errors occurred while synchronizing twenty-standard application',
);
}
+
+ await this.seedStandardObjectInitialViewsOrThrow({
+ workspaceId,
+ standardObjectMetadataUniversalIdentifiers: Object.keys(
+ toTwentyStandardAllFlatEntityMaps.flatObjectMetadataMaps
+ .byUniversalIdentifier,
+ ),
+ });
+ }
+
+ private async seedStandardObjectInitialViewsOrThrow({
+ workspaceId,
+ standardObjectMetadataUniversalIdentifiers,
+ }: {
+ workspaceId: string;
+ standardObjectMetadataUniversalIdentifiers: string[];
+ }): Promise<void> {
+ const { flatObjectMetadataMaps, flatViewMaps, flatViewFieldMaps } =
+ await this.workspaceCacheService.getOrRecompute(workspaceId, [
+ 'flatObjectMetadataMaps',
+ 'flatViewMaps',
+ 'flatViewFieldMaps',
+ ]);
+
+ const { workspaceCustomFlatApplication } =
+ await this.applicationService.findWorkspaceTwentyStandardAndCustomApplicationOrThrow(
+ { workspaceId },
+ );
+
+ const seedOperations = computeMissingInitialObjectViewOperations({
+ flatObjectMetadatas:
+ findManyFlatEntityByUniversalIdentifierInUniversalFlatEntityMaps({
+ flatEntityMaps: flatObjectMetadataMaps,
+ universalIdentifiers: standardObjectMetadataUniversalIdentifiers,
+ }),
+ flatViewMaps,
+ flatViewFieldMaps,
+ initialViewApplicationUniversalIdentifier:
+ workspaceCustomFlatApplication.universalIdentifier,
+ });
+
+ if (
+ seedOperations.viewsToCreate.length === 0 &&
+ seedOperations.viewFieldsToCreate.length === 0
+ ) {
+ return;
+ }
+
+ const result =
+ await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunLegacyWorkspaceMigration(
+ {
+ isSystemBuild: true,
+ workspaceId,
+ applicationUniversalIdentifier:
+ workspaceCustomFlatApplication.universalIdentifier,
+ allFlatEntityOperationByMetadataName: {
+ view: {
+ flatEntityToCreate: seedOperations.viewsToCreate,
+ flatEntityToDelete: [],
+ flatEntityToUpdate: [],
+ },
+ viewField: {
+ flatEntityToCreate: seedOperations.viewFieldsToCreate,
+ flatEntityToDelete: [],
+ flatEntityToUpdate: [],
+ },
+ },
+ },
+ );
+
+ if (result.status === 'fail') {
+ throw new WorkspaceMigrationBuilderException(
+ result,
+ `Multiple validation errors occurred while seeding initial object views for workspace ${workspaceId}`,
+ );
+ }
}
}
diff --git a/packages/twenty-server/test/integration/metadata/suites/object-metadata/view-side-effect-on-object-metadata-creation.integration-spec.ts b/packages/twenty-server/test/integration/metadata/suites/object-metadata/view-side-effect-on-object-metadata-creation.integration-spec.ts
index 44b3373a626..495f59d8661 100644
--- a/packages/twenty-server/test/integration/metadata/suites/object-metadata/view-side-effect-on-object-metadata-creation.integration-spec.ts
+++ b/packages/twenty-server/test/integration/metadata/suites/object-metadata/view-side-effect-on-object-metadata-creation.integration-spec.ts
@@ -5,7 +5,8 @@ import { deleteOneObjectMetadata } from 'test/integration/metadata/suites/object
import { updateOneObjectMetadata } from 'test/integration/metadata/suites/object-metadata/utils/update-one-object-metadata.util';
import { findViewFields } from 'test/integration/metadata/suites/view-field/utils/find-view-fields.util';
import { findViews } from 'test/integration/metadata/suites/view/utils/find-views.util';
-import { ViewType } from 'twenty-shared/types';
+import { updateFeatureFlag } from 'test/integration/metadata/suites/utils/update-feature-flag.util';
+import { FeatureFlagKey, ViewType } from 'twenty-shared/types';
import { isDefined } from 'twenty-shared/utils';
import { type FlatView } from 'src/engine/metadata-modules/flat-view/types/flat-view.type';
@@ -74,6 +75,13 @@ describe('View side effect on object creation', () => {
return createOneObject;
};
+ const findInitialViews = <TView extends { key: string | null; type: string }>(
+ views: TView[],
+ ) =>
+ views.filter(
+ (view) => !isDefined(view.key) && view.type === ViewType.TABLE,
+ );
+
const findIndexView = async (objectMetadataId: string) => {
const {
data: { getViews },
@@ -95,7 +103,6 @@ describe('View side effect on object creation', () => {
});
expect(createdViews).toBeDefined();
- expect(createdViews.length).toBe(2);
const indexView = createdViews.find((view) => view.key === 'INDEX');
@@ -108,6 +115,9 @@ describe('View side effect on object creation', () => {
type: ViewType.TABLE,
});
+ expect(createdViews.length).toBe(2);
+ expect(findInitialViews(createdViews)).toHaveLength(0);
+
const {
data: { getViewFields: indexViewFields },
} = await findViewFields({
@@ -118,6 +128,56 @@ describe('View side effect on object creation', () => {
expect(indexViewFields.length).toBe(5);
});
+ it('should expose the initial view and its view fields once the feature flag is enabled', async () => {
+ const createOneObject = await createDishesObject();
+
+ createdObjectMetadataId = createOneObject.id;
+
+ await updateFeatureFlag({
+ featureFlag: FeatureFlagKey.IS_INITIAL_OBJECT_VIEW_ENABLED,
+ value: true,
+ expectToFail: false,
+ });
+
+ try {
+ const {
+ data: { getViews: createdViews },
+ } = await findViews({
+ objectMetadataId: createdObjectMetadataId,
+ expectToFail: false,
+ });
+
+ const [initialView, ...extraInitialViews] = findInitialViews(createdViews);
+
+ if (!isDefined(initialView)) {
+ throw new Error('expected a initial user-owned view to be exposed');
+ }
+
+ expect(extraInitialViews).toHaveLength(0);
+
+ expect(initialView).toMatchObject<Partial<FlatView>>({
+ objectMetadataId: createdObjectMetadataId,
+ type: ViewType.TABLE,
+ name: 'All Dishes I love',
+ });
+
+ const {
+ data: { getViewFields: initialViewFields },
+ } = await findViewFields({
+ viewId: initialView.id,
+ expectToFail: false,
+ });
+
+ expect(initialViewFields.length).toBe(5);
+ } finally {
+ await updateFeatureFlag({
+ featureFlag: FeatureFlagKey.IS_INITIAL_OBJECT_VIEW_ENABLED,
+ value: false,
+ expectToFail: false,
+ });
+ }
+ });
+
it('should keep the same INDEX view when the object is renamed (lossless, deterministic identifier)', async () => {
const createOneObject = await createDishesObject();
diff --git a/packages/twenty-shared/src/types/FeatureFlagKey.ts b/packages/twenty-shared/src/types/FeatureFlagKey.ts
index d7077b930b8..dbcc25a31a6 100644
--- a/packages/twenty-shared/src/types/FeatureFlagKey.ts
+++ b/packages/twenty-shared/src/types/FeatureFlagKey.ts
@@ -13,5 +13,6 @@ export enum FeatureFlagKey {
IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED = 'IS_QUOTA_ENGINE_CREDIT_BOUND_ENABLED',
IS_RECORD_CREATION_FORM_ENABLED = 'IS_RECORD_CREATION_FORM_ENABLED',
IS_RECORD_SHARING_ENABLED = 'IS_RECORD_SHARING_ENABLED',
+ IS_INITIAL_OBJECT_VIEW_ENABLED = 'IS_INITIAL_OBJECT_VIEW_ENABLED',
IS_WEBHOOK_RATE_LIMIT_ENABLED = 'IS_WEBHOOK_RATE_LIMIT_ENABLED',
}