Add versioned project settings modal

src/db/migrations/0016_dashing_darkstar.sql

@@ -0,0 +1,4 @@
+ALTER TABLE `projects` ADD `internal_project_number` text;--> statement-breakpoint
+ALTER TABLE `projects` ADD `external_project_number` text;--> statement-breakpoint
+ALTER TABLE `projects` ADD `building_owner` text;--> statement-breakpoint
+ALTER TABLE `projects` ADD `description` text;

src/db/migrations/meta/_journal.json

@@ -113,6 +113,13 @@
       "when": 1785014383032,
       "tag": "0015_modern_madame_masque",
       "breakpoints": true
+    },
+    {
+      "idx": 16,
+      "version": "6",
+      "when": 1785254079435,
+      "tag": "0016_dashing_darkstar",
+      "breakpoints": true
     }
   ]
 }

src/db/repositories/project-settings-project-command.repository.ts

@@ -2,6 +2,8 @@ import { eq } from "drizzle-orm";
 import {
   assertProjectSettingsUpdateProjectCommand,
   createProjectSettingsUpdateProjectCommand,
+  legacyProjectSettingsUpdateCommandSchemaVersion,
+  type ProjectSettingsValues,
 } from "../../domain/models/project-settings-project-command.model.js";
 import type {
   ExecuteProjectSettingsUpdateCommandInput,
@@ -37,22 +39,45 @@ export class ProjectSettingsProjectCommandRepository
     if (!current) {
       throw new Error("Project not found.");
     }
-    if (
-      current.singlePhaseVoltageV ===
-        input.command.payload.singlePhaseVoltageV &&
-      current.threePhaseVoltageV ===
-        input.command.payload.threePhaseVoltageV
-    ) {
+    const target: ProjectSettingsValues =
+      input.command.schemaVersion ===
+      legacyProjectSettingsUpdateCommandSchemaVersion
+        ? {
+            name: current.name,
+            internalProjectNumber: current.internalProjectNumber,
+            externalProjectNumber: current.externalProjectNumber,
+            buildingOwner: current.buildingOwner,
+            description: current.description,
+            ...input.command.payload,
+          }
+        : input.command.payload;
+    if (projectSettingsEqual(current, target)) {
       throw new Error("Project settings did not change.");
     }
 
-    const inverse = createProjectSettingsUpdateProjectCommand({
-      singlePhaseVoltageV: current.singlePhaseVoltageV,
-      threePhaseVoltageV: current.threePhaseVoltageV,
-    });
+    const inverse =
+      input.command.schemaVersion ===
+      legacyProjectSettingsUpdateCommandSchemaVersion
+        ? {
+            schemaVersion: legacyProjectSettingsUpdateCommandSchemaVersion,
+            type: input.command.type,
+            payload: {
+              singlePhaseVoltageV: current.singlePhaseVoltageV,
+              threePhaseVoltageV: current.threePhaseVoltageV,
+            },
+          }
+        : createProjectSettingsUpdateProjectCommand({
+            name: current.name,
+            internalProjectNumber: current.internalProjectNumber,
+            externalProjectNumber: current.externalProjectNumber,
+            buildingOwner: current.buildingOwner,
+            description: current.description,
+            singlePhaseVoltageV: current.singlePhaseVoltageV,
+            threePhaseVoltageV: current.threePhaseVoltageV,
+          });
     const updated = tx
       .update(projects)
-      .set(input.command.payload)
+      .set(target)
       .where(eq(projects.id, input.projectId))
       .run();
     if (updated.changes !== 1) {
@@ -62,3 +87,18 @@ export class ProjectSettingsProjectCommandRepository
     return inverse;
   }
 }
+
+function projectSettingsEqual(
+  current: ProjectSettingsValues,
+  target: ProjectSettingsValues
+) {
+  return (
+    current.name === target.name &&
+    current.internalProjectNumber === target.internalProjectNumber &&
+    current.externalProjectNumber === target.externalProjectNumber &&
+    current.buildingOwner === target.buildingOwner &&
+    current.description === target.description &&
+    current.singlePhaseVoltageV === target.singlePhaseVoltageV &&
+    current.threePhaseVoltageV === target.threePhaseVoltageV
+  );
+}

src/db/repositories/project-snapshot.repository.ts

@@ -5,6 +5,7 @@ import { ProjectSnapshotNameConflictError } from "../../domain/errors/project-sn
 import { createProjectStateRestoreCommand } from "../../domain/models/project-state-restore-command.model.js";
 import {
   deserializeProjectStateSnapshot,
+  legacyProjectStateSnapshotSchemaVersion,
   projectStateSnapshotSchemaVersion,
 } from "../../domain/models/project-state-snapshot.model.js";
 import type {
@@ -138,7 +139,10 @@ export class ProjectSnapshotRepository implements ProjectSnapshotStore {
     if (actualChecksum !== stored.payloadSha256) {
       throw new Error("Project snapshot checksum verification failed.");
     }
-    if (stored.schemaVersion !== projectStateSnapshotSchemaVersion) {
+    if (
+      stored.schemaVersion !== legacyProjectStateSnapshotSchemaVersion &&
+      stored.schemaVersion !== projectStateSnapshotSchemaVersion
+    ) {
       throw new Error("Project snapshot schema version is not supported.");
     }
     const targetState = deserializeProjectStateSnapshot(stored.payloadJson);

src/db/repositories/project-state-restore-command.repository.ts

@@ -5,6 +5,7 @@ import {
   createProjectStateRestoreCommand,
 } from "../../domain/models/project-state-restore-command.model.js";
 import {
+  parseProjectStateSnapshot,
   serializeProjectStateSnapshot,
   type ProjectStateSnapshot,
 } from "../../domain/models/project-state-snapshot.model.js";
@@ -38,7 +39,10 @@ export class ProjectStateRestoreCommandRepository
 
   execute(input: ExecuteProjectStateRestoreCommandInput) {
     assertProjectStateRestoreCommand(input.command);
-    if (input.command.payload.targetState.project.id !== input.projectId) {
+    const targetState = parseProjectStateSnapshot(
+      input.command.payload.targetState
+    );
+    if (targetState.project.id !== input.projectId) {
       throw new Error("Restore state belongs to a different project.");
     }
 
@@ -68,15 +72,16 @@ export class ProjectStateRestoreCommandRepository
       );
     }
 
-    const targetPayloadJson = serializeProjectStateSnapshot(
+    const targetState = parseProjectStateSnapshot(
       input.command.payload.targetState
     );
+    const targetPayloadJson = serializeProjectStateSnapshot(targetState);
     const inverse = createProjectStateRestoreCommand(
       hashProjectStatePayload(targetPayloadJson),
       current.state
     );
 
-    replaceProjectState(tx, input.command.payload.targetState);
+    replaceProjectState(tx, targetState);
 
     return inverse;
   }
@@ -111,6 +116,10 @@ function replaceProjectState(
     .update(projects)
     .set({
       name: state.project.name,
+      internalProjectNumber: state.project.internalProjectNumber,
+      externalProjectNumber: state.project.externalProjectNumber,
+      buildingOwner: state.project.buildingOwner,
+      description: state.project.description,
       singlePhaseVoltageV: state.project.singlePhaseVoltageV,
       threePhaseVoltageV: state.project.threePhaseVoltageV,
     })

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

@@ -32,6 +32,10 @@ export function readProjectStateSnapshot(
     .select({
       id: projects.id,
       name: projects.name,
+      internalProjectNumber: projects.internalProjectNumber,
+      externalProjectNumber: projects.externalProjectNumber,
+      buildingOwner: projects.buildingOwner,
+      description: projects.description,
       singlePhaseVoltageV: projects.singlePhaseVoltageV,
       threePhaseVoltageV: projects.threePhaseVoltageV,
       currentRevision: projects.currentRevision,
@@ -172,6 +176,10 @@ export function readProjectStateSnapshot(
     project: {
       id: project.id,
       name: project.name,
+      internalProjectNumber: project.internalProjectNumber,
+      externalProjectNumber: project.externalProjectNumber,
+      buildingOwner: project.buildingOwner,
+      description: project.description,
       singlePhaseVoltageV: project.singlePhaseVoltageV,
       threePhaseVoltageV: project.threePhaseVoltageV,
     },

src/db/repositories/project.repository.ts

@@ -20,6 +20,10 @@ export class ProjectRepository {
     const project = {
       id,
       name: input.name,
+      internalProjectNumber: input.internalProjectNumber ?? null,
+      externalProjectNumber: input.externalProjectNumber ?? null,
+      buildingOwner: input.buildingOwner ?? null,
+      description: input.description ?? null,
       singlePhaseVoltageV: input.singlePhaseVoltageV ?? 230,
       threePhaseVoltageV: input.threePhaseVoltageV ?? 400,
       currentRevision: 0,

src/db/schema/projects.ts

@@ -3,6 +3,10 @@ import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
 export const projects = sqliteTable("projects", {
   id: text("id").primaryKey(),
   name: text("name").notNull(),
+  internalProjectNumber: text("internal_project_number"),
+  externalProjectNumber: text("external_project_number"),
+  buildingOwner: text("building_owner"),
+  description: text("description"),
   singlePhaseVoltageV: integer("single_phase_voltage_v").notNull().default(230),
   threePhaseVoltageV: integer("three_phase_voltage_v").notNull().default(400),
   currentRevision: integer("current_revision").notNull().default(0),