@cosmicdrift/kumiko-samples 0.338.0

package/samples/apps/ui-walkthrough/src/app/seed-vehicles.ts

@@ -0,0 +1,172 @@
+import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { countRowsForTenant } from "../db/queries/row-counts";
+
+const OCTAVIA_DESCRIPTION = [
+  "One owner from new. Full Škoda main dealer service history.",
+  "2.0 TDI, 110 kW, automatic, diesel. 28,500 km.",
+  "No accidents. Small stone chip on the front bumper, see photos.",
+  "Two keys. 12 months warranty.",
+].join("\n");
+
+const OCTAVIA = {
+  fin: "TMBJG7NE5M0123456",
+  marke: "Škoda",
+  modell: "Octavia",
+  baujahr: 2021,
+  preis: { amount: 18450, currency: "EUR" },
+  kilometerstand: 28500,
+  kilometerEinheit: "km",
+  kraftstoffart: "diesel",
+  getriebe: "automatic",
+  leistungKw: 110,
+  karosserieform: "estate",
+  ausstattungslinie: "SE L",
+  zustand: "used",
+  vorbesitzer: 1,
+  garantieMonate: 12,
+  garantieJahre: "3",
+  inspektion: "12",
+  scheckheft: "complete",
+  scheckheftGepflegt: true,
+  nichtraucher: true,
+  beschreibung: OCTAVIA_DESCRIPTION,
+  ausstattung: "Klimaautomatik, Navigation, Sitzheizung, Anhängerkupplung",
+} as const;
+
+const GOLF = {
+  fin: "WVWZZZ1KZAW123456",
+  marke: "VW",
+  modell: "Golf",
+  baujahr: 2019,
+  preis: { amount: 14900, currency: "EUR" },
+  kilometerstand: 64200,
+  kilometerEinheit: "km",
+  kraftstoffart: "petrol",
+  getriebe: "manual",
+  zustand: "used",
+  garantieJahre: "1",
+  inspektion: "",
+  scheckheftGepflegt: false,
+} as const;
+
+type SeedPost = {
+  readonly datum: string;
+  readonly kanal: "Instagram" | "Facebook" | "mobile.de";
+  readonly text: string;
+  readonly status: "geplant" | "gepostet";
+};
+
+type SeedCampaign = {
+  readonly name: string;
+  readonly status: "aktiv" | "abgeschlossen" | "entwurf";
+  readonly meta: string;
+  readonly gestartetAm: string;
+  readonly aktionStartet: string;
+  readonly aktionEndet: string;
+  readonly posts: readonly SeedPost[];
+};
+
+const CAMPAIGNS: readonly SeedCampaign[] = [
+  {
+    name: "Škoda Octavia (2021)",
+    status: "aktiv",
+    meta: "Tag 1 von 30 · 4 Besuche · 1 Interessent",
+    gestartetAm: "2026-09-29",
+    aktionStartet: "2026-10-04T18:00:00Z",
+    aktionEndet: "2026-10-04T20:00:00Z",
+    posts: [
+      { datum: "2026-09-29", kanal: "mobile.de", text: "Inserat online", status: "gepostet" },
+      {
+        datum: "2026-10-02",
+        kanal: "Instagram",
+        text: "Fotostrecke Außenansicht",
+        status: "geplant",
+      },
+      { datum: "2026-10-06", kanal: "Facebook", text: "Probefahrt-Aktion", status: "geplant" },
+      { datum: "2026-10-12", kanal: "Instagram", text: "Reel: Innenraum", status: "geplant" },
+    ],
+  },
+  {
+    name: "VW Golf (2019)",
+    status: "aktiv",
+    meta: "Tag 12 von 30 · 86 Besuche · 5 Interessenten",
+    gestartetAm: "2026-09-18",
+    aktionStartet: "2026-10-11T07:30:00Z",
+    aktionEndet: "2026-10-12T15:45:00Z",
+    posts: [
+      { datum: "2026-09-18", kanal: "mobile.de", text: "Inserat online", status: "gepostet" },
+      { datum: "2026-09-21", kanal: "Instagram", text: "Fotostrecke", status: "gepostet" },
+      { datum: "2026-09-25", kanal: "Facebook", text: "Preis gesenkt", status: "gepostet" },
+      { datum: "2026-10-03", kanal: "Instagram", text: "Story: Probefahrt", status: "geplant" },
+      { datum: "2026-10-08", kanal: "Facebook", text: "Erinnerung", status: "geplant" },
+      { datum: "2026-10-15", kanal: "mobile.de", text: "Inserat auffrischen", status: "geplant" },
+    ],
+  },
+  {
+    name: "BMW 320d Touring (2020)",
+    status: "abgeschlossen",
+    meta: "30 Tage · 212 Besuche · 9 Interessenten",
+    gestartetAm: "2026-08-30",
+    aktionStartet: "2026-09-19T08:00:00Z",
+    aktionEndet: "2026-09-19T14:00:00Z",
+    posts: [
+      { datum: "2026-08-30", kanal: "mobile.de", text: "Inserat online", status: "gepostet" },
+      { datum: "2026-09-05", kanal: "Instagram", text: "Fotostrecke", status: "gepostet" },
+      { datum: "2026-09-20", kanal: "Facebook", text: "Letzte Chance", status: "gepostet" },
+    ],
+  },
+  {
+    name: "Ford Focus (2018)",
+    status: "entwurf",
+    meta: "Noch nicht gestartet",
+    gestartetAm: "2026-08-01",
+    aktionStartet: "2026-10-25T09:00:00Z",
+    aktionEndet: "2026-10-25T16:00:00Z",
+    posts: [
+      { datum: "2026-10-20", kanal: "mobile.de", text: "Inserat online", status: "geplant" },
+      { datum: "2026-10-22", kanal: "Instagram", text: "Fotostrecke", status: "geplant" },
+      { datum: "2026-10-27", kanal: "Facebook", text: "Vorstellung", status: "geplant" },
+    ],
+  },
+  {
+    name: "Herbst - Gebrauchtwagen",
+    status: "entwurf",
+    meta: "Geplant für Oktober",
+    gestartetAm: "2026-07-15",
+    aktionStartet: "2026-10-31T17:00:00Z",
+    aktionEndet: "2026-11-01T11:00:00Z",
+    posts: [
+      {
+        datum: "2026-10-05",
+        kanal: "Facebook",
+        text: "Ankündigung Herbstaktion",
+        status: "geplant",
+      },
+      { datum: "2026-10-10", kanal: "Instagram", text: "Highlights der Woche", status: "geplant" },
+      { datum: "2026-10-18", kanal: "mobile.de", text: "Sammelinserat", status: "geplant" },
+    ],
+  },
+];
+
+export const seedVehicles: SeedFn = async (stack) => {
+  const { tenantId } = TestUsers.admin;
+  if ((await countRowsForTenant(stack.db, "read_ui_walkthrough_vehicles", tenantId)) > 0) return;
+  await stack.http.writeOk("vehicles:write:vehicle:create", OCTAVIA, TestUsers.admin);
+  await stack.http.writeOk("vehicles:write:vehicle:create", GOLF, TestUsers.admin);
+  for (const { posts, ...campaign } of CAMPAIGNS) {
+    const gepostet = posts.filter((post) => post.status === "gepostet").length;
+    const { id } = await stack.http.writeOk<{ id: string }>(
+      "vehicles:write:campaign:create",
+      { ...campaign, gepostet },
+      TestUsers.admin,
+    );
+    for (const post of posts) {
+      await stack.http.writeOk(
+        "vehicles:write:campaign-post:create",
+        { ...post, campaign: id },
+        TestUsers.admin,
+      );
+    }
+  }
+};

