Persist project settings updates

src/app/projects/[projectId]/page.tsx

@@ -245,17 +245,21 @@ export default function ProjectDetailPage() {
   }
 
   async function handleSaveProjectSettings() {
-    if (!projectId) {
+    if (!projectId || !project) {
       return;
     }
     setIsSaving(true);
     setError(null);
     try {
-      const updated = await updateProjectSettings(projectId, {
-        singlePhaseVoltageV: Number(singlePhaseVoltageV),
-        threePhaseVoltageV: Number(threePhaseVoltageV),
-      });
-      setProject(updated);
+      const result = await updateProjectSettings(
+        projectId,
+        project.currentRevision,
+        {
+          singlePhaseVoltageV: Number(singlePhaseVoltageV),
+          threePhaseVoltageV: Number(threePhaseVoltageV),
+        }
+      );
+      setProject(result.project);
     } catch (err) {
       setError(err instanceof Error ? err.message : "Projekteigenschaften konnten nicht gespeichert werden.");
     } finally {
@@ -599,7 +603,14 @@ export default function ProjectDetailPage() {
                     className="btn btn-primary w-100"
                     type="button"
                     onClick={handleSaveProjectSettings}
-                    disabled={isSaving}
+                    disabled={
+                      isSaving ||
+                      !project ||
+                      (Number(singlePhaseVoltageV) ===
+                        project.singlePhaseVoltageV &&
+                        Number(threePhaseVoltageV) ===
+                          project.threePhaseVoltageV)
+                    }
                   >
                     Projekteigenschaften speichern
                   </button>

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

@@ -0,0 +1,71 @@
+import { eq } from "drizzle-orm";
+import {
+  assertProjectSettingsUpdateProjectCommand,
+  createProjectSettingsUpdateProjectCommand,
+} from "../../domain/models/project-settings-project-command.model.js";
+import type {
+  ExecuteProjectSettingsUpdateCommandInput,
+  ProjectSettingsProjectCommandStore,
+} from "../../domain/ports/project-settings-project-command.store.js";
+import type { AppDatabase } from "../database-context.js";
+import { projects } from "../schema/projects.js";
+import { applyProjectHistoryTransition } from "./project-history.persistence.js";
+import { appendProjectRevision } from "./project-revision.persistence.js";
+
+export class ProjectSettingsProjectCommandRepository
+  implements ProjectSettingsProjectCommandStore
+{
+  constructor(private readonly database: AppDatabase) {}
+
+  executeUpdate(input: ExecuteProjectSettingsUpdateCommandInput) {
+    assertProjectSettingsUpdateProjectCommand(input.command);
+    return this.database.transaction((tx) => {
+      const current = tx
+        .select()
+        .from(projects)
+        .where(eq(projects.id, input.projectId))
+        .get();
+      if (!current) {
+        throw new Error("Project not found.");
+      }
+      if (
+        current.singlePhaseVoltageV ===
+          input.command.payload.singlePhaseVoltageV &&
+        current.threePhaseVoltageV ===
+          input.command.payload.threePhaseVoltageV
+      ) {
+        throw new Error("Project settings did not change.");
+      }
+
+      const inverse = createProjectSettingsUpdateProjectCommand({
+        singlePhaseVoltageV: current.singlePhaseVoltageV,
+        threePhaseVoltageV: current.threePhaseVoltageV,
+      });
+      const updated = tx
+        .update(projects)
+        .set(input.command.payload)
+        .where(eq(projects.id, input.projectId))
+        .run();
+      if (updated.changes !== 1) {
+        throw new Error("Project changed before settings update.");
+      }
+
+      const revision = appendProjectRevision(tx, {
+        projectId: input.projectId,
+        expectedRevision: input.expectedRevision,
+        source: input.source,
+        description: input.description,
+        actorId: input.actorId,
+        forward: input.command,
+        inverse,
+      });
+      applyProjectHistoryTransition(tx, {
+        projectId: input.projectId,
+        source: input.source,
+        recordedChangeSetId: revision.changeSetId,
+        targetChangeSetId: input.historyTargetChangeSetId,
+      });
+      return { revision, inverse };
+    });
+  }
+}

src/db/repositories/project.repository.ts

@@ -4,7 +4,6 @@ import { db } from "../client.js";
 import { projects } from "../schema/projects.js";
 import type {
   CreateProjectInput,
-  UpdateProjectSettingsInput,
 } from "../../shared/validation/project-structure.schemas.js";
 
 export class ProjectRepository {
@@ -30,16 +29,6 @@ export class ProjectRepository {
     return row ?? null;
   }
 
-  async updateSettings(projectId: string, input: UpdateProjectSettingsInput) {
-    await db
-      .update(projects)
-      .set({
-        singlePhaseVoltageV: input.singlePhaseVoltageV,
-        threePhaseVoltageV: input.threePhaseVoltageV,
-      })
-      .where(eq(projects.id, projectId));
-  }
-
   async delete(projectId: string) {
     await db.delete(projects).where(eq(projects.id, projectId));
   }

src/domain/models/project-settings-project-command.model.ts

@@ -0,0 +1,61 @@
+import type { SerializedProjectCommand } from "./project-command.model.js";
+
+export const projectSettingsUpdateCommandType =
+  "project.update-settings" as const;
+export const projectSettingsUpdateCommandSchemaVersion = 1 as const;
+
+export interface ProjectSettingsValues {
+  singlePhaseVoltageV: number;
+  threePhaseVoltageV: number;
+}
+
+export interface ProjectSettingsUpdateProjectCommand
+  extends SerializedProjectCommand<ProjectSettingsValues> {
+  schemaVersion: typeof projectSettingsUpdateCommandSchemaVersion;
+  type: typeof projectSettingsUpdateCommandType;
+}
+
+export function createProjectSettingsUpdateProjectCommand(
+  values: ProjectSettingsValues
+): ProjectSettingsUpdateProjectCommand {
+  const command: ProjectSettingsUpdateProjectCommand = {
+    schemaVersion: projectSettingsUpdateCommandSchemaVersion,
+    type: projectSettingsUpdateCommandType,
+    payload: { ...values },
+  };
+  assertProjectSettingsUpdateProjectCommand(command);
+  return command;
+}
+
+export function assertProjectSettingsUpdateProjectCommand(
+  command: SerializedProjectCommand<unknown>
+): asserts command is ProjectSettingsUpdateProjectCommand {
+  if (
+    command.schemaVersion !== projectSettingsUpdateCommandSchemaVersion ||
+    command.type !== projectSettingsUpdateCommandType
+  ) {
+    throw new Error("Unsupported project settings update command.");
+  }
+  if (
+    !isPlainObject(command.payload) ||
+    !isPositiveFiniteNumber(command.payload.singlePhaseVoltageV) ||
+    !isPositiveFiniteNumber(command.payload.threePhaseVoltageV) ||
+    Object.keys(command.payload).length !== 2
+  ) {
+    throw new Error(
+      "Project settings update command contains invalid voltages."
+    );
+  }
+}
+
+function isPositiveFiniteNumber(value: unknown): value is number {
+  return (
+    typeof value === "number" &&
+    Number.isFinite(value) &&
+    value > 0
+  );
+}
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}

src/domain/ports/project-settings-project-command.store.ts

@@ -0,0 +1,26 @@
+import type { ProjectSettingsUpdateProjectCommand } from "../models/project-settings-project-command.model.js";
+import type {
+  AppendedProjectRevision,
+  ProjectRevisionSource,
+} from "./project-revision.store.js";
+
+export interface ExecuteProjectSettingsUpdateCommandInput {
+  projectId: string;
+  expectedRevision: number;
+  source: ProjectRevisionSource;
+  description?: string;
+  actorId?: string;
+  historyTargetChangeSetId?: string;
+  command: ProjectSettingsUpdateProjectCommand;
+}
+
+export interface ExecutedProjectSettingsUpdateCommand {
+  revision: AppendedProjectRevision;
+  inverse: ProjectSettingsUpdateProjectCommand;
+}
+
+export interface ProjectSettingsProjectCommandStore {
+  executeUpdate(
+    input: ExecuteProjectSettingsUpdateCommandInput
+  ): ExecutedProjectSettingsUpdateCommand;
+}

src/domain/services/project-command.service.ts

@@ -45,6 +45,10 @@ import {
   assertProjectStateRestoreCommand,
   projectStateRestoreCommandType,
 } from "../models/project-state-restore-command.model.js";
+import {
+  assertProjectSettingsUpdateProjectCommand,
+  projectSettingsUpdateCommandType,
+} from "../models/project-settings-project-command.model.js";
 import {
   assertProjectDeviceRowSyncProjectCommand,
   projectDeviceRowSyncCommandType,
@@ -80,6 +84,7 @@ import type { ProjectDeviceProjectCommandStore } from "../ports/project-device-p
 import type { ProjectDeviceRowSyncProjectCommandStore } from "../ports/project-device-row-sync-project-command.store.js";
 import type { ProjectDeviceStructureProjectCommandStore } from "../ports/project-device-structure-project-command.store.js";
 import type { ProjectRevisionSource } from "../ports/project-revision.store.js";
+import type { ProjectSettingsProjectCommandStore } from "../ports/project-settings-project-command.store.js";
 import type { ProjectStateRestoreCommandStore } from "../ports/project-state-restore-command.store.js";
 
 interface DispatchProjectCommandInput {
@@ -104,6 +109,7 @@ export class ProjectCommandService implements ProjectCommandExecutor {
     private readonly projectDeviceStructureStore: ProjectDeviceStructureProjectCommandStore,
     private readonly projectDeviceStore: ProjectDeviceProjectCommandStore,
     private readonly projectDeviceRowSyncStore: ProjectDeviceRowSyncProjectCommandStore,
+    private readonly projectSettingsStore: ProjectSettingsProjectCommandStore,
     private readonly projectStateRestoreStore: ProjectStateRestoreCommandStore,
     private readonly historyStore: ProjectHistoryStore
   ) {}
@@ -294,6 +300,13 @@ export class ProjectCommandService implements ProjectCommandExecutor {
           command: input.command,
         }).revision;
       }
+      case projectSettingsUpdateCommandType: {
+        assertProjectSettingsUpdateProjectCommand(input.command);
+        return this.projectSettingsStore.executeUpdate({
+          ...input,
+          command: input.command,
+        }).revision;
+      }
       case projectStateRestoreCommandType: {
         assertProjectStateRestoreCommand(input.command);
         return this.projectStateRestoreStore.execute({

src/frontend/types.ts

@@ -58,6 +58,11 @@ export interface ProjectSnapshotRestoreResultDto
   snapshot: ProjectSnapshotMetadataDto;
 }
 
+export interface ProjectSettingsCommandResultDto
+  extends ProjectCommandResultDto {
+  project: ProjectDto;
+}
+
 export interface ProjectCommandDto {
   schemaVersion: number;
   type: string;

src/frontend/utils/api.ts

@@ -15,6 +15,7 @@ import type {
   ProjectRevisionPageDto,
   ProjectSnapshotMetadataDto,
   ProjectSnapshotRestoreResultDto,
+  ProjectSettingsCommandResultDto,
   ProjectDeviceSyncCommandResultDto,
   ProjectDeviceSyncPreviewDto,
   ProjectDto,
@@ -205,12 +206,16 @@ export function createProject(name: string) {
 
 export function updateProjectSettings(
   projectId: string,
+  expectedRevision: number,
   input: { singlePhaseVoltageV: number; threePhaseVoltageV: number }
 ) {
-  return request<ProjectDto>(`/api/projects/${projectId}`, {
+  return request<ProjectSettingsCommandResultDto>(
+    `/api/projects/${projectId}`,
+    {
     method: "PUT",
-    body: JSON.stringify(input),
-  });
+      body: JSON.stringify({ expectedRevision, ...input }),
+    }
+  );
 }
 
 export function listDistributionBoards(projectId: string) {

src/frontend/utils/project-version-history.ts

@@ -28,6 +28,7 @@ const commandTypeLabels: Record<string, string> = {
   "project-device.insert": "Projektgerät angelegt",
   "project-device.delete": "Projektgerät gelöscht",
   "project-device.sync-rows": "Projektgerät-Verknüpfungen geändert",
+  "project.update-settings": "Projekteinstellungen bearbeitet",
   "project.restore-state": "Projektstand wiederhergestellt",
 };
 

src/server/composition/project-command-stores.ts

@@ -10,6 +10,7 @@ import { ProjectHistoryRepository } from "../../db/repositories/project-history.
 import { ProjectDeviceProjectCommandRepository } from "../../db/repositories/project-device-project-command.repository.js";
 import { ProjectDeviceRowSyncProjectCommandRepository } from "../../db/repositories/project-device-row-sync-project-command.repository.js";
 import { ProjectDeviceStructureProjectCommandRepository } from "../../db/repositories/project-device-structure-project-command.repository.js";
+import { ProjectSettingsProjectCommandRepository } from "../../db/repositories/project-settings-project-command.repository.js";
 import { ProjectStateRestoreCommandRepository } from "../../db/repositories/project-state-restore-command.repository.js";
 import { ProjectCommandService } from "../../domain/services/project-command.service.js";
 
@@ -32,6 +33,8 @@ export const projectDeviceProjectCommandStore =
   new ProjectDeviceProjectCommandRepository(db);
 export const projectDeviceRowSyncProjectCommandStore =
   new ProjectDeviceRowSyncProjectCommandRepository(db);
+export const projectSettingsProjectCommandStore =
+  new ProjectSettingsProjectCommandRepository(db);
 export const projectStateRestoreCommandStore =
   new ProjectStateRestoreCommandRepository(db);
 export const projectHistoryStore = new ProjectHistoryRepository(db);
@@ -46,6 +49,7 @@ export const projectCommandService = new ProjectCommandService(
   projectDeviceStructureProjectCommandStore,
   projectDeviceProjectCommandStore,
   projectDeviceRowSyncProjectCommandStore,
+  projectSettingsProjectCommandStore,
   projectStateRestoreCommandStore,
   projectHistoryStore
 );

src/server/controllers/project.controller.ts

@@ -4,6 +4,9 @@ import {
   createProjectSchema,
   updateProjectSettingsSchema,
 } from "../../shared/validation/project-structure.schemas.js";
+import { createProjectSettingsUpdateProjectCommand } from "../../domain/models/project-settings-project-command.model.js";
+import { projectCommandService } from "../composition/project-command-stores.js";
+import { respondWithProjectCommandError } from "./project-command.controller.js";
 
 const projectRepository = new ProjectRepository();
 
@@ -44,10 +47,20 @@ export async function updateProjectSettings(req: Request, res: Response) {
     return res.status(400).json({ error: parsed.error.flatten() });
   }
 
-  await projectRepository.updateSettings(projectId, parsed.data);
-  const row = await projectRepository.findById(projectId);
-  if (!row) {
-    return res.status(404).json({ error: "Project not found" });
+  const { expectedRevision, ...settings } = parsed.data;
+  try {
+    const result = projectCommandService.executeUser({
+      projectId,
+      expectedRevision,
+      description: "Projekteinstellungen bearbeiten",
+      command: createProjectSettingsUpdateProjectCommand(settings),
+    });
+    const project = await projectRepository.findById(projectId);
+    if (!project) {
+      throw new Error("Updated project could not be loaded.");
+    }
+    return res.json({ ...result, project });
+  } catch (error) {
+    return respondWithProjectCommandError(error, res);
   }
-  return res.json(row);
 }

src/shared/validation/project-structure.schemas.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { expectedProjectRevisionSchema } from "./project-command.schemas.js";
 
 export const createProjectSchema = z.object({
   name: z.string().min(1),
@@ -6,10 +7,13 @@ export const createProjectSchema = z.object({
   threePhaseVoltageV: z.number().positive().optional(),
 });
 
-export const updateProjectSettingsSchema = z.object({
-  singlePhaseVoltageV: z.number().positive(),
-  threePhaseVoltageV: z.number().positive(),
-});
+export const updateProjectSettingsSchema = z
+  .object({
+    expectedRevision: expectedProjectRevisionSchema,
+    singlePhaseVoltageV: z.number().positive(),
+    threePhaseVoltageV: z.number().positive(),
+  })
+  .strict();
 
 export const createDistributionBoardSchema = z.object({
   name: z.string().min(1),