fix(frontend): weiße Seite bei fehlgeschlagenem Chunk-Import beheben

Alle Seiten werden per React.lazy als eigene Chunks nachgeladen. Schlug ein Import fehl (Safari: "Importing a module script failed" — z.B. nach einem Deployment mit neuen Chunk-Namen oder bei beschädigtem, wegen "Cache-Control: immutable" nie revalidiertem Browser-Cache), riss der Fehler mangels ErrorBoundary den kompletten React-Baum in eine weiße Seite. - main.tsx: Bei 'vite:preloadError' automatisch neu laden (max. 1×/Minute, sessionStorage-Guard gegen Reload-Schleifen) - AppErrorBoundary (neu): Fehlermeldung mit "Seite neu laden"-Button statt weißer Seite; bei Chunk-Ladefehlern mit Hinweis auf Cache-Leeren - App.tsx: ErrorBoundary um alle Routen gelegt Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
fix: Warteschlange blieb stehen – Altersvergleich in die DB verlagert
2026-07-27 10:20:25 +02:00 · 2026-07-22 12:07:51 +02:00 · 2026-07-22 11:10:36 +02:00 · 2026-07-22 11:03:10 +02:00 · 2026-07-14 22:46:42 +02:00 · 2026-07-14 10:55:04 +02:00
52 changed files with 2371 additions and 706 deletions
@@ -14,3 +14,6 @@ dist/

 # Docker
 docker-compose.override.yml
+
+# Secrets
+.gitea_token
@@ -13,6 +13,12 @@ Paperless Manager is a document automation platform that extends [Paperless-NGX]

 UI labels and comments are in **German**.

+## Sprache
+
+Alle Antworten an den Nutzer, Erklärungen, Commit-Messages, Code-Kommentare und UI-Texte
+sollen — wo möglich — auf **Deutsch** verfasst werden. Technische Bezeichner (Variablen-,
+Funktions- und Dateinamen) bleiben unverändert in der bestehenden Konvention.
+
 ## Structure

 ```
@@ -56,6 +56,8 @@ export class AgrarmonitorPollingService implements OnModuleInit {
    await this.upsertSetting('agrarmonitor_tag_hochgeladen', '');
    await this.upsertSetting('agrarmonitor_link_field', '');
    await this.upsertSetting('agrarmonitor_tag_manuell', '');
+    await this.upsertSetting('agrarmonitor_import_wartezeit_minuten', '10');
+    await this.upsertSetting('agrarmonitor_notiz_marker', 'Agrarmonitor');
  }

  @Cron(process.env['AGRARMONITOR_POLLING_CRON'] || '0 */30 * * * *')
@@ -80,21 +82,36 @@ export class AgrarmonitorPollingService implements OnModuleInit {
    tagHochgeladen: string;
    linkField: string;
    tagManuell: string;
+    importWartezeitMinuten: string;
+    notizMarker: string;
  }> {
-    const [fertig, verbucht, hochgeladen, linkField, manuell] =
-      await Promise.all([
-        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_fertig' }),
-        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_verbucht' }),
-        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_hochgeladen' }),
-        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_link_field' }),
-        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_manuell' }),
-      ]);
+    const [
+      fertig,
+      verbucht,
+      hochgeladen,
+      linkField,
+      manuell,
+      wartezeit,
+      marker,
+    ] = await Promise.all([
+      this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_fertig' }),
+      this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_verbucht' }),
+      this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_hochgeladen' }),
+      this.settingRepo.findOneBy({ Tag: 'agrarmonitor_link_field' }),
+      this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_manuell' }),
+      this.settingRepo.findOneBy({
+        Tag: 'agrarmonitor_import_wartezeit_minuten',
+      }),
+      this.settingRepo.findOneBy({ Tag: 'agrarmonitor_notiz_marker' }),
+    ]);
    return {
      tagFertig: fertig?.Wert ?? '4',
      tagVerbucht: verbucht?.Wert ?? '9',
      tagHochgeladen: hochgeladen?.Wert ?? '',
      linkField: linkField?.Wert ?? '',
      tagManuell: manuell?.Wert ?? '',
+      importWartezeitMinuten: wartezeit?.Wert ?? '10',
+      notizMarker: marker?.Wert ?? 'Agrarmonitor',
    };
  }

@@ -104,12 +121,16 @@ export class AgrarmonitorPollingService implements OnModuleInit {
    tagHochgeladen: string,
    linkField: string,
    tagManuell: string,
+    importWartezeitMinuten: string,
+    notizMarker: string,
  ): Promise<{
    tagFertig: string;
    tagVerbucht: string;
    tagHochgeladen: string;
    linkField: string;
    tagManuell: string;
+    importWartezeitMinuten: string;
+    notizMarker: string;
  }> {
    await Promise.all([
      this.settingRepo.update(
@@ -132,8 +153,24 @@ export class AgrarmonitorPollingService implements OnModuleInit {
        { Tag: 'agrarmonitor_tag_manuell' },
        { Wert: tagManuell },
      ),
+      this.settingRepo.update(
+        { Tag: 'agrarmonitor_import_wartezeit_minuten' },
+        { Wert: importWartezeitMinuten },
+      ),
+      this.settingRepo.update(
+        { Tag: 'agrarmonitor_notiz_marker' },
+        { Wert: notizMarker },
+      ),
    ]);
-    return { tagFertig, tagVerbucht, tagHochgeladen, linkField, tagManuell };
+    return {
+      tagFertig,
+      tagVerbucht,
+      tagHochgeladen,
+      linkField,
+      tagManuell,
+      importWartezeitMinuten,
+      notizMarker,
+    };
  }

  async runPolling(): Promise<PollingResult> {
@@ -393,17 +430,26 @@ export class AgrarmonitorPollingService implements OnModuleInit {
        fertigSetting,
        linkFieldSetting,
        manuellSetting,
+        wartezeitSetting,
+        markerSetting,
      ] = await Promise.all([
        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_hochgeladen' }),
        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_fertig' }),
        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_link_field' }),
        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_tag_manuell' }),
+        this.settingRepo.findOneBy({
+          Tag: 'agrarmonitor_import_wartezeit_minuten',
+        }),
+        this.settingRepo.findOneBy({ Tag: 'agrarmonitor_notiz_marker' }),
      ]);

      const tagHochgeladenId = parseInt(hochgeladenSetting?.Wert ?? '', 10);
      const tagFertigId = parseInt(fertigSetting?.Wert ?? '4', 10);
      const linkFieldId = parseInt(linkFieldSetting?.Wert ?? '', 10);
      const tagManuellId = parseInt(manuellSetting?.Wert ?? '', 10);
+      const importWartezeitMinuten =
+        parseInt(wartezeitSetting?.Wert ?? '10', 10) || 10;
+      const notizMarker = (markerSetting?.Wert ?? 'Agrarmonitor').trim();

      if (isNaN(tagHochgeladenId)) {
        this.logger.warn(
@@ -512,6 +558,40 @@ export class AgrarmonitorPollingService implements OnModuleInit {
            continue;
          }

+          // Karenzzeit: evtl. hat Agrarmonitor die E-Mail noch nicht importiert.
+          // Ist die Sende-Notiz jünger als die konfigurierte Wartezeit, nicht markieren.
+          const marker = notizMarker.toLowerCase();
+          if (marker) {
+            let notes: Array<{ note: string; created: string }>;
+            try {
+              notes = await this.paperlessService.getNotes(doc.id as number);
+            } catch (err: unknown) {
+              // Vorsichtig: bei Notiz-Abruf-Fehler NICHT markieren, nächster Lauf prüft erneut
+              this.logger.warn(
+                `${interneBelegnummer}: Notiz-Abruf fehlgeschlagen — nicht markiert: ${err instanceof Error ? err.message : err}`,
+              );
+              result.skipped++;
+              await this.delay(500);
+              continue;
+            }
+            const newest = notes
+              .filter((n) => (n.note ?? '').toLowerCase().includes(marker))
+              .map((n) => new Date(n.created).getTime())
+              .filter((t) => !isNaN(t))
+              .reduce((max, t) => Math.max(max, t), 0);
+            if (
+              newest > 0 &&
+              Date.now() - newest < importWartezeitMinuten * 60 * 1000
+            ) {
+              this.logger.log(
+                `${interneBelegnummer}: Sende-Notiz jünger als ${importWartezeitMinuten} Min — warte auf Import`,
+              );
+              result.skipped++;
+              await this.delay(500);
+              continue;
+            }
+          }
+
          // Weder verbucht noch im Dateieingang → Tags "Manuell bearbeiten" + "Von AM zurück" setzen
          if (!isNaN(tagManuellId)) {
            const currentTags: number[] = (doc.tags as number[]) ?? [];
@@ -42,6 +42,8 @@ export class AgrarmonitorController {
      tagHochgeladen: string;
      linkField: string;
      tagManuell: string;
+      importWartezeitMinuten: string;
+      notizMarker: string;
    },
  ) {
    return this.pollingService.updatePollingConfig(
@@ -50,6 +52,8 @@ export class AgrarmonitorController {
      body.tagHochgeladen,
      body.linkField,
      body.tagManuell ?? '',
+      body.importWartezeitMinuten ?? '10',
+      body.notizMarker ?? 'Agrarmonitor',
    );
  }

@@ -28,12 +28,19 @@ export class ApiKeyGuard implements CanActivate {
      if (apiKey) source = 'apiKey query param';
    }

-    // Fallback to Authorization: Bearer (used by SSE clients that can't set X-API-Key)
+    // Fallback to Authorization: Bearer (used by SSE clients that can't set
+    // X-API-Key). Nur akzeptieren, wenn das Token wie ein API-Key aussieht
+    // (Präfix "pm_"). Ein (abgelaufenes) JWT als Bearer-Token wird hier ignoriert,
+    // statt es fälschlich als API-Key zu prüfen – das vermeidet die irreführende
+    // "Invalid API Key"-Warnung beim normalen JWT-Ablauf.
    if (!apiKey) {
      const auth: string | undefined = request.headers['authorization'];
      if (auth?.startsWith('Bearer ')) {
-        apiKey = auth.slice(7);
-        source = 'Authorization: Bearer';
+        const token = auth.slice(7);
+        if (token.startsWith('pm_')) {
+          apiKey = token;
+          source = 'Authorization: Bearer';
+        }
      }
    }

@@ -26,6 +26,7 @@ import {
  CorrespondentEmailMapping,
  UserSettings,
  LabelPrintJob,
+  WebhookQueueItem,
 } from './entities';

 // CLI-Kontext: .env laden (Laufzeit im Container liefert die Variablen via Docker,
@@ -57,6 +58,7 @@ export const entities = [
  CorrespondentEmailMapping,
  UserSettings,
  LabelPrintJob,
+  WebhookQueueItem,
 ];

 const isProduction = process.env.NODE_ENV === 'production';
@@ -21,3 +21,4 @@ export { InboxPostprocessingAction } from './inbox-postprocessing-action.entity'
 export { CorrespondentEmailMapping } from './correspondent-email-mapping.entity';
 export { UserSettings } from './user-settings.entity';
 export { LabelPrintJob } from './label-print-job.entity';
+export { WebhookQueueItem } from './webhook-queue-item.entity';
@@ -0,0 +1,26 @@
+import {
+  Entity,
+  PrimaryColumn,
+  Column,
+  CreateDateColumn,
+  Index,
+} from 'typeorm';
+
+/**
+ * Persistente Warteschlange der vom Paperless-Webhook gemeldeten Dokument-IDs.
+ * `documentId` ist Primärschlüssel und erzwingt damit, dass jede ID nur einmal
+ * in der Warteschlange steht (Dedup auf DB-Ebene). Die Tabelle übersteht
+ * Neustarts; ausstehende IDs werden nach dem Boot weiterverarbeitet.
+ */
+@Entity('webhook_queue')
+export class WebhookQueueItem {
+  @PrimaryColumn({ type: 'int' })
+  documentId!: number;
+
+  @Column({ type: 'varchar', length: 100, nullable: true })
+  action!: string | null;
+
+  @Index()
+  @CreateDateColumn()
+  createdAt!: Date;
+}
@@ -0,0 +1,25 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Legt die persistente Webhook-Warteschlange an (`webhook_queue`).
+ * `documentId` ist Primärschlüssel → jede Dokument-ID kommt nur einmal vor.
+ */
+export class CreateWebhookQueue1782700000000 implements MigrationInterface {
+  name = 'CreateWebhookQueue1782700000000';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      CREATE TABLE IF NOT EXISTS \`webhook_queue\` (
+        \`documentId\` int NOT NULL,
+        \`action\` varchar(100) NULL,
+        \`createdAt\` datetime(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6),
+        PRIMARY KEY (\`documentId\`),
+        INDEX \`IDX_webhook_queue_createdAt\` (\`createdAt\`)
+      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`DROP TABLE \`webhook_queue\``);
+  }
+}
@@ -20,6 +20,14 @@ import { Attachment } from '../database/entities/attachment.entity';
 import { Content } from '../database/entities/content.entity';
 import { isERechnung } from './zugferd.util';