package/samples/apps/ui-walkthrough/src/app/seed.ts

@@ -0,0 +1,25 @@
+// Seed for ui-walkthrough — a handful of tasks so the generated list screen
+// isn't empty in `bun dev` and the screenshot runner renders real rows. Goes
+// through the normal dispatcher (tasks:write:task:create) so validation +
+// audit + search-index run like a real request. Idempotent: skips when the
+// tenant already has tasks (persistent KUMIKO_DEV_DB_NAME survives reboots).
+
+import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { countTasksForTenant } from "../db/queries/task-counts";
+
+const DEMO_TASKS = [
+  { title: "Ship the docs overhaul", status: "in progress", priority: 1, isUrgent: true },
+  { title: "Review the tutorial PR", status: "todo", priority: 2, isUrgent: false },
+  { title: "Regenerate the screenshots", status: "todo", priority: 3, isUrgent: false },
+  { title: "Reply on the launch thread", status: "done", priority: 2, isUrgent: false },
+  { title: "Plan the next sprint", status: "todo", priority: 5, isUrgent: false },
+] as const;
+
+export const seedTasks: SeedFn = async (stack) => {
+  const existing = await countTasksForTenant(stack.db, TestUsers.admin.tenantId);
+  if (existing > 0) return;
+  for (const task of DEMO_TASKS) {
+    await stack.http.write("tasks:write:task:create", task, TestUsers.admin);
+  }
+};

