Add external row quantity foundation

src/db/migrations/0005_stale_gorilla_man.sql

@@ -0,0 +1,3 @@
+ALTER TABLE `circuit_device_rows` ADD `manual_quantity` integer DEFAULT 0 NOT NULL;
+--> statement-breakpoint
+UPDATE `circuit_device_rows` SET `manual_quantity` = `quantity`;

src/db/migrations/meta/_journal.json

@@ -36,6 +36,13 @@
       "when": 1785684457208,
       "tag": "0004_illegal_the_stranger",
       "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "6",
+      "when": 1785687503453,
+      "tag": "0005_stale_gorilla_man",
+      "breakpoints": true
     }
   ]
 }

src/db/repositories/circuit-device-row-project-command.repository.ts

@@ -82,6 +82,14 @@ export class CircuitDeviceRowProjectCommandRepository
         change.value,
       ])
     ) as CircuitDeviceRowPatchInput;
+    const targetQuantity = patch.quantity ?? current.quantity;
+    const targetManualQuantity =
+      patch.manualQuantity ?? current.manualQuantity;
+    if (targetManualQuantity > targetQuantity) {
+      throw new Error(
+        "Device-row manual quantity must not exceed total quantity."
+      );
+    }
     if (
       input.source === "user" &&
       patch.phaseType !== undefined &&

src/db/repositories/circuit-device-row-structure-project-command.repository.ts

@@ -20,6 +20,7 @@ import { circuitLists } from "../schema/circuit-lists.js";
 import { circuits } from "../schema/circuits.js";
 import {
   assertCircuitDeviceRowReferencesInProject,
+  toCircuitDeviceRowInsertValues,
   toCircuitDeviceRowSnapshot,
 } from "./circuit-device-row-structure.persistence.js";
 import { executeProjectCommandTransaction } from "./project-command-transaction.persistence.js";
@@ -92,7 +93,10 @@ export class CircuitDeviceRowStructureProjectCommandRepository
       throw new Error("Circuit device-row id already exists.");
     }
 
-    database.insert(circuitDeviceRows).values(row).run();
+    database
+      .insert(circuitDeviceRows)
+      .values(toCircuitDeviceRowInsertValues(row))
+      .run();
     const circuitUpdate = database
       .update(circuits)
       .set({ isReserve: 0 })

src/db/repositories/circuit-device-row-structure.persistence.ts

@@ -61,6 +61,7 @@ export function toCircuitDeviceRowSnapshot(
     roomNumberSnapshot: row.roomNumberSnapshot,
     roomNameSnapshot: row.roomNameSnapshot,
     quantity: row.quantity,
+    manualQuantity: row.manualQuantity,
     powerPerUnit: row.powerPerUnit,
     simultaneityFactor: row.simultaneityFactor,
     cosPhi: row.cosPhi,
@@ -68,3 +69,10 @@ export function toCircuitDeviceRowSnapshot(
     overriddenFields: row.overriddenFields,
   };
 }
+
+export function toCircuitDeviceRowInsertValues(row: CircuitDeviceRowSnapshot) {
+  return {
+    ...row,
+    manualQuantity: row.manualQuantity ?? row.quantity,
+  };
+}

src/db/repositories/circuit-device-row.persistence.ts

