[REQUIRES_CACHE_FLUSH][GQL_VIEW_GROUP_API_BREAKING_CHANGE] ViewGroup in v2 (#15052)

# Introduction Adding view-group to core engine v2 Following https://github.com/twentyhq/twenty/pull/15010 ( same pattern ) ## What's done - Created flat-view-group - flat view group runner - flat view group builder - create view group service v2 and input transpilers - refactor the existing view group resolver to fix standard ( BREAKING_CHANGE on graphql api update especially ) REST stays the same - refactored the front to consume the mutations autogenerated close https://github.com/twentyhq/core-team-issues/issues/1665
2025-10-14 15:55:50 +02:00
parent 5fec6a9afc
commit 7d747c9876
88 changed files with 2640 additions and 497 deletions
@@ -0,0 +1,12 @@
+import { ALL_METADATA_NAME } from 'src/engine/metadata-modules/flat-entity/constant/all-metadata-name.constant';
+import { type OrchestratorFailureReport } from 'src/engine/workspace-manager/workspace-migration-v2/types/workspace-migration-orchestrator.type';
+
+export const EMPTY_ORCHESTRATOR_FAILURE_REPORT = (
+  Object.keys(ALL_METADATA_NAME) as (keyof typeof ALL_METADATA_NAME)[]
+).reduce(
+  (orchestratorReport, metadataName) => ({
+    ...orchestratorReport,
+    [metadataName]: [],
+  }),
+  {} as OrchestratorFailureReport,
+);
@@ -1,5 +1,6 @@
 import { type I18n } from '@lingui/core';

+import { EMPTY_ORCHESTRATOR_FAILURE_REPORT } from 'src/engine/workspace-manager/workspace-migration-v2/constant/empty-orchestrator-failure-report.constant';
 import { type WorkspaceMigrationBuilderExceptionV2 } from 'src/engine/workspace-manager/workspace-migration-v2/exceptions/workspace-migration-builder-exception-v2';
 import { type ValidationErrorResponse } from 'src/engine/workspace-manager/workspace-migration-v2/interceptors/types/validate-error-response.type';
 import { translateOrchestratorFailureReport } from 'src/engine/workspace-manager/workspace-migration-v2/interceptors/utils/translate-validation-errors.util';
@@ -20,20 +21,10 @@ export const fromWorkspaceMigrationBuilderExceptionToValidationResponseError = (
      invalidCronTrigger: 0,
      invalidRouteTrigger: 0,
      invalidFieldMetadata: 0,
+      invalidViewGroup: 0,
      totalErrors: 0,
    },
-    errors: {
-      fieldMetadata: [],
-      index: [],
-      objectMetadata: [],
-      view: [],
-      viewField: [],
-      serverlessFunction: [],
-      databaseEventTrigger: [],
-      cronTrigger: [],
-      routeTrigger: [],
-      viewFilter: [],
-    },
+    errors: EMPTY_ORCHESTRATOR_FAILURE_REPORT,
  };

  const report =