package/samples/apps/ui-walkthrough/src/app/server.ts

@@ -0,0 +1,56 @@
+// @runtime dev
+//
+// Dev-Server für ui-walkthrough. runDevApp mischt die Standard-Features
+// (config/user/tenant/auth) automatisch dazu wenn `auth` gesetzt ist und
+// ruft seedAdmin im onAfterSetup. Schema landet als window.__KUMIKO_
+// SCHEMA__-Injection im Browser.
+//
+// Auth-Mode aktiv: Client muss sich über den Login-Screen anmelden,
+// kein Auto-Mint-JWT mehr. Persistent-DB-Modus über KUMIKO_DEV_DB_NAME
+// in der Umgebung.
+
+import { runDevApp } from "@cosmicdrift/kumiko-dev-server";
+import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
+import { APP_FEATURES } from "../run-config";
+import { ADMIN_EMAIL, ADMIN_PASSWORD, BETA_TENANT_ID, DEV_TENANT_ID } from "./auth-constants";
+import { seedTasks } from "./seed";
+import { seedRental } from "./seed-rental";
+import { seedVehicles } from "./seed-vehicles";
+
+// Zwei feste Tenants — Admin ist in beiden Mitglied damit der
+// TenantSwitcher im Sample sichtbar ist (rendert nur bei >1 Tenant).
+// Unterschiedliche Rollen pro Tenant beweisen tenant-isolierte
+// Memberships. TenantId-Cast lokal an der Use-Site (auth-constants.ts
+// bleibt framework-frei für den E2E-Helper-Pfad).
+
+await runDevApp({
+  features: [...APP_FEATURES],
+  seeds: [seedTasks, seedRental, seedVehicles],
+  // PORT env-var override für Playwright-e2e-Runs (config zeigt auf 4174);
+  // sonst lokal-Default 4173.
+  port: Number.parseInt(process.env["PORT"] ?? "4173", 10),
+  clientEntry: "./src/app/client.tsx",
+  htmlPath: "./public/index.html",
+  watchDirs: ["./src", "../../../packages/*/src"],
+  auth: {
+    admin: {
+      email: ADMIN_EMAIL,
+      password: ADMIN_PASSWORD,
+      displayName: "Admin",
+      memberships: [
+        {
+          tenantId: DEV_TENANT_ID as TenantId,
+          tenantKey: "dev",
+          tenantName: "Dev Tenant",
+          roles: ["Admin"],
+        },
+        {
+          tenantId: BETA_TENANT_ID as TenantId,
+          tenantKey: "beta",
+          tenantName: "Beta Tenant",
+          roles: ["User"],
+        },
+      ],
+    },
+  },
+});

