@cosmicdrift/kumiko-samples 0.378.0 → 0.379.0

package/packages/bundled-features/src/waitlist/payloads.ts

@@ -1,6 +1,6 @@
 import { canonicalizeLocaleTag, isValidLocaleTag } from "@cosmicdrift/kumiko-framework/i18n";
 import * as z from "zod";
-import { WAITLIST_FIELD_LIMITS } from "./constants.ts";
+import { WAITLIST_FIELD_LIMITS } from "./web/constants.ts";
 
 // Submitted text lands in a mail subject; CR/LF there would allow header injection.
 const NO_CONTROL_CHARS = /^\P{Cc}*$/u;

package/packages/bundled-features/src/waitlist/screens.ts

@@ -1,6 +1,6 @@
 import { type EntityListScreenDefinition, i18nKey } from "@cosmicdrift/kumiko-framework/engine";
-import { WAITLIST_STATUS, WaitlistHandlers } from "./constants.ts";
 import { adminAccess } from "./lib.ts";
+import { WAITLIST_STATUS, WaitlistHandlers } from "./web/constants.ts";
 
 export const waitlistListScreen: EntityListScreenDefinition = {
   id: "waitlist-list",

package/packages/bundled-features/src/waitlist/{constants.ts → web/constants.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // Pure string constants, safe for browser code (see auth-email-password/constants.ts).
 export const WAITLIST_FEATURE = "waitlist" as const;
 

package/samples/apps/styleguide/src/features/content/web.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 // Client-Seite des Content-Stresstests: der navProvider hängt sich an den
 // statischen `content`-Nav-Knoten (QN "content:nav:content"), lädt die Seiten
 // per /api/query und emittiert sie als Tree-Leaves. navEntities ["page"]

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

@@ -2,6 +2,7 @@
 // übergibt Shell + clientFeatures an createKumikoApp.
 
 import { emailPasswordClient } from "@cosmicdrift/kumiko-bundled-features/auth-email-password/web";
+import { billingFoundationClient } from "@cosmicdrift/kumiko-bundled-features/billing-foundation/web";
 import { textBlocksClient } from "@cosmicdrift/kumiko-bundled-features/template-resolver/web";
 import { documentDesignerClient } from "@cosmicdrift/kumiko-document-designer/web";
 import { localeDeClient } from "@cosmicdrift/kumiko-locale-de/web";
@@ -21,6 +22,7 @@ createKumikoApp({
     rentalClient,
     vehiclesClient,
     billingClient,
+    billingFoundationClient(),
     textBlocksClient(),
     documentDesignerClient(),
   ],

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

@@ -5,7 +5,12 @@ import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
 import { createTenantDb } from "@cosmicdrift/kumiko-framework/db";
 import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { countRowsForTenant } from "../db/queries/row-counts";
-import { leaseExecutor, partyExecutor, positionExecutor } from "../features/rental/lease-support";
+import {
+  leaseExecutor,
+  managementProfileExecutor,
+  partyExecutor,
+  positionExecutor,
+} from "../features/rental/lease-support";
 
 type BoardLease = {
   readonly mieter: string;
@@ -269,4 +274,15 @@ export const seedRental: SeedFn = async (stack) => {
     db,
   );
   if (!position.isSuccess) throw new Error("seed position failed");
+
+  const profile = await managementProfileExecutor.create(
+    {
+      name: "Nordlicht Immobilien GmbH",
+      anschrift: "Hafenstraße 12, 24103 Kiel",
+      zahlungsziel: 14,
+    },
+    TestUsers.admin,
+    db,
+  );
+  if (!profile.isSuccess) throw new Error("seed management profile failed");
 };

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

@@ -212,6 +212,17 @@ export const seedTemplates: SeedFn = async (stack) => {
   await upsertTenant(INVOICE_CORRECTED_DRAFT, "draft");
   for (const reminder of PAYMENT_REMINDER_TEMPLATES) await upsertTenant(reminder, "active");
   await upsertTenant(TENANT_UTILITY_STATEMENT, "active");
+  // The platform admin adapted the Exposé for Nordlicht, but the template is not unlocked for
+  // tenants, so the stored copy is not delivered; the SystemAdmin overview flags it.
+  await upsert(
+    TemplateResolverHandlers.upsertTenant,
+    {
+      ...SYSTEM_PROPERTY_EXPOSE,
+      content: SYSTEM_PROPERTY_EXPOSE.content.replace("Exposé", "Objektexposé"),
+    },
+    platformAdmin,
+    { status: "active" },
+  );
 
   // Other tenants with their own invoice copy: what the SystemAdmin sees in the overrides drawer.
   for (const override of TENANT_INVOICE_OVERRIDES) {

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

@@ -13,6 +13,7 @@ import { createUnsubscribeRoutes } from "@cosmicdrift/kumiko-bundled-features/de
 import { runDevApp } from "@cosmicdrift/kumiko-dev-server";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
 import { createInMemoryFileProvider } from "@cosmicdrift/kumiko-framework/files";
+import { seedPlanTerms } from "../features/subscription-plans";
 import { APP_FEATURES } from "../run-config";
 import {
   ADMIN_EMAIL,
@@ -34,7 +35,7 @@ import { seedVehicles } from "./seed-vehicles";
 
 await runDevApp({
   features: [...APP_FEATURES],
-  seeds: [seedTasks, seedRental, seedVehicles, seedTemplates],
+  seeds: [seedTasks, seedRental, seedVehicles, seedTemplates, seedPlanTerms],
   // 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),

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

@@ -66,16 +66,44 @@ const INVOICE_ISSUED_VARIABLES = {
 } as const;
 
 const PAYMENT_REMINDER_VARIABLES = {
-  customerName: templateVariable.text({ required: true }),
-  invoiceNumber: templateVariable.text({ required: true }),
-  amount: templateVariable.money({ required: true }),
-  dueDate: templateVariable.date({ required: true }),
-  invoiceUrl: templateVariable.link({ required: true }),
+  customerName: templateVariable.text({
+    label: "billing:mail.variable.customerName",
+    required: true,
+    example: "Familie Yilmaz",
+  }),
+  invoiceNumber: templateVariable.text({
+    label: "billing:mail.variable.invoiceNumber",
+    required: true,
+    example: "RE-2026-0142",
+  }),
+  amount: templateVariable.money({
+    label: "billing:mail.variable.amountDue",
+    required: true,
+    example: { amount: 128450, currency: "EUR" },
+  }),
+  dueDate: templateVariable.date({
+    label: "billing:mail.variable.dueDate",
+    required: true,
+    example: "2026-10-30",
+  }),
+  invoiceUrl: templateVariable.link({
+    label: "billing:mail.variable.invoiceUrl",
+    required: true,
+    example: "https://nordlicht-immobilien.de/rechnungen/RE-2026-0142",
+  }),
 } as const;
 
 const TERMS_CHANGED_VARIABLES = {
-  customerName: templateVariable.text({ required: true, example: "Familie Yilmaz" }),
-  effectiveDate: templateVariable.date({ required: true, example: "2026-12-01" }),
+  customerName: templateVariable.text({
+    label: "billing:mail.variable.customerName",
+    required: true,
+    example: "Familie Yilmaz",
+  }),
+  effectiveDate: templateVariable.date({
+    label: "billing:mail.variable.effectiveDate",
+    required: true,
+    example: "2026-12-01",
+  }),
 } as const;
 
 export const billingFeature = defineFeature("billing", (r) => {

package/samples/apps/ui-walkthrough/src/features/billing/i18n.ts

@@ -11,6 +11,9 @@ export const billingTranslations: TranslationsByLocale = {
     "billing:notify.payment-reminder.label": "Mahnlauf",
     "billing:notify.terms-changed.label": "AGB-Änderung",
     "billing:mail.variable.recipientName": "Empfängername",
+    "billing:mail.variable.customerName": "Kundenname",
+    "billing:mail.variable.amountDue": "Offener Betrag",
+    "billing:mail.variable.effectiveDate": "Gültig ab",
     "billing:mail.variable.recipientEmail": "Empfänger-Adresse",
     "billing:mail.variable.invoiceNumber": "Rechnungsnummer",
     "billing:mail.variable.invoiceTotal": "Rechnungsbetrag",
@@ -31,6 +34,9 @@ export const billingTranslations: TranslationsByLocale = {
     "billing:notify.payment-reminder.label": "Dunning run",
     "billing:notify.terms-changed.label": "Terms update",
     "billing:mail.variable.recipientName": "Recipient name",
+    "billing:mail.variable.customerName": "Customer name",
+    "billing:mail.variable.amountDue": "Amount due",
+    "billing:mail.variable.effectiveDate": "Effective date",
     "billing:mail.variable.recipientEmail": "Recipient address",
     "billing:mail.variable.invoiceNumber": "Invoice number",
     "billing:mail.variable.invoiceTotal": "Invoice total",

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

@@ -1,6 +1,7 @@
 import {
   createDateField,
   createEntity,
+  createFileField,
   createMoneyField,
   createNumberField,
   createSelectField,
@@ -9,6 +10,9 @@ import {
 
 const DEMO_DATA = { personal: false, reason: "is_business_data" } as const;
 
+// Server-side accept lists are extensions, not MIME types.
+export const RECEIPT_ACCEPT = ["pdf", "png", "jpg"] as const;
+
 export const LEASE_STATUSES = ["active", "terminated"] as const;
 
 export const leaseEntity = createEntity({
@@ -56,3 +60,26 @@ export const leasePartyEntity = createEntity({
     rolle: createTextField({ ...DEMO_DATA, filterable: true }),
   },
 });
+
+// A receipt keeps the uploaded file as its own record; dateiname is a copy for the success list.
+export const receiptEntity = createEntity({
+  table: "read_ui_walkthrough_receipts",
+  fields: {
+    datei: createFileField({
+      ...DEMO_DATA,
+      required: true,
+      accept: RECEIPT_ACCEPT,
+      maxSize: "10MB",
+    }),
+    dateiname: createTextField({ ...DEMO_DATA, required: true }),
+  },
+});
+
+export const managementProfileEntity = createEntity({
+  table: "read_ui_walkthrough_management_profiles",
+  fields: {
+    name: createTextField({ ...DEMO_DATA, required: true }),
+    anschrift: createTextField(DEMO_DATA),
+    zahlungsziel: createNumberField({ integer: true, required: true }),
+  },
+});

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

@@ -7,7 +7,13 @@ import {
 } from "@cosmicdrift/kumiko-renderer-puppeteer-client";
 import { z } from "zod";
 import { openToAllSignedIn, toKeyFirst } from "../translations";
-import { leaseEntity, leasePartyEntity, leasePositionEntity } from "./entities";
+import {
+  leaseEntity,
+  leasePartyEntity,
+  leasePositionEntity,
+  managementProfileEntity,
+  receiptEntity,
+} from "./entities";
 import { rentalTranslations } from "./i18n";
 import { receiveInvoicePayloadSchema } from "./invoice-receive";
 import {
@@ -18,6 +24,7 @@ import {
   germanStatusLabel,
   idPayloadSchema,
   leaseExecutor,
+  managementProfileExecutor,
   noticePeriodEnd,
   parseLeaseRow,
   partyExecutor,
@@ -28,7 +35,9 @@ import {
   type RecordedPositionItem,
   recordPositionsPayloadSchema,
   rentAdjustPayloadSchema,
+  saveManagementProfilePayloadSchema,
 } from "./lease-support";
+import { receiptsUploadPayloadSchema, uploadReceipts } from "./receipts-upload";
 import {
   adjustRentScreen,
   leaseDetailGapsScreen,
@@ -40,11 +49,13 @@ import {
   leaseListShortScreen,
   leaseSuccessionListScreen,
   leaseUnterlagenScreen,
+  managementProfileScreen,
   partyEditScreen,
   positionEditScreen,
   receiveInvoiceScreen,
   recordPositionsScreen,
   rentalDashboardScreen,
+  uploadReceiptsScreen,
 } from "./screens";
 
 export { leaseEntity, leasePartyEntity, leasePositionEntity };
@@ -237,6 +248,46 @@ export const rentalFeature = defineFeature("rental", (r) => {
     ...open,
   });
 
+  r.entity({ name: "receipt", ...receiptEntity });
+  // One row per tenant: the profile screen loads it without a record id.
+  r.entity({ name: "managementProfile", ...managementProfileEntity });
+
+  r.queryHandler({
+    name: "profile:current",
+    schema: z.object({}),
+    handler: async (query, ctx) => {
+      const page = await managementProfileExecutor.list({ limit: 1 }, query.user, ctx.db);
+      return page.rows[0] ?? null;
+    },
+    ...open,
+  });
+
+  r.writeHandler({
+    name: "profile:save",
+    schema: saveManagementProfilePayloadSchema,
+    handler: async (event, ctx) => {
+      const page = await managementProfileExecutor.list({ limit: 1 }, event.user, ctx.db);
+      const existing = page.rows[0];
+      if (existing === undefined) {
+        return managementProfileExecutor.create(event.payload, event.user, ctx.db);
+      }
+      return managementProfileExecutor.update(
+        { id: String(existing["id"]), changes: event.payload },
+        event.user,
+        ctx.db,
+        { skipOptimisticLock: true },
+      );
+    },
+    ...open,
+  });
+
+  r.writeHandler({
+    name: "receipts-upload",
+    schema: receiptsUploadPayloadSchema,
+    handler: uploadReceipts,
+    ...open,
+  });
+
   r.writeHandler({
     name: "invoice:receive",
     schema: receiveInvoicePayloadSchema,
@@ -314,12 +365,8 @@ export const rentalFeature = defineFeature("rental", (r) => {
   r.screen(recordPositionsScreen);
   r.screen(receiveInvoiceScreen);
   r.screen(leaseUnterlagenScreen);
-  r.screen({
-    id: "upload-standard-layout",
-    type: "custom",
-    renderer: { react: { __component: "upload-standard-layout" } },
-    description: "Receipt upload on the standard form screen layout.",
-  });
+  r.screen(uploadReceiptsScreen);
+  r.screen(managementProfileScreen);
 
   r.nav({
     id: "contracts",
@@ -340,6 +387,13 @@ export const rentalFeature = defineFeature("rental", (r) => {
     screen: "rental:screen:rental-dashboard",
     order: 20,
   });
+  r.nav({
+    id: "management-profile",
+    label: i18nKey("rental.nav.managementProfile"),
+    parent: "rental:nav:contracts",
+    screen: "rental:screen:management-profile",
+    order: 50,
+  });
   r.nav({
     id: "receive-invoice",
     label: i18nKey("rental.nav.receiveInvoice"),

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

@@ -13,14 +13,14 @@ export const rentalTranslations: TranslationsByLocale = {
     "screen:upload-standard-layout.title": "Belege hochladen",
     "rental.upload.description":
       "Laden Sie Rechnungen und Nebenkostenbelege zum Mietvertrag hoch. Danach gehen sie zur Prüfung.",
+    "rental.upload.screenDescription": "Belege hochladen; sie werden dem Vorgang zugeordnet.",
     "rental.upload.zoneTitle": "Belege auswählen",
-    "rental.upload.zoneDescription": "PDF oder Foto, mehrere Dateien auf einmal sind möglich.",
-    "rental.upload.dropTitle": "Rechnungen und Belege hier ablegen",
-    "rental.upload.dropHint": "PDF, JPG oder PNG",
-    "rental.upload.resultTitle": "Hochgeladene Belege",
-    "rental.upload.resultDescription": "Diese Dateien gehen mit der Prüfung an die Buchhaltung.",
-    "rental.upload.empty": "Noch keine Belege hochgeladen.",
-    "rental.upload.toReview": "Zur Prüfung",
+    "rental.upload.submit": "Zur Prüfung übernehmen",
+    "rental.upload.factCount": "Übernommene Belege",
+    "rental.upload.factFiles": "Dateien",
+    "rental.upload.unknownFile":
+      "Mindestens eine Datei gehört nicht zu Ihrem Upload. Bitte laden Sie sie erneut hoch.",
+    "rental:entity:__action-form__:field:belege": "Belege",
 
     "screen:lease-list.title": "Mietverträge",
     "screen:lease-list-short.title": "Mietverträge (gekündigt)",
@@ -30,6 +30,17 @@ export const rentalTranslations: TranslationsByLocale = {
     "screen:lease-hub.title": "Mietvertrag Hub",
     "screen:rental-dashboard.title": "Kennzahlen",
     "rental.nav.dashboard": "Kennzahlen",
+    "rental.nav.managementProfile": "Verwaltungsprofil",
+    "screen:management-profile.title": "Verwaltungsprofil",
+    "rental.managementProfile.hint":
+      "Diese Angaben erscheinen auf Mieterschreiben und Abrechnungen Ihrer Hausverwaltung.",
+    "rental:entity:__action-form__:field:profileName": "Name der Hausverwaltung",
+    "rental:entity:__action-form__:field:anschrift": "Anschrift",
+    "rental:entity:__action-form__:field:zahlungsziel": "Zahlungsziel in Tagen",
+    "rental.dashboard.profileHint.title": "Hinweis",
+    "rental.dashboard.profileHint.text":
+      "Auf Abrechnungen steht noch der Standardabsender. Hinterlegen Sie Name und Zahlungsziel Ihrer Hausverwaltung.",
+    "rental.dashboard.profileHint.link": "Verwaltungsprofil öffnen",
     "rental.dashboard.debt": "Restschuld heute",
     "rental.dashboard.rent": "Monatsmiete gesamt",
     "rental.tab.history": "Verlauf",
@@ -115,10 +126,12 @@ export const rentalTranslations: TranslationsByLocale = {
     "rental.action.recordPositions": "Positionen speichern",
     "rental.nav.receiveInvoice": "Eingangsrechnung",
     "screen:receive-invoice.title": "Eingangsrechnung erfassen",
-    "rental.section.invoiceLines": "Rechnungspositionen",
-    "rental.section.invoiceTotals": "Summen",
-    "rental.section.invoiceTotalsHint":
-      "Mit Positionen sind die Summen berechnet. Ohne Positionen tragen Sie Netto und USt.-Satz ein.",
+    "rental.section.invoiceLines": "Positionen",
+    "rental.section.invoiceLines.description":
+      "Eine Zeile pro Leistung. Netto, USt. und Brutto stehen unter der Tabelle.",
+    "rental.total.net": "Netto",
+    "rental.total.vat": "USt.",
+    "rental.total.gross": "Brutto",
     "rental.action.receiveInvoice": "Rechnung erfassen",
     "rental:entity:__action-form__:field:supplier": "Lieferant",
     "rental:entity:__action-form__:field:invoiceNumber": "Rechnungsnummer",
@@ -128,7 +141,6 @@ export const rentalTranslations: TranslationsByLocale = {
     "rental:entity:__action-form__:field:lines:cell:vatRate": "USt. in %",
     "rental:entity:__action-form__:field:lines:cell:vatAmount": "USt.",
     "rental:entity:__action-form__:field:netTotal": "Netto gesamt",
-    "rental:entity:__action-form__:field:vatRate": "USt.-Satz in %",
     "rental:entity:__action-form__:field:vatTotal": "USt. gesamt",
     "rental:entity:__action-form__:field:grossTotal": "Brutto gesamt",
     "rental:entity:__action-form__:field:lease": "Mietvertrag",
@@ -165,14 +177,14 @@ export const rentalTranslations: TranslationsByLocale = {
     "screen:upload-standard-layout.title": "Upload receipts",
     "rental.upload.description":
       "Upload invoices and service charge receipts for the lease. They then go to review.",
+    "rental.upload.screenDescription": "Upload receipts; they are attached to the record.",
     "rental.upload.zoneTitle": "Choose receipts",
-    "rental.upload.zoneDescription": "PDF or photo, several files at once are fine.",
-    "rental.upload.dropTitle": "Drop invoices and receipts here",
-    "rental.upload.dropHint": "PDF, JPG or PNG",
-    "rental.upload.resultTitle": "Uploaded receipts",
-    "rental.upload.resultDescription": "These files go to accounting with the review.",
-    "rental.upload.empty": "No receipts uploaded yet.",
-    "rental.upload.toReview": "To review",
+    "rental.upload.submit": "Send to review",
+    "rental.upload.factCount": "Receipts accepted",
+    "rental.upload.factFiles": "Files",
+    "rental.upload.unknownFile":
+      "At least one file is not part of your upload. Please upload it again.",
+    "rental:entity:__action-form__:field:belege": "Receipts",
 
     "screen:lease-list.title": "Leases",
     "screen:lease-list-short.title": "Leases (terminated)",
@@ -182,6 +194,17 @@ export const rentalTranslations: TranslationsByLocale = {
     "screen:lease-hub.title": "Lease hub",
     "screen:rental-dashboard.title": "Key figures",
     "rental.nav.dashboard": "Key figures",
+    "rental.nav.managementProfile": "Management profile",
+    "screen:management-profile.title": "Management profile",
+    "rental.managementProfile.hint":
+      "These details appear on tenant letters and statements of your property management.",
+    "rental:entity:__action-form__:field:profileName": "Property management name",
+    "rental:entity:__action-form__:field:anschrift": "Address",
+    "rental:entity:__action-form__:field:zahlungsziel": "Payment term in days",
+    "rental.dashboard.profileHint.title": "Note",
+    "rental.dashboard.profileHint.text":
+      "Statements still carry the default sender. Enter the name and payment term of your property management.",
+    "rental.dashboard.profileHint.link": "Open management profile",
     "rental.dashboard.debt": "Remaining debt today",
     "rental.dashboard.rent": "Total monthly rent",
     "rental.tab.history": "History",
@@ -264,10 +287,12 @@ export const rentalTranslations: TranslationsByLocale = {
     "rental.action.recordPositions": "Save positions",
     "rental.nav.receiveInvoice": "Incoming invoice",
     "screen:receive-invoice.title": "Record incoming invoice",
-    "rental.section.invoiceLines": "Invoice lines",
-    "rental.section.invoiceTotals": "Totals",
-    "rental.section.invoiceTotalsHint":
-      "With lines the totals are computed. Without lines, enter the net amount and the VAT rate.",
+    "rental.section.invoiceLines": "Lines",
+    "rental.section.invoiceLines.description":
+      "One row per service. Net, VAT and gross are shown below the table.",
+    "rental.total.net": "Net",
+    "rental.total.vat": "VAT",
+    "rental.total.gross": "Gross",
     "rental.action.receiveInvoice": "Record invoice",
     "rental:entity:__action-form__:field:supplier": "Supplier",
     "rental:entity:__action-form__:field:invoiceNumber": "Invoice number",
@@ -277,7 +302,6 @@ export const rentalTranslations: TranslationsByLocale = {
     "rental:entity:__action-form__:field:lines:cell:vatRate": "VAT in %",
     "rental:entity:__action-form__:field:lines:cell:vatAmount": "VAT",
     "rental:entity:__action-form__:field:netTotal": "Net total",
-    "rental:entity:__action-form__:field:vatRate": "VAT rate in %",
     "rental:entity:__action-form__:field:vatTotal": "VAT total",
     "rental:entity:__action-form__:field:grossTotal": "Gross total",
     "rental:entity:__action-form__:field:lease": "Lease",

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

@@ -12,7 +12,6 @@ export const receiveInvoicePayloadSchema = withFormDerivations(
     invoiceNumber: z.string().min(1),
     lines: fieldToZod(receiveInvoiceLines, ["EUR"]),
     netTotal: moneyPayload,
-    vatRate: z.number().optional(),
     vatTotal: moneyPayload,
     grossTotal: moneyPayload,
   }),

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

@@ -1,7 +1,12 @@
 import { createEntityExecutor } from "@cosmicdrift/kumiko-framework/engine";
 import { getTemporal } from "@cosmicdrift/kumiko-framework/time";
 import { z } from "zod";
-import { leaseEntity, leasePartyEntity, leasePositionEntity } from "./entities";
+import {
+  leaseEntity,
+  leasePartyEntity,
+  leasePositionEntity,
+  managementProfileEntity,
+} from "./entities";
 
 export const { executor: leaseExecutor } = createEntityExecutor("lease", leaseEntity);
 export const { executor: positionExecutor } = createEntityExecutor(
@@ -10,6 +15,17 @@ export const { executor: positionExecutor } = createEntityExecutor(
 );
 export const { executor: partyExecutor } = createEntityExecutor("leaseParty", leasePartyEntity);
 
+export const { executor: managementProfileExecutor } = createEntityExecutor(
+  "managementProfile",
+  managementProfileEntity,
+);
+
+export const saveManagementProfilePayloadSchema = z.object({
+  name: z.string().min(1).max(200),
+  anschrift: z.string().max(400).optional(),
+  zahlungsziel: z.number().int().min(0).max(120),
+});
+
 export const idPayloadSchema = z.object({ id: z.uuid() });
 
 // Walkthrough shortcut, not the pattern: a real handler reads the photo ids from the stored record, never from the client.

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

@@ -4,6 +4,7 @@ export const RENTAL_QUERIES = {
   partyList: "rental:query:lease-party:list",
   positionList: "rental:query:lease:positions",
   kennzahlen: "rental:query:lease:kennzahlen",
+  managementProfile: "rental:query:profile:current",
 } as const;
 
 export const RENTAL_WRITES = {
@@ -11,4 +12,6 @@ export const RENTAL_WRITES = {
   rentAdjust: "rental:write:rent:adjust",
   positionsRecord: "rental:write:lease:record-positions",
   invoiceReceive: "rental:write:invoice:receive",
+  receiptsUpload: "rental:write:receipts-upload",
+  managementProfileSave: "rental:write:profile:save",
 } as const;

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

@@ -0,0 +1,70 @@
+import { createEntityExecutor, type WriteHandlerFn } from "@cosmicdrift/kumiko-framework/engine";
+import { UnprocessableError } from "@cosmicdrift/kumiko-framework/errors";
+import {
+  bindPendingFileRef,
+  FILE_REF_ENTITY_NAME,
+  fileRefEntity,
+  loadPendingFileRef,
+} from "@cosmicdrift/kumiko-framework/files";
+import { z } from "zod";
+import { receiptEntity } from "./entities";
+
+const UPLOAD_SCREEN_QN = "rental:screen:upload-standard-layout";
+const UPLOAD_FIELD = "belege";
+
+const { executor: receiptExecutor } = createEntityExecutor("receipt", receiptEntity);
+const { executor: fileRefExecutor } = createEntityExecutor(FILE_REF_ENTITY_NAME, fileRefEntity);
+
+export const receiptsUploadPayloadSchema = z.object({
+  belege: z.array(z.uuid()).min(1).max(10),
+});
+
+const unknownFile = () =>
+  new UnprocessableError("unknown_upload", { i18nKey: "rental.upload.unknownFile" });
+
+// The form only carries file ids. Each one must be the caller's own, still unbound upload of this
+// form; everything is checked before the first receipt is written so a bad id creates nothing.
+export const uploadReceipts: WriteHandlerFn<z.infer<typeof receiptsUploadPayloadSchema>> = async (
+  event,
+  ctx,
+) => {
+  const { user, payload } = event;
+  const pendingNames: { readonly fileRefId: string; readonly fileName: string }[] = [];
+  for (const fileRefId of new Set(payload.belege)) {
+    const pending = await loadPendingFileRef({
+      fileRefId,
+      entityName: UPLOAD_SCREEN_QN,
+      fieldName: UPLOAD_FIELD,
+      user,
+      db: ctx.db,
+    });
+    if (pending === undefined) throw unknownFile();
+    // fileName is personal data and may be encrypted, so only the executor's detail returns it.
+    const row = await fileRefExecutor.detail({ id: fileRefId }, user, ctx.db);
+    if (row === null) throw unknownFile();
+    pendingNames.push({ fileRefId, fileName: String(row["fileName"]) });
+  }
+
+  const belege: { readonly label: string }[] = [];
+  for (const { fileRefId, fileName } of pendingNames) {
+    const created = await receiptExecutor.create(
+      { datei: fileRefId, dateiname: fileName },
+      user,
+      ctx.db,
+    );
+    if (!created.isSuccess) return created;
+    const outcome = await bindPendingFileRef({
+      fileRefId,
+      entityName: UPLOAD_SCREEN_QN,
+      fieldName: UPLOAD_FIELD,
+      entityId: String(created.data.id),
+      bindTo: { entityName: "receipt", fieldName: "datei" },
+      registry: ctx.registry,
+      user,
+      db: ctx.db,
+    });
+    if (outcome !== "bound") throw unknownFile();
+    belege.push({ label: fileName });
+  }
+  return { isSuccess: true, data: { count: belege.length, belege } };
+};