+function sanitizeFilename(name: string): string {
+  return name
+    .replace(/[/\\]/g, '-')
+    .replace(/\.\./g, '.')
+    .replace(/\x00/g, '')
+    .trim();
+}
+
@Injectable()
 export class EmailDownloadService {
  private readonly logger = new Logger(EmailDownloadService.name);
@@ -291,7 +299,7 @@ export class EmailDownloadService {
    }

    const attachment = new Attachment();
-    attachment.FileName = filename.slice(0, 255);
+    attachment.FileName = sanitizeFilename(filename).slice(0, 255);
    attachment.ContentType = contentType.slice(0, 100);
    attachment.IsEmbedded = isEmbedded;
    attachment.ContentId = att.cid ? att.cid.slice(0, 255) : null;
@@ -10,6 +10,7 @@ import { Content } from '../database/entities/content.entity';
 import { CorrespondentEmailMapping } from '../database/entities/correspondent-email-mapping.entity';
 import { Task } from '../database/entities/task.entity';
 import { PaperlessService } from '../paperless/paperless.service';
+import { deriveTaskMetadata } from '../paperless/task-metadata.util';
 import * as QRCode from 'qrcode';
 import { EmailPageCacheService } from './email-page-cache.service';
 import { ImapFolderService } from './imap-folder.service';
@@ -19,6 +20,14 @@ import * as os from 'os';
 import * as fs from 'fs/promises';
 import * as crypto from 'crypto';

+function sanitizeFilename(name: string): string {
+  return name
+    .replace(/[/\\]/g, '-')
+    .replace(/\.\./g, '.')
+    .replace(/\x00/g, '')
+    .trim();
+}
+
@Injectable()
 export class EmailImportService {
  private readonly logger = new Logger(EmailImportService.name);
@@ -491,7 +500,7 @@ export class EmailImportService {
        if (!content) continue;

        const originalPdfBytes = content.Content1;
-        const baseFilename = attachmentEntity.FileName.replace(/\.pdf$/i, '');
+        const baseFilename = sanitizeFilename(attachmentEntity.FileName.replace(/\.pdf$/i, ''));
        const paperlessIds: any = {};

        const uploadPromises = [];
@@ -557,13 +566,29 @@ export class EmailImportService {

        // Upload all generated PDFs
        for (const uploadItem of uploadPromises) {
+          // Einmal definieren, zweimal verwenden: Upload-Metadaten und Task
+          // tragen garantiert dieselben Werte
+          const taskFields = {
+            InterneBelegnummer: att.belegnummer || '',
+            Eingangsdatum: att.barcode?.datum
+              ? new Date(att.barcode.datum)
+              : createdDate,
+            Belegdatum: createdDate,
+            DocumentType: att.type === 'MAIN' ? null : 5, // 5 = Anlage
+            BetriebID: null, // Owner-Entfernung erledigt der Task-Processor
+          };
+          // Metadaten direkt beim Upload mitgeben; der Task-Processor patcht
+          // später idempotent nach (Sicherheitsnetz)
+          const derived = deriveTaskMetadata(taskFields);
          const options: any = {
            filename: uploadItem.filename,
            title: att.belegnummer
              ? `Beleg ${att.belegnummer}`
              : uploadItem.filename,
            created: createdDate,
-            owner: null,
+            documentType: derived.documentType,
+            archiveSerialNumber: derived.archiveSerialNumber,
+            customFields: derived.customFields,
          };
          if (att.paperlessCorrespondentId)
            options.correspondent = att.paperlessCorrespondentId;
@@ -577,15 +602,9 @@ export class EmailImportService {
          // Create background task for enrichment (same logic as Inbox)
          const backgroundTask = this.taskRepo.create({
            TaskId: paperlessTaskId,
-            InterneBelegnummer: att.belegnummer || '',
-            Eingangsdatum: att.barcode?.datum
-              ? new Date(att.barcode.datum)
-              : createdDate,
-            Belegdatum: createdDate,
+            ...taskFields,
            BarcodeJson: att.barcode ? JSON.stringify(att.barcode) : null,
-            BetriebID: null, // Owner
            Fertig: 0,
-            DocumentType: att.type === 'MAIN' ? null : 5, // 5 = Anlage
            SourceAttachmentID: att.attachmentId,
            SourceAttachmentRange: uploadItem.rangeKey,
          });
@@ -648,11 +667,17 @@ export class EmailImportService {
          this.logger.log(
            `Email ${firstAtt.EmailMessageId} als verarbeitet markiert.`,
          );
-          const emailEntity = await this.emailRepo.findOne({ where: { Id: firstAtt.EmailMessageId } });
+          const emailEntity = await this.emailRepo.findOne({
+            where: { Id: firstAtt.EmailMessageId },
+          });
          if (emailEntity) {
-            this.imapFolderService.moveToImportiert(emailEntity.MessageId).catch(err =>
-              this.logger.error('IMAP-Verschieben fehlgeschlagen: ' + err.message),
-            );
+            this.imapFolderService
+              .moveToImportiert(emailEntity.MessageId)
+              .catch((err) =>
+                this.logger.error(
+                  'IMAP-Verschieben fehlgeschlagen: ' + err.message,
+                ),
+              );
          }
        }
      }
@@ -204,9 +204,11 @@ export class EmailController {
      this.logger.log(
        `Prüfung abgeschlossen. ${updatedCount} E-Mails aktualisiert, ${idsUpdated} Paperless-IDs ergänzt, ${skippedCount} übersprungen.`,
      );
-      this.imapFolderService.cleanupImportedEmails().catch(err =>
-        this.logger.error('IMAP-Cleanup fehlgeschlagen: ' + err.message),
-      );
+      this.imapFolderService
+        .cleanupImportedEmails()
+        .catch((err) =>
+          this.logger.error('IMAP-Cleanup fehlgeschlagen: ' + err.message),
+        );

      let movedToImportiert = 0;
      if (body.includeProcessed) {
@@ -214,8 +216,13 @@ export class EmailController {
          where: [{ Status: 1 }, { Status: 3 }],
          select: ['MessageId'],
        });
-        const messageIds = processedEmails.map((e) => e.MessageId).filter(Boolean);
-        movedToImportiert = await this.imapFolderService.moveProcessedInboxToImportiert(messageIds);
+        const messageIds = processedEmails
+          .map((e) => e.MessageId)
+          .filter(Boolean);
+        movedToImportiert =
+          await this.imapFolderService.moveProcessedInboxToImportiert(
+            messageIds,
+          );
      }

      return { updatedCount, idsUpdated, movedToImportiert };
@@ -25,8 +25,14 @@ export class ImapFolderService {
  @Cron('0 3 * * *', { timeZone: 'Europe/Berlin' })
  async cleanupImportedEmails(): Promise<void> {
    if (!this.configService.get<string>('IMAP_HOST')) return;
-    const importedFolder = this.configService.get<string>('IMAP_IMPORTED_FOLDER', 'importiert');
-    const trashFolder = this.configService.get<string>('IMAP_TRASH_FOLDER', 'Trash');
+    const importedFolder = this.configService.get<string>(
+      'IMAP_IMPORTED_FOLDER',
+      'importiert',
+    );
+    const trashFolder = this.configService.get<string>(
+      'IMAP_TRASH_FOLDER',
+      'Trash',
+    );
    const client = this.createClient();
    try {
      await client.connect();
@@ -39,10 +45,14 @@ export class ImapFolderService {
        const oldUids = await client.search({ before: cutoff }, { uid: true });
        if (Array.isArray(oldUids) && oldUids.length > 0) {
          await client.messageMove(oldUids, trashFolder, { uid: true });
-          this.logger.log(`${oldUids.length} alte E-Mail(s) aus "${importedFolder}" in "${trashFolder}" verschoben.`);
+          this.logger.log(
+            `${oldUids.length} alte E-Mail(s) aus "${importedFolder}" in "${trashFolder}" verschoben.`,
+          );
        }
      } catch (err: any) {
-        this.logger.warn(`Bereinigung "${importedFolder}" nicht möglich: ${err.message}`);
+        this.logger.warn(
+          `Bereinigung "${importedFolder}" nicht möglich: ${err.message}`,
+        );
      }

      // Papierkorb leeren
@@ -51,10 +61,14 @@ export class ImapFolderService {
        const trashUids = await client.search({ all: true }, { uid: true });
        if (Array.isArray(trashUids) && trashUids.length > 0) {
          await client.messageDelete(trashUids, { uid: true });
-          this.logger.log(`${trashUids.length} E-Mail(s) aus "${trashFolder}" gelöscht.`);
+          this.logger.log(
+            `${trashUids.length} E-Mail(s) aus "${trashFolder}" gelöscht.`,
+          );
        }
      } catch (err: any) {
-        this.logger.warn(`Papierkorb "${trashFolder}" konnte nicht geleert werden: ${err.message}`);
+        this.logger.warn(
+          `Papierkorb "${trashFolder}" konnte nicht geleert werden: ${err.message}`,
+        );
      }
    } catch (err: any) {
      this.logger.error(`IMAP-Cleanup fehlgeschlagen: ${err.message}`);
@@ -64,9 +78,13 @@ export class ImapFolderService {
  }

  async moveProcessedInboxToImportiert(messageIds: string[]): Promise<number> {
-    if (!this.configService.get<string>('IMAP_HOST') || messageIds.length === 0) return 0;
+    if (!this.configService.get<string>('IMAP_HOST') || messageIds.length === 0)
+      return 0;

-    const importedFolder = this.configService.get<string>('IMAP_IMPORTED_FOLDER', 'importiert');
+    const importedFolder = this.configService.get<string>(
+      'IMAP_IMPORTED_FOLDER',
+      'importiert',
+    );
    const client = this.createClient();
    let movedCount = 0;

@@ -74,7 +92,7 @@ export class ImapFolderService {
      await client.connect();

      const mailboxes = await client.list();
-      if (!mailboxes.some(m => m.path === importedFolder)) {
+      if (!mailboxes.some((m) => m.path === importedFolder)) {
        await client.mailboxCreate(importedFolder);
        this.logger.log(`IMAP-Ordner "${importedFolder}" erstellt.`);
      }
@@ -86,7 +104,10 @@ export class ImapFolderService {
      const idSet = new Set(messageIds.map(normalize));
      const uidsToMove: number[] = [];

-      for await (const msg of client.fetch('1:*', { uid: true, envelope: true })) {
+      for await (const msg of client.fetch('1:*', {
+        uid: true,
+        envelope: true,
+      })) {
        const msgId = msg.envelope?.messageId;
        if (msgId && idSet.has(normalize(msgId))) {
          uidsToMove.push(msg.uid);
@@ -96,10 +117,14 @@ export class ImapFolderService {
      if (uidsToMove.length > 0) {
        await client.messageMove(uidsToMove, importedFolder, { uid: true });
        movedCount = uidsToMove.length;
-        this.logger.log(`${movedCount} E-Mail(s) aus INBOX → "${importedFolder}" verschoben.`);
+        this.logger.log(
+          `${movedCount} E-Mail(s) aus INBOX → "${importedFolder}" verschoben.`,
+        );
      }
    } catch (err: any) {
-      this.logger.error(`moveProcessedInboxToImportiert fehlgeschlagen: ${err.message}`);
+      this.logger.error(
+        `moveProcessedInboxToImportiert fehlgeschlagen: ${err.message}`,
+      );
    } finally {
      await client.logout().catch(() => {});
    }
@@ -110,24 +135,34 @@ export class ImapFolderService {
  async moveToImportiert(messageId: string): Promise<void> {
    if (!this.configService.get<string>('IMAP_HOST')) return;

-    const importedFolder = this.configService.get<string>('IMAP_IMPORTED_FOLDER', 'importiert');
+    const importedFolder = this.configService.get<string>(
+      'IMAP_IMPORTED_FOLDER',
+      'importiert',
+    );
    const client = this.createClient();
    try {
      await client.connect();

      const mailboxes = await client.list();
-      if (!mailboxes.some(m => m.path === importedFolder)) {
+      if (!mailboxes.some((m) => m.path === importedFolder)) {
        await client.mailboxCreate(importedFolder);
        this.logger.log(`IMAP-Ordner "${importedFolder}" erstellt.`);
      }

      await client.mailboxOpen('INBOX');
-      const uids = await client.search({ header: { 'message-id': messageId } }, { uid: true });
+      const uids = await client.search(
+        { header: { 'message-id': messageId } },
+        { uid: true },
+      );
      if (Array.isArray(uids) && uids.length > 0) {
        await client.messageMove(uids, importedFolder, { uid: true });
-        this.logger.log(`E-Mail ${messageId} → "${importedFolder}" verschoben.`);
+        this.logger.log(
+          `E-Mail ${messageId} → "${importedFolder}" verschoben.`,
+        );
      } else {
-        this.logger.warn(`E-Mail ${messageId} nicht in INBOX gefunden (bereits verschoben?).`);
+        this.logger.warn(
+          `E-Mail ${messageId} nicht in INBOX gefunden (bereits verschoben?).`,
+        );
      }
    } catch (err: any) {
      this.logger.error(`IMAP moveToImportiert fehlgeschlagen: ${err.message}`);
@@ -181,7 +181,7 @@ export class PaperlessProcessorService {
                doc.correspondent !== null && doc.correspondent !== undefined;
              break;
            case 2:
-              isFilled = !!doc.created || !!doc.created_date;
+              isFilled = !!doc.created;
              break;
            case 3:
              isFilled =
@@ -0,0 +1,201 @@
+import { PaperlessTaskProcessorService } from './paperless-task-processor.service';
+import { Task } from '../database/entities/task.entity';
+
+/**
+ * Charakterisierungstest für processSuccessfulTask: pinnt den PATCH-Payload
+ * fest, damit der Refactor auf deriveTaskMetadata() verhaltensidentisch bleibt.
+ * custom_fields wird ordnungsunabhängig verglichen (Paperless behandelt das
+ * Array als Menge).
+ */
+
+function createTask(overrides: Partial<Task> = {}): Task {
+  return {
+    TaskId: 'task-uuid-1',
+    InterneBelegnummer: '',
+    DocumentType: null,
+    Eingangsdatum: null,
+    Fertig: 0,
+    Tags: null,
+    BetriebID: null,
+    Lieferant: null,
+    externeBelegnummer: null,
+    EinkaufID: null,
+    Belegdatum: null,
+    PaperlessDocumentID: null,
+    TaskReferenceID: null,
+    BarcodeJson: null,
+    DuplikatZU: null,
+    CustomFieldsJson: null,
+    Asn: null,
+    SourceAttachmentID: null,
+    SourceAttachmentRange: null,
+    ...overrides,
+  } as Task;
+}
+
+function sortByField(fields: Array<{ field: number }>) {
+  return [...fields].sort((a, b) => a.field - b.field);
+}
+
+/** Erwartete Form des PATCH-Payloads an updateDocument. */
+interface PatchPayload {
+  custom_fields: Array<{ field: number; value: unknown }>;
+  archive_serial_number?: number;
+  document_type?: number;
+  created?: string;
+  owner?: number | null;
+  tags?: number[];
+  title?: string;
+}
+
+describe('PaperlessTaskProcessorService.processSuccessfulTask', () => {
+  let paperlessService: {
+    getDocument: jest.Mock;
+    updateDocument: jest.Mock;
+    addNote: jest.Mock;
+    getDocumentMetadata: jest.Mock;
+    getTask: jest.Mock;
+  };
+  let taskRepo: { save: jest.Mock };
+  let documentRepo: { findOne: jest.Mock; create: jest.Mock; save: jest.Mock };
+  let attachmentRepo: { findOne: jest.Mock; save: jest.Mock };
+  let service: PaperlessTaskProcessorService;
+
+  /** Zugriff auf die private Methode, typsicher für den Test gekapselt. */
+  function runProcessSuccessfulTask(
+    task: Task,
+    apiTask: { related_document: number },
+    parentTask: Task | null,
+  ): Promise<void> {
+    return (
+      service as unknown as {
+        processSuccessfulTask: (
+          t: Task,
+          a: { related_document: number },
+          p: Task | null,
+        ) => Promise<void>;
+      }
+    ).processSuccessfulTask(task, apiTask, parentTask);
+  }
+
+  function lastPatchPayload(): PatchPayload {
+    const calls = paperlessService.updateDocument.mock.calls as Array<
+      [number, PatchPayload]
+    >;
+    return calls[calls.length - 1][1];
+  }
+
+  beforeEach(() => {
+    paperlessService = {
+      getDocument: jest.fn(),
+      updateDocument: jest.fn().mockResolvedValue(undefined),
+      addNote: jest.fn().mockResolvedValue(undefined),
+      getDocumentMetadata: jest.fn().mockResolvedValue({
+        original_checksum: 'abc',
+        original_filename: 'test.pdf',
+      }),
+      getTask: jest.fn(),
+    };
+    taskRepo = { save: jest.fn().mockResolvedValue(undefined) };
+    documentRepo = {
+      findOne: jest.fn().mockResolvedValue(null),
+      create: jest.fn((v: object) => v),
+      save: jest.fn().mockResolvedValue(undefined),
+    };
+    attachmentRepo = {
+      findOne: jest.fn().mockResolvedValue(null),
+      save: jest.fn().mockResolvedValue(undefined),
+    };
+    service = new PaperlessTaskProcessorService(
+      taskRepo as any,
+      documentRepo as any,
+      attachmentRepo as any,
+      paperlessService as any,
+    );
+  });
+
+  it('baut den PATCH-Payload mit ASN, CF3/CF7/CF9, Typ, created, owner und Tag-Merge', async () => {
+    paperlessService.getDocument.mockResolvedValue({
+      id: 101,
+      title: 'Testdokument',
+      custom_fields: [{ field: 7, value: 'alt' }],
+      tags: [99],
+    });
+    const task = createTask({
+      InterneBelegnummer: '2026-000123',
+      externeBelegnummer: 'RE-9',
+      Eingangsdatum: new Date('2026-07-14T00:00:00Z'),
+      Belegdatum: new Date('2026-07-01T00:00:00Z'),
+      DocumentType: 2,
+      BetriebID: 3,
+      Tags: '1,2',
+      CustomFieldsJson: JSON.stringify({ '4': 'x' }),
+    });
+
+    await runProcessSuccessfulTask(task, { related_document: 101 }, null);
+
+    expect(paperlessService.updateDocument).toHaveBeenCalledTimes(1);
+    expect(paperlessService.updateDocument).toHaveBeenCalledWith(
+      101,
+      expect.anything(),
+    );
+    const payload = lastPatchPayload();
+    expect(payload.archive_serial_number).toBe(2026000123);
+    expect(payload.document_type).toBe(2);
+    expect(payload.created).toBe('2026-07-01T00:00:00.000Z');
+    expect(payload.owner).toBe(3);
+    expect(payload.tags).toEqual([99, 1, 2]);
+    expect(sortByField(payload.custom_fields)).toEqual([
+      { field: 3, value: 'RE-9' },
+      { field: 4, value: 'x' },
+      { field: 7, value: '2026-000123' },
+      { field: 9, value: '2026-07-14' },
+    ]);
+    expect(task.Fertig).toBe(1);
+    expect(task.PaperlessDocumentID).toBe(101);
+  });
+
+  it('entfernt den Owner (null) bei leerer BetriebID', async () => {
+    paperlessService.getDocument.mockResolvedValue({
+      id: 102,
+      title: 'Ohne Betrieb',
+      custom_fields: [],
+      tags: [],
+    });
+    const task = createTask({ InterneBelegnummer: '2026-000124' });
+
+    await runProcessSuccessfulTask(task, { related_document: 102 }, null);
+
+    expect(lastPatchPayload().owner).toBeNull();
+  });
+
+  it('überschreibt bei Anlagen document_type/title und verknüpft CF8 zum Elterndokument', async () => {
+    paperlessService.getDocument
+      .mockResolvedValueOnce({
+        id: 103,
+        title: 'Anlage-Roh',
+        custom_fields: [],
+        tags: [],
+      })
+      .mockResolvedValueOnce({ id: 55, title: 'Eltern' });
+    paperlessService.getTask.mockResolvedValue([{ related_document: 55 }]);
+    const task = createTask({
+      DocumentType: 2,
+      TaskReferenceID: 'parent-uuid',
+    });
+    const parentTask = createTask({
+      TaskId: 'parent-uuid',
+      InterneBelegnummer: '2026-000100',
+      Fertig: 1,
+    });
+
+    await runProcessSuccessfulTask(task, { related_document: 103 }, parentTask);
+
+    const payload = lastPatchPayload();
+    expect(payload.document_type).toBe(5);
+    expect(payload.title).toBe('Anlage zu 2026-000100');
+    expect(sortByField(payload.custom_fields)).toEqual([
+      { field: 8, value: [55] },
+    ]);
+  });
+});
@@ -6,6 +6,7 @@ import { Task } from '../database/entities/task.entity';
 import { Document } from '../database/entities/document.entity';
 import { Attachment } from '../database/entities/attachment.entity';
 import { PaperlessService } from './paperless.service';
+import { deriveTaskMetadata } from './task-metadata.util';

@Injectable()
 export class PaperlessTaskProcessorService {
@@ -74,7 +75,12 @@ export class PaperlessTaskProcessorService {
              await this.processSuccessfulTask(t, apiResponseTask, parentTask);
            }
          } else if (apiResponseTask.status === 'FAILURE') {
-            this.logger.warn(`Task ${t.TaskId} failed in Paperless`);
+            // Seit Metadaten (inkl. ASN) direkt beim Upload gesetzt werden, kann
+            // z.B. eine ASN-Kollision bereits den Consume scheitern lassen –
+            // vor dem Löschen die Diagnose-Infos festhalten
+            this.logger.error(
+              `Task ${t.TaskId} in Paperless fehlgeschlagen (Beleg: ${t.InterneBelegnummer || '-'}, Attachment: ${t.SourceAttachmentID ?? '-'}). Paperless-Meldung: ${apiResponseTask.result ?? 'keine'}`,
+            );
            toDelete.push(t);
          }
        } else {
@@ -200,104 +206,34 @@ export class PaperlessTaskProcessorService {
          : [],
      };

-      // CustomFieldsJson als Basis zuerst anwenden – dedizierte Felder weiter unten überschreiben diese
-      if (t.CustomFieldsJson) {
-        try {
-          const extra = JSON.parse(t.CustomFieldsJson) as Record<
-            string,
-            string
-          >;
-          for (const [k, v] of Object.entries(extra)) {
-            const fieldId = parseInt(k, 10);
-            if (!Number.isFinite(fieldId)) continue;
-            const idx = updateData.custom_fields.findIndex(
-              (f: any) => f.field === fieldId,
-            );
-            if (idx !== -1) updateData.custom_fields[idx].value = v;
-            else updateData.custom_fields.push({ field: fieldId, value: v });
-          }
-        } catch {
-          /* JSON-Parse-Fehler ignorieren */
-        }
+      // Gemeinsame Ableitung – identische Regeln wie beim direkten Upload (task-metadata.util)
+      const derived = deriveTaskMetadata(t);
+
+      for (const [k, v] of Object.entries(derived.customFields)) {
+        const fieldId = parseInt(k, 10);
+        const idx = updateData.custom_fields.findIndex(
+          (f: any) => f.field === fieldId,
+        );
+        if (idx !== -1) updateData.custom_fields[idx].value = v;
+        else updateData.custom_fields.push({ field: fieldId, value: v });
      }

-      if (t.Asn) {
-        const asnNum = parseInt(t.Asn.replace(/[^0-9]/g, ''), 10);
-        if (!isNaN(asnNum)) {
-          this.logger.log(
-            `[Postprocessing] Task ${t.TaskId} - Setze ASN (explizit): ${asnNum}`,
-          );
-          updateData.archive_serial_number = asnNum;
-        }
-      }
-
-      if (t.InterneBelegnummer) {
+      if (derived.archiveSerialNumber !== undefined) {
        this.logger.log(
-          `[Postprocessing] Task ${t.TaskId} - Setze InterneBelegnummer: ${t.InterneBelegnummer}`,
+          `[Postprocessing] Task ${t.TaskId} - Setze ASN: ${derived.archiveSerialNumber}`,
        );
-        if (!t.Asn) {
-          const asnFromBelegnummer = parseInt(
-            t.InterneBelegnummer.replace(/-/g, ''),
-            10,
-          );
-          if (!isNaN(asnFromBelegnummer)) {
-            updateData.archive_serial_number = asnFromBelegnummer;
-          } else {
-            this.logger.warn(
-              `[Postprocessing] Task ${t.TaskId} - ASN aus InterneBelegnummer konnte nicht geparst werden: ${t.InterneBelegnummer}`,
-            );
-          }
-        }
-        const existingField7 = updateData.custom_fields.find(
-          (f: any) => f.field === 7,
+        updateData.archive_serial_number = derived.archiveSerialNumber;
+      } else if (t.Asn || t.InterneBelegnummer) {
+        this.logger.warn(
+          `[Postprocessing] Task ${t.TaskId} - ASN konnte nicht abgeleitet werden (Asn: ${t.Asn ?? '-'}, InterneBelegnummer: ${t.InterneBelegnummer || '-'})`,
        );
-        if (existingField7) {
-          existingField7.value = t.InterneBelegnummer;
-        } else {
-          updateData.custom_fields.push({
-            field: 7,
-            value: t.InterneBelegnummer,
-          });
-        }
      }

-      if (t.externeBelegnummer) {
+      if (derived.documentType !== undefined) {
        this.logger.log(
-          `[Postprocessing] Task ${t.TaskId} - Setze externeBelegnummer: ${t.externeBelegnummer}`,
+          `[Postprocessing] Task ${t.TaskId} - Setze DocumentType: ${derived.documentType}`,
        );
-        const existingField3 = updateData.custom_fields.find(
-          (f: any) => f.field === 3,
-        );
-        if (existingField3) {
-          existingField3.value = t.externeBelegnummer;
-        } else {
-          updateData.custom_fields.push({
-            field: 3,
-            value: t.externeBelegnummer,
-          });
-        }
-      }
-
-      if (t.Eingangsdatum) {
-        const dateValue = new Date(t.Eingangsdatum).toISOString().split('T')[0];
-        this.logger.log(
-          `[Postprocessing] Task ${t.TaskId} - Setze Eingangsdatum: ${dateValue}`,
-        );
-        const existingField9 = updateData.custom_fields.find(
-          (f: any) => f.field === 9,
-        );
-        if (existingField9) {
-          existingField9.value = dateValue;
-        } else {
-          updateData.custom_fields.push({ field: 9, value: dateValue });
-        }
-      }
-
-      if (t.DocumentType) {
-        this.logger.log(
-          `[Postprocessing] Task ${t.TaskId} - Setze DocumentType: ${t.DocumentType}`,
-        );
-        updateData.document_type = t.DocumentType;
+        updateData.document_type = derived.documentType;
      }

      // Parent Task / Attachment logic
@@ -350,36 +286,33 @@ export class PaperlessTaskProcessorService {
        }
      }

-      if (t.Belegdatum) {
+      if (derived.created) {
        this.logger.log(
-          `[Postprocessing] Task ${t.TaskId} - Setze Belegdatum: ${t.Belegdatum.toISOString()}`,
+          `[Postprocessing] Task ${t.TaskId} - Setze Belegdatum: ${derived.created}`,
        );
-        updateData.created = t.Belegdatum.toISOString();
+        updateData.created = derived.created;
      }

-      if (t.BetriebID) {
+      if (derived.owner !== undefined) {
        this.logger.log(
-          `[Postprocessing] Task ${t.TaskId} - Setze Owner: ${t.BetriebID}`,
+          `[Postprocessing] Task ${t.TaskId} - Setze Owner: ${derived.owner}`,
        );
-        updateData.owner = t.BetriebID;
      } else {
        this.logger.log(
          `[Postprocessing] Task ${t.TaskId} - Entferne Owner (setze null)`,
        );
-        updateData.owner = null;
      }
+      updateData.owner = derived.owner ?? null;

-      // Tags
-      if (t.Tags) {
+      // Tags: Upload-/Consume-Tags des Dokuments bleiben erhalten (Merge statt Ersetzen)
+      if (derived.tags) {
        this.logger.log(
          `[Postprocessing] Task ${t.TaskId} - Setze Tags: ${t.Tags}`,
        );
-        const tagIds = t.Tags.split(',')
-          .map((id) => parseInt(id.trim(), 10))
-          .filter((id) => !isNaN(id));
        const currentTags = document.tags || [];
-        const newTags = Array.from(new Set([...currentTags, ...tagIds]));
-        updateData.tags = newTags;
+        updateData.tags = Array.from(
+          new Set([...currentTags, ...derived.tags]),
+        );
      }

      // Agrarmonitor Link (Skip API call for now, but save the link if needed)
@@ -23,6 +23,7 @@ import { FileInterceptor } from '@nestjs/platform-express';
 import { InjectRepository } from '@nestjs/typeorm';
 import { Repository } from 'typeorm';
 import { PaperlessService } from './paperless.service';
+import { deriveTaskMetadata } from './task-metadata.util';
 import { ApiKeyGuard } from '../auth/api-key.guard';
 import { UploadExternalDto } from './dto/upload-external.dto';
 import { Task } from '../database/entities/task.entity';
@@ -155,7 +156,7 @@ export class PaperlessController {
        asn: doc.archive_serial_number,
        documentType: doc.document_type,
        correspondent: doc.correspondent,
-        created: doc.created_date,
+        created: doc.created,
        added: doc.added,
        tags: doc.tags,
        customFields: doc.custom_fields,
@@ -179,7 +180,7 @@ export class PaperlessController {
        asn: doc.archive_serial_number,
        documentType: doc.document_type,
        correspondent: doc.correspondent,
-        created: doc.created_date,
+        created: doc.created,
        added: doc.added,
        tags: doc.tags,
        customFields: doc.custom_fields,
@@ -338,7 +339,7 @@ export class PaperlessController {
            docDate.getHours() * 60 * 60 * 1000,
        );
      }
-      oldDocument.created_date = docDate.toISOString().split('T')[0];
+      oldDocument.created = docDate.toISOString();
    }

    const cfDefinitions = await this.paperlessService.getCustomFields();
@@ -390,7 +391,7 @@ export class PaperlessController {
    for (const req of reqs) {
      let isFieldValid = false;
      if (req.Type === 1) isFieldValid = oldDocument.correspondent !== null;
-      if (req.Type === 2) isFieldValid = oldDocument.created_date !== null;
+      if (req.Type === 2) isFieldValid = oldDocument.created !== null;
      if (req.Type === 3)
        isFieldValid = oldDocument.archive_serial_number !== null;
      if (req.Type === 4)
@@ -446,10 +447,8 @@ export class PaperlessController {
            );
          }
        }
-        titleTemplate = titleTemplate.replace(
-          '{{DATE}}',
-          oldDocument.created_date,
-        );
+        const createdDatePart = String(oldDocument.created ?? '').split('T')[0];
+        titleTemplate = titleTemplate.replace('{{DATE}}', createdDatePart);
        oldDocument.title = titleTemplate;
      }
    } else {
@@ -471,6 +470,9 @@ export class PaperlessController {
      }
    }

+    // Veraltetes Feld nicht mit-PATCHen (löst Paperless-Deprecation-Warnung aus)
+    delete oldDocument.created_date;
+
    await this.paperlessService.updateDocument(documentId, oldDocument);
    return { success: true };
  }
@@ -513,11 +515,28 @@ export class PaperlessController {
      // 0. Check if ASN already exists
      await this.paperlessService.validateAsnNotExists(dto.interneBelegnummer);

-      // 1. Forward to Paperless
+      // 1. Forward to Paperless – Metadaten direkt beim Upload mitgeben;
+      // der Task-Processor patcht später idempotent nach (Sicherheitsnetz)
+      const derived = deriveTaskMetadata({
+        InterneBelegnummer: dto.interneBelegnummer,
+        externeBelegnummer: dto.externeBelegnummer ?? null,
+        Eingangsdatum: dto.Eingangsdatum ? new Date(dto.Eingangsdatum) : null,
+        Belegdatum: dto.belegdatum ? new Date(dto.belegdatum) : null,
+        // Anlagen (parentId gesetzt) bekommen Typ 5 sofort; Titel/CF8 folgen im Processor
+        DocumentType: dto.parentId ? 5 : (dto.dokumentType ?? null),
+        Tags: dto.tag ? String(dto.tag) : null,
+        BetriebID: dto.betriebId ?? null,
+      });
      const paperlessTaskId = await this.paperlessService.uploadDocument(
        file.path,
        {
          title: `Beleg ${dto.interneBelegnummer}`,
+          created: derived.created,
+          documentType: derived.documentType,
+          owner: derived.owner,
+          tags: derived.tags,
+          archiveSerialNumber: derived.archiveSerialNumber,
+          customFields: derived.customFields,
        },
      );

@@ -250,6 +250,14 @@ export class PaperlessService {
    return response.data;
  }

+  async getNotes(
+    id: number,
+  ): Promise<Array<{ id: number; note: string; created: string }>> {
+    const response = await this.client.get(`/documents/${id}/notes/`);
+    const data = response.data;
+    return Array.isArray(data) ? data : (data?.results ?? []);
+  }
+
  async checksumExists(checksum: string): Promise<boolean> {
    const response = await this.client.get('/documents/', {
      params: { checksum__iexact: checksum },
@@ -0,0 +1,139 @@
+import { deriveTaskMetadata } from './task-metadata.util';
+
+describe('deriveTaskMetadata', () => {
+  describe('archiveSerialNumber', () => {
+    it('parst ASN aus Asn und entfernt alle Nicht-Ziffern', () => {
+      const result = deriveTaskMetadata({ Asn: 'ASN-123' });
+      expect(result.archiveSerialNumber).toBe(123);
+    });
+
+    it('leitet ASN aus InterneBelegnummer ab (nur Bindestriche entfernen)', () => {
+      const result = deriveTaskMetadata({ InterneBelegnummer: '2026-000123' });
+      expect(result.archiveSerialNumber).toBe(2026000123);
+    });
+
+    it('bevorzugt Asn vor InterneBelegnummer', () => {
+      const result = deriveTaskMetadata({
+        Asn: '42',
+        InterneBelegnummer: '2026-000123',
+      });
+      expect(result.archiveSerialNumber).toBe(42);
+    });
+
+    it('nutzt keinen Belegnummer-Fallback, wenn Asn gesetzt aber unparsebar ist', () => {
+      // Entspricht exakt der Processor-Logik: Fallback nur bei leerem Asn
+      const result = deriveTaskMetadata({
+        Asn: 'abc',
+        InterneBelegnummer: '2026-000123',
+      });
+      expect(result.archiveSerialNumber).toBeUndefined();
+    });
+
+    it('lässt ASN weg, wenn InterneBelegnummer nicht parsebar ist', () => {
+      const result = deriveTaskMetadata({ InterneBelegnummer: 'Beleg-X' });
+      expect(result.archiveSerialNumber).toBeUndefined();
+    });
+  });
+
+  describe('customFields (CF7/CF3/CF9)', () => {
+    it('setzt CF7 aus InterneBelegnummer', () => {
+      const result = deriveTaskMetadata({ InterneBelegnummer: '2026-000123' });
+      expect(result.customFields['7']).toBe('2026-000123');
+    });
+
+    it('setzt CF3 aus externeBelegnummer', () => {
+      const result = deriveTaskMetadata({ externeBelegnummer: 'RE-4711' });
+      expect(result.customFields['3']).toBe('RE-4711');
+    });
+
+    it('setzt CF9 aus Eingangsdatum als YYYY-MM-DD', () => {
+      const result = deriveTaskMetadata({
+        Eingangsdatum: new Date('2026-07-14T10:30:00Z'),
+      });
+      expect(result.customFields['9']).toBe('2026-07-14');
+    });
+
+    it('übernimmt CustomFieldsJson als Basis mit normalisierten numerischen Keys', () => {
+      const result = deriveTaskMetadata({
+        CustomFieldsJson: JSON.stringify({ '4': 'wert4', abc: 'ignoriert' }),
+      });
+      expect(result.customFields).toEqual({ '4': 'wert4' });
+    });
+
+    it('überschreibt CustomFieldsJson-Basis mit dedizierten Feldern CF7/CF3/CF9', () => {
+      const result = deriveTaskMetadata({
+        InterneBelegnummer: '2026-000123',
+        externeBelegnummer: 'RE-4711',
+        Eingangsdatum: new Date('2026-07-14T00:00:00Z'),
+        CustomFieldsJson: JSON.stringify({
+          '7': 'alt7',
+          '3': 'alt3',
+          '9': 'alt9',
+        }),
+      });
+      expect(result.customFields['7']).toBe('2026-000123');
+      expect(result.customFields['3']).toBe('RE-4711');
+      expect(result.customFields['9']).toBe('2026-07-14');
+    });
+
+    it('ignoriert ungültiges CustomFieldsJson still', () => {
+      const result = deriveTaskMetadata({
+        CustomFieldsJson: '{kein json',
+        InterneBelegnummer: '2026-000123',
+      });
+      expect(result.customFields).toEqual({ '7': '2026-000123' });
+    });
+
+    it('liefert leeres customFields-Objekt ohne Eingaben', () => {
+      const result = deriveTaskMetadata({});
+      expect(result.customFields).toEqual({});
+    });
+  });
+
+  describe('documentType / created / owner / tags', () => {
+    it('übernimmt DocumentType nur wenn truthy', () => {
+      expect(deriveTaskMetadata({ DocumentType: 5 }).documentType).toBe(5);
+      expect(
+        deriveTaskMetadata({ DocumentType: 0 }).documentType,
+      ).toBeUndefined();
+      expect(
+        deriveTaskMetadata({ DocumentType: null }).documentType,
+      ).toBeUndefined();
+    });
+
+    it('leitet created als ISO-String aus Belegdatum ab', () => {
+      const result = deriveTaskMetadata({
+        Belegdatum: new Date('2026-07-01T00:00:00Z'),
+      });
+      expect(result.created).toBe('2026-07-01T00:00:00.000Z');
+    });
+
+    it('setzt owner nur bei truthy BetriebID', () => {
+      expect(deriveTaskMetadata({ BetriebID: 3 }).owner).toBe(3);
+      expect(deriveTaskMetadata({ BetriebID: null }).owner).toBeUndefined();
+      expect(deriveTaskMetadata({}).owner).toBeUndefined();
+    });
+
+    it('parst Tags-CSV und filtert Ungültiges', () => {
+      const result = deriveTaskMetadata({ Tags: '1, 2, x' });
+      expect(result.tags).toEqual([1, 2]);
+    });
+
+    it('lässt tags bei leerem Tags-Feld weg', () => {
+      expect(deriveTaskMetadata({ Tags: null }).tags).toBeUndefined();
+      expect(deriveTaskMetadata({}).tags).toBeUndefined();
+    });
+  });
+
+  describe('leere Eingaben', () => {
+    it('lässt bei leeren Strings alle Felder weg', () => {
+      const result = deriveTaskMetadata({
+        InterneBelegnummer: '',
+        Asn: '',
+        externeBelegnummer: '',
+        Tags: '',
+      });
+      expect(result).toEqual({ customFields: {} });
+    });
+  });
+});
@@ -0,0 +1,102 @@
+/**
+ * Leitet Paperless-Metadaten aus Task-Feldern ab.
+ *
+ * Wird sowohl von den Upload-Pfaden (external-upload, E-Mail-Import) als auch
+ * vom PaperlessTaskProcessorService genutzt, damit beim Upload und beim
+ * nachgelagerten PATCH garantiert dieselben Ableitungsregeln gelten.
+ */
+
+/** Teilmenge der Task-Entity-Felder, aus denen Metadaten abgeleitet werden. */
+export interface TaskMetadataInput {
+  InterneBelegnummer?: string | null;
+  Asn?: string | null;
+  externeBelegnummer?: string | null;
+  Eingangsdatum?: Date | string | null;
+  Belegdatum?: Date | string | null;
+  DocumentType?: number | null;
+  /** CSV wie Task.Tags, z.B. "1,2,3" */
+  Tags?: string | null;
+  BetriebID?: number | null;
+  CustomFieldsJson?: string | null;
+}
+
+export interface DerivedTaskMetadata {
+  archiveSerialNumber?: number;
+  /** Basis aus CustomFieldsJson; CF7/CF3/CF9 überschreiben die Basis. */
+  customFields: Record<string, string>;
+  documentType?: number;
+  /** ISO-String aus Belegdatum */
+  created?: string;
+  /** Nur gesetzt, wenn BetriebID truthy — Owner-Entfernung bleibt Sache des Processors. */
+  owner?: number;
+  tags?: number[];
+}
+
+export function deriveTaskMetadata(t: TaskMetadataInput): DerivedTaskMetadata {
+  const result: DerivedTaskMetadata = { customFields: {} };
+
+  // Basis aus CustomFieldsJson – dedizierte Felder unten überschreiben diese
+  if (t.CustomFieldsJson) {
+    try {
+      const extra = JSON.parse(t.CustomFieldsJson) as Record<string, string>;
+      for (const [k, v] of Object.entries(extra)) {
+        const fieldId = parseInt(k, 10);
+        if (!Number.isFinite(fieldId)) continue;
+        result.customFields[String(fieldId)] = v;
+      }
+    } catch {
+      /* JSON-Parse-Fehler ignorieren */
+    }
+  }
+
+  if (t.Asn) {
+    const asnNum = parseInt(t.Asn.replace(/[^0-9]/g, ''), 10);
+    if (!isNaN(asnNum)) {
+      result.archiveSerialNumber = asnNum;
+    }
+  }
+
+  if (t.InterneBelegnummer) {
+    // ASN-Fallback nur bei leerem Asn; bewusst nur Bindestriche entfernen
+    if (!t.Asn) {
+      const asnFromBelegnummer = parseInt(
+        t.InterneBelegnummer.replace(/-/g, ''),
+        10,
+      );
+      if (!isNaN(asnFromBelegnummer)) {
+        result.archiveSerialNumber = asnFromBelegnummer;
+      }
+    }
+    result.customFields['7'] = t.InterneBelegnummer;
+  }
+
+  if (t.externeBelegnummer) {
+    result.customFields['3'] = t.externeBelegnummer;
+  }
+
+  if (t.Eingangsdatum) {
+    result.customFields['9'] = new Date(t.Eingangsdatum)
+      .toISOString()
+      .split('T')[0];
+  }
+
+  if (t.DocumentType) {
+    result.documentType = t.DocumentType;
+  }
+
+  if (t.Belegdatum) {
+    result.created = new Date(t.Belegdatum).toISOString();
+  }
+
+  if (t.BetriebID) {
+    result.owner = t.BetriebID;
+  }
+
+  if (t.Tags) {
+    result.tags = t.Tags.split(',')
+      .map((id) => parseInt(id.trim(), 10))
+      .filter((id) => !isNaN(id));
+  }
+
+  return result;
+}
@@ -0,0 +1,184 @@
+// PaperlessProcessorService zieht über die Postprocessing-Kette das ESM-Paket
+// "webdav" nach, das Jest nicht transformiert. Für diesen Unit-Test ersetzen wir
+// das Modul durch eine Dummy-Klasse – der Service erhält seine Abhängigkeiten
+// ohnehin als Mocks injiziert.
+jest.mock('../paperless/paperless-processor.service', () => ({
+  PaperlessProcessorService: class {},
+}));
+
+import { WebhookQueueService } from './webhook-queue.service';
+
+/**
+ * Baut ein Mock-Repository, das die `webhook_queue`-Tabelle durch ein einfaches
+ * FIFO-Array simuliert: `INSERT IGNORE` (Dedup), FIFO-`find` und `delete`.
+ */
+function createQueueRepoMock() {
+  const store: { documentId: number; createdAt: Date }[] = [];
+  return {
+    store,
+    createQueryBuilder: jest.fn(() => ({
+      insert: () => ({
+        into: () => ({
+          values: (v: { documentId: number }) => ({
+            orIgnore: () => ({
+              execute: () => {
+                const added = !store.some((s) => s.documentId === v.documentId);
+                if (added) {
+                  // Standardmäßig "alt genug" (60s), damit die Mindest-Wartezeit
+                  // die Verhaltenstests nicht blockiert.
+                  store.push({
+                    documentId: v.documentId,
+                    createdAt: new Date(Date.now() - 60_000),
+                  });
+                }
+                return Promise.resolve({
+                  raw: { affectedRows: added ? 1 : 0 },
+                });
+              },
+            }),
+          }),
+        }),
+      }),
+    })),
+    find: jest.fn(() => {
+      // Simuliert den DB-seitigen Alters-Filter (createdAt <= NOW() - 5000 ms).
+      const eligible = [...store]
+        .filter((s) => Date.now() - s.createdAt.getTime() >= 5000)
+        .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+      return Promise.resolve(
+        eligible.length
+          ? [
+              {
+                documentId: eligible[0].documentId,
+                action: null,
+                createdAt: eligible[0].createdAt,
+              },
+            ]
+          : [],
+      );
+    }),
+    delete: jest.fn((criteria: { documentId: number }) => {
+      const idx = store.findIndex((s) => s.documentId === criteria.documentId);
+      if (idx >= 0) store.splice(idx, 1);
+      return Promise.resolve({ affected: 1 });
+    }),
+    count: jest.fn(() => Promise.resolve(store.length)),
+  };
+}
+
+describe('WebhookQueueService', () => {
+  let processor: { processDocumentById: jest.Mock };
+  let settingRepo: { findOneBy: jest.Mock; create: jest.Mock; save: jest.Mock };
+  let queueRepo: ReturnType<typeof createQueueRepoMock>;
+  let service: WebhookQueueService;
+
+  beforeEach(() => {
+    processor = {
+      processDocumentById: jest.fn().mockResolvedValue({ processed: true }),
+    };
+    settingRepo = {
+      findOneBy: jest.fn().mockResolvedValue(null),
+      create: jest.fn((x: unknown) => x),
+      save: jest.fn().mockResolvedValue(undefined),
+    };
+    queueRepo = createQueueRepoMock();
+    service = new WebhookQueueService(
+      processor as never,
+      settingRepo as never,
+      queueRepo as never,
+    );
+  });
+
+  it('reiht jede ID nur einmal ein (Dedup)', async () => {
+    await service.enqueue(5);
+    await service.enqueue(5);
+    expect(queueRepo.store.map((s) => s.documentId)).toEqual([5]);
+    expect(await service.count()).toBe(1);
+  });
+
+  it('verarbeitet alle eingereihten IDs und leert die Warteschlange', async () => {
+    await service.enqueue(1);
+    await service.enqueue(2);
+
+    await service.processQueue();
+
+    expect(processor.processDocumentById).toHaveBeenCalledWith(1);
+    expect(processor.processDocumentById).toHaveBeenCalledWith(2);
+    expect(processor.processDocumentById).toHaveBeenCalledTimes(2);
+    expect(queueRepo.store).toHaveLength(0);
+  });
+
+  it('entfernt die ID vor Verarbeitungsbeginn aus der Tabelle', async () => {
+    let containedWhileProcessing = true;
+    processor.processDocumentById.mockImplementation((id: number) => {
+      containedWhileProcessing = queueRepo.store.some(
+        (s) => s.documentId === id,
+      );
+      return Promise.resolve({ processed: true });
+    });
+
+    await service.enqueue(42);
+    await service.processQueue();
+
+    // Beim Verarbeitungsstart war die ID bereits aus der Tabelle entfernt.
+    expect(containedWhileProcessing).toBe(false);
+  });
+
+  it('arbeitet eine während der Verarbeitung erneut eingereihte ID erneut ab', async () => {
+    let firstRun = true;
+    processor.processDocumentById.mockImplementation(async (id: number) => {
+      // Beim ersten Lauf feuert der Webhook erneut, während verarbeitet wird.
+      if (firstRun && id === 7) {
+        firstRun = false;
+        await service.enqueue(7);
+      }
+      return { processed: true };
+    });
+
+    await service.enqueue(7);
+    await service.processQueue();
+
+    expect(processor.processDocumentById).toHaveBeenCalledTimes(2);
+    expect(queueRepo.store).toHaveLength(0);
+  });
+
+  it('startet keinen zweiten Durchlauf parallel (isProcessing-Guard)', async () => {
+    let resolveFirst: (() => void) | undefined;
+    let signalStarted!: () => void;
+    const started = new Promise<void>((res) => {
+      signalStarted = res;
+    });
+    processor.processDocumentById.mockImplementation(
+      () =>
+        new Promise<{ processed: boolean }>((res) => {
+          resolveFirst = () => res({ processed: true });
+          signalStarted(); // erste Verarbeitung läuft und blockiert hier
+        }),
+    );
+
+    await service.enqueue(1);
+    const firstRun = service.processQueue(); // blockiert in processDocumentById
+    await started; // warten, bis der erste Lauf tatsächlich verarbeitet
+    await service.processQueue(); // muss sofort zurückkehren (isProcessing)
+
+    expect(processor.processDocumentById).toHaveBeenCalledTimes(1);
+
+    resolveFirst?.();
+    await firstRun;
+  });
+
+  it('verarbeitet einen Eintrag erst nach der Mindest-Wartezeit', async () => {
+    // Frisch eingereihter Eintrag (Alter ~0) darf noch nicht verarbeitet werden.
+    queueRepo.store.push({ documentId: 99, createdAt: new Date() });
+
+    await service.processQueue();
+    expect(processor.processDocumentById).not.toHaveBeenCalled();
+    expect(queueRepo.store).toHaveLength(1);
+
+    // Nach Überschreiten der Mindest-Wartezeit (5000 ms) wird verarbeitet.
+    queueRepo.store[0].createdAt = new Date(Date.now() - 6000);
+    await service.processQueue();
+    expect(processor.processDocumentById).toHaveBeenCalledWith(99);
+    expect(queueRepo.store).toHaveLength(0);
+  });
+});
@@ -0,0 +1,197 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { Interval } from '@nestjs/schedule';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Raw, Repository } from 'typeorm';
+import { PaperlessProcessorService } from '../paperless/paperless-processor.service';
+import { Setting } from '../database/entities/setting.entity';
+import { WebhookQueueItem } from '../database/entities/webhook-queue-item.entity';
+
+// Tag (Schlüssel) des Settings-Eintrags, der den letzten Webhook-Aufruf festhält.
+const LAST_WEBHOOK_CALL_TAG = 'last_webhook_call';
+
+// Prüfintervall der Warteschlange (sehr kurz). Über ENV überschreibbar.
+const QUEUE_INTERVAL_MS = Number(process.env.WEBHOOK_QUEUE_INTERVAL_MS) || 1000;
+
+// Mindest-Verweildauer zwischen Einreihen und Verarbeitung. Ein Eintrag wird
+// frühestens verarbeitet, wenn er so lange in der Warteschlange lag. Über ENV
+// überschreibbar (Default 5000 ms).
+const MIN_QUEUE_AGE_MS = Number(process.env.WEBHOOK_QUEUE_MIN_AGE_MS) || 5000;
+
+interface WebhookStatusInfo {
+  documentId: number | null;
+  action?: string;
+  status: 'queued' | 'processed' | 'error' | 'bad-request';
+  reason?: string;
+  message?: string;
+}
+
+/**
+ * Entkoppelt den Webhook-Empfang von der Verarbeitung: Eingehende Dokument-IDs
+ * werden in eine **persistente**, deduplizierte Warteschlange (`webhook_queue`)
+ * gelegt und von einem separaten Intervall-Prozess **sequenziell** (ohne
+ * Überschneidung) abgearbeitet. So führt mehrfaches schnelles Speichern
+ * desselben Dokuments nicht zu parallelen Läufen.
+ *
+ * Verhalten:
+ * - Jede ID kommt nur **einmal** in der Warteschlange vor (Dedup via Primär-
+ *   schlüssel `documentId` / `INSERT IGNORE`).
+ * - Beim Verarbeitungsstart wird die ID **sofort** aus der Tabelle entfernt; ein
+ *   erneutes Feuern während der Verarbeitung reiht sie wieder ein (ein weiterer
+ *   Lauf folgt danach).
+ * - Es läuft immer nur eine Verarbeitung gleichzeitig (`isProcessing`-Guard).
+ * - Zwischen Einreihen und Verarbeitung liegen mindestens `MIN_QUEUE_AGE_MS`
+ *   (Default 5000 ms); jüngere Einträge warten bis zum nächsten Tick.
+ *
+ * Da die Warteschlange in der Datenbank liegt, überstehen ausstehende IDs einen
+ * Neustart und werden nach dem Boot weiterverarbeitet.
+ */
+@Injectable()
+export class WebhookQueueService {
+  private readonly logger = new Logger(WebhookQueueService.name);
+  private isProcessing = false;
+
+  constructor(
+    private readonly paperlessProcessor: PaperlessProcessorService,
+    @InjectRepository(Setting)
+    private readonly settingRepo: Repository<Setting>,
+    @InjectRepository(WebhookQueueItem)
+    private readonly queueRepo: Repository<WebhookQueueItem>,
+  ) {}
+
+  /** Anzahl der aktuell wartenden Dokument-IDs. */
+  count(): Promise<number> {
+    return this.queueRepo.count();
+  }
+
+  /**
+   * Reiht eine Dokument-ID zur Verarbeitung ein. Ist die ID bereits in der
+   * Warteschlange, wird sie nicht erneut hinzugefügt (Dedup über den Primär-
+   * schlüssel; `INSERT IGNORE` ist atomar und race-sicher).
+   */
+  async enqueue(documentId: number, action?: string): Promise<void> {
+    const result = await this.queueRepo
+      .createQueryBuilder()
+      .insert()
+      .into(WebhookQueueItem)
+      .values({ documentId, action: action ?? null })
+      .orIgnore()
+      .execute();
+
+    const added =
+      ((result.raw as { affectedRows?: number })?.affectedRows ?? 0) > 0;
+    if (added) {
+      this.logger.log(`Dokument ${documentId} eingereiht.`);
+    } else {
+      this.logger.log(
+        `Dokument ${documentId} ist bereits in der Warteschlange – nicht erneut hinzugefügt.`,
+      );
+    }
+    await this.recordStatus({ documentId, action, status: 'queued' });
+  }
+
+  /**
+   * Prüft in kurzen Abständen die Warteschlange und arbeitet vorhandene IDs
+   * nacheinander ab. Ein bereits laufender Durchlauf wird nicht doppelt
+   * gestartet (kein paralleles Verarbeiten).
+   */
+  @Interval(QUEUE_INTERVAL_MS)
+  async processQueue(): Promise<void> {
+    if (this.isProcessing) return;
+    this.isProcessing = true;
+    try {
+      // Solange (alte genug) Einträge vorhanden sind, sequenziell abarbeiten.
+      for (;;) {
+        // Ältesten Eintrag (FIFO) holen, der die Mindest-Wartezeit erfüllt.
+        // Der Altersvergleich läuft bewusst in der DB (NOW() vs. createdAt) und
+        // ist damit unabhängig von Zeitzone/Uhr des Node-Prozesses – ein Node/DB-
+        // Zeitversatz würde sonst den Vergleich verfälschen (Einträge nie "alt
+        // genug"). Nur ein numerisches Konstantenliteral wird interpoliert.
+        const [next] = await this.queueRepo.find({
+          where: {
+            createdAt: Raw(
+              (alias) =>
+                `${alias} <= (NOW(6) - INTERVAL ${MIN_QUEUE_AGE_MS * 1000} MICROSECOND)`,
+            ),
+          },
+          order: { createdAt: 'ASC' },
+          take: 1,
+        });
+        if (!next) break; // Warteschlange leer oder noch nichts alt genug
+        // SOFORT (vor Verarbeitungsstart) aus der Tabelle entfernen.
+        await this.queueRepo.delete({ documentId: next.documentId });
+        await this.handleDocument(next.documentId);
+      }
+    } finally {
+      this.isProcessing = false;
+    }
+  }
+
+  private async handleDocument(documentId: number): Promise<void> {
+    try {
+      await this.paperlessProcessor.processDocumentById(documentId);
+      this.logger.log(`Dokument ${documentId} aus Warteschlange verarbeitet.`);
+      await this.recordStatus({ documentId, status: 'processed' });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      this.logger.error(
+        `Fehler bei der Verarbeitung von Dokument ${documentId}: ${message}`,
+      );
+      await this.recordStatus({ documentId, status: 'error', message });
+    }
+  }
+
+  /**
+   * Liefert den letzten festgehaltenen Webhook-Status sowie die aktuelle
+   * Warteschlangen-Größe.
+   */
+  async getStatus(): Promise<{ lastCall: unknown; queueSize: number }> {
+    const setting = await this.settingRepo.findOneBy({
+      Tag: LAST_WEBHOOK_CALL_TAG,
+    });
+    let lastCall: unknown = null;
+    if (setting?.Wert) {
+      try {
+        lastCall = JSON.parse(setting.Wert);
+      } catch {
+        lastCall = { raw: setting.Wert };
+      }
+    }
+    return { lastCall, queueSize: await this.queueRepo.count() };
+  }
+
+  /**
+   * Hält den letzten Webhook-Vorgang in der Settings-Tabelle fest
+   * (Tag "last_webhook_call"). Fehler beim Speichern werden nur geloggt.
+   */
+  async recordStatus(info: WebhookStatusInfo): Promise<void> {
+    try {
+      const value = JSON.stringify({
+        at: new Date().toISOString(),
+        documentId: info.documentId,
+        action: info.action ?? null,
+        status: info.status,
+        ...(info.reason ? { reason: info.reason } : {}),
+        ...(info.message ? { message: info.message.slice(0, 100) } : {}),
+      });
+
+      let setting = await this.settingRepo.findOneBy({
+        Tag: LAST_WEBHOOK_CALL_TAG,
+      });
+      if (!setting) {
+        setting = this.settingRepo.create({
+          Typ: 0,
+          Tag: LAST_WEBHOOK_CALL_TAG,
+          Wert: value,
+        });
+      } else {
+        setting.Wert = value;
+      }
+      await this.settingRepo.save(setting);
+    } catch (err) {
+      this.logger.error(
+        'Konnte Webhook-Status nicht in den Settings speichern',
+        err instanceof Error ? err.stack : String(err),
+      );
+    }
+  }
+}
@@ -9,11 +9,8 @@ import {
  UseGuards,
  BadRequestException,
 } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
 import { ApiKeyGuard } from '../auth/api-key.guard';
-import { PaperlessProcessorService } from '../paperless/paperless-processor.service';
-import { Setting } from '../database/entities/setting.entity';
+import { WebhookQueueService } from './webhook-queue.service';

 export interface PaperlessWebhookPayload {
  doc_url?: string;
@@ -22,18 +19,11 @@ export interface PaperlessWebhookPayload {
  [key: string]: any;
 }

-// Tag (Schlüssel) des Settings-Eintrags, der den letzten Webhook-Aufruf festhält.
-const LAST_WEBHOOK_CALL_TAG = 'last_webhook_call';
-
@Controller('api/webhook')
 export class WebhookController {
  private readonly logger = new Logger(WebhookController.name);

-  constructor(
-    private readonly paperlessProcessor: PaperlessProcessorService,
-    @InjectRepository(Setting)
-    private readonly settingRepo: Repository<Setting>,
-  ) {}
+  constructor(private readonly webhookQueue: WebhookQueueService) {}

  @UseGuards(ApiKeyGuard)
  @Post('paperless')
@@ -44,7 +34,7 @@ export class WebhookController {
      this.logger.warn(
        `Webhook ohne ermittelbare Dokument-ID: ${JSON.stringify(payload)}`,
      );
-      await this.recordWebhookCall({
+      await this.webhookQueue.recordStatus({
        documentId: null,
        action: payload.action,
        status: 'bad-request',
@@ -55,54 +45,22 @@ export class WebhookController {
    }

    this.logger.log(
-      `Webhook: action=${payload.action}, document=${documentId}`,
+      `Webhook: action=${payload.action}, document=${documentId} → eingereiht`,
    );
-
-    try {
-      const result =
-        await this.paperlessProcessor.processDocumentById(documentId);
-      const status = result.processed ? 'processed' : 'skipped';
-      await this.recordWebhookCall({
-        documentId,
-        action: payload.action,
-        status,
-        reason: result.reason,
-      });
-      return { status, reason: result.reason };
-    } catch (err) {
-      // Fehler tolerieren (wie der bisherige Cron) und 200 zurückgeben,
-      // damit Paperless keine Retry-Schleife startet.
-      const message = err instanceof Error ? err.message : String(err);
-      this.logger.error(
-        `Fehler bei Webhook-Verarbeitung von Dokument ${documentId}: ${message}`,
-      );
-      await this.recordWebhookCall({
-        documentId,
-        action: payload.action,
-        status: 'error',
-        message,
-      });
-      return { status: 'error', message };
-    }
+    // Sofort einreihen und antworten; die eigentliche Verarbeitung übernimmt
+    // der separate Queue-Prozess (sequenziell, dedupliziert).
+    await this.webhookQueue.enqueue(documentId, payload.action);
+    return { status: 'queued', documentId };
  }

  /**
-   * Liefert Informationen zum letzten Webhook-Aufruf (Zeitpunkt, Dokument,
-   * Ergebnis). Über die globalen Guards per JWT oder API-Key zugänglich.
+   * Liefert Informationen zum letzten Webhook-Vorgang (Zeitpunkt, Dokument,
+   * Ergebnis) und die aktuelle Warteschlangen-Größe. Über die globalen Guards
+   * per JWT oder API-Key zugänglich.
   */
  @Get('status')
-  async getWebhookStatus(): Promise<{ lastCall: unknown }> {
-    const setting = await this.settingRepo.findOneBy({
-      Tag: LAST_WEBHOOK_CALL_TAG,
-    });
-    if (!setting?.Wert) {
-      return { lastCall: null };
-    }
-    try {
-      return { lastCall: JSON.parse(setting.Wert) };
-    } catch {
-      return { lastCall: { raw: setting.Wert } };
-    }
+  async getWebhookStatus(): Promise<{ lastCall: unknown; queueSize: number }> {
+    return this.webhookQueue.getStatus();
  }

  /**
@@ -124,47 +82,4 @@ export class WebhookController {
    }
    return null;
  }
-
-  /**
-   * Hält den letzten Webhook-Aufruf in der Settings-Tabelle fest
-   * (Tag "last_webhook_call"). Fehler beim Speichern werden nur geloggt und
-   * beeinflussen die Webhook-Antwort nicht.
-   */
-  private async recordWebhookCall(info: {
-    documentId: number | null;
-    action?: string;
-    status: string;
-    reason?: string;
-    message?: string;
-  }): Promise<void> {
-    try {
-      const value = JSON.stringify({
-        at: new Date().toISOString(),
-        documentId: info.documentId,
-        action: info.action ?? null,
-        status: info.status,
-        ...(info.reason ? { reason: info.reason } : {}),
-        ...(info.message ? { message: info.message.slice(0, 100) } : {}),
-      });
-
-      let setting = await this.settingRepo.findOneBy({
-        Tag: LAST_WEBHOOK_CALL_TAG,
-      });
-      if (!setting) {
-        setting = this.settingRepo.create({
-          Typ: 0,
-          Tag: LAST_WEBHOOK_CALL_TAG,
-          Wert: value,
-        });
-      } else {
-        setting.Wert = value;
-      }
-      await this.settingRepo.save(setting);
-    } catch (err) {
-      this.logger.error(
-        'Konnte letzten Webhook-Aufruf nicht in den Settings speichern',
-        err instanceof Error ? err.stack : String(err),
-      );
-    }
-  }
 }
@@ -1,12 +1,19 @@
 import { Module } from '@nestjs/common';
 import { TypeOrmModule } from '@nestjs/typeorm';
 import { WebhookController } from './webhook.controller';
+import { WebhookQueueService } from './webhook-queue.service';
 import { PaperlessModule } from '../paperless/paperless.module';
 import { AuthModule } from '../auth/auth.module';
 import { Setting } from '../database/entities/setting.entity';
+import { WebhookQueueItem } from '../database/entities/webhook-queue-item.entity';

@Module({
-  imports: [TypeOrmModule.forFeature([Setting]), PaperlessModule, AuthModule],
+  imports: [
+    TypeOrmModule.forFeature([Setting, WebhookQueueItem]),
+    PaperlessModule,
+    AuthModule,
+  ],
  controllers: [WebhookController],
+  providers: [WebhookQueueService],
 })
 export class WebhookModule {}
@@ -22,10 +22,7 @@ export class ZahlungController {
  }

  @Put('documents/:id/zahlung')
-  setZahlung(
-    @Param('id') id: string,
-    @Body('value') value: string | null,
-  ) {
+  setZahlung(@Param('id') id: string, @Body('value') value: string | null) {
    return this.zahlungService.setZahlung(parseInt(id, 10), value ?? null);
  }

@@ -20,7 +20,11 @@ export class ZahlungService {
    private readonly paperlessService: PaperlessService,
  ) {}

-  async getZahlungDocuments(page: number, pageSize: number, filter: ZahlungFilter) {
+  async getZahlungDocuments(
+    page: number,
+    pageSize: number,
+    filter: ZahlungFilter,
+  ) {
    const docTypes = await this.documentTypeRepo.find({
      where: { FreigabeErforderlich: true as any },
    });
@@ -44,7 +48,10 @@ export class ZahlungService {
      const result = await this.paperlessService.getDocuments(params);
      allDocs = result.results ?? [];
    } catch (err: any) {
-      this.logger.warn('Fehler beim Laden der Belege für Zahlung', err?.message);
+      this.logger.warn(
+        'Fehler beim Laden der Belege für Zahlung',
+        err?.message,
+      );
      return { count: 0, results: [] };
    }

@@ -73,9 +80,12 @@ export class ZahlungService {

  private getCfValue(doc: any, fieldId: number): string | null {
    const cf = (doc.custom_fields ?? []).find((f: any) => f.field === fieldId);
-    if (!cf || cf.value === null || cf.value === undefined || cf.value === '') return null;
+    if (!cf || cf.value === null || cf.value === undefined || cf.value === '')
+      return null;
    if (typeof cf.value === 'object') {
-      return String(cf.value?.id ?? cf.value?.value ?? cf.value?.label ?? '') || null;
+      return (
+        String(cf.value?.id ?? cf.value?.value ?? cf.value?.label ?? '') || null
+      );
    }
    return String(cf.value);
  }
@@ -91,20 +101,24 @@ export class ZahlungService {
    }

    const customFields: any[] = [...(doc.custom_fields ?? [])];
-    const existing = customFields.find((f: any) => f.field === ZAHLUNG_FIELD_ID);
+    const existing = customFields.find(
+      (f: any) => f.field === ZAHLUNG_FIELD_ID,
+    );
    if (existing) {
      existing.value = value;
    } else if (value !== null && value !== '') {
      customFields.push({ field: ZAHLUNG_FIELD_ID, value });
    }

-    await this.paperlessService.updateDocument(documentId, { custom_fields: customFields });
+    await this.paperlessService.updateDocument(documentId, {
+      custom_fields: customFields,
+    });
    return { success: true };
  }

  async getZahlungOptions(): Promise<{ id: string; label: string }[]> {
    const fields = await this.paperlessService.getCustomFields();
-    const field = (fields as any[]).find((f: any) => f.id === ZAHLUNG_FIELD_ID);
+    const field = fields.find((f: any) => f.id === ZAHLUNG_FIELD_ID);
    if (!field) return [];

    const rawOptions: any[] = field.extra_data?.select_options ?? [];
@@ -7,6 +7,7 @@ import { saveReturnUrl } from './auth/sessionRedirect';
 import { ThemeProvider, useTheme } from './theme/ThemeContext';
 import AuthCallback from './auth/AuthCallback';
 import AppLayout from './layouts/AppLayout';
+import AppErrorBoundary from './components/AppErrorBoundary';
 import { Spin, Result, Button } from 'antd';
 import type { ReactNode } from 'react';

@@ -76,6 +77,10 @@ function ThemedApp() {
        token: {
          colorPrimary: '#1677ff',
          borderRadius: 6,
+          // Gleiche Schriftfamilie wie der Body (index.css), damit AntD-Eingaben
+          // – z.B. das Select-Suchfeld – nicht im AntD-Default-Stack abweichen.
+          fontFamily:
+            "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif",
          ...(isDark
            ? {}
            : {
@@ -113,6 +118,7 @@ function ThemedApp() {
      <AuthProvider>
        <AntdApp>
          <BrowserRouter>
+            <AppErrorBoundary>
            <Suspense fallback={<div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', height: '100vh' }}><Spin size="large" /></div>}>
              <Routes>
                <Route path="/login" element={<LoginPage />} />
@@ -139,6 +145,7 @@ function ThemedApp() {
                </Route>
              </Routes>
            </Suspense>
+            </AppErrorBoundary>
          </BrowserRouter>
        </AntdApp>
      </AuthProvider>
@@ -1,8 +1,12 @@
-import axios from 'axios';
-import { getAccessToken } from '../auth/oidc';
+import axios, { type InternalAxiosRequestConfig } from 'axios';
+import { getAccessToken, renewToken } from '../auth/oidc';
 import { triggerLoginRedirect } from '../auth/sessionRedirect';
 import { getEnv } from '../utils/env';

+// Markiert eine bereits einmal wiederholte Anfrage, um Endlosschleifen zu
+// vermeiden.
+type RetryConfig = InternalAxiosRequestConfig & { _retried?: boolean };
+
 const api = axios.create({
  baseURL: getEnv('VITE_API_URL') || '',
  timeout: 30000,
@@ -19,7 +23,18 @@ api.interceptors.request.use(async (config) => {
 api.interceptors.response.use(
  (response) => response,
  async (error) => {
-    if (error.response?.status === 401) {
+    const original = error.config as RetryConfig | undefined;
+    if (error.response?.status === 401 && original && !original._retried) {
+      original._retried = true;
+      // Erst still erneuern und die Anfrage einmal wiederholen, bevor wir den
+      // Nutzer zu einer kompletten Neuanmeldung zwingen.
+      const user = await renewToken();
+      if (user?.access_token) {
+        original.headers.Authorization = `Bearer ${user.access_token}`;
+        return api(original);
+      }
+      // Erneuerung fehlgeschlagen (Refresh-Token ungültig/abgelaufen) →
+      // echte Neuanmeldung nötig.
      await triggerLoginRedirect();
    }
    return Promise.reject(error);
@@ -4,7 +4,6 @@ export interface FreigabeDocument {
  id: number;
  title: string;
  created: string;
-  created_date: string;
  correspondent: number | null;
  document_type: number | null;
  archive_serial_number: number | null;
@@ -208,6 +208,8 @@ export interface AgrarmonitorPollingConfig {
  tagHochgeladen: string;
  linkField: string;
  tagManuell: string;
+  importWartezeitMinuten: string;
+  notizMarker: string;
 }

 export interface AgrarmonitorPollingResult {
@@ -4,13 +4,14 @@ export interface WebhookLastCall {
  at: string; // ISO-Zeitstempel
  documentId: number | null;
  action: string | null;
-  status: 'processed' | 'skipped' | 'error' | 'bad-request' | string;
+  status: 'queued' | 'processed' | 'error' | 'bad-request' | string;
  reason?: string;
  message?: string;
 }

 export interface WebhookStatus {
  lastCall: WebhookLastCall | null;
+  queueSize?: number;
 }

 export const webhookApi = {
@@ -6,7 +6,6 @@ export interface ZahlungDocument {
  id: number;
  title: string;
  created: string;
-  created_date: string;
  correspondent: number | null;
  document_type: number | null;
  archive_serial_number: number | null;
@@ -34,9 +34,36 @@ export async function getUser(): Promise<User | null> {
  return userManager.getUser();
 }

+// Laufender Silent-Renew-Vorgang – mehrere gleichzeitige Aufrufe teilen sich
+// denselben Refresh (Dedup), damit nicht parallele signinSilent-Aufrufe mit
+// einem rotierenden Refresh-Token kollidieren (invalid_grant).
+let renewPromise: Promise<User | null> | null = null;
+
+/**
+ * Erneuert das Token still über den Refresh-Token (signinSilent). Schlägt die
+ * Erneuerung fehl, wird null geliefert (statt zu werfen). Gleichzeitige Aufrufe
+ * werden dedupliziert.
+ */
+export function renewToken(): Promise<User | null> {
+  if (!renewPromise) {
+    renewPromise = userManager.signinSilent().catch((err: unknown) => {
+      console.error('OIDC: signinSilent fehlgeschlagen', err);
+      return null;
+    });
+    void renewPromise.finally(() => {
+      renewPromise = null;
+    });
+  }
+  return renewPromise;
+}
+
 export async function getAccessToken(): Promise<string | null> {
  const user = await getUser();
-  return user?.access_token ?? null;
+  if (!user) return null; // nicht eingeloggt
+  if (!user.expired) return user.access_token ?? null;
+  // Token ist abgelaufen → vor dem Senden still erneuern.
+  const renewed = await renewToken();
+  return renewed?.access_token ?? null;
 }

 export { userManager };
@@ -0,0 +1,62 @@
+import { Component } from 'react';
+import type { ReactNode } from 'react';
+import { Button, Result } from 'antd';
+
+interface Props {
+  children: ReactNode;
+}
+
+interface State {
+  error: Error | null;
+}
+
+// Erkennt fehlgeschlagene Lazy-Chunk-Imports:
+// Safari:  "Importing a module script failed."
+// Chrome:  "Failed to fetch dynamically imported module: …"
+// Firefox: "error loading dynamically imported module"
+function istChunkLadefehler(error: Error): boolean {
+  return /module script failed|dynamically imported module/i.test(error.message);
+}
+
+/**
+ * Fängt Renderfehler ab, die sonst den kompletten React-Baum aushängen und
+ * nur eine weiße Seite hinterlassen — insbesondere fehlgeschlagene
+ * React.lazy-Chunk-Imports nach einem Deployment oder bei beschädigtem
+ * Browser-Cache (Assets werden mit "immutable" gecacht und nie revalidiert).
+ */
+export default class AppErrorBoundary extends Component<Props, State> {
+  state: State = { error: null };
+
+  static getDerivedStateFromError(error: Error): State {
+    return { error };
+  }
+
+  componentDidCatch(error: Error) {
+    console.error('AppErrorBoundary:', error);
+  }
+
+  render() {
+    const { error } = this.state;
+    if (!error) return this.props.children;
+
+    return (
+      <Result
+        status="error"
+        title="Die Seite konnte nicht geladen werden"
+        subTitle={
+          istChunkLadefehler(error)
+            ? 'Ein Teil der Anwendung konnte nicht nachgeladen werden — vermutlich wurde die ' +
+              'Anwendung aktualisiert oder eine zwischengespeicherte Datei ist beschädigt. ' +
+              'Bitte neu laden. Hilft das nicht, den Browser-Cache leeren ' +
+              '(Safari: Verlauf → Websitedaten löschen).'
+            : error.message
+        }
+        extra={
+          <Button type="primary" onClick={() => window.location.reload()}>
+            Seite neu laden
+          </Button>
+        }
+      />
+    );
+  }
+}
@@ -1,6 +1,6 @@
 import { useEffect, useState, useCallback } from 'react';
 import { Modal, Form, Select, DatePicker, Input, Spin, message, Row, Col, Button, Space, Divider, Tag } from 'antd';
-import { PlusOutlined, EyeOutlined, SearchOutlined } from '@ant-design/icons';
+import { PlusOutlined, EyeOutlined, SearchOutlined, ExportOutlined } from '@ant-design/icons';
 import dayjs from 'dayjs';
 import { posteingangApi } from '../api/posteingang';
 import type { DocumentRequirement, PosteingangDocument, Kontonummer } from '../api/posteingang';
@@ -11,6 +11,7 @@ import type { PaperlessDocType, PaperlessCorrespondent, PaperlessTag } from '../
 import { getEnv } from '../utils/env';
 import { AuthIframe, openAuthUrl } from '../utils/auth-resource';
 import DocumentSearchModal from './DocumentSearchModal';
+import { useIsMobile } from '../hooks/useIsMobile';

 const { Option } = Select;

@@ -26,6 +27,7 @@ interface Props {

 export default function DocumentEditModal({ documentId, document, open, onClose, onSave, isPosteingang = true, hasNextDocument = true }: Props) {
  const [form] = Form.useForm();
+  const isMobile = useIsMobile();
  
  const [loading, setLoading] = useState(false);
  const [saving, setSaving] = useState(false);
@@ -292,28 +294,51 @@ export default function DocumentEditModal({ documentId, document, open, onClose,
    }
  };

+  const runSave = async (values: any, isNext: boolean) => {
+    // Kontonummer-Logik (unverändert): neue Kontonummer ggf. bestätigen lassen.
+    const kontonummerReq = requirements.find(r => r.customFieldIndex === 5);
+    if (kontonummerReq && values['cf_5'] && values.correspondent) {
+      const kNummer = values['cf_5'];
+      const knData = await posteingangApi.getKontonummern(values.correspondent);
+      const exists = knData.some(k => k.Nummer === kNummer);
+      if (!exists) {
+        // Prompt user to save kontonummer
+        setKontonummerMissing({ correspondentId: values.correspondent, nummer: kNummer });
+        return; // Stop saving, wait for confirmation
+      }
+    }
+    await handleSaveDocument(values, isNext);
+  };
+
  const handleSubmit = async (isNext: boolean = false) => {
    try {
-        const values = await form.validateFields();
-        
-        // Kontonummer Logic
-        const kontonummerReq = requirements.find(r => r.customFieldIndex === 5);
-        if (kontonummerReq && values[`cf_5`] && values.correspondent) {
-            const kNummer = values[`cf_5`];
-            const knData = await posteingangApi.getKontonummern(values.correspondent);
-            const exists = knData.some(k => k.Nummer === kNummer);
-            
-            if (!exists) {
-                // Prompt user to save kontonummer
-                setKontonummerMissing({ correspondentId: values.correspondent, nummer: kNummer });
-                return; // Stop saving, wait for confirmation
-            }
-        }
-
-        await handleSaveDocument(values, isNext);
+      const values = await form.validateFields();
+      await runSave(values, isNext);
    } catch (e) {
-        // Validation failed
+      const errorFields =
+        (e as { errorFields?: { name: unknown; errors: string[] }[] })?.errorFields ?? [];
+
+      // Kein Validierungsfehler, oder Posteingang → bisheriges Verhalten (stiller Abbruch).
+      if (errorFields.length === 0 || isPosteingang) {
        console.error("Form validation failed:", e);
+        return;
+      }
+
+      // "Manuell bearbeiten": Speichern trotz fehlender Pflichtfelder mit Hinweis anbieten.
+      const missing = Array.from(new Set(errorFields.flatMap((f) => f.errors)));
+      Modal.confirm({
+        title: 'Pflichtfelder unvollständig',
+        okText: 'Trotzdem speichern',
+        cancelText: 'Abbrechen',
+        content: (
+          <div>
+            <p>Nicht alle Pflichtfelder sind ausgefüllt:</p>
+            <ul>{missing.map((m, i) => <li key={i}>{m}</li>)}</ul>
+            <p>Möchtest du trotzdem speichern?</p>
+          </div>
+        ),
+        onOk: () => runSave(form.getFieldsValue(), isNext),
+      });
    }
  };

@@ -349,8 +374,8 @@ export default function DocumentEditModal({ documentId, document, open, onClose,
        title={`Dokument bearbeiten (${document?.title || ''})`}
        open={open && !kontonummerMissing}
        onCancel={() => onClose(false)}
-        width={1400}
-        style={{ top: 20 }}
+        width={{ xs: '100vw', md: 900, xl: 1400 }}
+        style={isMobile ? {} : { top: 20 }}
        footer={
           hasNextDocument ? [
               <Button key="cancel" onClick={() => onClose(false)}>Abbrechen</Button>,
@@ -363,8 +388,12 @@ export default function DocumentEditModal({ documentId, document, open, onClose,
        }
      >
        <Spin spinning={loading}>
-            <Row gutter={16} style={{ height: '75vh', overflow: 'hidden' }}>
-                <Col span={10} style={{ overflowY: 'auto', paddingRight: '1rem', borderRight: '1px solid #f0f0f0' }}>
+            <Row gutter={[16, 16]} style={isMobile ? {} : { height: '75vh', overflow: 'hidden' }}>
+                <Col
+                    xs={24}
+                    lg={10}
+                    style={isMobile ? {} : { overflowY: 'auto', paddingRight: '1rem', borderRight: '1px solid #f0f0f0' }}
+                >
                    <Form form={form} layout="vertical" disabled={saving}>
                        
                        <Form.Item name="mandant" label="Mandant" rules={[{ required: true, message: 'Wähle einen Mandanten' }]}>
@@ -556,10 +585,20 @@ export default function DocumentEditModal({ documentId, document, open, onClose,
                        })}
                    </Form>
                </Col>
-                <Col span={14} style={{ height: '100%' }}>
+                <Col xs={24} lg={14} style={isMobile ? {} : { height: '100%' }}>
+                    {isMobile && (
+                        <Button
+                            icon={<ExportOutlined />}
+                            block
+                            style={{ marginBottom: 8 }}
+                            onClick={() => openAuthUrl(`${getEnv('VITE_API_URL')}/api/paperless/inbox/pdf/${documentId}`)}
+                        >
+                            PDF in neuem Tab öffnen
+                        </Button>
+                    )}
                    <AuthIframe
                      src={`${getEnv('VITE_API_URL')}/api/paperless/inbox/pdf/${documentId}#toolbar=0`}
-                      style={{ width: '100%', height: '100%' }}
+                      style={{ width: '100%', height: isMobile ? '50vh' : '100%' }}
                      title="PDF Preview"
                    />
                </Col>
@@ -57,7 +57,7 @@ export default function DocumentSearchModal({ open, onCancel, onSelect }: Props)
      open={open}
      onCancel={onCancel}
      footer={null}
-      width={800}
+      width={{ xs: '100vw', md: 800 }}
      style={{ top: 50 }}
    >
      <div style={{ marginBottom: 16 }}>
@@ -100,7 +100,7 @@ export default function DocumentSearchModal({ open, onCancel, onSelect }: Props)
                description={
                  <Space direction="vertical" size={0}>
                    <Text type="secondary" style={{ fontSize: 12 }}>ID: {doc.id} | ASN: {doc.archive_serial_number || 'Keine'}</Text>
-                    <Text type="secondary" style={{ fontSize: 12 }}>Erstellt: {dayjs(doc.created_date).format('DD.MM.YYYY')}</Text>
+                    <Text type="secondary" style={{ fontSize: 12 }}>Erstellt: {dayjs(doc.created).format('DD.MM.YYYY')}</Text>
                  </Space>
                }
              />
@@ -538,8 +538,8 @@ export default function MailImportWizard({ visible, onClose, onSuccess, email, a
         {toProcess.map(item => (
            <div key={item.virtualId} style={{ marginBottom: 24, padding: 16, border: '1px solid #f0f0f0', borderRadius: 8 }}>
               <Text strong style={{ fontSize: 16, marginBottom: 12, display: 'block' }}>{item.fileName}</Text>
-               <Row gutter={24}>
-                  <Col span={8}>
+               <Row gutter={[24, 16]}>
+                  <Col xs={24} lg={8}>
                     {/* Eingangsdatum */}
                     <div style={{ marginBottom: 16 }}>
                        <Text style={{ display: 'block', marginBottom: 4 }}>Eingangsdatum:</Text>
@@ -626,7 +626,7 @@ export default function MailImportWizard({ visible, onClose, onSuccess, email, a
                        </Text>
                     </div>
                  </Col>
-                  <Col span={16}>
+                  <Col xs={24} lg={16}>
                      <BarcodePositioner
                        attachmentId={item.attachmentId}
                        startPage={item.pages?.start}
@@ -666,9 +666,9 @@ export default function MailImportWizard({ visible, onClose, onSuccess, email, a
          return (
            <div key={main.virtualId} style={{ marginBottom: 24, padding: 16, border: '1px solid #f0f0f0', borderRadius: 8 }}>
              <Text strong style={{ fontSize: 16, marginBottom: 12, display: 'block' }}>{main.fileName}</Text>
-              <Row gutter={24} align="middle">
-                <Col span={showPrint ? 20 : 24}>
-                  <Space size={24}>
+              <Row gutter={[24, 12]} align="middle">
+                <Col xs={24} md={showPrint ? 20 : 24}>
+                  <Space size={24} wrap>
                    <Text type="secondary">
                      Eingangsdatum: <Text strong>{datum?.format('DD.MM.YYYY') ?? '—'}</Text>
                    </Text>
@@ -690,7 +690,7 @@ export default function MailImportWizard({ visible, onClose, onSuccess, email, a
                  )}
                </Col>
                {showPrint && (
-                  <Col span={4} style={{ textAlign: 'right' }}>
+                  <Col xs={24} md={4} style={{ textAlign: 'right' }}>
                    <Button icon={<PrinterOutlined />} onClick={() => printDocument(main.virtualId, main.attachmentId)}>
                      Drucken
                    </Button>
@@ -735,7 +735,7 @@ export default function MailImportWizard({ visible, onClose, onSuccess, email, a
      title="Paperless Import-Wizard"
      open={visible}
      onCancel={onClose}
-      width={1000}
+      width={{ xs: '100vw', md: 900, lg: 1000 }}
      footer={
        importSuccess ? (
          <Button type="primary" onClick={onSuccess ?? onClose}>Schließen</Button>
@@ -0,0 +1,64 @@
+import type { ReactNode } from 'react';
+import { List, Card } from 'antd';
+import type { TablePaginationConfig } from 'antd';
+
+interface MobileCardListProps<T> {
+  dataSource: T[];
+  rowKey: keyof T | ((record: T) => React.Key);
+  loading?: boolean;
+  /** Gleiche Pagination-Config wie bei <Table> — wird durchgereicht (mobil kompakt). */
+  pagination?: TablePaginationConfig | false;
+  /** Seitenspezifischer Karteninhalt für einen Datensatz. */
+  renderCard: (record: T) => ReactNode;
+  onCardClick?: (record: T) => void;
+  emptyText?: string;
+}
+
+/**
+ * Mobile Karten-Ansicht als Ersatz für breite Tabellen:
+ * eine Karte pro Datensatz, Pagination wie bei der Tabelle.
+ */
+export default function MobileCardList<T>({
+  dataSource,
+  rowKey,
+  loading,
+  pagination,
+  renderCard,
+  onCardClick,
+  emptyText = 'Keine Einträge vorhanden',
+}: MobileCardListProps<T>) {
+  const getKey = (record: T): React.Key =>
+    typeof rowKey === 'function' ? rowKey(record) : (record[rowKey] as React.Key);
+
+  return (
+    <List
+      dataSource={dataSource}
+      loading={loading}
+      rowKey={getKey}
+      locale={{ emptyText }}
+      pagination={
+        pagination
+          ? {
+              ...pagination,
+              position: undefined,
+              simple: true,
+              showSizeChanger: false,
+            }
+          : false
+      }
+      renderItem={(record) => (
+        <List.Item style={{ padding: 0, marginBottom: 8, borderBlockEnd: 'none' }}>
+          <Card
+            size="small"
+            style={{ width: '100%' }}
+            styles={{ body: { padding: 12 } }}
+            hoverable={!!onCardClick}
+            onClick={onCardClick ? () => onCardClick(record) : undefined}
+          >
+            {renderCard(record)}
+          </Card>
+        </List.Item>
+      )}
+    />
+  );
+}
@@ -0,0 +1,11 @@
+import { Grid } from 'antd';
+
+/**
+ * Zentraler Breakpoint-Hook: mobil = Viewport unter `md` (768px).
+ * Beim allerersten Render liefert useBreakpoint() noch keine Werte —
+ * dann Desktop annehmen, um ein Layout-Flackern zu vermeiden.
+ */
+export function useIsMobile(): boolean {
+  const screens = Grid.useBreakpoint();
+  return screens.md === undefined ? false : !screens.md;
+}
@@ -139,3 +139,29 @@ body {
 .ant-picker-input > input {
  font-size: 14px !important;
 }
+
+/* ── Responsive / Mobile ─────────────────────────────────────── */
+
+html {
+  -webkit-text-size-adjust: 100%;
+}
+
+@media (max-width: 767px) {
+  .ant-modal {
+    top: 8px;
+  }
+
+  /* Modal-Inhalte scrollbar statt abgeschnitten (v. a. Settings-Dialoge) */
+  .ant-modal .ant-modal-body {
+    max-height: calc(100dvh - 160px);
+    overflow-y: auto;
+    -webkit-overflow-scrolling: touch;
+  }
+
+  /* Sicherheitsnetz: Tabellen ohne Karten-Ansicht seitlich scrollbar */
+  .ant-table-content,
+  .ant-table-body {
+    overflow-x: auto;
+    -webkit-overflow-scrolling: touch;
+  }
+}
@@ -1,6 +1,6 @@
 import { useState, useEffect } from 'react';
 import { Outlet, useNavigate, useLocation } from 'react-router-dom';
-import { Layout, Menu, Avatar, Dropdown, theme, Typography, Tooltip, Badge } from 'antd';
+import { Layout, Menu, Avatar, Dropdown, theme, Typography, Tooltip, Badge, Drawer, Button } from 'antd';
 import {
  InboxOutlined,
  FileTextOutlined,
@@ -15,9 +15,11 @@ import {
  GlobalOutlined,
  CheckCircleOutlined,
  EuroOutlined,
+  MenuOutlined,
 } from '@ant-design/icons';
 import { useAuth } from '../auth/AuthContext';
 import { useTheme } from '../theme/ThemeContext';
+import { useIsMobile } from '../hooks/useIsMobile';
 import { Permission } from '../auth/permissions';
 import { statsApi, type StatsCounts } from '../api/stats';

@@ -47,14 +49,19 @@ const allMenuItems: MenuItemDef[] = [

 export default function AppLayout() {
  const [collapsed, setCollapsed] = useState(false);
+  const [drawerOpen, setDrawerOpen] = useState(false);
  const navigate = useNavigate();
  const location = useLocation();
  const { user, logout, hasPermission, isAuthenticated } = useAuth();
  const { token: themeToken } = theme.useToken();
  const { isDark, toggleTheme } = useTheme();
+  const isMobile = useIsMobile();

  const [counts, setCounts] = useState<StatsCounts | null>(null);

+  // Im Drawer (mobil) ist die Navigation nie eingeklappt
+  const effectiveCollapsed = isMobile ? false : collapsed;
+
  useEffect(() => {
    if (!isAuthenticated) return;

@@ -80,7 +87,7 @@ export default function AppLayout() {
      label: (
        <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', width: '100%', paddingRight: 8 }}>
          <span>{item.label}</span>
-          {item.countKey && counts && counts[item.countKey] > 0 && !collapsed && (
+          {item.countKey && counts && counts[item.countKey] > 0 && !effectiveCollapsed && (
            <Badge
              count={counts[item.countKey]}
              overflowCount={99}
@@ -107,158 +114,231 @@ export default function AppLayout() {

  const logoColor = isDark ? '#fff' : '#1a1a2e';
  const subtleColor = isDark ? '#ffffffa6' : '#4a4a6a';
+  const dividerColor = isDark ? 'rgba(255,255,255,0.08)' : '#e2e4ea';
+
+  // Sidebar-Inhalt (Logo, Menü, Bottom-Sektion) — identisch für Sider (Desktop)
+  // und Drawer (mobil). `onNavigate` schließt auf Mobil den Drawer.
+  const renderSidebarContent = (isCollapsed: boolean, onNavigate?: () => void) => (
+    <>
+      {/* Logo / Collapse-Toggle */}
+      <button
+        onClick={() => (onNavigate ? onNavigate() : setCollapsed(!collapsed))}
+        style={{
+          height: 56,
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          cursor: 'pointer',
+          userSelect: 'none',
+          border: 'none',
+          borderBottom: `1px solid ${dividerColor}`,
+          background: 'transparent',
+          width: '100%',
+          padding: 0,
+          transition: 'background 0.2s',
+        }}
+        onMouseEnter={(e) => (e.currentTarget.style.background = isDark ? 'rgba(255,255,255,0.04)' : 'rgba(0,0,0,0.02)')}
+        onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
+      >
+        <Text strong style={{ color: logoColor, fontSize: isCollapsed ? 14 : 18, transition: 'font-size 0.2s' }}>
+          {isCollapsed ? 'PM' : 'Paperless'}
+        </Text>
+      </button>
+
+      {/* Navigation Menu */}
+      <Menu
+        theme={isDark ? 'dark' : 'light'}
+        mode="inline"
+        selectedKeys={[selectedKey]}
+        items={menuItems}
+        onClick={({ key }) => {
+          const item = allMenuItems.find((i) => i.key === key);
+          if (item?.externalUrl) {
+            window.open(item.externalUrl, '_blank', 'noopener,noreferrer');
+          } else {
+            navigate(key);
+          }
+          onNavigate?.();
+        }}
+        style={isDark ? { flex: 1 } : { background: 'transparent', flex: 1 }}
+      />
+
+      {/* Bottom Section: User + Theme Toggle */}
+      <div
+        style={{
+          position: 'absolute',
+          bottom: 0,
+          left: 0,
+          right: 0,
+          borderTop: `1px solid ${dividerColor}`,
+          padding: isCollapsed ? '12px 0' : '12px 16px',
+          display: 'flex',
+          flexDirection: 'column',
+          gap: 4,
+          transition: 'padding 0.2s',
+        }}
+      >
+        {/* Theme Toggle */}
+        <Tooltip title={isDark ? 'Light Mode' : 'Dark Mode'} placement="right">
+          <button
+            onClick={toggleTheme}
+            style={{
+              display: 'flex',
+              alignItems: 'center',
+              gap: 10,
+              padding: isCollapsed ? '8px 0' : '8px 12px',
+              borderRadius: 6,
+              cursor: 'pointer',
+              color: subtleColor,
+              justifyContent: isCollapsed ? 'center' : 'flex-start',
+              border: 'none',
+              background: 'transparent',
+              width: '100%',
+              transition: 'background 0.2s',
+            }}
+            onMouseEnter={(e) => (e.currentTarget.style.background = isDark ? 'rgba(255,255,255,0.08)' : '#eef1f8')}
+            onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
+          >
+            {isDark ? <SunOutlined style={{ fontSize: 16 }} /> : <MoonOutlined style={{ fontSize: 16 }} />}
+            {!isCollapsed && <Text style={{ color: subtleColor, fontSize: 13 }}>{isDark ? 'Light Mode' : 'Dark Mode'}</Text>}
+          </button>
+        </Tooltip>
+
+        {/* User Menu */}
+        <Dropdown
+          menu={{
+            items: [
+              {
+                key: 'user-settings',
+                icon: <SettingOutlined />,
+                label: 'Benutzereinstellungen',
+                onClick: () => {
+                  navigate('/user-settings');
+                  onNavigate?.();
+                },
+              },
+              {
+                key: 'logout',
+                icon: <LogoutOutlined />,
+                label: 'Abmelden',
+                onClick: () => logout(),
+              },
+            ],
+          }}
+          placement="topRight"
+          trigger={['click']}
+        >
+          <div
+            style={{
+              display: 'flex',
+              alignItems: 'center',
+              gap: 10,
+              padding: isCollapsed ? '8px 0' : '8px 12px',
+              borderRadius: 6,
+              cursor: 'pointer',
+              justifyContent: isCollapsed ? 'center' : 'flex-start',
+              transition: 'all 0.2s',
+            }}
+            onMouseEnter={(e) => (e.currentTarget.style.background = isDark ? 'rgba(255,255,255,0.08)' : '#eef1f8')}
+            onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
+          >
+            <Avatar size="small" icon={<UserOutlined />} />
+            {!isCollapsed && (
+              <Text ellipsis style={{ color: subtleColor, fontSize: 13, maxWidth: 120 }}>
+                {user?.profile?.name || 'Benutzer'}
+              </Text>
+            )}
+          </div>
+        </Dropdown>
+      </div>
+    </>
+  );

  return (
    <Layout style={{ minHeight: '100vh' }}>
-      <Sider
-        width={240}
-        trigger={null}
-        collapsible
-        collapsed={collapsed}
-        theme={isDark ? 'dark' : 'light'}
-        style={{
-          overflow: 'hidden',
-          height: '100vh',
-          position: 'fixed',
-          left: 0,
-          top: 0,
-          bottom: 0,
-          display: 'flex',
-          flexDirection: 'column',
-          ...siderStyle,
-        }}
-      >
-        {/* Logo / Collapse-Toggle */}
-        <button
-          onClick={() => setCollapsed(!collapsed)}
-          style={{
-            height: 56,
-            display: 'flex',
-            alignItems: 'center',
-            justifyContent: 'center',
-            cursor: 'pointer',
-            userSelect: 'none',
-            border: 'none',
-            borderBottom: `1px solid ${isDark ? 'rgba(255,255,255,0.08)' : '#e2e4ea'}`,
-            background: 'transparent',
-            width: '100%',
-            padding: 0,
-            transition: 'background 0.2s',
-          }}
-          onMouseEnter={(e) => (e.currentTarget.style.background = isDark ? 'rgba(255,255,255,0.04)' : 'rgba(0,0,0,0.02)')}
-          onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
-        >
-          <Text strong style={{ color: logoColor, fontSize: collapsed ? 14 : 18, transition: 'font-size 0.2s' }}>
-            {collapsed ? 'PM' : 'Paperless'}
-          </Text>
-        </button>
+      {isMobile ? (
+        <>
+          {/* Mobile Top-Bar mit Hamburger */}
+          <div
+            style={{
+              position: 'fixed',
+              top: 0,
+              left: 0,
+              right: 0,
+              height: 48,
+              zIndex: 100,
+              display: 'flex',
+              alignItems: 'center',
+              gap: 8,
+              padding: '0 8px',
+              background: themeToken.colorBgContainer,
+              borderBottom: `1px solid ${dividerColor}`,
+            }}
+          >
+            <Button
+              type="text"
+              icon={<MenuOutlined />}
+              aria-label="Menü öffnen"
+              onClick={() => setDrawerOpen(true)}
+            />
+            <Text strong style={{ color: logoColor, fontSize: 18 }}>Paperless</Text>
+          </div>

-        {/* Navigation Menu */}
-        <Menu
+          <Drawer
+            placement="left"
+            width={260}
+            open={drawerOpen}
+            onClose={() => setDrawerOpen(false)}
+            closable={false}
+            styles={{
+              body: {
+                padding: 0,
+                position: 'relative',
+                background: isDark ? '#001529' : '#f0f2f7',
+              },
+            }}
+          >
+            {renderSidebarContent(false, () => setDrawerOpen(false))}
+          </Drawer>
+        </>
+      ) : (
+        <Sider
+          width={240}
+          trigger={null}
+          collapsible
+          collapsed={collapsed}
          theme={isDark ? 'dark' : 'light'}
-          mode="inline"
-          selectedKeys={[selectedKey]}
-          items={menuItems}
-          onClick={({ key }) => {
-            const item = allMenuItems.find((i) => i.key === key);
-            if (item?.externalUrl) {
-              window.open(item.externalUrl, '_blank', 'noopener,noreferrer');
-            } else {
-              navigate(key);
-            }
-          }}
-          style={isDark ? { flex: 1 } : { background: 'transparent', flex: 1 }}
-        />
-
-        {/* Bottom Section: User + Theme Toggle */}
-        <div
          style={{
-            position: 'absolute',
-            bottom: 0,
+            overflow: 'hidden',
+            height: '100vh',
+            position: 'fixed',
            left: 0,
-            right: 0,
-            borderTop: `1px solid ${isDark ? 'rgba(255,255,255,0.08)' : '#e2e4ea'}`,
-            padding: collapsed ? '12px 0' : '12px 16px',
+            top: 0,
+            bottom: 0,
            display: 'flex',
            flexDirection: 'column',
-            gap: 4,
-            transition: 'padding 0.2s',
+            ...siderStyle,
          }}
        >
-          {/* Theme Toggle */}
-          <Tooltip title={isDark ? 'Light Mode' : 'Dark Mode'} placement="right">
-            <button
-              onClick={toggleTheme}
-              style={{
-                display: 'flex',
-                alignItems: 'center',
-                gap: 10,
-                padding: collapsed ? '8px 0' : '8px 12px',
-                borderRadius: 6,
-                cursor: 'pointer',
-                color: subtleColor,
-                justifyContent: collapsed ? 'center' : 'flex-start',
-                border: 'none',
-                background: 'transparent',
-                width: '100%',
-                transition: 'background 0.2s',
-              }}
-              onMouseEnter={(e) => (e.currentTarget.style.background = isDark ? 'rgba(255,255,255,0.08)' : '#eef1f8')}
-              onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
-            >
-              {isDark ? <SunOutlined style={{ fontSize: 16 }} /> : <MoonOutlined style={{ fontSize: 16 }} />}
-              {!collapsed && <Text style={{ color: subtleColor, fontSize: 13 }}>{isDark ? 'Light Mode' : 'Dark Mode'}</Text>}
-            </button>
-          </Tooltip>
+          {renderSidebarContent(collapsed)}
+        </Sider>
+      )}

-          {/* User Menu */}
-          <Dropdown
-            menu={{
-              items: [
-                {
-                  key: 'user-settings',
-                  icon: <SettingOutlined />,
-                  label: 'Benutzereinstellungen',
-                  onClick: () => navigate('/user-settings'),
-                },
-                {
-                  key: 'logout',
-                  icon: <LogoutOutlined />,
-                  label: 'Abmelden',
-                  onClick: () => logout(),
-                },
-              ],
-            }}
-            placement="topRight"
-            trigger={['click']}
-          >
-            <div
-              style={{
-                display: 'flex',
-                alignItems: 'center',
-                gap: 10,
-                padding: collapsed ? '8px 0' : '8px 12px',
-                borderRadius: 6,
-                cursor: 'pointer',
-                justifyContent: collapsed ? 'center' : 'flex-start',
-                transition: 'all 0.2s',
-              }}
-              onMouseEnter={(e) => (e.currentTarget.style.background = isDark ? 'rgba(255,255,255,0.08)' : '#eef1f8')}
-              onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
-            >
-              <Avatar size="small" icon={<UserOutlined />} />
-              {!collapsed && (
-                <Text ellipsis style={{ color: subtleColor, fontSize: 13, maxWidth: 120 }}>
-                  {user?.profile?.name || 'Benutzer'}
-                </Text>
-              )}
-            </div>
-          </Dropdown>
-        </div>
-      </Sider>
-
-      <Layout style={{ marginLeft: collapsed ? 80 : 240, transition: 'margin-left 0.2s' }}>
-        <Content style={{ margin: 24, padding: 24, background: themeToken.colorBgContainer, borderRadius: 8 }}>
+      <Layout
+        style={{
+          marginLeft: isMobile ? 0 : collapsed ? 80 : 240,
+          marginTop: isMobile ? 48 : 0,
+          transition: 'margin-left 0.2s',
+        }}
+      >
+        <Content
+          style={{
+            margin: isMobile ? 8 : 24,
+            padding: isMobile ? 12 : 24,
+            background: themeToken.colorBgContainer,
+            borderRadius: 8,
+          }}
+        >
          <Outlet />
        </Content>
      </Layout>
@@ -3,6 +3,22 @@ import { createRoot } from 'react-dom/client';
 import App from './App';
 import './index.css';

+// Nach einem Deployment existieren die alten, inhalts-gehashten Chunks nicht
+// mehr; zudem bleibt ein einmal fehlerhaft zwischengespeicherter Chunk wegen
+// "Cache-Control: immutable" dauerhaft defekt. Vite meldet fehlgeschlagene
+// dynamische Imports als 'vite:preloadError' — dann automatisch neu laden,
+// damit der Browser die aktuelle index.html samt gültiger Chunk-Namen holt.
+// Höchstens ein Versuch pro Minute, sonst droht eine Reload-Schleife; danach
+// zeigt der AppErrorBoundary eine sichtbare Fehlermeldung.
+window.addEventListener('vite:preloadError', (event) => {
+  const KEY = 'vite-preload-error-reload';
+  const letzterVersuch = Number(sessionStorage.getItem(KEY) ?? 0);
+  if (Date.now() - letzterVersuch < 60_000) return;
+  sessionStorage.setItem(KEY, String(Date.now()));
+  event.preventDefault();
+  window.location.reload();
+});
+
 createRoot(document.getElementById('root')!).render(
  <StrictMode>
    <App />
@@ -7,11 +7,14 @@ import type { ColumnsType } from 'antd/es/table';
 import dayjs from 'dayjs';
 import { freigabeApi, type FreigabeDocument, type FreigabeOption } from '../api/freigabe';
 import { paperlessApi, type PaperlessDocType, type PaperlessCorrespondent } from '../api/paperless';
+import { useIsMobile } from '../hooks/useIsMobile';
+import MobileCardList from '../components/MobileCardList';

-const { Title } = Typography;
+const { Title, Text } = Typography;
 const FREIGABE_FIELD_ID = 15;

 export default function FreigabePage() {
+  const isMobile = useIsMobile();
  const [data, setData] = useState<FreigabeDocument[]>([]);
  const [total, setTotal] = useState(0);
  const [loading, setLoading] = useState(false);
@@ -119,7 +122,7 @@ export default function FreigabePage() {
    },
    {
      title: 'Erstellt',
-      dataIndex: 'created_date',
+      dataIndex: 'created',
      key: 'created',
      width: 110,
      render: (v: string) => v ? dayjs(v).format('DD.MM.YYYY') : '—',
@@ -153,44 +156,92 @@ export default function FreigabePage() {
    },
  ];

+  const paginationConfig = {
+    current: page,
+    pageSize,
+    total,
+    showSizeChanger: true,
+    pageSizeOptions: ['25', '50', '100'],
+    onChange: (p: number, ps: number) => {
+      setPage(p);
+      setPageSize(ps);
+    },
+    showTotal: (t: number) => `${t} Belege`,
+  };
+
  return (
    <>
      <Title level={4} style={{ marginTop: 0, marginBottom: 16 }}>Freigabe</Title>

-      <Space style={{ marginBottom: 16 }}>
-        <Radio.Group
+      {isMobile ? (
+        <Select
+          style={{ width: '100%', marginBottom: 16 }}
          value={nurNichtFreigegeben}
-          onChange={(e) => {
+          onChange={(v) => {
            setPage(1);
-            setNurNichtFreigegeben(e.target.value);
+            setNurNichtFreigegeben(v);
          }}
-          optionType="button"
-          buttonStyle="solid"
-        >
-          <Radio.Button value={true}>Nicht freigegeben</Radio.Button>
-          <Radio.Button value={false}>Alle</Radio.Button>
-        </Radio.Group>
-      </Space>
+          options={[
+            { value: true, label: 'Nicht freigegeben' },
+            { value: false, label: 'Alle' },
+          ]}
+        />
+      ) : (
+        <Space style={{ marginBottom: 16 }}>
+          <Radio.Group
+            value={nurNichtFreigegeben}
+            onChange={(e) => {
+              setPage(1);
+              setNurNichtFreigegeben(e.target.value);
+            }}
+            optionType="button"
+            buttonStyle="solid"
+          >
+            <Radio.Button value={true}>Nicht freigegeben</Radio.Button>
+            <Radio.Button value={false}>Alle</Radio.Button>
+          </Radio.Group>
+        </Space>
+      )}

-      <Table<FreigabeDocument>
-        dataSource={data}
-        columns={columns}
-        rowKey="id"
-        loading={loading}
-        size="small"
-        pagination={{
-          current: page,
-          pageSize,
-          total,
-          showSizeChanger: true,
-          pageSizeOptions: ['25', '50', '100'],
-          onChange: (p, ps) => {
-            setPage(p);
-            setPageSize(ps);
-          },
-          showTotal: (t) => `${t} Belege`,
-        }}
-      />
+      {isMobile ? (
+        <MobileCardList<FreigabeDocument>
+          dataSource={data}
+          rowKey="id"
+          loading={loading}
+          pagination={paginationConfig}
+          emptyText="Keine Belege vorhanden"
+          renderCard={(doc) => (
+            <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
+              <Text strong>{doc.title || '—'}</Text>
+              <Text type="secondary" style={{ fontSize: 13 }}>Dokumenttyp: {getDocTypeName(doc.document_type)}</Text>
+              <Text type="secondary" style={{ fontSize: 13 }}>Absender: {getCorrespondentName(doc.correspondent)}</Text>
+              <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
+                <Text type="secondary" style={{ fontSize: 13 }}>
+                  Erstellt: {doc.created ? dayjs(doc.created).format('DD.MM.YYYY') : '—'}
+                </Text>
+                {getFreigabeValue(doc)}
+              </div>
+              <Button
+                icon={<CheckCircleOutlined />}
+                type="primary"
+                block
+                onClick={() => openModal(doc)}
+              >
+                Freigabe setzen
+              </Button>
+            </div>
+          )}
+        />
+      ) : (
+        <Table<FreigabeDocument>
+          dataSource={data}
+          columns={columns}
+          rowKey="id"
+          loading={loading}
+          size="small"
+          pagination={paginationConfig}
+        />
+      )}

      <Modal
        title="Freigabe setzen"
@@ -25,6 +25,7 @@ import {
 import { inboxApi, type InboxBarcode, type InboxFile, type PostprocessActionResult } from '../api/inbox';
 import { paperlessApi } from '../api/paperless';
 import { userSettingsApi, type SenderOption } from '../api/userSettings';
+import { useIsMobile } from '../hooks/useIsMobile';

 const ZOOM_MIN = 0.5;
 const ZOOM_MAX = 3;
@@ -113,6 +114,7 @@ function CompareModal({
  onCreateNewVersion,
  onSkip,
 }: CompareModalProps) {
+  const compareIsMobile = useIsMobile();
  const [paperlessUrl, setPaperlessUrl] = useState<string | null>(null);
  const [inboxUrl, setInboxUrl] = useState<string | null>(null);
  const [loading, setLoading] = useState(false);
@@ -165,8 +167,8 @@ function CompareModal({
        </Button>,
      ]}
    >
-      <div style={{ display: 'flex', gap: 12, height: '75vh' }}>
-        <div style={{ flex: 1, display: 'flex', flexDirection: 'column', minWidth: 0 }}>
+      <div style={{ display: 'flex', flexDirection: compareIsMobile ? 'column' : 'row', gap: 12, height: '75vh' }}>
+        <div style={{ flex: 1, display: 'flex', flexDirection: 'column', minWidth: 0, minHeight: 0 }}>
          <Typography.Text strong style={{ marginBottom: 4 }}>
            Original (Paperless)
          </Typography.Text>
@@ -180,7 +182,7 @@ function CompareModal({
            )}
          </div>
        </div>
-        <div style={{ flex: 1, display: 'flex', flexDirection: 'column', minWidth: 0 }}>
+        <div style={{ flex: 1, display: 'flex', flexDirection: 'column', minWidth: 0, minHeight: 0 }}>
          <Typography.Text strong style={{ marginBottom: 4 }}>
            Aktueller Abschnitt (Inbox)
          </Typography.Text>
@@ -858,6 +860,7 @@ function SendEmailDialog({ open, fileId, fileName, documents, thumbUrls, onClose
 export default function InboxDetailPage() {
  const { id } = useParams<{ id: string }>();
  const navigate = useNavigate();
+  const isMobile = useIsMobile();
  const [file, setFile] = useState<InboxFile | null>(null);
  const [loading, setLoading] = useState(true);
  const [thumbUrls, setThumbUrls] = useState<Map<number, string>>(new Map());
@@ -1211,13 +1214,13 @@ export default function InboxDetailPage() {
  })();

  return (
-    <div style={{ display: 'flex', flexDirection: 'column', height: 'calc(100vh - 120px)' }}>
-      <div style={{ display: 'flex', alignItems: 'center', marginBottom: 12, gap: 12 }}>
-        <Space>
+    <div style={{ display: 'flex', flexDirection: 'column', height: isMobile ? 'calc(100dvh - 180px)' : 'calc(100vh - 120px)' }}>
+      <div style={{ display: 'flex', alignItems: 'center', flexWrap: 'wrap', rowGap: 8, marginBottom: 12, gap: 12 }}>
+        <Space wrap>
          <Button icon={<ArrowLeftOutlined />} onClick={() => navigate('/inbox')}>
            Zurück
          </Button>
-          <Title level={3} style={{ margin: 0 }}>
+          <Title level={isMobile ? 5 : 3} style={{ margin: 0, maxWidth: isMobile ? 180 : undefined }} ellipsis={{ tooltip: file.name }}>
            {file.name}
          </Title>
          <SourceTag source={file.source} />
@@ -1399,12 +1402,13 @@ export default function InboxDetailPage() {
      >
        <div
          style={{
-            width: 140,
+            width: isMobile ? 84 : 140,
            overflowY: 'auto',
            padding: 6,
            background: '#fafafa',
            border: '1px solid #f0f0f0',
            borderRadius: 8,
+            flexShrink: 0,
          }}
        >
          {sidebarPages.map((n, idx) => {
@@ -1428,7 +1432,7 @@ export default function InboxDetailPage() {
                <div
                  style={{
                    width: '100%',
-                    height: 170,
+                    height: isMobile ? 100 : 170,
                    display: 'flex',
                    alignItems: 'center',
                    justifyContent: 'center',
@@ -1439,7 +1443,7 @@ export default function InboxDetailPage() {
                    <img
                      src={url}
                      alt={`Seite ${docPage}`}
-                      style={thumbImageStyle(rotationFor(n), 130)}
+                      style={thumbImageStyle(rotationFor(n), isMobile ? 72 : 130)}
                    />
                  ) : (
                    <Spin size="small" />
@@ -37,6 +37,8 @@ import { inboxApi, type InboxBarcode, type InboxFile } from '../api/inbox';
 import { barcodeTemplatesApi, type BarcodeTemplate } from '../api/barcode-templates';
 import { labelPrintAgentApi } from '../api/labelPrintAgent';
 import { userSettingsApi } from '../api/userSettings';
+import { useIsMobile } from '../hooks/useIsMobile';
+import MobileCardList from '../components/MobileCardList';

 const { Title } = Typography;

@@ -51,6 +53,18 @@ function formatDate(iso: string): string {
  });
 }

+function renderSourceTag(src: InboxFile['source']): ReactNode {
+  return src === 'user' ? (
+    <Tag icon={<UserOutlined />} color="purple">
+      Persönlich
+    </Tag>
+  ) : (
+    <Tag icon={<FolderOpenOutlined />} color="blue">
+      Gemeinsam
+    </Tag>
+  );
+}
+
 function renderBarcodes(barcodes: InboxBarcode[]): ReactNode {
  if (!barcodes || barcodes.length === 0) {
    return <Typography.Text type="secondary">—</Typography.Text>;
@@ -137,6 +151,7 @@ function buildInitialFieldValues(template: BarcodeTemplate | null): Record<strin

 export default function InboxPage() {
  const navigate = useNavigate();
+  const isMobile = useIsMobile();
  const [files, setFiles] = useState<InboxFile[]>([]);
  const [loading, setLoading] = useState(true);
  const [search, setSearch] = useState('');
@@ -261,6 +276,50 @@ export default function InboxPage() {
    search ? f.name.toLowerCase().includes(search.toLowerCase()) : true,
  );

+  // Karten-Ansicht sortiert wie die Tabelle (neueste zuerst)
+  const sortedForMobile = [...filtered].sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+
+  const renderActions = (record: InboxFile, direction: 'column' | 'row' = 'column') => (
+    <div style={{ display: 'flex', flexDirection: direction, alignItems: 'flex-start', flexWrap: 'wrap' }}>
+      <Tooltip title="Vorschau öffnen">
+        <Button
+          type="link"
+          icon={<EyeOutlined />}
+          onClick={() => navigate(`/inbox/${encodeURIComponent(record.id)}`)}
+        >
+          Weiterverarbeiten
+        </Button>
+      </Tooltip>
+      <Popconfirm
+        title="Dokument löschen?"
+        description="Datei und Datenbank-Eintrag werden dauerhaft entfernt."
+        okText="Löschen"
+        cancelText="Abbrechen"
+        okButtonProps={{ danger: true }}
+        onConfirm={() => handleDelete(record.id)}
+      >
+        <Button type="link" danger icon={<DeleteOutlined />}>
+          Löschen
+        </Button>
+      </Popconfirm>
+      <Tooltip
+        title={
+          record.source === 'all'
+            ? 'In meinen persönlichen Scan-Ordner verschieben'
+            : 'In den gemeinsamen Ordner (Öffentlich) verschieben'
+        }
+      >
+        <Button
+          type="link"
+          icon={record.source === 'all' ? <UserOutlined /> : <TeamOutlined />}
+          onClick={() => handleUpdateSource(record.id, record.source)}
+        >
+          {record.source === 'all' ? 'Zu Persönlich' : 'Zu Öffentlich'}
+        </Button>
+      </Tooltip>
+    </div>
+  );
+
  const columns: ColumnsType<InboxFile> = [
    {
      title: 'Dateiname',
@@ -283,16 +342,7 @@ export default function InboxPage() {
        { text: 'Persönlich', value: 'user' },
      ],
      onFilter: (value, record) => record.source === value,
-      render: (src: InboxFile['source']) =>
-        src === 'user' ? (
-          <Tag icon={<UserOutlined />} color="purple">
-            Persönlich
-          </Tag>
-        ) : (
-          <Tag icon={<FolderOpenOutlined />} color="blue">
-            Gemeinsam
-          </Tag>
-        ),
+      render: (src: InboxFile['source']) => renderSourceTag(src),
    },
    {
      title: 'QR-Code / Vorlage',
@@ -321,46 +371,7 @@ export default function InboxPage() {
      title: 'Aktionen',
      key: 'actions',
      width: 140,
-      render: (_, record) => (
-        <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'flex-start' }}>
-          <Tooltip title="Vorschau öffnen">
-            <Button
-              type="link"
-              icon={<EyeOutlined />}
-              onClick={() => navigate(`/inbox/${encodeURIComponent(record.id)}`)}
-            >
-              Weiterverarbeiten
-            </Button>
-          </Tooltip>
-          <Popconfirm
-            title="Dokument löschen?"
-            description="Datei und Datenbank-Eintrag werden dauerhaft entfernt."
-            okText="Löschen"
-            cancelText="Abbrechen"
-            okButtonProps={{ danger: true }}
-            onConfirm={() => handleDelete(record.id)}
-          >
-            <Button type="link" danger icon={<DeleteOutlined />}>
-              Löschen
-            </Button>
-          </Popconfirm>
-          <Tooltip
-            title={
-              record.source === 'all'
-                ? 'In meinen persönlichen Scan-Ordner verschieben'
-                : 'In den gemeinsamen Ordner (Öffentlich) verschieben'
-            }
-          >
-            <Button
-              type="link"
-              icon={record.source === 'all' ? <UserOutlined /> : <TeamOutlined />}
-              onClick={() => handleUpdateSource(record.id, record.source)}
-            >
-              {record.source === 'all' ? 'Zu Persönlich' : 'Zu Öffentlich'}
-            </Button>
-          </Tooltip>
-        </div>
-      ),
+      render: (_, record) => renderActions(record),
    },
  ];

@@ -371,6 +382,8 @@ export default function InboxPage() {
          display: 'flex',
          justifyContent: 'space-between',
          alignItems: 'center',
+          flexWrap: 'wrap',
+          gap: 12,
          marginBottom: 16,
        }}
      >
@@ -383,11 +396,11 @@ export default function InboxPage() {
            Scan-Ordner.
          </Typography.Text>
        </div>
-        <Space>
+        <Space wrap>
          <Input
            prefix={<SearchOutlined />}
            placeholder="Suchen …"
-            style={{ width: 260 }}
+            style={{ width: isMobile ? '100%' : 260 }}
            value={search}
            onChange={(e) => setSearch(e.target.value)}
            allowClear
@@ -478,20 +491,48 @@ export default function InboxPage() {
        </Form>
      </Modal>

-      <Card>
-        <Table<InboxFile>
+      {isMobile ? (
+        <MobileCardList<InboxFile>
+          dataSource={sortedForMobile}
          rowKey="id"
-          columns={columns}
-          dataSource={filtered}
          loading={loading}
          pagination={{
            pageSize: 25,
-            showSizeChanger: true,
            showTotal: (t) => `${t} Dateien`,
          }}
-          locale={{ emptyText: 'Keine Dateien vorhanden' }}
+          emptyText="Keine Dateien vorhanden"
+          renderCard={(record) => (
+            <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
+              <DocumentPreviewPopover record={record}>
+                <Typography.Text strong>{record.name}</Typography.Text>
+              </DocumentPreviewPopover>
+              <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', alignItems: 'center' }}>
+                {renderSourceTag(record.source)}
+                <Typography.Text type="secondary" style={{ fontSize: 13 }}>
+                  {record.pageCount > 0 ? `${record.pageCount} Seiten` : '—'} · {formatDate(record.createdAt)}
+                </Typography.Text>
+              </div>
+              {renderBarcodes(record.barcodes)}
+              {renderActions(record, 'row')}
+            </div>
+          )}
        />
-      </Card>
+      ) : (
+        <Card>
+          <Table<InboxFile>
+            rowKey="id"
+            columns={columns}
+            dataSource={filtered}
+            loading={loading}
+            pagination={{
+              pageSize: 25,
+              showSizeChanger: true,
+              showTotal: (t) => `${t} Dateien`,
+            }}
+            locale={{ emptyText: 'Keine Dateien vorhanden' }}
+          />
+        </Card>
+      )}
    </div>
  );
 }
@@ -10,12 +10,14 @@ import { emailsApi, type EmailItem, type EmailAttachment } from '../api/emails';
 import { emailImportApi } from '../api/email-import';
 import { getEnv } from '../utils/env';
 import MailImportWizard from '../components/MailImportWizard';
+import { useIsMobile } from '../hooks/useIsMobile';

 const { Title, Text } = Typography;

 export default function MailDetailPage() {
  const { id } = useParams<{ id: string }>();
  const navigate = useNavigate();
+  const isMobile = useIsMobile();
  const [email, setEmail] = useState<EmailItem | null>(null);
  const [attachments, setAttachments] = useState<EmailAttachment[]>([]);
  const [selected, setSelected] = useState<EmailAttachment | null>(null);
@@ -136,16 +138,16 @@ export default function MailDetailPage() {

  return (
    <div>
-      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 16 }}>
-        <Space>
+      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', flexWrap: 'wrap', gap: 8, marginBottom: 16 }}>
+        <Space wrap>
          <Button icon={<ArrowLeftOutlined />} onClick={() => navigate('/mailpostfach')}>
            Zurück
          </Button>
-          <Title level={3} style={{ margin: 0 }}>{email.Subject}</Title>
+          <Title level={isMobile ? 5 : 3} style={{ margin: 0 }}>{email.Subject}</Title>
          {hasErechnung && <Tag color="green">eRechnung</Tag>}
        </Space>

-        <Space>
+        <Space wrap>
          <Popconfirm
            title="E-Mail ignorieren"
            description="Möchten Sie diese E-Mail wirklich als ignoriert markieren?"
@@ -183,12 +185,26 @@ export default function MailDetailPage() {
        </Space>
      </div>

-      <div style={{ display: 'grid', gridTemplateColumns: '2fr 3fr', gap: 16, height: 'calc(100vh - 140px)' }}>
+      <div
+        style={{
+          display: 'grid',
+          gridTemplateColumns: isMobile ? '1fr' : '2fr 3fr',
+          gap: 16,
+          height: isMobile ? 'auto' : 'calc(100vh - 140px)',
+        }}
+      >
        {/* Linke Seite: E-Mail-Inhalt */}
        <Card
          title="E-Mail"
          size="small"
-          styles={{ body: { overflow: 'auto', height: 'calc(100vh - 200px)', display: 'flex', flexDirection: 'column' } }}
+          styles={{
+            body: {
+              overflow: 'auto',
+              height: isMobile ? 'auto' : 'calc(100vh - 200px)',
+              display: 'flex',
+              flexDirection: 'column',
+            },
+          }}
        >
          <div style={{ marginBottom: 12 }}>
            <div><Text type="secondary">Von:</Text> <Text>{email.SenderAddress}</Text></div>
@@ -208,7 +224,17 @@ export default function MailDetailPage() {
        </Card>

        {/* Rechte Seite: Anhänge + Vorschau */}
-        <Card size="small" styles={{ body: { padding: 0, display: 'flex', flexDirection: 'column', height: 'calc(100vh - 200px)' } }}>
+        <Card
+          size="small"
+          styles={{
+            body: {
+              padding: 0,
+              display: 'flex',
+              flexDirection: 'column',
+              height: isMobile ? 'auto' : 'calc(100vh - 200px)',
+            },
+          }}
+        >
          <div style={{ flex: '0 0 auto', borderBottom: `1px solid ${token.colorBorder}`, maxHeight: 240, overflow: 'auto' }}>
            <Table<EmailAttachment>
              columns={columns}
@@ -224,7 +250,7 @@ export default function MailDetailPage() {
              locale={{ emptyText: <Empty description="Keine Anhänge" image={Empty.PRESENTED_IMAGE_SIMPLE} /> }}
            />
          </div>
-          <div style={{ flex: 1, minHeight: 0, background: token.colorBgLayout }}>
+          <div style={isMobile ? { height: '60vh', background: token.colorBgLayout } : { flex: 1, minHeight: 0, background: token.colorBgLayout }}>
            {previewLoading ? (
              <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', height: '100%' }}>
                <Spin />
@@ -7,11 +7,22 @@ import dayjs from 'dayjs';
 import { emailsApi, type EmailItem } from '../api/emails';
 import { useAuth } from '../auth/AuthContext';
 import { Permission } from '../auth/permissions';
+import { useIsMobile } from '../hooks/useIsMobile';
+import MobileCardList from '../components/MobileCardList';

-const { Title } = Typography;
+const { Title, Text } = Typography;
+
+function renderStatusTag(s: number) {
+  if (s === 0) return <Tag color="blue">Neu</Tag>;
+  if (s === 1) return <Tag color="green">Verarbeitet</Tag>;
+  if (s === 2) return <Tag color="red">Fehler</Tag>;
+  if (s === 3) return <Tag color="default">Ignoriert</Tag>;
+  return <Tag>{s}</Tag>;
+}

 export default function MailpostfachPage() {
  const navigate = useNavigate();
+  const isMobile = useIsMobile();
  const [emails, setEmails] = useState<EmailItem[]>([]);
  const [loading, setLoading] = useState(false);
  const [fetching, setFetching] = useState(false);
@@ -84,13 +95,7 @@ export default function MailpostfachPage() {
      dataIndex: 'Status',
      key: 'Status',
      width: 110,
-      render: (s: number) => {
-        if (s === 0) return <Tag color="blue">Neu</Tag>;
-        if (s === 1) return <Tag color="green">Verarbeitet</Tag>;
-        if (s === 2) return <Tag color="red">Fehler</Tag>;
-        if (s === 3) return <Tag color="default">Ignoriert</Tag>;
-        return <Tag>{s}</Tag>;
-      },
+      render: renderStatusTag,
      filters: [
        { text: 'Neu', value: 0 },
        { text: 'Verarbeitet', value: 1 },
@@ -116,9 +121,9 @@ export default function MailpostfachPage() {

  return (
    <div>
-      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 16 }}>
+      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', flexWrap: 'wrap', gap: 12, marginBottom: 16 }}>
        <Title level={3} style={{ margin: 0 }}>Mailpostfach</Title>
-        <Space>
+        <Space wrap>
          <Button
            icon={<DownloadOutlined />}
            onClick={async () => {
@@ -198,13 +203,13 @@ export default function MailpostfachPage() {
            prefix={<SearchOutlined />}
            value={searchText}
            onChange={(e) => setSearchText(e.target.value)}
-            style={{ width: 300 }}
+            style={{ width: isMobile ? '100%' : 300 }}
            allowClear
          />
          <Select
            value={statusFilter}
            onChange={setStatusFilter}
-            style={{ width: 200 }}
+            style={{ width: isMobile ? '100%' : 200 }}
            options={[
              { value: 'all', label: 'Alle Status' },
              { value: 0, label: 'Neu' },
@@ -214,18 +219,48 @@ export default function MailpostfachPage() {
            ]}
          />
        </div>
-        <Table<EmailItem>
-          columns={columns}
-          dataSource={filteredEmails}
-          loading={loading}
-          rowKey="Id"
-          pagination={{ pageSize: 20, showSizeChanger: true, showTotal: (t) => `${t} E-Mails` }}
-          locale={{ emptyText: 'Keine Einträge vorhanden' }}
-          onRow={(record) => ({
-            onClick: () => navigate(`/mailpostfach/${record.Id}`),
-            style: { cursor: 'pointer' },
-          })}
-        />
+        {isMobile ? (
+          <MobileCardList<EmailItem>
+            dataSource={[...filteredEmails].sort(
+              (a, b) => new Date(b.Date).getTime() - new Date(a.Date).getTime(),
+            )}
+            rowKey="Id"
+            loading={loading}
+            pagination={{ pageSize: 20, showTotal: (t) => `${t} E-Mails` }}
+            onCardClick={(record) => navigate(`/mailpostfach/${record.Id}`)}
+            renderCard={(record) => {
+              const hasErechnung = record.Attachments?.some((a) => a.Erechnung);
+              return (
+                <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
+                  <div style={{ display: 'flex', gap: 8, alignItems: 'baseline', flexWrap: 'wrap' }}>
+                    <Text strong>{record.Subject || '—'}</Text>
+                    {hasErechnung && <Tag color="green">eRechnung</Tag>}
+                  </div>
+                  <Text type="secondary" style={{ fontSize: 13 }}>{record.SenderAddress}</Text>
+                  <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
+                    <Text type="secondary" style={{ fontSize: 13 }}>
+                      {record.Date ? dayjs(record.Date).format('DD.MM.YYYY HH:mm') : '-'}
+                    </Text>
+                    {renderStatusTag(record.Status)}
+                  </div>
+                </div>
+              );
+            }}
+          />
+        ) : (
+          <Table<EmailItem>
+            columns={columns}
+            dataSource={filteredEmails}
+            loading={loading}
+            rowKey="Id"
+            pagination={{ pageSize: 20, showSizeChanger: true, showTotal: (t) => `${t} E-Mails` }}
+            locale={{ emptyText: 'Keine Einträge vorhanden' }}
+            onRow={(record) => ({
+              onClick: () => navigate(`/mailpostfach/${record.Id}`),
+              style: { cursor: 'pointer' },
+            })}
+          />
+        )}
      </Card>
    </div>
  );
@@ -1,7 +1,7 @@
 import { useEffect, useState } from 'react';
 import { Table, Popover, Button, Space, message, Tooltip, Typography, Tag } from 'antd';

-const { Title } = Typography;
+const { Title, Text } = Typography;
 import { ReloadOutlined } from '@ant-design/icons';
 import dayjs from 'dayjs';
 import { posteingangApi } from '../api/posteingang';
@@ -11,8 +11,11 @@ import type { PaperlessTag } from '../api/paperless';
 import DocumentEditModal from '../components/DocumentEditModal';
 import { getEnv } from '../utils/env';
 import { AuthImage } from '../utils/auth-resource';
+import { useIsMobile } from '../hooks/useIsMobile';
+import MobileCardList from '../components/MobileCardList';

 export default function ManuellBearbeitenPage() {
+  const isMobile = useIsMobile();
  const [data, setData] = useState<PosteingangDocument[]>([]);
  const [loading, setLoading] = useState(false);
  const [editModalOpen, setEditModalOpen] = useState(false);
@@ -77,6 +80,26 @@ export default function ManuellBearbeitenPage() {
    />
  );

+  const getContentTags = (record: PosteingangDocument) =>
+    (record.tags || [])
+      .filter(id => !steuertagIds.includes(id))
+      .map(id => allTags.find(t => t.id === id))
+      .filter((t): t is PaperlessTag => !!t);
+
+  const renderContentTags = (record: PosteingangDocument) => {
+    const contentTags = getContentTags(record);
+    if (contentTags.length === 0) return null;
+    return (
+      <Space size={[4, 4]} wrap style={{ marginTop: 4 }}>
+        {contentTags.map(t => (
+          <Tag key={t.id} color={t.color} style={{ color: t.text_color, margin: 0 }}>
+            {t.name}
+          </Tag>
+        ))}
+      </Space>
+    );
+  };
+
  const columns = [
    {
      title: 'Vorschau',
@@ -97,26 +120,12 @@ export default function ManuellBearbeitenPage() {
      dataIndex: 'title',
      key: 'title',
      width: '35%',
-      render: (_: any, record: PosteingangDocument) => {
-        const contentTags = (record.tags || [])
-          .filter(id => !steuertagIds.includes(id))
-          .map(id => allTags.find(t => t.id === id))
-          .filter((t): t is PaperlessTag => !!t);
-        return (
-          <div>
-            <div>{record.title}</div>
-            {contentTags.length > 0 && (
-              <Space size={[4, 4]} wrap style={{ marginTop: 4 }}>
-                {contentTags.map(t => (
-                  <Tag key={t.id} color={t.color} style={{ color: t.text_color, margin: 0 }}>
-                    {t.name}
-                  </Tag>
-                ))}
-              </Space>
-            )}
-          </div>
-        );
-      },
+      render: (_: any, record: PosteingangDocument) => (
+        <div>
+          <div>{record.title}</div>
+          {renderContentTags(record)}
+        </div>
+      ),
    },
    {
      title: 'Eingangsdatum',
@@ -153,14 +162,47 @@ export default function ManuellBearbeitenPage() {
                </Tooltip>
            </Space>
        </div>
-        <Table 
-          columns={columns} 
-          dataSource={data} 
-          rowKey="id" 
-          loading={loading}
-          pagination={{ pageSize: 20, showSizeChanger: true, showTotal: (t) => `${t} Dokumente` }}
-          locale={{ emptyText: 'Keine Einträge vorhanden' }}
-        />
+        {isMobile ? (
+          <MobileCardList<PosteingangDocument>
+            dataSource={data}
+            rowKey="id"
+            loading={loading}
+            pagination={{ pageSize: 20, showTotal: (t) => `${t} Dokumente` }}
+            renderCard={(record) => (
+              <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
+                <div style={{ display: 'flex', gap: 12 }}>
+                  <AuthImage
+                    src={`${getEnv('VITE_API_URL')}/api/paperless/inbox/preview/${record.id}`}
+                    width={72}
+                    style={{ border: '1px solid #d9d9d9', objectFit: 'contain', flexShrink: 0 }}
+                  />
+                  <div style={{ display: 'flex', flexDirection: 'column', gap: 4, minWidth: 0 }}>
+                    <Text strong>{record.title || '—'}</Text>
+                    {renderContentTags(record)}
+                    <Text type="secondary" style={{ fontSize: 13 }}>
+                      Eingangsdatum: {record.created ? dayjs(record.created).format('DD.MM.YYYY') : '-'}
+                    </Text>
+                    <Text type="secondary" style={{ fontSize: 13 }}>
+                      Importiert am: {dayjs(record.added).format('DD.MM.YYYY HH:mm')}
+                    </Text>
+                  </div>
+                </div>
+                <Button type="primary" block onClick={() => handleEdit(record)}>
+                  Bearbeiten
+                </Button>
+              </div>
+            )}
+          />
+        ) : (
+          <Table
+            columns={columns}
+            dataSource={data}
+            rowKey="id"
+            loading={loading}
+            pagination={{ pageSize: 20, showSizeChanger: true, showTotal: (t) => `${t} Dokumente` }}
+            locale={{ emptyText: 'Keine Einträge vorhanden' }}
+          />
+        )}

        <DocumentEditModal
            documentId={selectedDoc?.id || null}
@@ -3,14 +3,17 @@ import { Table, Popover, Button, Space, message, Tooltip, Typography } from 'ant
 import { AuthImage } from '../utils/auth-resource';
 import { ReloadOutlined } from '@ant-design/icons';

-const { Title } = Typography;
+const { Title, Text } = Typography;
 import dayjs from 'dayjs';
 import { posteingangApi } from '../api/posteingang';
 import type { PosteingangDocument } from '../api/posteingang';
 import DocumentEditModal from '../components/DocumentEditModal';
 import { getEnv } from '../utils/env';
+import { useIsMobile } from '../hooks/useIsMobile';
+import MobileCardList from '../components/MobileCardList';

 export default function PosteingangPage() {
+  const isMobile = useIsMobile();
  const [data, setData] = useState<PosteingangDocument[]>([]);
  const [loading, setLoading] = useState(false);
  const [editModalOpen, setEditModalOpen] = useState(false);
@@ -64,6 +67,11 @@ export default function PosteingangPage() {
    />
  );

+  const getEingangsdatum = (record: PosteingangDocument) => {
+    const cf = record.customFields?.find((f) => f.field === 9);
+    return cf?.value ? dayjs(cf.value).format('DD.MM.YYYY') : '-';
+  };
+
  const columns = [
    {
      title: 'Vorschau',
@@ -88,10 +96,7 @@ export default function PosteingangPage() {
    {
      title: 'Eingangsdatum',
      key: 'eingangsdatum',
-      render: (_: any, record: PosteingangDocument) => {
-        const cf = record.customFields?.find((f) => f.field === 9);
-        return cf?.value ? dayjs(cf.value).format('DD.MM.YYYY') : '-';
-      }
+      render: (_: any, record: PosteingangDocument) => getEingangsdatum(record),
    },
    {
      title: 'Importiert am',
@@ -121,14 +126,46 @@ export default function PosteingangPage() {
                </Tooltip>
            </Space>
        </div>
-        <Table 
-          columns={columns} 
-          dataSource={data} 
-          rowKey="id" 
-          loading={loading}
-          pagination={{ pageSize: 20, showSizeChanger: true, showTotal: (t) => `${t} Dokumente` }}
-          locale={{ emptyText: 'Keine Einträge vorhanden' }}
-        />
+        {isMobile ? (
+          <MobileCardList<PosteingangDocument>
+            dataSource={data}
+            rowKey="id"
+            loading={loading}
+            pagination={{ pageSize: 20, showTotal: (t) => `${t} Dokumente` }}
+            renderCard={(record) => (
+              <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
+                <div style={{ display: 'flex', gap: 12 }}>
+                  <AuthImage
+                    src={`${getEnv('VITE_API_URL')}/api/paperless/inbox/preview/${record.id}`}
+                    width={72}
+                    style={{ border: '1px solid #d9d9d9', objectFit: 'contain', flexShrink: 0 }}
+                  />
+                  <div style={{ display: 'flex', flexDirection: 'column', gap: 4, minWidth: 0 }}>
+                    <Text strong>{record.title || '—'}</Text>
+                    <Text type="secondary" style={{ fontSize: 13 }}>
+                      Eingangsdatum: {getEingangsdatum(record)}
+                    </Text>
+                    <Text type="secondary" style={{ fontSize: 13 }}>
+                      Importiert am: {dayjs(record.added).format('DD.MM.YYYY HH:mm')}
+                    </Text>
+                  </div>
+                </div>
+                <Button type="primary" block onClick={() => handleEdit(record)}>
+                  Bearbeiten
+                </Button>
+              </div>
+            )}
+          />
+        ) : (
+          <Table
+            columns={columns}
+            dataSource={data}
+            rowKey="id"
+            loading={loading}
+            pagination={{ pageSize: 20, showSizeChanger: true, showTotal: (t) => `${t} Dokumente` }}
+            locale={{ emptyText: 'Keine Einträge vorhanden' }}
+          />
+        )}

        <DocumentEditModal
            documentId={selectedDoc?.id || null}
@@ -321,7 +321,7 @@ function UserClientsTab() {
      <Button type="primary" icon={<PlusOutlined />} onClick={() => setModalOpen(true)} style={{ marginBottom: 16 }}>
        Zuordnung hinzufügen
      </Button>
-      <Table dataSource={data} columns={columns} loading={loading} rowKey="Id" size="small" pagination={false} />
+      <Table dataSource={data} columns={columns} loading={loading} rowKey="Id" size="small" pagination={false} scroll={{ x: 'max-content' }} />

      <Divider />
      <Typography.Title level={5} style={{ marginBottom: 8 }}>Betriebe — Agrarmonitor-Zuordnung</Typography.Title>
@@ -335,6 +335,7 @@ function UserClientsTab() {
        rowKey="Id"
        size="small"
        pagination={false}
+        scroll={{ x: 'max-content' }}
      />

      <Modal title="Neue Zuordnung" open={modalOpen} onOk={handleAdd} onCancel={() => setModalOpen(false)}>
@@ -606,6 +607,7 @@ function DocTypesTab() {
        rowKey="Id"
        size="small"
        pagination={false}
+        scroll={{ x: 'max-content' }}
      />
      <Modal 
        title="Dokumenttyp bearbeiten" 
@@ -1039,7 +1041,7 @@ function PostprocessingTab() {
      <Button type="primary" icon={<PlusOutlined />} onClick={openNew} style={{ marginBottom: 16 }}>
        Regel hinzufügen
      </Button>
-      <Table dataSource={data} columns={columns} loading={loading} rowKey="Id" size="small" pagination={false} />
+      <Table dataSource={data} columns={columns} loading={loading} rowKey="Id" size="small" pagination={false} scroll={{ x: 'max-content' }} />

      <Modal
        title={isNew ? 'Neue Postprocessing-Regel' : 'Regel bearbeiten'}
@@ -1181,7 +1183,7 @@ function ExportTargetsTab() {
      <Button type="primary" icon={<PlusOutlined />} onClick={openNew} style={{ marginBottom: 16 }}>
        Export-Ziel hinzufügen
      </Button>
-      <Table dataSource={data} columns={columns} loading={loading} rowKey="Id" size="small" pagination={false} />
+      <Table dataSource={data} columns={columns} loading={loading} rowKey="Id" size="small" pagination={false} scroll={{ x: 'max-content' }} />

      <Modal title={isNew ? 'Neues Export-Ziel' : 'Export-Ziel bearbeiten'} open={!!editing} onOk={handleSave} onCancel={() => setEditing(null)}>
        <Form form={form} layout="vertical">
@@ -1247,6 +1249,7 @@ function PostprocessingLogsTab() {
      loading={loading}
      rowKey="Id"
      size="small"
+      scroll={{ x: 'max-content' }}
      pagination={{
        current: page,
        total,
@@ -1352,7 +1355,7 @@ function ApiKeysTab() {
        </Button>
      </div>

-      <Table dataSource={data} columns={columns} loading={loading} rowKey="id" size="small" pagination={false} />
+      <Table dataSource={data} columns={columns} loading={loading} rowKey="id" size="small" pagination={false} scroll={{ x: 'max-content' }} />

      <Modal 
        title="Neuen API-Key erstellen" 
@@ -1578,6 +1581,7 @@ function CorrespondentsTab() {
        loading={loading}
        rowKey="id"
        size="small"
+        scroll={{ x: 'max-content' }}
        pagination={{
          current: currentPage,
          pageSize: pageSize,
@@ -1911,7 +1915,7 @@ function InboxActionsForTemplateEditor({ templateId }: { templateId: number }) {
        <h4 style={{ margin: 0 }}>Weiterverarbeitungs-Aktionen</h4>
        <Button type="dashed" size="small" icon={<PlusOutlined />} onClick={openNew}>Aktion hinzufügen</Button>
      </Space>
-      <Table<InboxAction> rowKey="Id" columns={columns} dataSource={actions} loading={loading} pagination={false} size="small" />
+      <Table<InboxAction> rowKey="Id" columns={columns} dataSource={actions} loading={loading} pagination={false} size="small" scroll={{ x: 'max-content' }} />

      <Modal
        title={isNew ? 'Neue Aktion' : 'Aktion bearbeiten'}
@@ -2168,6 +2172,7 @@ function BarcodeTemplatesTab() {
        dataSource={data}
        loading={loading}
        pagination={false}
+        scroll={{ x: 'max-content' }}
      />

      <Modal
@@ -2600,6 +2605,20 @@ function AgrarmonitorTab() {
                ))}
              </Select>
            </Form.Item>
+            <Form.Item
+              name="importWartezeitMinuten"
+              label="Wartezeit bis „zurück&ldquo; (Minuten)"
+              tooltip="Wie lange nach dem Versand gewartet wird, bevor ein Beleg als „Von Agrarmonitor zurück&ldquo; markiert wird (Import kann bis zu 10 Min dauern)."
+            >
+              <Input placeholder="10" style={{ width: 120 }} />
+            </Form.Item>
+            <Form.Item
+              name="notizMarker"
+              label="Notiz-Marker (Text der AM-Sende-Notiz)"
+              tooltip="Text, an dem die Sende-Notiz erkannt wird (Teil-Übereinstimmung, Groß-/Kleinschreibung egal). Deren Zeitstempel bestimmt die Wartezeit."
+            >
+              <Input placeholder="Agrarmonitor" style={{ width: 280 }} />
+            </Form.Item>
            <Button type="primary" loading={pollingSaving} onClick={handleSavePollingConfig}>
              Speichern
            </Button>
@@ -2774,8 +2793,8 @@ function WebhookStatusTab() {

  const renderStatusBadge = (s: string) => {
    switch (s) {
+      case 'queued': return <Badge status="processing" text="In Warteschlange" />;
      case 'processed': return <Badge status="success" text="Verarbeitet" />;
-      case 'skipped': return <Badge status="warning" text="Übersprungen" />;
      case 'error': return <Badge status="error" text="Fehler" />;
      case 'bad-request': return <Badge status="error" text="Ungültige Anfrage" />;
      default: return <Badge status="default" text={s} />;
@@ -2783,6 +2802,7 @@ function WebhookStatusTab() {
  };

  const lastCall = status?.lastCall ?? null;
+  const queueSize = status?.queueSize ?? 0;

  return (
    <>
@@ -2791,13 +2811,19 @@ function WebhookStatusTab() {
        <Typography.Paragraph type="secondary">
          Paperless-NGX ruft nach dem Bearbeiten eines Dokuments den Webhook{' '}
          <Typography.Text code>/api/webhook/paperless</Typography.Text> auf
-          (per API-Key authentifiziert). Hier siehst du den zuletzt
-          verarbeiteten Aufruf. Eine vollständige Historie steht in den
-          Backend-Logs.
+          (per API-Key authentifiziert). Die ID wird in eine Warteschlange
+          gelegt und von einem separaten Prozess nacheinander verarbeitet.
+          Hier siehst du den zuletzt festgehaltenen Vorgang. Eine vollständige
+          Historie steht in den Backend-Logs.
        </Typography.Paragraph>
-        <Button icon={<ReloadOutlined />} loading={loading} onClick={load}>
-          Aktualisieren
-        </Button>
+        <Space>
+          <Button icon={<ReloadOutlined />} loading={loading} onClick={load}>
+            Aktualisieren
+          </Button>
+          <Tag color={queueSize > 0 ? 'processing' : 'default'}>
+            Warteschlange: {queueSize}
+          </Tag>
+        </Space>
      </div>

      <Card size="small" title="Letzter Webhook-Aufruf" loading={loading}>
@@ -1,9 +1,13 @@
 import { useEffect, useState } from 'react';
-import { Table, Button, Space, Tag, Tooltip, Popconfirm, message, ConfigProvider } from 'antd';
+import { Table, Button, Space, Tag, Tooltip, Popconfirm, message, ConfigProvider, Typography } from 'antd';
 import { ReloadOutlined, DeleteOutlined } from '@ant-design/icons';
 import dayjs from 'dayjs';
 import { tasksApi } from '../api/tasks';
 import type { Task } from '../api/tasks';
+import { useIsMobile } from '../hooks/useIsMobile';
+import MobileCardList from '../components/MobileCardList';
+
+const { Text } = Typography;

 function statusTag(fertig: number | null) {
  if (fertig === 1) return <Tag color="success">Fertig</Tag>;
@@ -12,6 +16,7 @@ function statusTag(fertig: number | null) {
 }

 export default function TaskLogPage() {
+  const isMobile = useIsMobile();
  const [data, setData] = useState<Task[]>([]);
  const [loading, setLoading] = useState(false);
  const [deleting, setDeleting] = useState(false);
@@ -155,14 +160,55 @@ export default function TaskLogPage() {
            </Popconfirm>
          </Space>
        </div>
-        <Table
-          columns={columns}
-          dataSource={data}
-          rowKey="TaskId"
-          loading={loading}
-          pagination={{ pageSize: 20 }}
-          locale={{ emptyText: 'Keine Einträge vorhanden' }}
-        />
+        {isMobile ? (
+          <MobileCardList<Task>
+            dataSource={data}
+            rowKey="TaskId"
+            loading={loading}
+            pagination={{ pageSize: 20 }}
+            renderCard={(record) => (
+              <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
+                <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: 8 }}>
+                  <Text strong>{record.InterneBelegnummer || '—'}</Text>
+                  {statusTag(record.Fertig)}
+                </div>
+                <Text type="secondary" style={{ fontFamily: 'monospace', fontSize: 12 }}>
+                  {record.TaskId.slice(0, 8)}…
+                </Text>
+                <Text type="secondary" style={{ fontSize: 13 }}>Lieferant: {record.Lieferant || '-'}</Text>
+                <Text type="secondary" style={{ fontSize: 13 }}>
+                  Belegdatum: {record.Belegdatum ? dayjs(record.Belegdatum).format('DD.MM.YYYY') : '-'}
+                  {' · '}
+                  Eingang: {record.Eingangsdatum ? dayjs(record.Eingangsdatum).format('DD.MM.YYYY') : '-'}
+                </Text>
+                <Text type="secondary" style={{ fontSize: 13 }}>
+                  Paperless-Dok.-ID: {record.PaperlessDocumentID ?? '-'}
+                </Text>
+                <Popconfirm
+                  title="Task löschen"
+                  description={`Task ${record.TaskId.slice(0, 8)}… dauerhaft entfernen?`}
+                  onConfirm={() => handleDeleteOne(record.TaskId)}
+                  okText="Löschen"
+                  cancelText="Abbrechen"
+                  okButtonProps={{ danger: true }}
+                >
+                  <Button danger size="small" icon={<DeleteOutlined />} block>
+                    Löschen
+                  </Button>
+                </Popconfirm>
+              </div>
+            )}
+          />
+        ) : (
+          <Table
+            columns={columns}
+            dataSource={data}
+            rowKey="TaskId"
+            loading={loading}
+            pagination={{ pageSize: 20 }}
+            locale={{ emptyText: 'Keine Einträge vorhanden' }}
+          />
+        )}
      </div>
    </ConfigProvider>
  );
@@ -5,13 +5,22 @@ import type { ColumnsType } from 'antd/es/table';
 import dayjs from 'dayjs';
 import { zahlungApi, type ZahlungDocument, type ZahlungOption, type ZahlungFilter } from '../api/zahlung';
 import { paperlessApi, type PaperlessDocType, type PaperlessCorrespondent } from '../api/paperless';
+import { useIsMobile } from '../hooks/useIsMobile';
+import MobileCardList from '../components/MobileCardList';

-const { Title } = Typography;
+const { Title, Text } = Typography;
 const FREIGABE_FIELD_ID = 15;
 const ZAHLUNG_FIELD_ID = 16;
 const FREIGABE_WERT_FREIGEGEBEN = 'freigegeben';

+const FILTER_OPTIONS: { value: ZahlungFilter; label: string }[] = [
+  { value: 'ausstehend', label: 'Freigegeben, noch nicht bezahlt' },
+  { value: 'freigegeben', label: 'Alle freigegebenen' },
+  { value: 'alle', label: 'Alle' },
+];
+
 export default function ZahlungPage() {
+  const isMobile = useIsMobile();
  const [data, setData] = useState<ZahlungDocument[]>([]);
  const [total, setTotal] = useState(0);
  const [loading, setLoading] = useState(false);
@@ -132,7 +141,7 @@ export default function ZahlungPage() {
    },
    {
      title: 'Erstellt',
-      dataIndex: 'created_date',
+      dataIndex: 'created',
      key: 'created',
      width: 110,
      render: (v: string) => v ? dayjs(v).format('DD.MM.YYYY') : '—',
@@ -178,45 +187,100 @@ export default function ZahlungPage() {
    },
  ];

+  const paginationConfig = {
+    current: page,
+    pageSize,
+    total,
+    showSizeChanger: true,
+    pageSizeOptions: ['25', '50', '100'],
+    onChange: (p: number, ps: number) => {
+      setPage(p);
+      setPageSize(ps);
+    },
+    showTotal: (t: number) => `${t} Belege`,
+  };
+
  return (
    <>
      <Title level={4} style={{ marginTop: 0, marginBottom: 16 }}>Zahlung</Title>

-      <Space style={{ marginBottom: 16 }}>
-        <Radio.Group
+      {isMobile ? (
+        <Select
+          style={{ width: '100%', marginBottom: 16 }}
          value={filter}
-          onChange={(e) => {
+          onChange={(v) => {
            setPage(1);
-            setFilter(e.target.value);
+            setFilter(v);
          }}
-          optionType="button"
-          buttonStyle="solid"
-        >
-          <Radio.Button value="ausstehend">Freigegeben, noch nicht bezahlt</Radio.Button>
-          <Radio.Button value="freigegeben">Alle freigegebenen</Radio.Button>
-          <Radio.Button value="alle">Alle</Radio.Button>
-        </Radio.Group>
-      </Space>
+          options={FILTER_OPTIONS}
+        />
+      ) : (
+        <Space style={{ marginBottom: 16 }}>
+          <Radio.Group
+            value={filter}
+            onChange={(e) => {
+              setPage(1);
+              setFilter(e.target.value);
+            }}
+            optionType="button"
+            buttonStyle="solid"
+          >
+            {FILTER_OPTIONS.map((o) => (
+              <Radio.Button key={o.value} value={o.value}>{o.label}</Radio.Button>
+            ))}
+          </Radio.Group>
+        </Space>
+      )}

-      <Table<ZahlungDocument>
-        dataSource={data}
-        columns={columns}
-        rowKey="id"
-        loading={loading}
-        size="small"
-        pagination={{
-          current: page,
-          pageSize,
-          total,
-          showSizeChanger: true,
-          pageSizeOptions: ['25', '50', '100'],
-          onChange: (p, ps) => {
-            setPage(p);
-            setPageSize(ps);
-          },
-          showTotal: (t) => `${t} Belege`,
-        }}
-      />
+      {isMobile ? (
+        <MobileCardList<ZahlungDocument>
+          dataSource={data}
+          rowKey="id"
+          loading={loading}
+          pagination={paginationConfig}
+          emptyText="Keine Belege vorhanden"
+          renderCard={(doc) => {
+            const freigegeben = istFreigegeben(doc);
+            return (
+              <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
+                <Text strong>{doc.title || '—'}</Text>
+                <Text type="secondary" style={{ fontSize: 13 }}>Dokumenttyp: {getDocTypeName(doc.document_type)}</Text>
+                <Text type="secondary" style={{ fontSize: 13 }}>Absender: {getCorrespondentName(doc.correspondent)}</Text>
+                <Text type="secondary" style={{ fontSize: 13 }}>
+                  Erstellt: {doc.created ? dayjs(doc.created).format('DD.MM.YYYY') : '—'}
+                </Text>
+                <div style={{ display: 'flex', gap: 4, flexWrap: 'wrap' }}>
+                  {renderFreigabeTag(doc)}
+                  {renderZahlungTag(doc)}
+                </div>
+                <Button
+                  icon={<EuroOutlined />}
+                  type="primary"
+                  block
+                  disabled={!freigegeben}
+                  onClick={() => openModal(doc)}
+                >
+                  Zahlung verbuchen
+                </Button>
+                {!freigegeben && (
+                  <Text type="secondary" style={{ fontSize: 12 }}>
+                    Beleg muss zuerst freigegeben werden
+                  </Text>
+                )}
+              </div>
+            );
+          }}
+        />
+      ) : (
+        <Table<ZahlungDocument>
+          dataSource={data}
+          columns={columns}
+          rowKey="id"
+          loading={loading}
+          size="small"
+          pagination={paginationConfig}
+        />
+      )}

      <Modal
        title="Zahlung verbuchen"
Author	SHA1	Message	Date
bjoernpoettker	32ba772e4e	fix(frontend): weiße Seite bei fehlgeschlagenem Chunk-Import beheben Build and Push Multi-Platform Images / build-and-push (push) Successful in 18s Details Alle Seiten werden per React.lazy als eigene Chunks nachgeladen. Schlug ein Import fehl (Safari: "Importing a module script failed" — z.B. nach einem Deployment mit neuen Chunk-Namen oder bei beschädigtem, wegen "Cache-Control: immutable" nie revalidiertem Browser-Cache), riss der Fehler mangels ErrorBoundary den kompletten React-Baum in eine weiße Seite. - main.tsx: Bei 'vite:preloadError' automatisch neu laden (max. 1×/Minute, sessionStorage-Guard gegen Reload-Schleifen) - AppErrorBoundary (neu): Fehlermeldung mit "Seite neu laden"-Button statt weißer Seite; bei Chunk-Ladefehlern mit Hinweis auf Cache-Leeren - App.tsx: ErrorBoundary um alle Routen gelegt Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-27 10:20:25 +02:00
bjoernpoettker	095cc4bb02	fix: Warteschlange blieb stehen – Altersvergleich in die DB verlagert Build and Push Multi-Platform Images / build-and-push (push) Successful in 32s Details Der Mindest-Wartezeit-Check verglich Date.now() (Node-Uhr) mit dem aus der DB gelesenen createdAt. Ohne gesetzte timezone (mysql2-Default 'local') wird createdAt bei abweichender DB-Zeitzone als zukünftig interpretiert → Alter negativ → jeder Eintrag galt als "zu jung" und wurde nie verarbeitet. Der Vergleich läuft jetzt in der DB (createdAt <= NOW(6) - INTERVAL 5s via TypeORM Raw), unabhängig von Zeitzone/Uhr des Node-Prozesses. Bereits wartende Einträge werden dadurch nach dem Deploy sofort abgearbeitet. Test-Mock bildet den DB-Alters-Filter nach. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-22 12:07:51 +02:00
bjoernpoettker	7b2a79be2a	fix: Dateinamen mit Pfadtrennzeichen beim Mail-Import absichern Build and Push Multi-Platform Images / build-and-push (push) Successful in 31s Details Anhänge mit '/' im Dateinamen (z.B. "Rechnung - 2026/002650322.PDF") führten zu einem Fehler, weil '/' als Verzeichnistrenner interpretiert wurde und der temp. Pfad nicht existierte. - sanitizeFilename() ersetzt '/' und '\' durch '-', entfernt '..' und Null-Bytes - Wird beim Speichern in die DB (email-download) und beim Aufbau des temp. Pfads (email-import) angewendet (defense-in-depth) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-07-22 11:10:36 +02:00
bjoernpoettker	1c70473cef	feat: Mindest-Wartezeit (5000 ms) zwischen Einreihen und Verarbeitung Build and Push Multi-Platform Images / build-and-push (push) Successful in 33s Details processQueue verarbeitet den ältesten Warteschlangen-Eintrag erst, wenn er mindestens MIN_QUEUE_AGE_MS (Default 5000 ms, ENV WEBHOOK_QUEUE_MIN_AGE_MS) in der Tabelle lag. Ist der älteste Eintrag (FIFO) noch zu jung, bricht der Tick ab und prüft beim nächsten Intervall erneut. Unit-Test ergänzt. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-22 11:03:10 +02:00
bjoernpoettker	beaa1be4a5	feat(backend): Metadaten direkt beim Paperless-Upload übergeben Build and Push Multi-Platform Images / build-and-push (push) Successful in 31s Details E-Mail-Import und External-Upload setzen ASN, Custom Fields (CF3/CF7/CF9), Dokumenttyp, Tags, Owner und Belegdatum jetzt bereits beim post_document, statt erst nachträglich über den Task-Processor-Cron (30 s + PATCH). - Neu: deriveTaskMetadata() in task-metadata.util.ts als gemeinsame Ableitung (Task-Felder → Paperless-Metadaten) für beide Upload-Pfade und den Task-Processor – identische Parsing-Regeln, kein Copy-Paste - Task-Processor nutzt den Helper (verhaltensidentischer Refactor) und patcht weiterhin idempotent nach; zuständig bleibt er für alles ID-Abhängige (CF8-Verknüpfungen, Anlage-Titel, Owner-Entfernung, Notizen) - FAILURE-Zweig loggt Paperless-Fehlertext und Belegnummer vor dem Löschen des Tasks (ASN-Kollision kann jetzt den Consume scheitern lassen) - Tests: 18 Unit-Tests für deriveTaskMetadata, 3 Charakterisierungstests pinnen den PATCH-Payload von processSuccessfulTask Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-14 22:46:42 +02:00
bjoernpoettker	57c8964384	feat(frontend): Manuell bearbeiten – Speichern trotz fehlender Pflichtfelder Build and Push Multi-Platform Images / build-and-push (push) Successful in 17s Details Im "Manuell bearbeiten"-Dialog (DocumentEditModal, isPosteingang=false) kann jetzt trotz leerer Pflichtfelder gespeichert werden: Schlägt die Formular- Validierung fehl, erscheint ein Bestätigungsdialog, der die fehlenden Pflicht- felder auflistet; per "Trotzdem speichern" wird ohne erneute Validierung gespeichert. Der Posteingang (isPosteingang=true) blockiert wie bisher. Die Kontonummer-Logik wurde in runSave() ausgelagert und von beiden Pfaden (normal + "trotzdem speichern") wiederverwendet. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-14 10:55:04 +02:00
bjoernpoettker	8390d03869	Merge pull request 'Freigabe → main: Mobile UI, Webhook, IMAP, Zahlung-Workflow und weitere Features' (#5 ) from Freigabe into main Build and Push Multi-Platform Images / build-and-push (push) Successful in 8s Details Reviewed-on: #5	2026-07-14 07:44:32 +00:00
bjoernpoettker	3cbb64686a	chore: add .gitea_token to .gitignore Build and Push Multi-Platform Images / build-and-push (push) Successful in 10s Details	2026-07-14 09:43:53 +02:00
bjoernpoettker	7076eef57b	feat: add mobile-responsive layout and card views across all pages Build and Push Multi-Platform Images / build-and-push (push) Successful in 39s Details - New useIsMobile hook and MobileCardList component - AppLayout: hamburger menu + Drawer navigation on mobile - All list pages (Inbox, Posteingang, Manuell, Mail, Freigabe, Zahlung, TaskLog) show card layout on mobile instead of tables - CSS: responsive modal height, horizontal table scroll, text-size-adjust - Backend: Agrarmonitor polling fixes, Zahlung service improvements, IMAP folder service extended, misc controller fixes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-07-14 09:22:58 +02:00
bjoernpoettker	0765d14d3b	fix(agrarmonitor): Karenzzeit vor "Von AM zurück"-Markierung Build and Push Multi-Platform Images / build-and-push (push) Successful in 39s Details Belege, die per E-Mail an Agrarmonitor gesendet werden, brauchen bis zu 10 Minuten bis zum Import in den Dateieingang. Bisher wurden sie im Upload-Check sofort als "Manuell bearbeiten" + Tag 19 markiert, wenn sie weder verbucht noch im Dateieingang waren – auch mitten im Import-Fenster. Jetzt wird vor dem Markieren geprüft, ob die jüngste Notiz mit dem konfigurierbaren Marker-Text jünger als die Wartezeit ist; falls ja, wird der Beleg übersprungen und beim nächsten Lauf erneut geprüft. Wartezeit (agrarmonitor_import_wartezeit_minuten, Standard 10) und Marker (agrarmonitor_notiz_marker, Standard "Agrarmonitor") sind als Settings konfigurierbar und in der Settings-Seite editierbar. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-07-03 12:40:59 +02:00
bjoernpoettker	8fda248683	fix(frontend): seltener Relogin durch stillen Token-Refresh Build and Push Multi-Platform Images / build-and-push (push) Successful in 17s Details Zwei Lücken behoben, die bei abgelaufenem Access-Token (v.a. nach inaktivem Tab, dessen Renew-Timer gedrosselt wurde) zu vollständigen Neuanmeldungen führten: - getAccessToken erneuert das Token jetzt proaktiv (signinSilent), wenn es abgelaufen ist, statt ein abgelaufenes Token zu senden. Profitiert auch den direkten fetch-Aufrufen (Bilder/PDFs). - Der 401-Interceptor versucht zuerst einen stillen Refresh und wiederholt die Anfrage einmal; erst wenn das scheitert (Refresh-Token ungültig), erfolgt der Login-Redirect. Gleichzeitige Refreshes werden dedupliziert (renewToken), um invalid_grant bei Refresh-Token-Rotation zu vermeiden. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 11:53:38 +02:00
bjoernpoettker	156b0401b3	fix(auth): JWT nicht als API-Key prüfen (Bearer-Fallback nur für pm_-Keys) Build and Push Multi-Platform Images / build-and-push (push) Successful in 30s Details Beim JWT-Ablauf fällt der JwtOrApiKeyGuard auf den ApiKeyGuard zurück. Dieser nahm bisher jedes Authorization-Bearer-Token als API-Key-Kandidaten – also auch das (abgelaufene) JWT – und loggte eine irreführende "Invalid API Key"-Warnung (samt JWT-Präfix). Der Bearer-Fallback akzeptiert nun nur noch Token mit dem API-Key-Präfix "pm_"; ein JWT wird ignoriert. Ergebnis bleibt 401 (Frontend re-authentifiziert), aber ohne irreführenden Log. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 11:12:53 +02:00
bjoernpoettker	e50111a731	fix(frontend): einheitliche Schriftart in AntD-Komponenten Build and Push Multi-Platform Images / build-and-push (push) Successful in 17s Details fontFamily-Token im ConfigProvider auf denselben Inter-Stack wie der Body gesetzt. Zuvor fehlte das Token, sodass AntD-Eingaben (z.B. das Select- Suchfeld) im AntD-Default-Stack abwichen, während der angezeigte Wert die Body-Schrift (Inter) nutzte. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-30 11:09:52 +02:00
bjoernpoettker	9718d6888a	feat: Webhook-Warteschlange in Datenbank persistieren Build and Push Multi-Platform Images / build-and-push (push) Successful in 31s Details Die Warteschlange liegt nicht mehr im Speicher, sondern in der neuen Tabelle webhook_queue (Entity WebhookQueueItem, documentId als Primärschlüssel). So überstehen ausstehende IDs einen Neustart und werden nach dem Boot weiterverarbeitet. - Neue Entity + Migration (CreateWebhookQueue); in data-source.ts/Barrel registriert. Dev: synchronize legt die Tabelle an; Prod: migrationsRun. - enqueue nutzt INSERT IGNORE (atomar, race-sicher) -> Dedup über den PK. - processQueue holt FIFO (createdAt ASC), entfernt die Zeile vor der Verarbeitung, arbeitet sequenziell (isProcessing-Guard). - getStatus/queueSize lesen die DB-Anzahl. Controller awaitet enqueue. - Unit-Test mit simuliertem FIFO-Repo: Dedup, Remove-on-start, Re-Enqueue, No-Parallel (deterministisch). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 17:54:16 +02:00
bjoernpoettker	66a2cccd20	feat: Webhook-Warteschlange für sequenzielle, deduplizierte Verarbeitung Build and Push Multi-Platform Images / build-and-push (push) Successful in 37s Details Der Webhook reiht eingehende Dokument-IDs nur noch in eine Warteschlange ein und antwortet sofort (status "queued"). Ein separater Intervall-Prozess (WebhookQueueService) arbeitet die IDs nacheinander ab – ohne Überschneidung, falls ein Dokument mehrfach kurz hintereinander gespeichert wird: - Jede ID kommt nur einmal in der Liste vor (Dedup). - Beim Verarbeitungsstart wird die ID sofort entfernt; ein erneutes Feuern während der Verarbeitung reiht sie wieder ein (ein weiterer Lauf folgt). - Es läuft immer nur eine Verarbeitung gleichzeitig (isProcessing-Guard). - Prüfintervall sehr kurz (WEBHOOK_QUEUE_INTERVAL_MS, Default 1000 ms). Status-Recording (last_webhook_call) + GET /api/webhook/status wandern in den Queue-Service und liefern zusätzlich die aktuelle Warteschlangen-Größe. Frontend-Tab zeigt Status "In Warteschlange" und die Queue-Größe an. Unit-Test deckt Dedup, Remove-on-start, Re-Enqueue und No-Parallel ab. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-29 17:09:23 +02:00
bjoernpoettker	c665451abf	Merge pull request 'Freigabe' (#4 ) from Freigabe into main Build and Push Multi-Platform Images / build-and-push (push) Successful in 9s Details Reviewed-on: #4	2026-06-16 14:49:23 +00:00