Add external row quantity foundation

src/domain/models/project-state-snapshot.model.ts

@@ -27,8 +27,9 @@ import {
   type ExternalModelStateSnapshot,
 } from "../../external-model/domain/external-model-contracts.js";
 
-export const projectStateSnapshotSchemaVersion = 4 as const;
-const previousProjectStateSnapshotSchemaVersion = 3 as const;
+export const projectStateSnapshotSchemaVersion = 5 as const;
+const previousProjectStateSnapshotSchemaVersion = 4 as const;
+const externalModelProjectStateSnapshotSchemaVersion = 3 as const;
 const legacyProjectStateSnapshotSchemaVersion = 2 as const;
 const baselineProjectStateSnapshotSchemaVersion = 1 as const;
 
@@ -103,8 +104,15 @@ const circuitSectionSchema = z
     }
   });
 
-const circuitDeviceRowSchema = z
-  .object({
+const circuitDeviceRowSchema = z.preprocess(
+  (value) => {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
+    const row = value as Record<string, unknown>;
+    return Object.prototype.hasOwnProperty.call(row, "manualQuantity")
+      ? row
+      : { ...row, manualQuantity: row.quantity };
+  },
+  z.object({
     id: idSchema,
     circuitId: idSchema,
     linkedProjectDeviceId: idSchema.nullable(),
@@ -120,13 +128,15 @@ const circuitDeviceRowSchema = z
     roomNumberSnapshot: nullableStringSchema,
     roomNameSnapshot: nullableStringSchema,
     quantity: finiteNumberSchema.nonnegative(),
+    manualQuantity: finiteNumberSchema.nonnegative(),
     powerPerUnit: finiteNumberSchema.nonnegative(),
     simultaneityFactor: finiteNumberSchema.nonnegative(),
     cosPhi: finiteNumberSchema.positive().nullable(),
     remark: nullableStringSchema,
     overriddenFields: nullableStringSchema,
   })
-  .strict();
+  .strict()
+);
 
 const circuitSchema = z
   .object({
@@ -453,6 +463,17 @@ const previousProjectStateSnapshotSchema = z
     project: projectSchema,
     distributionBoards: z.array(distributionBoardSchema),
     externalCsvConfiguration: externalCsvConfigurationSnapshotSchema.nullable(),
+    externalModel: externalModelStateSchema,
+    ...projectStateSnapshotContents,
+  })
+  .strict();
+
+const externalModelProjectStateSnapshotSchema = z
+  .object({
+    schemaVersion: z.literal(externalModelProjectStateSnapshotSchemaVersion),
+    project: projectSchema,
+    distributionBoards: z.array(distributionBoardSchema),
+    externalCsvConfiguration: externalCsvConfigurationSnapshotSchema.nullable(),
     ...projectStateSnapshotContents,
   })
   .strict();
@@ -502,6 +523,13 @@ function upgradePreviousProjectStateSnapshot(value: unknown): unknown {
   const schemaVersion = (value as { schemaVersion: number }).schemaVersion;
   if (schemaVersion === previousProjectStateSnapshotSchemaVersion) {
     const previous = previousProjectStateSnapshotSchema.parse(value);
+    return {
+      ...previous,
+      schemaVersion: projectStateSnapshotSchemaVersion,
+    };
+  }
+  if (schemaVersion === externalModelProjectStateSnapshotSchemaVersion) {
+    const previous = externalModelProjectStateSnapshotSchema.parse(value);
     return {
       ...previous,
       schemaVersion: projectStateSnapshotSchemaVersion,
@@ -765,6 +793,11 @@ function assertProjectStateSnapshotRelations(
       if (row.roomId !== null) {
         assertReference(roomIds, row.roomId, "device row room");
       }
+      if (row.manualQuantity > row.quantity) {
+        throw new Error(
+          "Snapshot device row manual quantity must not exceed total quantity."
+        );
+      }
     }
   }