@@ -13,6 +13,7 @@ export interface CircuitDeviceRowUpdateInput {
   roomNumberSnapshot?: string;
   roomNameSnapshot?: string;
   quantity: number;
+  manualQuantity?: number;
   powerPerUnit: number;
   simultaneityFactor: number;
   cosPhi?: number;
@@ -34,6 +35,7 @@ export interface CircuitDeviceRowPatchInput {
   roomNumberSnapshot?: string | null;
   roomNameSnapshot?: string | null;
   quantity?: number;
+  manualQuantity?: number;
   powerPerUnit?: number;
   simultaneityFactor?: number;
   cosPhi?: number | null;
@@ -61,6 +63,7 @@ export function toCircuitDeviceRowUpdateValues(input: CircuitDeviceRowUpdateInpu
     roomNumberSnapshot: input.roomNumberSnapshot ?? null,
     roomNameSnapshot: input.roomNameSnapshot ?? null,
     quantity: input.quantity,
+    manualQuantity: input.manualQuantity ?? input.quantity,
     powerPerUnit: input.powerPerUnit,
     simultaneityFactor: input.simultaneityFactor,
     cosPhi: input.cosPhi ?? null,
@@ -90,6 +93,7 @@ export function toCircuitDeviceRowPatchValues(input: CircuitDeviceRowPatchInput)
   }
   if (has("roomNameSnapshot")) values.roomNameSnapshot = input.roomNameSnapshot ?? null;
   if (input.quantity !== undefined) values.quantity = input.quantity;
+  if (input.manualQuantity !== undefined) values.manualQuantity = input.manualQuantity;
   if (input.powerPerUnit !== undefined) values.powerPerUnit = input.powerPerUnit;
   if (input.simultaneityFactor !== undefined) {
     values.simultaneityFactor = input.simultaneityFactor;

src/db/repositories/circuit-device-row.repository.ts

@@ -37,6 +37,7 @@ export class CircuitDeviceRowRepository {
         roomNumberSnapshot: circuitDeviceRows.roomNumberSnapshot,
         roomNameSnapshot: circuitDeviceRows.roomNameSnapshot,
         quantity: circuitDeviceRows.quantity,
+        manualQuantity: circuitDeviceRows.manualQuantity,
         powerPerUnit: circuitDeviceRows.powerPerUnit,
         simultaneityFactor: circuitDeviceRows.simultaneityFactor,
         cosPhi: circuitDeviceRows.cosPhi,

src/db/repositories/circuit-group-subtree-project-command.repository.ts

@@ -24,6 +24,7 @@ import { circuitSections } from "../schema/circuit-sections.js";
 import { circuits } from "../schema/circuits.js";
 import { distributionBoardComponentProtectionDevices } from "../schema/distribution-board-component-protection-devices.js";
 import { distributionBoardComponents } from "../schema/distribution-board-components.js";
+import { toCircuitDeviceRowInsertValues } from "./circuit-device-row-structure.persistence.js";
 import { executeProjectCommandTransaction } from "./project-command-transaction.persistence.js";
 
 export class CircuitGroupSubtreeProjectCommandRepository
@@ -212,7 +213,10 @@ export class CircuitGroupSubtreeProjectCommandRepository
           .run();
       }
       if (deviceRows.length > 0) {
-        database.insert(circuitDeviceRows).values(deviceRows).run();
+        database
+          .insert(circuitDeviceRows)
+          .values(deviceRows.map(toCircuitDeviceRowInsertValues))
+          .run();
       }
     }
   }

src/db/repositories/circuit-structure-project-command.repository.ts

@@ -22,6 +22,7 @@ import { circuitSections } from "../schema/circuit-sections.js";
 import { circuits } from "../schema/circuits.js";
 import {
   assertCircuitDeviceRowReferencesInProject,
+  toCircuitDeviceRowInsertValues,
   toCircuitDeviceRowSnapshot,
 } from "./circuit-device-row-structure.persistence.js";
 import { executeProjectCommandTransaction } from "./project-command-transaction.persistence.js";
@@ -166,7 +167,10 @@ export class CircuitStructureProjectCommandRepository
       })
       .run();
     if (snapshot.deviceRows.length > 0) {
-      database.insert(circuitDeviceRows).values(snapshot.deviceRows).run();
+      database
+        .insert(circuitDeviceRows)
+        .values(snapshot.deviceRows.map(toCircuitDeviceRowInsertValues))
+        .run();
     }
     if (snapshot.protectionDevice) {
       database

src/db/repositories/distribution-board-subtree-project-command.repository.ts

@@ -29,6 +29,7 @@ import { floors } from "../schema/floors.js";
 import { projectDevices } from "../schema/project-devices.js";
 import { projects } from "../schema/projects.js";
 import { rooms } from "../schema/rooms.js";
+import { toCircuitDeviceRowInsertValues } from "./circuit-device-row-structure.persistence.js";
 import { executeProjectCommandTransaction } from "./project-command-transaction.persistence.js";
 
 export class DistributionBoardSubtreeProjectCommandRepository
@@ -253,7 +254,10 @@ export class DistributionBoardSubtreeProjectCommandRepository
           .run();
       }
       if (deviceRows.length > 0) {
-        database.insert(circuitDeviceRows).values(deviceRows).run();
+        database
+          .insert(circuitDeviceRows)
+          .values(deviceRows.map(toCircuitDeviceRowInsertValues))
+          .run();
       }
     }
   }

src/db/repositories/project-state-snapshot.persistence.ts

@@ -192,6 +192,7 @@ export function readProjectStateSnapshot(
       roomNumberSnapshot: circuitDeviceRows.roomNumberSnapshot,
       roomNameSnapshot: circuitDeviceRows.roomNameSnapshot,
       quantity: circuitDeviceRows.quantity,
+      manualQuantity: circuitDeviceRows.manualQuantity,
       powerPerUnit: circuitDeviceRows.powerPerUnit,
       simultaneityFactor: circuitDeviceRows.simultaneityFactor,
       cosPhi: circuitDeviceRows.cosPhi,

src/db/schema/circuit-device-rows.ts

@@ -25,6 +25,7 @@ export const circuitDeviceRows = sqliteTable("circuit_device_rows", {
   roomNumberSnapshot: text("room_number_snapshot"),
   roomNameSnapshot: text("room_name_snapshot"),
   quantity: integer("quantity").notNull(),
+  manualQuantity: integer("manual_quantity").notNull().default(0),
   powerPerUnit: real("power_per_unit").notNull(),
   simultaneityFactor: real("simultaneity_factor").notNull(),
   cosPhi: real("cos_phi"),