@cosmicdrift/kumiko-samples 0.377.0 → 0.379.0

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

@@ -0,0 +1,19 @@
+import { fieldToZod, withFormDerivations } from "@cosmicdrift/kumiko-framework/engine";
+import { z } from "zod";
+import { receiveInvoiceLines, receiveInvoiceScreen } from "./screens";
+
+const moneyPayload = z.object({ amount: z.number(), currency: z.string().min(1) });
+
+// Totals are recomputed from the lines before validation, so a client-sent
+// total never reaches the handler.
+export const receiveInvoicePayloadSchema = withFormDerivations(
+  z.object({
+    supplier: z.string().min(1),
+    invoiceNumber: z.string().min(1),
+    lines: fieldToZod(receiveInvoiceLines, ["EUR"]),
+    netTotal: moneyPayload,
+    vatTotal: moneyPayload,
+    grossTotal: moneyPayload,
+  }),
+  receiveInvoiceScreen,
+);

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,8 +15,34 @@ 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.
+export const propertyExposePayloadSchema = z.object({
+  propertyAddress: z.string().min(1),
+  propertySummary: z.string().min(1),
+  photos: z.array(z.uuid()).max(10),
+});
+
+// Walkthrough shortcut, not the pattern: real screens resolve FileRefs from the record, never from route-supplied ids.
+export const fileRefIdsPayloadSchema = z.object({
+  id: z
+    .string()
+    .transform((raw) => raw.split(","))
+    .pipe(z.array(z.uuid()).min(1).max(10)),
+});
+
 export const rentAdjustPayloadSchema = z.object({
   positionId: z.uuid(),
   wirksamAb: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),

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

@@ -1,12 +1,17 @@
 export const RENTAL_QUERIES = {
   leaseAkte: "rental:query:lease:akte",
+  leaseUnterlagen: "rental:query:lease:unterlagen",
   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 = {
   leaseTerminate: "rental:write:lease:terminate",
   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 } };
+};

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

@@ -1,6 +1,8 @@
 import {
   createDateField,
   createEmbeddedListField,
+  createFilesField,
+  createNumberField,
   createSelectField,
   createTextField,
 } from "@cosmicdrift/kumiko-framework/engine";
@@ -11,6 +13,7 @@ import type {
   EntityListScreenDefinition,
   ProjectionDetailScreenDefinition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
+import { RECEIPT_ACCEPT } from "./entities";
 import { PAYMENT_METHODS, POSITION_KINDS, POSITION_MEASURES } from "./lease-support";
 import { RENTAL_QUERIES, RENTAL_WRITES } from "./qualified-names";
 
@@ -361,10 +364,50 @@ export const rentalDashboardScreen: DashboardScreenDefinition = {
       valueField: "rent",
       subField: "rentSub",
     },
+    {
+      kind: "text",
+      id: "profile-hint",
+      label: "rental.dashboard.profileHint.title",
+      blocks: [
+        { kind: "paragraph", text: "rental.dashboard.profileHint.text" },
+        {
+          kind: "link",
+          text: "rental.dashboard.profileHint.link",
+          screen: "management-profile",
+          roles: ["Admin"],
+        },
+      ],
+    },
   ],
   access: OPEN_ACCESS,
 };
 