@@ -5,8 +5,8 @@ import { isDefined } from 'twenty-shared/utils';
 import { EMPTY_ALL_FLAT_ENTITY_MAPS } from 'src/engine/metadata-modules/flat-entity/constant/empty-all-flat-entity-maps.constant';
 import { AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';
 import { EMPTY_ORCHESTRATOR_ACTIONS_REPORT } from 'src/engine/workspace-manager/workspace-migration-v2/constant/empty-orchestrator-actions-report.constant';
+import { EMPTY_ORCHESTRATOR_FAILURE_REPORT } from 'src/engine/workspace-manager/workspace-migration-v2/constant/empty-orchestrator-failure-report.constant';
 import {
-  OrchestratorFailureReport,
  WorkspaceMigrationOrchestratorBuildArgs,
  WorkspaceMigrationOrchestratorFailedResult,
  WorkspaceMigrationOrchestratorSuccessfulResult,
@@ -21,7 +21,9 @@ import { WorkspaceMigrationV2RouteTriggerActionsBuilderService } from 'src/engin
 import { WorkspaceMigrationV2ServerlessFunctionActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/serverless-function/workspace-migration-v2-serverless-function-actions-builder.service';
 import { WorkspaceMigrationV2ViewFieldActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-field/workspace-migration-v2-view-field-actions-builder.service';
 import { WorkspaceMigrationV2ViewFilterActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-filter/workspace-migration-v2-view-filter-actions-builder.service';
+import { WorkspaceMigrationV2ViewGroupActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-group/workspace-migration-v2-view-group-actions-builder.service';
 import { WorkspaceMigrationV2ViewActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view/workspace-migration-v2-view-actions-builder.service';
+
@Injectable()
 export class WorkspaceMigrationBuildOrchestratorService {
  constructor(
@@ -30,6 +32,7 @@ export class WorkspaceMigrationBuildOrchestratorService {
    private readonly workspaceMigrationV2ViewActionsBuilderService: WorkspaceMigrationV2ViewActionsBuilderService,
    private readonly workspaceMigrationV2ViewFieldActionsBuilderService: WorkspaceMigrationV2ViewFieldActionsBuilderService,
    private readonly workspaceMigrationV2ViewFilterActionsBuilderService: WorkspaceMigrationV2ViewFilterActionsBuilderService,
+    private readonly workspaceMigrationV2ViewGroupActionsBuilderService: WorkspaceMigrationV2ViewGroupActionsBuilderService,
    private readonly workspaceMigrationV2ServerlessFunctionActionsBuilderService: WorkspaceMigrationV2ServerlessFunctionActionsBuilderService,
    private readonly workspaceMigrationV2DatabaseEventTriggerActionsBuilderService: WorkspaceMigrationV2DatabaseEventTriggerActionsBuilderService,
    private readonly workspaceMigrationV2CronTriggerActionsBuilderService: WorkspaceMigrationV2CronTriggerActionsBuilderService,
@@ -80,18 +83,9 @@ export class WorkspaceMigrationBuildOrchestratorService {
    const orchestratorActionsReport = structuredClone({
      ...EMPTY_ORCHESTRATOR_ACTIONS_REPORT,
    });
-    const orchestratorFailureReport: OrchestratorFailureReport = {
-      objectMetadata: [],
-      view: [],
-      viewField: [],
-      index: [],
-      serverlessFunction: [],
-      databaseEventTrigger: [],
-      cronTrigger: [],
-      routeTrigger: [],
-      fieldMetadata: [],
-      viewFilter: [],
-    };
+    const orchestratorFailureReport = structuredClone(
+      EMPTY_ORCHESTRATOR_FAILURE_REPORT,
+    );

    const optimisticAllFlatEntityMaps = this.setupOptimisticCache({
      fromToAllFlatEntityMaps,
@@ -108,6 +102,7 @@ export class WorkspaceMigrationBuildOrchestratorService {
      flatRouteTriggerMaps,
      flatFieldMetadataMaps,
      flatViewFilterMaps,
+      flatViewGroupMaps,
    } = fromToAllFlatEntityMaps;

    if (isDefined(flatObjectMetadataMaps)) {
@@ -302,6 +297,36 @@ export class WorkspaceMigrationBuildOrchestratorService {
      }
    }

+    if (isDefined(flatViewGroupMaps)) {
+      const { from: fromFlatViewGroupMaps, to: toFlatViewGroupMaps } =
+        flatViewGroupMaps;
+      const viewGroupResult =
+        await this.workspaceMigrationV2ViewGroupActionsBuilderService.validateAndBuild(
+          {
+            from: fromFlatViewGroupMaps,
+            to: toFlatViewGroupMaps,
+            buildOptions,
+            dependencyOptimisticFlatEntityMaps: {
+              flatFieldMetadataMaps:
+                optimisticAllFlatEntityMaps.flatFieldMetadataMaps,
+              flatViewMaps: optimisticAllFlatEntityMaps.flatViewMaps,
+            },
+            workspaceId,
+          },
+        );
+
+      optimisticAllFlatEntityMaps.flatViewGroupMaps =
+        viewGroupResult.optimisticFlatEntityMaps;
+      optimisticAllFlatEntityMaps.flatViewMaps =
+        viewGroupResult.dependencyOptimisticFlatEntityMaps.flatViewMaps;
+
+      if (viewGroupResult.status === 'fail') {
+        orchestratorFailureReport.viewGroup.push(...viewGroupResult.errors);
+      } else {
+        orchestratorActionsReport.viewGroup = viewGroupResult.actions;
+      }
+    }
+
    if (isDefined(flatServerlessFunctionMaps)) {
      const {
        from: fromFlatServerlessFunctionMaps,
@@ -471,6 +496,9 @@ export class WorkspaceMigrationBuildOrchestratorService {
          ...aggregatedOrchestratorActionsReport.viewFilter.deleted,
          ...aggregatedOrchestratorActionsReport.viewFilter.created,
          ...aggregatedOrchestratorActionsReport.viewFilter.updated,
+          ...aggregatedOrchestratorActionsReport.viewGroup.deleted,
+          ...aggregatedOrchestratorActionsReport.viewGroup.created,
+          ...aggregatedOrchestratorActionsReport.viewGroup.updated,
          ///

          // Serverless functions
@@ -0,0 +1,26 @@
+import { type FlatEntityPropertiesUpdates } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-properties-updates.type';
+import { type FlatViewGroup } from 'src/engine/metadata-modules/flat-view-group/types/flat-view-group.type';
+
+export type CreateViewGroupAction = {
+  type: 'create_view_group';
+  viewGroup: FlatViewGroup;
+};
+
+export type UpdateViewGroupAction = {
+  type: 'update_view_group';
+  viewGroupId: string;
+  updates: FlatEntityPropertiesUpdates<'viewGroup'>;
+};
+
+export type DeleteViewGroupAction = {
+  type: 'delete_view_group';
+  viewGroupId: string;
+};
+
+export type WorkspaceMigrationViewGroupActionV2 =
+  | CreateViewGroupAction
+  | UpdateViewGroupAction
+  | DeleteViewGroupAction;
+
+export type WorkspaceMigrationViewGroupActionTypeV2 =
+  WorkspaceMigrationViewGroupActionV2['type'];
@@ -0,0 +1,164 @@
+import { Injectable } from '@nestjs/common';
+
+import { isDefined } from 'twenty-shared/utils';
+
+import { ALL_METADATA_NAME } from 'src/engine/metadata-modules/flat-entity/constant/all-metadata-name.constant';
+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 { replaceFlatEntityInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/replace-flat-entity-in-flat-entity-maps-or-throw.util';
+import { UpdateViewGroupAction } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-group/types/workspace-migration-view-group-action-v2.type';
+import { WorkspaceEntityMigrationBuilderV2Service } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/services/workspace-entity-migration-builder-v2.service';
+import { FlatEntityUpdateValidationArgs } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/types/flat-entity-update-validation-args.type';
+import { FlatEntityValidationArgs } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/types/flat-entity-validation-args.type';
+import { FlatEntityValidationReturnType } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/types/flat-entity-validation-result.type';
+import { FlatViewGroupValidatorService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/validators/services/flat-view-group-validator.service';
+
+@Injectable()
+export class WorkspaceMigrationV2ViewGroupActionsBuilderService extends WorkspaceEntityMigrationBuilderV2Service<
+  typeof ALL_METADATA_NAME.viewGroup
+> {
+  constructor(
+    private readonly flatViewGroupValidatorService: FlatViewGroupValidatorService,
+  ) {
+    super(ALL_METADATA_NAME.viewGroup);
+  }
+
+  protected async validateFlatEntityCreation(
+    args: FlatEntityValidationArgs<typeof ALL_METADATA_NAME.viewGroup>,
+  ): Promise<
+    FlatEntityValidationReturnType<
+      typeof ALL_METADATA_NAME.viewGroup,
+      'created'
+    >
+  > {
+    const validationResult =
+      this.flatViewGroupValidatorService.validateFlatViewGroupCreation(args);
+
+    if (validationResult.errors.length > 0) {
+      return {
+        status: 'fail',
+        ...validationResult,
+      };
+    }
+
+    const {
+      flatEntityToValidate: flatViewGroupToValidate,
+      dependencyOptimisticFlatEntityMaps,
+    } = args;
+
+    const flatView = findFlatEntityByIdInFlatEntityMapsOrThrow({
+      flatEntityId: flatViewGroupToValidate.viewId,
+      flatEntityMaps: dependencyOptimisticFlatEntityMaps.flatViewMaps,
+    });
+
+    const updatedFlatViewMaps = replaceFlatEntityInFlatEntityMapsOrThrow({
+      flatEntity: {
+        ...flatView,
+        viewGroupIds: [...flatView.viewGroupIds, flatViewGroupToValidate.id],
+      },
+      flatEntityMaps: dependencyOptimisticFlatEntityMaps.flatViewMaps,
+    });
+
+    return {
+      status: 'success',
+      action: {
+        type: 'create_view_group',
+        viewGroup: flatViewGroupToValidate,
+      },
+      dependencyOptimisticFlatEntityMaps: {
+        ...dependencyOptimisticFlatEntityMaps,
+        flatViewMaps: updatedFlatViewMaps,
+      },
+    };
+  }
+
+  protected async validateFlatEntityDeletion(
+    args: FlatEntityValidationArgs<typeof ALL_METADATA_NAME.viewGroup>,
+  ): Promise<
+    FlatEntityValidationReturnType<
+      typeof ALL_METADATA_NAME.viewGroup,
+      'deleted'
+    >
+  > {
+    const validationResult =
+      this.flatViewGroupValidatorService.validateFlatViewGroupDeletion(args);
+
+    if (validationResult.errors.length > 0) {
+      return {
+        status: 'fail',
+        ...validationResult,
+      };
+    }
+
+    const {
+      flatEntityToValidate: flatViewGroupToValidate,
+      dependencyOptimisticFlatEntityMaps,
+    } = args;
+
+    const flatView = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: flatViewGroupToValidate.viewId,
+      flatEntityMaps: dependencyOptimisticFlatEntityMaps.flatViewMaps,
+    });
+
+    const updatedFlatViewMaps = isDefined(flatView)
+      ? replaceFlatEntityInFlatEntityMapsOrThrow({
+          flatEntity: {
+            ...flatView,
+            viewGroupIds: flatView.viewGroupIds.filter(
+              (id) => id !== flatViewGroupToValidate.id,
+            ),
+          },
+          flatEntityMaps: dependencyOptimisticFlatEntityMaps.flatViewMaps,
+        })
+      : dependencyOptimisticFlatEntityMaps.flatViewMaps;
+
+    return {
+      status: 'success',
+      action: {
+        type: 'delete_view_group',
+        viewGroupId: flatViewGroupToValidate.id,
+      },
+      dependencyOptimisticFlatEntityMaps: {
+        ...dependencyOptimisticFlatEntityMaps,
+        flatViewMaps: updatedFlatViewMaps,
+      },
+    };
+  }
+
+  protected async validateFlatEntityUpdate(
+    args: FlatEntityUpdateValidationArgs<typeof ALL_METADATA_NAME.viewGroup>,
+  ): Promise<
+    FlatEntityValidationReturnType<
+      typeof ALL_METADATA_NAME.viewGroup,
+      'updated'
+    >
+  > {
+    const validationResult =
+      this.flatViewGroupValidatorService.validateFlatViewGroupUpdate(args);
+
+    if (validationResult.errors.length > 0) {
+      return {
+        status: 'fail',
+        ...validationResult,
+      };
+    }
+
+    const {
+      dependencyOptimisticFlatEntityMaps,
+      flatEntityId,
+      flatEntityUpdates,
+    } = args;
+
+    const updateViewGroupAction: UpdateViewGroupAction = {
+      type: 'update_view_group',
+      viewGroupId: flatEntityId,
+      updates: flatEntityUpdates,
+    };
+
+    return {
+      status: 'success',
+      action: updateViewGroupAction,
+      dependencyOptimisticFlatEntityMaps,
+    };
+  }
+}
@@ -0,0 +1,184 @@
+import { Injectable } from '@nestjs/common';
+
+import { msg, t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+import { ALL_METADATA_NAME } from 'src/engine/metadata-modules/flat-entity/constant/all-metadata-name.constant';
+import { findFlatEntityByIdInFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps.util';
+import { FlatViewGroup } from 'src/engine/metadata-modules/flat-view-group/types/flat-view-group.type';
+import { ViewExceptionCode } from 'src/engine/metadata-modules/view/exceptions/view.exception';
+import { FailedFlatEntityValidation } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/types/failed-flat-entity-validation.type';
+import { FlatEntityUpdateValidationArgs } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/types/flat-entity-update-validation-args.type';
+import { FlatEntityValidationArgs } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/types/flat-entity-validation-args.type';
+import { fromFlatEntityPropertiesUpdatesToPartialFlatEntity } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/utils/from-flat-entity-properties-updates-to-partial-flat-entity';
+
+@Injectable()
+export class FlatViewGroupValidatorService {
+  public validateFlatViewGroupUpdate({
+    flatEntityId,
+    flatEntityUpdates,
+    optimisticFlatEntityMaps: optimisticFlatViewGroupMaps,
+    dependencyOptimisticFlatEntityMaps,
+  }: FlatEntityUpdateValidationArgs<
+    typeof ALL_METADATA_NAME.viewGroup
+  >): FailedFlatEntityValidation<FlatViewGroup> {
+    const validationResult: FailedFlatEntityValidation<FlatViewGroup> = {
+      type: 'update_view_group',
+      errors: [],
+      flatEntityMinimalInformation: {
+        id: flatEntityId,
+      },
+    };
+
+    const existingFlatViewGroup =
+      optimisticFlatViewGroupMaps.byId[flatEntityId];
+
+    if (!isDefined(existingFlatViewGroup)) {
+      validationResult.errors.push({
+        code: ViewExceptionCode.INVALID_VIEW_DATA,
+        message: t`View group to update not found`,
+        userFriendlyMessage: msg`View group to update not found`,
+      });
+
+      return validationResult;
+    }
+
+    const updatedFlatViewGroup = {
+      ...existingFlatViewGroup,
+      ...fromFlatEntityPropertiesUpdatesToPartialFlatEntity({
+        updates: flatEntityUpdates,
+      }),
+    };
+
+    validationResult.flatEntityMinimalInformation = {
+      id: updatedFlatViewGroup.id,
+      viewId: updatedFlatViewGroup.viewId,
+      fieldMetadataId: updatedFlatViewGroup.fieldMetadataId,
+    };
+
+    const flatView = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: updatedFlatViewGroup.viewId,
+      flatEntityMaps: dependencyOptimisticFlatEntityMaps.flatViewMaps,
+    });
+
+    if (!isDefined(flatView)) {
+      validationResult.errors.push({
+        code: ViewExceptionCode.INVALID_VIEW_DATA,
+        message: t`View group to update parent view not found`,
+        userFriendlyMessage: msg`View group to update parent view not found`,
+      });
+    }
+
+    const flatFieldMetadata = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: updatedFlatViewGroup.fieldMetadataId,
+      flatEntityMaps: dependencyOptimisticFlatEntityMaps.flatFieldMetadataMaps,
+    });
+
+    if (!isDefined(flatFieldMetadata)) {
+      validationResult.errors.push({
+        code: ViewExceptionCode.INVALID_VIEW_DATA,
+        message: t`View group to update parent field not found`,
+        userFriendlyMessage: msg`View group to update parent field not found`,
+      });
+    }
+
+    return validationResult;
+  }
+
+  public validateFlatViewGroupDeletion({
+    flatEntityToValidate: { id: viewGroupIdToDelete },
+    optimisticFlatEntityMaps: optimisticFlatViewGroupMaps,
+  }: FlatEntityValidationArgs<
+    typeof ALL_METADATA_NAME.viewGroup
+  >): FailedFlatEntityValidation<FlatViewGroup> {
+    const validationResult: FailedFlatEntityValidation<FlatViewGroup> = {
+      type: 'delete_view_group',
+      errors: [],
+      flatEntityMinimalInformation: {
+        id: viewGroupIdToDelete,
+      },
+    };
+
+    const existingFlatViewGroup =
+      optimisticFlatViewGroupMaps.byId[viewGroupIdToDelete];
+
+    if (!isDefined(existingFlatViewGroup)) {
+      validationResult.errors.push({
+        code: ViewExceptionCode.INVALID_VIEW_DATA,
+        message: t`View group to delete not found`,
+        userFriendlyMessage: msg`View group to delete not found`,
+      });
+    } else {
+      if (!isDefined(existingFlatViewGroup.deletedAt)) {
+        validationResult.errors.push({
+          code: ViewExceptionCode.INVALID_VIEW_DATA,
+          message: t`View group to delete has not been soft deleted`,
+          userFriendlyMessage: msg`View group to delete has not been soft deleted`,
+        });
+      }
+    }
+
+    return validationResult;
+  }
+
+  public validateFlatViewGroupCreation({
+    flatEntityToValidate: flatViewGroupToValidate,
+    optimisticFlatEntityMaps: optimisticFlatViewGroupMaps,
+    dependencyOptimisticFlatEntityMaps,
+  }: FlatEntityValidationArgs<
+    typeof ALL_METADATA_NAME.viewGroup
+  >): FailedFlatEntityValidation<FlatViewGroup> {
+    const validationResult: FailedFlatEntityValidation<FlatViewGroup> = {
+      type: 'create_view_group',
+      errors: [],
+      flatEntityMinimalInformation: {
+        id: flatViewGroupToValidate.id,
+        viewId: flatViewGroupToValidate.viewId,
+        fieldMetadataId: flatViewGroupToValidate.fieldMetadataId,
+      },
+    };
+
+    const existingFlatViewGroup =
+      optimisticFlatViewGroupMaps.byId[flatViewGroupToValidate.id];
+
+    if (isDefined(existingFlatViewGroup)) {
+      const flatViewGroupId = flatViewGroupToValidate.id;
+
+      validationResult.errors.push({
+        code: ViewExceptionCode.INVALID_VIEW_DATA,
+        message: t`View group metadata with id ${flatViewGroupId} already exists`,
+        userFriendlyMessage: msg`View group metadata already exists`,
+      });
+    }
+
+    const flatFieldMetadata = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: flatViewGroupToValidate.fieldMetadataId,
+      flatEntityMaps: dependencyOptimisticFlatEntityMaps.flatFieldMetadataMaps,
+    });
+
+    if (!isDefined(flatFieldMetadata)) {
+      validationResult.errors.push({
+        code: ViewExceptionCode.INVALID_VIEW_DATA,
+        message: t`Field metadata not found`,
+        userFriendlyMessage: msg`Field metadata not found`,
+      });
+    }
+
+    const flatView =
+      dependencyOptimisticFlatEntityMaps.flatViewMaps.byId[
+        flatViewGroupToValidate.viewId
+      ];
+
+    if (!isDefined(flatView)) {
+      validationResult.errors.push({
+        code: ViewExceptionCode.INVALID_VIEW_DATA,
+        message: t`View not found`,
+        userFriendlyMessage: msg`View not found`,
+      });
+
+      return validationResult;
+    }
+
+    return validationResult;
+  }
+}
@@ -11,6 +11,7 @@ import { FlatRouteTriggerValidatorService } from 'src/engine/workspace-manager/w
 import { FlatServerlessFunctionValidatorService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/validators/services/flat-serverless-function-validator.service';
 import { FlatViewFieldValidatorService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/validators/services/flat-view-field-validator.service';
 import { FlatViewFilterValidatorService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/validators/services/flat-view-filter-validator.service';
+import { FlatViewGroupValidatorService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/validators/services/flat-view-group-validator.service';
 import { FlatViewValidatorService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/validators/services/flat-view-validator.service';

@Module({
@@ -19,6 +20,7 @@ import { FlatViewValidatorService } from 'src/engine/workspace-manager/workspace
    FlatViewValidatorService,
    FlatViewFieldValidatorService,
    FlatViewFilterValidatorService,
+    FlatViewGroupValidatorService,
    FlatIndexValidatorService,
    FlatFieldMetadataValidatorService,
    FlatObjectMetadataValidatorService,
@@ -32,6 +34,7 @@ import { FlatViewValidatorService } from 'src/engine/workspace-manager/workspace
    FlatViewValidatorService,
    FlatViewFieldValidatorService,
    FlatViewFilterValidatorService,
+    FlatViewGroupValidatorService,
    FlatIndexValidatorService,
    FlatFieldMetadataValidatorService,
    FlatObjectMetadataValidatorService,
@@ -11,6 +11,7 @@ import { WorkspaceMigrationV2RouteTriggerActionsBuilderService } from 'src/engin
 import { WorkspaceMigrationV2ServerlessFunctionActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/serverless-function/workspace-migration-v2-serverless-function-actions-builder.service';
 import { WorkspaceMigrationV2ViewFieldActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-field/workspace-migration-v2-view-field-actions-builder.service';
 import { WorkspaceMigrationV2ViewFilterActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-filter/workspace-migration-v2-view-filter-actions-builder.service';
+import { WorkspaceMigrationV2ViewGroupActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-group/workspace-migration-v2-view-group-actions-builder.service';
 import { WorkspaceMigrationV2ViewActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view/workspace-migration-v2-view-actions-builder.service';
 import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/validators/workspace-migration-builder-validators.module';

@@ -22,6 +23,7 @@ import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-
    WorkspaceMigrationV2ViewActionsBuilderService,
    WorkspaceMigrationV2ViewFieldActionsBuilderService,
    WorkspaceMigrationV2ViewFilterActionsBuilderService,
+    WorkspaceMigrationV2ViewGroupActionsBuilderService,
    WorkspaceMigrationV2IndexActionsBuilderService,
    WorkspaceMigrationV2ServerlessFunctionActionsBuilderService,
    WorkspaceMigrationV2DatabaseEventTriggerActionsBuilderService,
@@ -35,6 +37,7 @@ import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-
    WorkspaceMigrationV2ObjectActionsBuilderService,
    WorkspaceMigrationV2ViewFieldActionsBuilderService,
    WorkspaceMigrationV2ViewFilterActionsBuilderService,
+    WorkspaceMigrationV2ViewGroupActionsBuilderService,
    WorkspaceMigrationV2FieldActionsBuilderService,
    WorkspaceMigrationV2ServerlessFunctionActionsBuilderService,
    WorkspaceMigrationV2DatabaseEventTriggerActionsBuilderService,
@@ -0,0 +1,55 @@
+import { Injectable } from '@nestjs/common';
+
+import {
+  OptimisticallyApplyActionOnAllFlatEntityMapsArgs,
+  WorkspaceMigrationRunnerActionHandler,
+} from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';
+import { addFlatEntityToFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/add-flat-entity-to-flat-entity-maps-or-throw.util';
+import { ViewGroupEntity } from 'src/engine/metadata-modules/view-group/entities/view-group.entity';
+import { CreateViewGroupAction } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-group/types/workspace-migration-view-group-action-v2.type';
+import { WorkspaceMigrationActionRunnerArgs } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/types/workspace-migration-action-runner-args.type';
+
+@Injectable()
+export class CreateViewGroupActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+  'create_view_group',
+) {
+  optimisticallyApplyActionOnAllFlatEntityMaps({
+    action,
+    allFlatEntityMaps,
+  }: OptimisticallyApplyActionOnAllFlatEntityMapsArgs<CreateViewGroupAction>): Partial<AllFlatEntityMaps> {
+    const { flatViewGroupMaps } = allFlatEntityMaps;
+    const { viewGroup } = action;
+
+    const updatedFlatViewGroupMaps = addFlatEntityToFlatEntityMapsOrThrow({
+      flatEntity: viewGroup,
+      flatEntityMaps: flatViewGroupMaps,
+    });
+
+    return {
+      flatViewGroupMaps: updatedFlatViewGroupMaps,
+    };
+  }
+
+  async executeForMetadata(
+    context: WorkspaceMigrationActionRunnerArgs<CreateViewGroupAction>,
+  ): Promise<void> {
+    const { action, queryRunner, workspaceId } = context;
+    const { viewGroup } = action;
+
+    const viewGroupRepository =
+      queryRunner.manager.getRepository<ViewGroupEntity>(ViewGroupEntity);
+
+    await viewGroupRepository.insert({
+      ...viewGroup,
+      workspaceId,
+    });
+  }
+
+  async executeForWorkspaceSchema(
+    _context: WorkspaceMigrationActionRunnerArgs<CreateViewGroupAction>,
+  ): Promise<void> {
+    return;
+  }
+}
@@ -0,0 +1,55 @@
+import { Injectable } from '@nestjs/common';
+
+import {
+  OptimisticallyApplyActionOnAllFlatEntityMapsArgs,
+  WorkspaceMigrationRunnerActionHandler,
+} from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';
+import { deleteFlatEntityFromFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/delete-flat-entity-from-flat-entity-maps-or-throw.util';
+import { ViewGroupEntity } from 'src/engine/metadata-modules/view-group/entities/view-group.entity';
+import { DeleteViewGroupAction } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-group/types/workspace-migration-view-group-action-v2.type';
+import { WorkspaceMigrationActionRunnerArgs } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/types/workspace-migration-action-runner-args.type';
+
+@Injectable()
+export class DeleteViewGroupActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+  'delete_view_group',
+) {
+  optimisticallyApplyActionOnAllFlatEntityMaps({
+    action,
+    allFlatEntityMaps,
+  }: OptimisticallyApplyActionOnAllFlatEntityMapsArgs<DeleteViewGroupAction>): Partial<AllFlatEntityMaps> {
+    const { flatViewGroupMaps } = allFlatEntityMaps;
+    const { viewGroupId } = action;
+
+    const updatedFlatViewGroupMaps = deleteFlatEntityFromFlatEntityMapsOrThrow({
+      entityToDeleteId: viewGroupId,
+      flatEntityMaps: flatViewGroupMaps,
+    });
+
+    return {
+      flatViewGroupMaps: updatedFlatViewGroupMaps,
+    };
+  }
+
+  async executeForMetadata(
+    context: WorkspaceMigrationActionRunnerArgs<DeleteViewGroupAction>,
+  ): Promise<void> {
+    const { action, queryRunner, workspaceId } = context;
+    const { viewGroupId } = action;
+
+    const viewGroupRepository =
+      queryRunner.manager.getRepository<ViewGroupEntity>(ViewGroupEntity);
+
+    await viewGroupRepository.delete({
+      id: viewGroupId,
+      workspaceId,
+    });
+  }
+
+  async executeForWorkspaceSchema(
+    _context: WorkspaceMigrationActionRunnerArgs<DeleteViewGroupAction>,
+  ): Promise<void> {
+    return;
+  }
+}
@@ -0,0 +1,66 @@
+import { Injectable } from '@nestjs/common';
+
+import {
+  OptimisticallyApplyActionOnAllFlatEntityMapsArgs,
+  WorkspaceMigrationRunnerActionHandler,
+} from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';
+import { findFlatEntityByIdInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps-or-throw.util';
+import { replaceFlatEntityInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/replace-flat-entity-in-flat-entity-maps-or-throw.util';
+import { ViewGroupEntity } from 'src/engine/metadata-modules/view-group/entities/view-group.entity';
+import { UpdateViewGroupAction } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-builder-v2/builders/view-group/types/workspace-migration-view-group-action-v2.type';
+import { WorkspaceMigrationActionRunnerArgs } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/types/workspace-migration-action-runner-args.type';
+import { fromFlatEntityPropertiesUpdatesToPartialFlatEntity } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/utils/from-flat-entity-properties-updates-to-partial-flat-entity';
+
+@Injectable()
+export class UpdateViewGroupActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+  'update_view_group',
+) {
+  optimisticallyApplyActionOnAllFlatEntityMaps({
+    action,
+    allFlatEntityMaps,
+  }: OptimisticallyApplyActionOnAllFlatEntityMapsArgs<UpdateViewGroupAction>): Partial<AllFlatEntityMaps> {
+    const { flatViewGroupMaps } = allFlatEntityMaps;
+    const { viewGroupId } = action;
+
+    const existingViewGroup = findFlatEntityByIdInFlatEntityMapsOrThrow({
+      flatEntityId: viewGroupId,
+      flatEntityMaps: flatViewGroupMaps,
+    });
+
+    const updatedViewGroup = {
+      ...existingViewGroup,
+      ...fromFlatEntityPropertiesUpdatesToPartialFlatEntity(action),
+    };
+
+    const updatedFlatViewGroupMaps = replaceFlatEntityInFlatEntityMapsOrThrow({
+      flatEntity: updatedViewGroup,
+      flatEntityMaps: flatViewGroupMaps,
+    });
+
+    return {
+      flatViewGroupMaps: updatedFlatViewGroupMaps,
+    };
+  }
+
+  async executeForMetadata(
+    context: WorkspaceMigrationActionRunnerArgs<UpdateViewGroupAction>,
+  ): Promise<void> {
+    const { action, queryRunner } = context;
+    const { viewGroupId } = action;
+
+    const viewGroupRepository =
+      queryRunner.manager.getRepository<ViewGroupEntity>(ViewGroupEntity);
+
+    const update = fromFlatEntityPropertiesUpdatesToPartialFlatEntity(action);
+
+    await viewGroupRepository.update(viewGroupId, update);
+  }
+
+  async executeForWorkspaceSchema(
+    _context: WorkspaceMigrationActionRunnerArgs<UpdateViewGroupAction>,
+  ): Promise<void> {
+    return;
+  }
+}
@@ -27,6 +27,9 @@ import { UpdateViewFieldActionHandlerService } from 'src/engine/workspace-manage
 import { CreateViewFilterActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view-filter/services/create-view-filter-action-handler.service';
 import { DeleteViewFilterActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view-filter/services/delete-view-filter-action-handler.service';
 import { UpdateViewFilterActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view-filter/services/update-view-filter-action-handler.service';
+import { CreateViewGroupActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view-group/services/create-view-group-action-handler.service';
+import { DeleteViewGroupActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view-group/services/delete-view-group-action-handler.service';
+import { UpdateViewGroupActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view-group/services/update-view-group-action-handler.service';
 import { CreateViewActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view/services/create-view-action-handler.service';
 import { DeleteViewActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view/services/delete-view-action-handler.service';
 import { UpdateViewActionHandlerService } from 'src/engine/workspace-manager/workspace-migration-v2/workspace-migration-runner-v2/action-handlers/view/services/update-view-action-handler.service';
@@ -57,6 +60,10 @@ import { UpdateViewActionHandlerService } from 'src/engine/workspace-manager/wor
    UpdateViewFilterActionHandlerService,
    DeleteViewFilterActionHandlerService,

+    CreateViewGroupActionHandlerService,
+    UpdateViewGroupActionHandlerService,
+    DeleteViewGroupActionHandlerService,
+
    CreateServerlessFunctionActionHandlerService,
    DeleteServerlessFunctionActionHandlerService,
    UpdateServerlessFunctionActionHandlerService,