package/samples/apps/ui-walkthrough/src/app/shell.tsx

@@ -0,0 +1,67 @@
+// AppShell mit Brand und User-Menü im Sidebar-Footer. Tenant-, Sprach- und
+// Theme-Wahl hängen im User-Menü. Tenant-Name-Mapping bleibt im Shell —
+// App-spezifische Logik, kein Framework-Konzept.
+
+import {
+  TenantMenuItems,
+  UserMenu,
+} from "@cosmicdrift/kumiko-bundled-features/auth-email-password/web";
+import {
+  type AppSchema,
+  DefaultAppShell,
+  LanguageMenuItems,
+  SidebarBrand,
+  ThemeMenuItem,
+  ThemeToggle,
+} from "@cosmicdrift/kumiko-renderer-web";
+import { MoonStar, Sun } from "lucide-react";
+import type { ReactNode } from "react";
+import { AssistantAction } from "./assistant-action";
+import { BETA_TENANT_ID, DEV_TENANT_ID } from "./auth-constants";
+
+const APP_NAME = "Kumiko Walkthrough";
+const APP_TAGLINE = "Design-Referenz";
+
+const tenantName = (tenantId: string): string => {
+  if (tenantId === DEV_TENANT_ID) return "Dev Tenant";
+  if (tenantId === BETA_TENANT_ID) return "Beta Tenant";
+  return tenantId.slice(0, 8);
+};
+
+const availableLocales = [
+  { code: "de", label: "Deutsch" },
+  { code: "en", label: "English" },
+];
+
+export function AppShell({
+  children,
+  schema,
+}: {
+  readonly children: ReactNode;
+  readonly schema: AppSchema;
+}): ReactNode {
+  return (
+    <DefaultAppShell
+      brand={<SidebarBrand name={APP_NAME} plan={APP_TAGLINE} />}
+      schema={schema}
+      headerActions={
+        <>
+          <AssistantAction />
+          <ThemeToggle />
+        </>
+      }
+      sidebarFooter={
+        <UserMenu variant="sidebar">
+          <TenantMenuItems tenantName={tenantName} />
+          <LanguageMenuItems locales={availableLocales} />
+          <ThemeMenuItem
+            lightIcon={<Sun className="h-4 w-4" />}
+            darkIcon={<MoonStar className="h-4 w-4" />}
+          />
+        </UserMenu>
+      }
+    >
+      {children}
+    </DefaultAppShell>
+  );
+}

package/samples/apps/ui-walkthrough/src/db/queries/row-counts.ts

@@ -0,0 +1,24 @@
+import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
+import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
+
+type CountedTable = "read_ui_walkthrough_leases" | "read_ui_walkthrough_vehicles";
+
+const COUNTED_TABLES: ReadonlySet<string> = new Set<CountedTable>([
+  "read_ui_walkthrough_leases",
+  "read_ui_walkthrough_vehicles",
+]);
+
+export async function countRowsForTenant(
+  db: DbRunner,
+  table: CountedTable,
+  tenantId: string,
+): Promise<number> {
+  if (!COUNTED_TABLES.has(table)) {
+    throw new Error(`countRowsForTenant: table "${table}" is not allowed`);
+  }
+  const rows = await asRawClient(db).unsafe<{ count: number }>(
+    `SELECT count(*)::int AS count FROM ${table} WHERE tenant_id = $1`,
+    [tenantId],
+  );
+  return rows[0]?.count ?? 0;
+}

package/samples/apps/ui-walkthrough/src/db/queries/task-counts.ts

@@ -0,0 +1,10 @@
+import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
+import type { DbRunner } from "@cosmicdrift/kumiko-framework/db";
+
+export async function countTasksForTenant(db: DbRunner, tenantId: string): Promise<number> {
+  const rows = await asRawClient(db).unsafe<{ count: number }>(
+    `SELECT count(*)::int AS count FROM read_ui_walkthrough_tasks WHERE tenant_id = $1`,
+    [tenantId],
+  );
+  return rows[0]?.count ?? 0;
+}