+export const managementProfileScreen: ActionFormScreenDefinition = {
+  id: "management-profile",
+  type: "actionForm",
+  handler: RENTAL_WRITES.managementProfileSave,
+  load: { query: RENTAL_QUERIES.managementProfile, singleton: true },
+  fields: {
+    name: createTextField({ personal: false, reason: "is_business_data", required: true }),
+    anschrift: createTextField({ personal: false, reason: "is_business_data" }),
+    zahlungsziel: createNumberField({ integer: true, required: true }),
+  },
+  fieldLabels: {
+    name: "rental:entity:__action-form__:field:profileName",
+    anschrift: "rental:entity:__action-form__:field:anschrift",
+    zahlungsziel: "rental:entity:__action-form__:field:zahlungsziel",
+  },
+  layout: {
+    sections: [
+      {
+        description: "rental.managementProfile.hint",
+        fields: ["name", "anschrift", "zahlungsziel"],
+      },
+    ],
+  },
+  access: OPEN_ACCESS,
+};
+
 export const adjustRentScreen: ActionFormScreenDefinition = {
   id: "adjust-rent",
   type: "actionForm",
@@ -462,6 +505,63 @@ export const recordPositionsScreen: ActionFormScreenDefinition = {
   access: OPEN_ACCESS,
 };
 
+const EUR = { kind: "literal", code: "EUR" } as const;
+
+export const receiveInvoiceLines = createEmbeddedListField(
+  {
+    description: { type: "text", required: true },
+    amount: { type: "money", required: true },
+    vatRate: { type: "decimal", scale: 2, required: true },
+    vatAmount: { type: "money" },
+  },
+  {
+    minItems: 1,
+    derived: { vatAmount: { op: "percent", from: ["amount", "vatRate"] } },
+    totals: [
+      { label: "rental.total.net", from: ["amount"] },
+      { label: "rental.total.vat", from: ["vatAmount"] },
+      { label: "rental.total.gross", from: ["amount", "vatAmount"] },
+    ],
+  },
+);
+
+export const receiveInvoiceScreen: ActionFormScreenDefinition = {
+  id: "receive-invoice",
+  type: "actionForm",
+  handler: RENTAL_WRITES.invoiceReceive,
+  fields: {
+    supplier: createTextField({ personal: "tenant", find: "none", required: true }),
+    invoiceNumber: createTextField({
+      personal: false,
+      reason: "is_business_data",
+      required: true,
+    }),
+    lines: receiveInvoiceLines,
+    netTotal: { type: "money", currency: EUR },
+    vatTotal: { type: "money", currency: EUR },
+    grossTotal: { type: "money", currency: EUR },
+  },
+  derive: {
+    netTotal: { op: "listSum", list: "lines", cell: "amount" },
+    vatTotal: { op: "listSum", list: "lines", cell: "vatAmount" },
+    grossTotal: { op: "sum", from: ["netTotal", "vatTotal"] },
+  },
+  layout: {
+    width: "full",
+    sections: [
+      { fields: ["supplier", "invoiceNumber"] },
+      {
+        title: "rental.section.invoiceLines",
+        description: "rental.section.invoiceLines.description",
+        columns: 1,
+        fields: ["lines"],
+      },
+    ],
+  },
+  submitLabel: "rental.action.receiveInvoice",
+  access: OPEN_ACCESS,
+};
+
 // Fixtures for the UI-gap screenshots: a confirm-gated primary action that is
 // visible only while the lease is active (a terminated lease falls back to edit
 // as the main button), and a list that is empty because of its default filter.
@@ -518,3 +618,59 @@ export const leaseSuccessionListScreen: EntityListScreenDefinition = {
   rowActions: [openLeaseDetail],
   access: OPEN_ACCESS,
 };
+
+export const leaseUnterlagenScreen: ProjectionDetailScreenDefinition = {
+  id: "lease-unterlagen",
+  type: "projectionDetail",
+  dormant: true,
+  query: RENTAL_QUERIES.leaseUnterlagen,
+  recordTitleField: "titel",
+  fieldLabels: { unterlagen: "rental.unterlagen.label" },
+  layout: {
+    sections: [
+      {
+        title: "rental.unterlagen.section",
+        description: "rental.unterlagen.sectionDescription",
+        icon: "file",
+        fields: [{ field: "unterlagen", renderer: { format: "file" } }],
+      },
+    ],
+  },
+  access: OPEN_ACCESS,
+};
+
+export const uploadReceiptsScreen: ActionFormScreenDefinition = {
+  id: "upload-standard-layout",
+  type: "actionForm",
+  description: "rental.upload.screenDescription",
+  handler: RENTAL_WRITES.receiptsUpload,
+  fields: {
+    belege: createFilesField({
+      personal: false,
+      reason: "is_business_data",
+      accept: RECEIPT_ACCEPT,
+      maxSize: "10MB",
+      maxCount: 10,
+      display: "dropzone",
+    }),
+  },
+  fieldLabels: { belege: "rental:entity:__action-form__:field:belege" },
+  layout: {
+    sections: [
+      {
+        icon: "upload",
+        title: "rental.upload.zoneTitle",
+        description: "rental.upload.description",
+        fields: ["belege"],
+      },
+    ],
+  },
+  submitLabel: "rental.upload.submit",
+  successFacts: [
+    { field: "count", label: "rental.upload.factCount" },
+    { field: "belege", label: "rental.upload.factFiles" },
+  ],
+  resetOnSuccess: true,
+  cancelTarget: false,
+  access: OPEN_ACCESS,
+};

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

@@ -0,0 +1,103 @@
+import {
+  createBillingFoundationFeature,
+  type ProviderPrice,
+  type SubscriptionProviderPlugin,
+} from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
+import { defineFeature, i18nKey } from "@cosmicdrift/kumiko-framework/engine";
+import { toKeyFirst } from "../translations";
+import { subscriptionPlansTranslations } from "./i18n";
+
+export const PLAN_PROVIDER = "nordlicht-mock-provider";
+export const PLAN_TERMS_SLUG = "portal-terms";
+const PLAN_PATH = "/billing-plans";
+
+const PRICE_IDS = { starter: "price_portal_starter", pro: "price_portal_professional" };
+
+const PRICES: readonly ProviderPrice[] = [
+  {
+    priceId: PRICE_IDS.starter,
+    unitAmount: 1900,
+    currency: "eur",
+    interval: "month",
+    intervalCount: 1,
+    active: true,
+    metadata: {},
+  },
+  {
+    priceId: PRICE_IDS.pro,
+    unitAmount: 4900,
+    currency: "eur",
+    interval: "month",
+    intervalCount: 1,
+    active: true,
+    metadata: {},
+  },
+];
+
+// The sample talks to no payment provider: prices are fixed and checkout just returns to the plans screen.
+const mockProvider: SubscriptionProviderPlugin = {
+  verifyAndParseWebhook: async (rawBody) => JSON.parse(rawBody),
+  priceToTier: { [PRICE_IDS.starter]: "starter", [PRICE_IDS.pro]: "pro" },
+  retrievePrices: async (_ctx, priceIds) => PRICES.filter((p) => priceIds.includes(p.priceId)),
+  createCheckoutSession: async (_ctx, options) => ({ url: options.successUrl }),
+  cancelSubscription: async () => {},
+};
+
+export function createPortalBillingFeature(baseUrl: string) {
+  return createBillingFoundationFeature({
+    baseUrl,
+    catalog: {
+      plans: ["starter", "pro"],
+      tierLabelKey: (tier) => `subscription-plans:plan.${tier}.label`,
+      benefits: (tier) => [
+        { labelKey: `subscription-plans:plan.${tier}.benefit.units` },
+        { labelKey: `subscription-plans:plan.${tier}.benefit.support` },
+      ],
+      resolveCurrentTier: async () => "free",
+      viewRoles: ["TenantAdmin", "SystemAdmin"],
+      successPath: PLAN_PATH,
+      cancelPath: PLAN_PATH,
+      providerName: PLAN_PROVIDER,
+      contact: {
+        labelKey: "subscription-plans:plan.portfolio.label",
+        benefits: [{ labelKey: "subscription-plans:plan.portfolio.benefit" }],
+        actionLabelKey: "subscription-plans:plan.portfolio.action",
+        href: "mailto:vertrieb@nordlicht-immobilien.de",
+      },
+    },
+    consumerProtection: {
+      termsTextBlock: PLAN_TERMS_SLUG,
+      vatNote: { de: "Preise inkl. USt.", en: "Prices include VAT." },
+      operatorEmail: "abrechnung@nordlicht-immobilien.de",
+      legalLinks: {
+        de: {
+          terms: "https://nordlicht-immobilien.de/agb",
+          withdrawal: "https://nordlicht-immobilien.de/widerruf",
+          privacy: "https://nordlicht-immobilien.de/datenschutz",
+        },
+        en: {
+          terms: "https://nordlicht-immobilien.de/terms",
+          withdrawal: "https://nordlicht-immobilien.de/withdrawal",
+          privacy: "https://nordlicht-immobilien.de/privacy",
+        },
+      },
+    },
+  });
+}
+
+// Named after the screen it opens: "billing" already belongs to the invoice mails.
+export const subscriptionPlansFeature = defineFeature("subscription-plans", (r) => {
+  r.describe("Plan overview of the tenant admin: nav entry, plan labels and the mock provider.");
+  r.requires({ features: ["billing-foundation"] });
+  r.translations({ keys: toKeyFirst(subscriptionPlansTranslations) });
+  r.useExtension("subscriptionProvider", PLAN_PROVIDER, mockProvider);
+  r.nav({
+    id: "subscription-plans",
+    label: i18nKey("subscription-plans.nav.plans"),
+    icon: "file",
+    screen: "billing-foundation:screen:billing-plans",
+    order: 50,
+    access: { roles: ["TenantAdmin", "SystemAdmin"] },
+  });
+  return {};
+});

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

@@ -0,0 +1,36 @@
+import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
+
+export const subscriptionPlansTranslations: TranslationsByLocale = {
+  de: {
+    "subscription-plans.nav.plans": "Tarif und Abrechnung",
+    "subscription-plans:plan.free.label": "Basis",
+    "subscription-plans:plan.free.benefit.units": "Bis zu 3 Wohneinheiten",
+    "subscription-plans:plan.free.benefit.support": "Hilfe-Center",
+    "subscription-plans:plan.starter.label": "Starter",
+    "subscription-plans:plan.starter.benefit.units": "Bis zu 25 Wohneinheiten",
+    "subscription-plans:plan.starter.benefit.support": "Support per E-Mail",
+    "subscription-plans:plan.pro.label": "Professional",
+    "subscription-plans:plan.pro.benefit.units": "Bis zu 150 Wohneinheiten",
+    "subscription-plans:plan.pro.benefit.support": "Telefonischer Support",
+    "subscription-plans:plan.portfolio.label": "Portfolio",
+    "subscription-plans:plan.portfolio.benefit":
+      "Größere Bestände mit individuellen Konditionen und festem Ansprechpartner",
+    "subscription-plans:plan.portfolio.action": "Vertrieb kontaktieren",
+  },
+  en: {
+    "subscription-plans.nav.plans": "Plan and billing",
+    "subscription-plans:plan.free.label": "Basic",
+    "subscription-plans:plan.free.benefit.units": "Up to 3 residential units",
+    "subscription-plans:plan.free.benefit.support": "Help center",
+    "subscription-plans:plan.starter.label": "Starter",
+    "subscription-plans:plan.starter.benefit.units": "Up to 25 residential units",
+    "subscription-plans:plan.starter.benefit.support": "Support by email",
+    "subscription-plans:plan.pro.label": "Professional",
+    "subscription-plans:plan.pro.benefit.units": "Up to 150 residential units",
+    "subscription-plans:plan.pro.benefit.support": "Support by phone",
+    "subscription-plans:plan.portfolio.label": "Portfolio",
+    "subscription-plans:plan.portfolio.benefit":
+      "Larger portfolios with individual terms and a dedicated contact",
+    "subscription-plans:plan.portfolio.action": "Contact sales",
+  },
+};

package/samples/apps/ui-walkthrough/src/features/subscription-plans/index.ts

@@ -0,0 +1,2 @@
+export { createPortalBillingFeature, subscriptionPlansFeature } from "./feature";
+export { seedPlanTerms } from "./seed";

package/samples/apps/ui-walkthrough/src/features/subscription-plans/seed.ts

@@ -0,0 +1,21 @@
+import { seedTextBlock } from "@cosmicdrift/kumiko-bundled-features/template-resolver/seeding";
+import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
+import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
+import { PLAN_TERMS_SLUG } from "./feature";
+
+const TERMS_BY_LOCALE: Readonly<Record<string, string>> = {
+  de: "Diese Bedingungen gelten für alle kostenpflichtigen Tarife des Nordlicht Mieterportals. Der Vertrag läuft monatlich und ist zum Ende des Abrechnungszeitraums kündbar.",
+  en: "These terms apply to every paid plan of the Nordlicht tenant portal. The contract renews monthly and can be terminated at the end of the billing period.",
+};
+
+export const seedPlanTerms: SeedFn = async (stack) => {
+  for (const [locale, content] of Object.entries(TERMS_BY_LOCALE)) {
+    await seedTextBlock(stack.db, {
+      tenantId: SYSTEM_TENANT_ID,
+      slug: PLAN_TERMS_SLUG,
+      locale,
+      title: "Nutzungsbedingungen",
+      content,
+    });
+  }
+};

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

@@ -9,6 +9,10 @@ export const tasksTranslations: TranslationsByLocale = {
     "tasks.assistant.label": "Assistent",
     "tasks.assistant.description": "Der Assistent ist im Walkthrough nicht angebunden.",
     "tasks.assistant.close": "Schließen",
+    "tasks.help.label": "Hilfe",
+    "tasks.help.description": "Kurzhilfe zur aktuellen Seite.",
+    "tasks.help.body":
+      "Die Seite bleibt bedienbar: Sie rückt neben das Hilfefenster, statt darunter zu verschwinden.",
     "tasks.nav.group": "Allgemein",
     "tasks.nav.list": "Aufgaben",
     "tasks.nav.new": "Neue Aufgabe",
@@ -29,6 +33,10 @@ export const tasksTranslations: TranslationsByLocale = {
     "tasks.assistant.label": "Assistant",
     "tasks.assistant.description": "The assistant is not connected in the walkthrough.",
     "tasks.assistant.close": "Close",
+    "tasks.help.label": "Help",
+    "tasks.help.description": "Quick help for the current page.",
+    "tasks.help.body":
+      "The page stays usable: it moves next to the help panel instead of disappearing under it.",
     "tasks.nav.group": "General",
     "tasks.nav.list": "Tasks",
     "tasks.nav.new": "New task",

package/samples/apps/ui-walkthrough/src/run-config.ts

@@ -4,14 +4,22 @@
 // from here — migration and runtime cannot drift.
 
 import { createAuditFeature } from "@cosmicdrift/kumiko-bundled-features/audit";
+import { AuthMailNotificationTypes } from "@cosmicdrift/kumiko-bundled-features/auth-email-password";
 import {
   createChannelEmailFeature,
   createInMemoryTransport,
 } from "@cosmicdrift/kumiko-bundled-features/channel-email";
+import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
 import { createDeliveryFeature } from "@cosmicdrift/kumiko-bundled-features/delivery";
+import { createFilesFeature } from "@cosmicdrift/kumiko-bundled-features/files";
 import { createManagedPagesFeature } from "@cosmicdrift/kumiko-bundled-features/managed-pages";
 import { createRendererFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/renderer-foundation";
-import { createTemplateResolverFeature } from "@cosmicdrift/kumiko-bundled-features/template-resolver";
+import {
+  createTemplateResolverFeature,
+  type TenantEditableTemplate,
+  templateEditAccess,
+} from "@cosmicdrift/kumiko-bundled-features/template-resolver";
+import { createTenantLifecycleFeature } from "@cosmicdrift/kumiko-bundled-features/tenant-lifecycle";
 import { createDocumentDesignerFeature } from "@cosmicdrift/kumiko-document-designer";
 import { localeDe } from "@cosmicdrift/kumiko-locale-de";
 import { localeEs } from "@cosmicdrift/kumiko-locale-es";
@@ -20,9 +28,34 @@ import { createRendererPuppeteerClientFeature } from "@cosmicdrift/kumiko-render
 import { TENANT_ADMIN_EMAIL } from "./app/auth-constants";
 import { billingFeature } from "./features/billing";
 import { rentalFeature } from "./features/rental";
+import {
+  createPortalBillingFeature,
+  subscriptionPlansFeature,
+} from "./features/subscription-plans";
 import { taskFeature } from "./features/tasks";
 import { vehiclesFeature } from "./features/vehicles";
 
+// The walkthrough shows the tenant admin editing these templates; every other template stays with the platform.
+const TENANT_EDITABLE_TEMPLATES: readonly TenantEditableTemplate[] = [
+  ...[
+    "billing:notify:invoice-issued",
+    "billing:notify:invoice-corrected",
+    "billing:notify:payment-reminder",
+    "billing:notify:terms-changed",
+    AuthMailNotificationTypes.passwordReset,
+  ].map((slug) => ({ kind: "mail" as const, slug, access: { roles: ["TenantAdmin"] } })),
+  ...["billing:invoice", "rental:utility-statement"].map((slug) => ({
+    kind: "document-pdf" as const,
+    slug,
+    access: { roles: ["TenantAdmin"] },
+  })),
+  ...(["mail-layout", "pdf-layout"] as const).map((kind) => ({
+    kind,
+    slug: "default",
+    access: { roles: ["TenantAdmin"] },
+  })),
+];
+
 export const APP_FEATURES = [
   localeDe(),
   // Spanish mail copy: subscribers whose mails go out in Spanish land on Spanish unsubscribe pages.
@@ -31,11 +64,18 @@ export const APP_FEATURES = [
   rentalFeature,
   vehiclesFeature,
   billingFeature,
-  createTemplateResolverFeature(),
+  createPortalBillingFeature(`http://localhost:${process.env["PORT"] ?? "4173"}`),
+  subscriptionPlansFeature,
+  // billing-foundation stores the subscription as tenant data and keeps the compliance profile.
+  createComplianceProfilesFeature(),
+  createTenantLifecycleFeature(),
+  createTemplateResolverFeature({ tenantEditable: TENANT_EDITABLE_TEMPLATES }),
   // Only the branding rail of the layout editor needs managed-pages; the sample
   // serves no public pages, so no host resolves to a tenant.
   createManagedPagesFeature({ resolveApexTenant: () => null }),
-  createDocumentDesignerFeature(),
+  // The mail editor offers uploads only when the files feature is mounted.
+  createFilesFeature(),
+  createDocumentDesignerFeature({ access: templateEditAccess(TENANT_EDITABLE_TEMPLATES) }),
   // Mounted individually: composeRendererStack() would add a second template-resolver.
   createRendererFoundationFeature(),
   createRendererMailHtmlFeature({

package/samples/apps/use-all-bundled/e2e-billing-gallery/server.ts

@@ -72,7 +72,7 @@ await runDevApp({
   },
   extraContext: (deps) => ({
     ...createDeliveryTestContext(deps),
-    templateResolver: createTemplateResolverApi(deps.db),
+    templateResolver: createTemplateResolverApi(deps.db, deps.registry),
   }),
   extraRoutes: [
     ...createE2eSeedRoutes({ mailOutbox: galleryMailTransport }),