Factorize from entity to flat entity utils (#21972)

## What

Factorizes the two responsibilities that were copy‑pasted across every
`from-<entity>-entity-to-flat-<entity>` util into two reusable tools.

### `fromEntityToScalarEntity`
Projects a TypeORM entity into its scalar flat shape using an
**allow‑list** driven by
`ALL_ENTITY_PROPERTIES_CONFIGURATION_BY_METADATA_NAME` (plus the base
columns `id`/`workspaceId`/`applicationId`/`universalIdentifier`). Only
registered scalar columns are forwarded, `Date`s are serialized to ISO
strings, and absent values are normalized to `null`. Replaces the
previous deny‑list (`removePropertiesFromRecord`) approach, so
unregistered/deprecated columns can no longer silently leak into the
flat entity.

### `resolveManyToOneRelationIdsToUniversalIdentifiers`
Resolves an entity's many‑to‑one foreign keys to their universal
identifiers, driven by `ALL_MANY_TO_ONE_METADATA_RELATIONS`. Handles the
always‑present `application`, nullable relations, and throws a
`FlatEntityMapsException` when a referenced id is missing from its
identifier map. Mirrors `resolveUniversalRelationIdentifiersToIds` in
the opposite direction.

Each `from-<entity>` util now reduces to: scalar spread + relation
spread (+ explicit one‑to‑many id/universalIdentifier arrays where
applicable).

### Note
The allow‑list drops `isUIReadOnly` (a `WasRemovedInUpgrade` column not
in the config) from `fieldMetadata`, which is the only
integration‑snapshot change.

<!-- This is an auto-generated description by cubic. -->
<a
href="https://cubic.dev/pr/twentyhq/twenty/pull/21972?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="Review in cubic"
src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>
<!-- End of auto-generated description by cubic. -->

packages/twenty-server/src/engine/metadata-modules/flat-view/utils/from-view-entity-to-flat-view.util.ts

@@ -1,93 +1,26 @@
-import { isDefined, removePropertiesFromRecord } from 'twenty-shared/utils';
+import { isDefined } from 'twenty-shared/utils';
 
-import {
-  FlatEntityMapsException,
-  FlatEntityMapsExceptionCode,
-} from 'src/engine/metadata-modules/flat-entity/exceptions/flat-entity-maps.exception';
-import { getMetadataEntityRelationProperties } from 'src/engine/metadata-modules/flat-entity/utils/get-metadata-entity-relation-properties.util';
+import { fromEntityToScalarEntity } from 'src/engine/metadata-modules/flat-entity/utils/from-entity-to-scalar-entity.util';
 import { type FlatView } from 'src/engine/metadata-modules/flat-view/types/flat-view.type';
 import { fromViewOverridesToUniversalOverrides } from 'src/engine/metadata-modules/flat-view/utils/from-view-overrides-to-universal-overrides.util';
 import { type FromEntityToFlatEntityArgs } from 'src/engine/workspace-cache/types/from-entity-to-flat-entity-args.type';
+import { resolveManyToOneRelationIdsToUniversalIdentifiers } from 'src/engine/workspace-manager/workspace-migration/universal-flat-entity/utils/resolve-many-to-one-relation-ids-to-universal-identifiers.util';
 
-export const fromViewEntityToFlatView = ({
-  entity: viewEntity,
-  applicationIdToUniversalIdentifierMap,
-  objectMetadataIdToUniversalIdentifierMap,
-  fieldMetadataIdToUniversalIdentifierMap,
-}: FromEntityToFlatEntityArgs<'view'>): FlatView => {
-  const viewEntityWithoutRelations = removePropertiesFromRecord(
-    viewEntity,
-    getMetadataEntityRelationProperties('view'),
-  );
+export const fromViewEntityToFlatView = (
+  args: FromEntityToFlatEntityArgs<'view'>,
+): FlatView => {
+  const { entity: viewEntity, fieldMetadataIdToUniversalIdentifierMap } = args;
 
-  const applicationUniversalIdentifier =
-    applicationIdToUniversalIdentifierMap.get(viewEntity.applicationId);
+  const viewScalarEntity = fromEntityToScalarEntity({
+    metadataName: 'view',
+    entity: viewEntity,
+  });
 
-  if (!isDefined(applicationUniversalIdentifier)) {
-    throw new FlatEntityMapsException(
-      `Application with id ${viewEntity.applicationId} not found for view ${viewEntity.id}`,
-      FlatEntityMapsExceptionCode.ENTITY_NOT_FOUND,
-    );
-  }
-
-  const objectMetadataUniversalIdentifier =
-    objectMetadataIdToUniversalIdentifierMap.get(viewEntity.objectMetadataId);
-
-  if (!isDefined(objectMetadataUniversalIdentifier)) {
-    throw new FlatEntityMapsException(
-      `ObjectMetadata with id ${viewEntity.objectMetadataId} not found for view ${viewEntity.id}`,
-      FlatEntityMapsExceptionCode.ENTITY_NOT_FOUND,
-    );
-  }
-
-  let kanbanAggregateOperationFieldMetadataUniversalIdentifier: string | null =
-    null;
-
-  if (isDefined(viewEntity.kanbanAggregateOperationFieldMetadataId)) {
-    kanbanAggregateOperationFieldMetadataUniversalIdentifier =
-      fieldMetadataIdToUniversalIdentifierMap.get(
-        viewEntity.kanbanAggregateOperationFieldMetadataId,
-      ) ?? null;
-
-    if (!isDefined(kanbanAggregateOperationFieldMetadataUniversalIdentifier)) {
-      throw new FlatEntityMapsException(
-        `FieldMetadata with id ${viewEntity.kanbanAggregateOperationFieldMetadataId} not found for view ${viewEntity.id}`,
-        FlatEntityMapsExceptionCode.ENTITY_NOT_FOUND,
-      );
-    }
-  }
-
-  let calendarFieldMetadataUniversalIdentifier: string | null = null;
-
-  if (isDefined(viewEntity.calendarFieldMetadataId)) {
-    calendarFieldMetadataUniversalIdentifier =
-      fieldMetadataIdToUniversalIdentifierMap.get(
-        viewEntity.calendarFieldMetadataId,
-      ) ?? null;
-
-    if (!isDefined(calendarFieldMetadataUniversalIdentifier)) {
-      throw new FlatEntityMapsException(
-        `FieldMetadata with id ${viewEntity.calendarFieldMetadataId} not found for view ${viewEntity.id}`,
-        FlatEntityMapsExceptionCode.ENTITY_NOT_FOUND,
-      );
-    }
-  }
-
-  let mainGroupByFieldMetadataUniversalIdentifier: string | null = null;
-
-  if (isDefined(viewEntity.mainGroupByFieldMetadataId)) {
-    mainGroupByFieldMetadataUniversalIdentifier =
-      fieldMetadataIdToUniversalIdentifierMap.get(
-        viewEntity.mainGroupByFieldMetadataId,
-      ) ?? null;
-
-    if (!isDefined(mainGroupByFieldMetadataUniversalIdentifier)) {
-      throw new FlatEntityMapsException(
-        `FieldMetadata with id ${viewEntity.mainGroupByFieldMetadataId} not found for view ${viewEntity.id}`,
-        FlatEntityMapsExceptionCode.ENTITY_NOT_FOUND,
-      );
-    }
-  }
+  const relationUniversalIdentifiers =
+    resolveManyToOneRelationIdsToUniversalIdentifiers({
+      metadataName: 'view',
+      ...args,
+    });
 
   const universalOverrides = isDefined(viewEntity.overrides)
     ? fromViewOverridesToUniversalOverrides({
@@ -100,22 +33,14 @@ export const fromViewEntityToFlatView = ({
     : null;
 
   return {
-    ...viewEntityWithoutRelations,
-    createdAt: viewEntity.createdAt.toISOString(),
-    updatedAt: viewEntity.updatedAt.toISOString(),
-    deletedAt: viewEntity.deletedAt?.toISOString() ?? null,
-    universalIdentifier: viewEntityWithoutRelations.universalIdentifier,
+    ...viewScalarEntity,
+    ...relationUniversalIdentifiers,
     universalOverrides,
     viewFieldIds: viewEntity.viewFields.map(({ id }) => id),
     viewFieldGroupIds: viewEntity.viewFieldGroups?.map(({ id }) => id) ?? [],
     viewFilterIds: viewEntity.viewFilters.map(({ id }) => id),
     viewGroupIds: viewEntity.viewGroups.map(({ id }) => id),
     viewFilterGroupIds: viewEntity.viewFilterGroups?.map(({ id }) => id) ?? [],
-    applicationUniversalIdentifier,
-    objectMetadataUniversalIdentifier,
-    kanbanAggregateOperationFieldMetadataUniversalIdentifier,
-    calendarFieldMetadataUniversalIdentifier,
-    mainGroupByFieldMetadataUniversalIdentifier,
     viewFieldUniversalIdentifiers: viewEntity.viewFields.map(
       ({ universalIdentifier }) => universalIdentifier,
     ),