feat(mitarbeiter): Vorgesetzter auch fuer Personen ohne Verzeichnis

Die Zuordnung lief allein ueber vorgesetzterExterneId, und die ist nur
innerhalb einer Verzeichnisquelle eindeutig: eine von Hand angelegte Person
konnte keinen Vorgesetzten haben, und {{vorgesetzter_sam}} blieb im
Onboarding-Befehl leer -- genau dort, wo er gebraucht wird.

Entschieden fuer eine eigene Selbstbeziehung vorgesetzterId. Die befuerchteten
"zwei Wege zur selben Auskunft" entstehen nicht, weil der Abgleich sie
mitschreibt: vorgesetzterExterneId ist jetzt wie abteilung nur der rohe Wert
des Verzeichnisses, gelesen wird allein vorgesetzterId. Die Alternative haette
manuellen Personen eine erfundene externeId geben muessen, und externeId heisst
"objectGUID aus dem Verzeichnis".

Liefert das Verzeichnis keinen manager, bleibt eine von Hand gesetzte Zuordnung
stehen -- geleert wird nur, was das Verzeichnis selbst gesetzt hatte.

Die Migration fuehrt bestehende Daten nach. Ohne das waere die Auskunft nach
dem Einspielen bei jeder Verzeichnis-Person still leer gewesen, bis der
naechste Abgleich laeuft. An einem nachgebauten Vor-Zustand gefahren.

Drei Grenzen, drei Stellen: der zusammengesetzte Fremdschluessel haelt die
Mandantengrenze, ein CHECK die kuerzeste Schleife, und der Dienst laeuft die
Kette hinauf fuer laengere.

Im gebauten Stand durchgeklickt: speichern, neu laden, Wert steht, entfernen,
390 px ohne horizontales Scrollen. Gegenprobe am Abgleich gefahren.

Closes #31

tests/mitarbeiter.test.ts

@@ -6,12 +6,15 @@ import {
   mitarbeiterAktivSetzen,
   mitarbeiterAnlegen,
   mitarbeiterBearbeiten,
+  vorgesetztenSetzen,
 } from "@/server/services/mitarbeiter";
 import {
   abteilungsNamen,
   geraeteDesMitarbeiters,
   mitarbeiterHolen,
   mitarbeiterListe,
+  moeglicheVorgesetzte,
+  vorgesetzterVon,
 } from "@/server/queries/mitarbeiter";
 import { datenbankLeeren, datenbankVerfuegbar, testPrisma } from "./helpers/db";
 
@@ -40,6 +43,118 @@ describe.runIf(datenbankVerfuegbar)("Mitarbeiter", () => {
     await datenbankLeeren();
   });
 