package/samples/apps/ui-walkthrough/src/features/rental/entities.ts

@@ -0,0 +1,57 @@
+import {
+  createDateField,
+  createEntity,
+  createMoneyField,
+  createNumberField,
+  createSelectField,
+  createTextField,
+} from "@cosmicdrift/kumiko-framework/engine";
+
+const DEMO_DATA = { personal: false, reason: "is_business_data" } as const;
+
+export const LEASE_STATUSES = ["active", "terminated"] as const;
+
+export const leaseEntity = createEntity({
+  table: "read_ui_walkthrough_leases",
+  fields: {
+    mieter: createTextField({ ...DEMO_DATA, required: true, searchable: true, sortable: true }),
+    einheit: createTextField({ ...DEMO_DATA, searchable: true, sortable: true, maxLength: 400 }),
+    liegenschaft: createTextField({ ...DEMO_DATA, searchable: true, sortable: true }),
+    beginn: createDateField({ required: true, sortable: true, filterable: true }),
+    ende: createDateField({ sortable: true }),
+    status: createSelectField({
+      options: LEASE_STATUSES,
+      optionTones: { active: "ok", terminated: "bad" },
+      default: "active",
+      required: true,
+      sortable: true,
+      filterable: true,
+    }),
+    grundmiete: createMoneyField({ required: true }),
+    kuendigungsfrist: createTextField(DEMO_DATA),
+    zahltag: createNumberField({ integer: true }),
+  },
+  defaultCurrency: "EUR",
+});
+
+export const leasePositionEntity = createEntity({
+  table: "read_ui_walkthrough_lease_positions",
+  fields: {
+    lease: { type: "reference", entity: "lease", required: true, filterable: true },
+    art: createTextField({ ...DEMO_DATA, required: true }),
+    einheit: createTextField(DEMO_DATA),
+    betrag: createMoneyField({ required: true }),
+    gueltigVon: createDateField({ required: true, sortable: true }),
+    gueltigBis: createDateField(),
+  },
+  defaultCurrency: "EUR",
+});
+
+export const leasePartyEntity = createEntity({
+  table: "read_ui_walkthrough_lease_parties",
+  fields: {
+    lease: { type: "reference", entity: "lease", required: true, filterable: true },
+    name: createTextField({ ...DEMO_DATA, required: true, searchable: true }),
+    rolle: createTextField({ ...DEMO_DATA, filterable: true }),
+  },
+});

package/samples/apps/ui-walkthrough/src/features/rental/feature.ts