+  describe("Vorgesetzter", () => {
+    it("laesst sich fuer eine von Hand angelegte Person setzen", async () => {
+      // Der Fall, der vorher gar nicht ging: ohne Verzeichnisquelle gab es kein
+      // Feld fuer die Zuordnung (#020).
+      const { admin } = await grundbestand();
+      const maria = await mitarbeiterAnlegen({ vorname: "Maria", nachname: "Huber" }, admin);
+      const petra = await mitarbeiterAnlegen({ vorname: "Petra", nachname: "Klein" }, admin);
+      expect(maria.herkunft).toBe(Herkunft.MANUELL);
+
+      await vorgesetztenSetzen(maria.id, petra.id, admin);
+      expect(await vorgesetzterVon(maria.id, admin)).toEqual({
+        id: petra.id,
+        anzeigename: "Petra Klein",
+      });
+    });
+
+    it("entfernt die Zuordnung bei leerer Angabe", async () => {
+      const { admin } = await grundbestand();
+      const maria = await mitarbeiterAnlegen({ vorname: "Maria", nachname: "Huber" }, admin);
+      const petra = await mitarbeiterAnlegen({ vorname: "Petra", nachname: "Klein" }, admin);
+      await vorgesetztenSetzen(maria.id, petra.id, admin);
+
+      await vorgesetztenSetzen(maria.id, "", admin);
+      expect(await vorgesetzterVon(maria.id, admin)).toBeUndefined();
+    });
+
+    it("laesst niemanden sein eigener Vorgesetzter sein", async () => {
+      const { admin } = await grundbestand();
+      const maria = await mitarbeiterAnlegen({ vorname: "Maria", nachname: "Huber" }, admin);
+      await expect(vorgesetztenSetzen(maria.id, maria.id, admin)).rejects.toThrow(/eigener Vorgesetzter/);
+    });
+
+    it("weist eine Schleife ueber zwei Personen ab", async () => {
+      const { admin } = await grundbestand();
+      const a = await mitarbeiterAnlegen({ vorname: "A", nachname: "Eins" }, admin);
+      const b = await mitarbeiterAnlegen({ vorname: "B", nachname: "Zwei" }, admin);
+      await vorgesetztenSetzen(b.id, a.id, admin);
+
+      await expect(vorgesetztenSetzen(a.id, b.id, admin)).rejects.toThrow(/Schleife/);
+    });
+
+    it("weist eine Schleife ueber drei Personen ab", async () => {
+      // Die Datenbank faengt nur die kuerzeste ab; diese braucht den Gang nach
+      // oben im Dienst.
+      const { admin } = await grundbestand();
+      const a = await mitarbeiterAnlegen({ vorname: "A", nachname: "Eins" }, admin);
+      const b = await mitarbeiterAnlegen({ vorname: "B", nachname: "Zwei" }, admin);
+      const c = await mitarbeiterAnlegen({ vorname: "C", nachname: "Drei" }, admin);
+      await vorgesetztenSetzen(b.id, a.id, admin);
+      await vorgesetztenSetzen(c.id, b.id, admin);
+
+      await expect(vorgesetztenSetzen(a.id, c.id, admin)).rejects.toThrow(/Schleife/);
+    });
+
+    it("gilt nur innerhalb desselben Kunden", async () => {
+      const { eigene, admin } = await grundbestand();
+      const fremd = await testPrisma.kunde.create({ data: { name: "Fremd GmbH", kuerzel: "FREMD" } });
+      const hier = await testPrisma.mitarbeiter.create({
+        data: { kundeId: eigene.id, vorname: "Maria", nachname: "Huber", anzeigename: "Maria Huber" },
+      });
+      const dort = await testPrisma.mitarbeiter.create({
+        data: { kundeId: fremd.id, vorname: "Petra", nachname: "Klein", anzeigename: "Petra Klein" },
+      });
+
+      await expect(vorgesetztenSetzen(hier.id, dort.id, admin)).rejects.toThrow(/selben Kunden/);
+      // Und auch an der Service-Schicht vorbei nicht: der zusammengesetzte
+      // Fremdschluessel haelt dieselbe Grenze.
+      await expect(
+        testPrisma.mitarbeiter.update({
+          where: { id: hier.id },
+          data: { vorgesetzterId: dort.id },
+        }),
+      ).rejects.toThrow(/Mitarbeiter_vorgesetzter_gleicher_kunde/);
+    });
+
+    it("bietet zur Auswahl nur aktive Kollegen desselben Kunden, ohne die Person selbst", async () => {
+      const { eigene, admin } = await grundbestand();
+      const fremd = await testPrisma.kunde.create({ data: { name: "Fremd GmbH", kuerzel: "FREMD" } });
+      const maria = await mitarbeiterAnlegen({ vorname: "Maria", nachname: "Huber" }, admin);
+      const petra = await mitarbeiterAnlegen({ vorname: "Petra", nachname: "Klein" }, admin);
+      const weg = await mitarbeiterAnlegen({ vorname: "Alt", nachname: "Kollege" }, admin);
+      await mitarbeiterAktivSetzen(weg.id, false, admin);
+      await testPrisma.mitarbeiter.create({
+        data: { kundeId: fremd.id, vorname: "Fremd", nachname: "Person", anzeigename: "Fremd Person" },
+      });
+      expect(eigene.id).toBe(maria.kundeId);
+
+      const auswahl = await moeglicheVorgesetzte(maria.id, admin);
+      expect(auswahl.map((eintrag) => eintrag.id)).toEqual([petra.id]);
+    });
+
+    it("schreibt die Aenderung ins Protokoll, mit Namen", async () => {
+      const { admin } = await grundbestand();
+      const maria = await mitarbeiterAnlegen({ vorname: "Maria", nachname: "Huber" }, admin);
+      const petra = await mitarbeiterAnlegen({ vorname: "Petra", nachname: "Klein" }, admin);
+
+      await vorgesetztenSetzen(maria.id, petra.id, admin);
+      await vorgesetztenSetzen(maria.id, null, admin);
+
+      const eintraege = await testPrisma.protokoll.findMany({
+        where: { entitaet: "Mitarbeiter", entitaetId: maria.id },
+        orderBy: { erstelltAm: "asc" },
+        select: { aktion: true },
+      });
+      // Das Anlegen protokolliert selbst - hier zaehlt, was danach kam.
+      expect(eintraege.map((e) => e.aktion).slice(1)).toEqual([
+        "Vorgesetzter auf Petra Klein gesetzt",
+        "Vorgesetzter entfernt",
+      ]);
+    });
+  });
+
   describe("Anlegen", () => {
     it("bildet den Anzeigenamen aus Vor- und Nachname, wenn keiner angegeben ist", async () => {
       const { admin } = await grundbestand();