@@ -0,0 +1,258 @@
+import { defineFeature, i18nKey } from "@cosmicdrift/kumiko-framework/engine";
+import { failNotFound } from "@cosmicdrift/kumiko-framework/errors";
+import { z } from "zod";
+import { openToAllSignedIn, toKeyFirst } from "../translations";
+import { leaseEntity, leasePartyEntity, leasePositionEntity } from "./entities";
+import { rentalTranslations } from "./i18n";
+import {
+  dayBefore,
+  formatGermanDate,
+  formatGermanMoney,
+  germanStatusLabel,
+  idPayloadSchema,
+  leaseExecutor,
+  parseLeaseRow,
+  partyExecutor,
+  positionExecutor,
+  positionListRowSchema,
+  positionRowSchema,
+  type RecordedPositionItem,
+  recordPositionsPayloadSchema,
+  rentAdjustPayloadSchema,
+} from "./lease-support";
+import {
+  adjustRentScreen,
+  leaseDetailScreen,
+  leaseEditScreen,
+  leaseHubScreen,
+  leaseListScreen,
+  leaseListShortScreen,
+  partyEditScreen,
+  positionEditScreen,
+  recordPositionsScreen,
+  rentalDashboardScreen,
+} from "./screens";
+
+export { leaseEntity, leasePartyEntity, leasePositionEntity };
+
+const open = openToAllSignedIn(
+  "demo app: any signed-in user manages every lease; there is no per-user ownership in this sample",
+);
+
+const roundToCents = (amount: number): number => Math.round(amount * 100) / 100;
+
+// measure and vatRate only exist to give the walkthrough form realistic column
+// types; leasePosition has no fields for them.
+function positionFromItem(
+  lease: string,
+  unitLabel: string | null | undefined,
+  item: RecordedPositionItem,
+) {
+  return {
+    lease,
+    art: item.kind,
+    ...(unitLabel && { einheit: unitLabel }),
+    betrag: {
+      amount: roundToCents(item.unitPrice.amount * item.quantity),
+      currency: item.unitPrice.currency,
+    },
+    gueltigVon: item.validFrom,
+    ...(item.validTo && { gueltigBis: item.validTo }),
+  };
+}
+
+export const rentalFeature = defineFeature("rental", (r) => {
+  r.translations({ keys: toKeyFirst(rentalTranslations) });
+
+  r.crud("lease", leaseEntity, { write: open, read: open });
+  r.crud("leasePosition", leasePositionEntity, { write: open, read: open });
+  r.crud("leaseParty", leasePartyEntity, { write: open, read: open });
+
+  r.queryHandler(
+    "lease:akte",
+    idPayloadSchema,
+    async (query, ctx) => {
+      const row = await leaseExecutor.detail({ id: query.payload.id }, query.user, ctx.db);
+      if (!row) return failNotFound("lease", query.payload.id);
+      const lease = parseLeaseRow(row);
+      const countChildren = async (executor: typeof positionExecutor): Promise<number> => {
+        const page = await executor.list(
+          { filter: { field: "lease", op: "eq", value: lease.id }, limit: 1, totalCount: true },
+          query.user,
+          ctx.db,
+        );
+        return page.total ?? page.rows.length;
+      };
+      return {
+        id: lease.id,
+        mieter: lease.mieter,
+        statusLabel: germanStatusLabel(lease.status),
+        grundmiete: formatGermanMoney(lease.grundmiete),
+        beginn: formatGermanDate(lease.beginn),
+        kuendigungsfrist: lease.kuendigungsfrist ?? "",
+        zahltag: lease.zahltag != null ? `Tag ${lease.zahltag}` : "",
+        einheit: lease.einheit ?? "",
+        liegenschaft: lease.liegenschaft ?? "",
+        ende: "",
+        kontostand: "0,00 €",
+        notizen: "",
+        partyCount: await countChildren(partyExecutor),
+        positionCount: await countChildren(positionExecutor),
+      };
+    },
+    open,
+  );
+
+  r.queryHandler(
+    "lease:positions",
+    idPayloadSchema,
+    async (query, ctx) => {
+      const page = await positionExecutor.list(
+        { filter: { field: "lease", op: "eq", value: query.payload.id }, limit: 100 },
+        query.user,
+        ctx.db,
+      );
+      return {
+        rows: page.rows.map((row) => {
+          const position = positionListRowSchema.parse(row);
+          return {
+            id: position.id,
+            art: position.art,
+            einheit: position.einheit ?? "",
+            betrag: formatGermanMoney(position.betrag),
+            betragWert: position.betrag,
+            gueltigVonIso: position.gueltigVon.toString(),
+            gueltigVon: formatGermanDate(position.gueltigVon),
+            gueltigBis: position.gueltigBis ? formatGermanDate(position.gueltigBis) : "–",
+          };
+        }),
+      };
+    },
+    open,
+  );
+
+  r.queryHandler(
+    "lease:kennzahlen",
+    z.object({}),
+    async () => ({
+      debt: "123.456 €",
+      debtSub: "nach 10 Jahren",
+      debtDelta: "15 %",
+      debtDeltaDirection: "down",
+      rent: "48.200 €",
+      rentSub: "319 Verträge",
+    }),
+    open,
+  );
+
+  r.writeHandler(
+    "lease:terminate",
+    idPayloadSchema,
+    async (event, ctx) =>
+      leaseExecutor.update(
+        {
+          id: event.payload.id,
+          changes: { status: "terminated", ende: ctx.tz.today(ctx.tz.tenant).toString() },
+        },
+        event.user,
+        ctx.db,
+        { skipOptimisticLock: true },
+      ),
+    open,
+  );
+
+  r.writeHandler(
+    "lease:record-positions",
+    recordPositionsPayloadSchema,
+    async (event, ctx) => {
+      let created: Awaited<ReturnType<typeof positionExecutor.create>> | undefined;
+      const unitLabels = new Map<string, string | null | undefined>();
+      for (const unitId of new Set(event.payload.items.map((item) => item.unit))) {
+        const unitRow = await leaseExecutor.detail({ id: unitId }, event.user, ctx.db);
+        if (!unitRow) return failNotFound("lease", unitId);
+        unitLabels.set(unitId, parseLeaseRow(unitRow).einheit);
+      }
+      for (const item of event.payload.items) {
+        created = await positionExecutor.create(
+          positionFromItem(event.payload.lease, unitLabels.get(item.unit), item),
+          event.user,
+          ctx.db,
+        );
+        if (!created.isSuccess) return created;
+      }
+      return created ?? failNotFound("leasePosition", event.payload.lease);
+    },
+    open,
+  );
+
+  r.writeHandler(
+    "rent:adjust",
+    rentAdjustPayloadSchema,
+    async (event, ctx) => {
+      const { positionId, wirksamAb, neuerBetrag } = event.payload;
+      const current = await positionExecutor.detail({ id: positionId }, event.user, ctx.db);
+      if (!current) return failNotFound("leasePosition", positionId);
+      const position = positionRowSchema.parse(current);
+
+      const endOld = await positionExecutor.update(
+        { id: positionId, changes: { gueltigBis: dayBefore(wirksamAb) } },
+        event.user,
+        ctx.db,
+        { skipOptimisticLock: true },
+      );
+      if (!endOld.isSuccess) return endOld;
+
+      const startNew = await positionExecutor.create(
+        {
+          lease: position.lease,
+          art: position.art,
+          einheit: position.einheit ?? "",
+          betrag: neuerBetrag,
+          gueltigVon: wirksamAb,
+        },
+        event.user,
+        ctx.db,
+      );
+      if (!startNew.isSuccess) return startNew;
+
+      return leaseExecutor.update(
+        { id: position.lease, changes: { grundmiete: neuerBetrag } },
+        event.user,
+        ctx.db,
+        { skipOptimisticLock: true },
+      );
+    },
+    open,
+  );
+
+  r.screen(leaseListScreen);
+  r.screen(leaseListShortScreen);
+  r.screen(leaseEditScreen);
+  r.screen(positionEditScreen);
+  r.screen(partyEditScreen);
+  r.screen(leaseDetailScreen);
+  r.screen(leaseHubScreen);
+  r.screen(rentalDashboardScreen);
+  r.screen(adjustRentScreen);
+  r.screen(recordPositionsScreen);
+
+  r.nav({
+    id: "contracts",
+    label: i18nKey("rental.nav.contracts"),
+    order: 30,
+  });
+  r.nav({
+    id: "lease-list",
+    label: i18nKey("rental.nav.leases"),
+    parent: "rental:nav:contracts",
+    screen: "rental:screen:lease-list",
+    order: 10,
+  });
+  r.nav({
+    id: "rental-dashboard",
+    label: i18nKey("rental.nav.dashboard"),
+    parent: "rental:nav:contracts",
+    screen: "rental:screen:rental-dashboard",
+    order: 20,
+  });
+});