From 3a14bcb0d0a6b16bf7e933c85f4e8043d6e004c6 Mon Sep 17 00:00:00 2001
From: Marcus van Elst <marcusvebo@gmail.com>
Date: Sat, 4 Apr 2026 11:47:14 +0200
Subject: [PATCH] =?UTF-8?q?Nachbearbeitung:=20verbliebene=20Meilensteinbez?=
 =?UTF-8?q?=C3=BCge=20in=20Produktivdokumentation=20bereinigt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pdf/umbenenner/application/port/out/ClockPort.java      | 3 ---
 .../umbenenner/application/port/out/ConfigurationPort.java  | 2 +-
 .../application/port/out/DocumentKnownProcessable.java      | 4 ++--
 .../pdf/umbenenner/application/port/out/DocumentRecord.java | 5 ++---
 .../application/port/out/DocumentRecordLookupResult.java    | 2 +-
 .../umbenenner/application/port/out/DocumentUnknown.java    | 2 +-
 .../umbenenner/application/port/out/FailureCounters.java    | 2 +-
 .../umbenenner/application/port/out/FingerprintPort.java    | 2 +-
 .../umbenenner/application/port/out/FingerprintSuccess.java | 2 +-
 .../port/out/PersistenceSchemaInitializationPort.java       | 4 ++--
 .../umbenenner/application/port/out/ProcessingAttempt.java  | 5 ++---
 .../pdf/umbenenner/application/port/out/RunLockPort.java    | 3 ---
 .../application/service/DocumentProcessingCoordinator.java  | 2 +-
 .../pdf/umbenenner/application/service/package-info.java    | 6 +++---
 .../pdf/umbenenner/application/usecase/package-info.java    | 2 +-
 15 files changed, 19 insertions(+), 27 deletions(-)

diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ClockPort.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ClockPort.java
index 2c77a2f..cd748f3 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ClockPort.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ClockPort.java
@@ -14,9 +14,6 @@ import java.time.Instant;
  * <p>
  * By isolating time access behind a port, the application can be tested with
  * deterministic time values without requiring system clock manipulation.
- * <p>
- * This port is defined in M2 for use in later milestones where timestamps
- * become relevant (e.g., run history, document date fallback).
  *
  */
 public interface ClockPort {
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ConfigurationPort.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ConfigurationPort.java
index 81f0dde..7410695 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ConfigurationPort.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ConfigurationPort.java
@@ -4,7 +4,7 @@ import de.gecheckt.pdf.umbenenner.application.config.StartConfiguration;
 
 /**
  * Outbound port for configuration access.
- * AP-005: Minimal interface for loading typed startup configuration.
+ * Provides a minimal interface for loading typed startup configuration.
  */
 public interface ConfigurationPort {
 
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentKnownProcessable.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentKnownProcessable.java
index 9954f97..7d20717 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentKnownProcessable.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentKnownProcessable.java
@@ -8,10 +8,10 @@ import java.util.Objects;
  * The document is known (fingerprint exists in the persistence store) but its overall
  * status is neither {@link de.gecheckt.pdf.umbenenner.domain.model.ProcessingStatus#SUCCESS}
  * nor {@link de.gecheckt.pdf.umbenenner.domain.model.ProcessingStatus#FAILED_FINAL}.
- * The use case may continue with normal M4 processing using the provided record.
+ * The use case may continue with normal processing using the provided record.
  * <p>
  * The existing {@link DocumentRecord} is supplied so the use case can inspect the
- * current status, failure counters, and other fields required to apply M4 retry rules
+ * current status, failure counters, and other fields required to apply retry rules
  * without an additional lookup.
  *
  * @param record the current master record for this document; never null
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecord.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecord.java
index 113a76b..fc0cb3f 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecord.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecord.java
@@ -18,7 +18,7 @@ import java.util.Objects;
  * Mapping between {@code DocumentRecord} and the persistence layer is performed
  * exclusively by the repository adapter in {@code adapter-out}.
  * <p>
- * <strong>M4 field semantics:</strong>
+ * <strong>Field semantics:</strong>
  * <ul>
  *   <li>{@link #fingerprint()} — primary identity; never changes for a given record.</li>
  *   <li>{@link #lastKnownSourceLocator()} — opaque locator used by adapters; the
@@ -37,8 +37,7 @@ import java.util.Objects;
  *   <li>{@link #updatedAt()} — timestamp of the most recent update to this master record.</li>
  * </ul>
  * <p>
- * <strong>Not included in M4:</strong> target path, target file name, AI-related fields.
- * These are added in later milestones.
+ * <strong>Not yet included:</strong> target path, target file name, AI-related fields.
  *
  * @param fingerprint             content-based identity; never null
  * @param lastKnownSourceLocator  opaque locator to the physical source file; never null
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecordLookupResult.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecordLookupResult.java
index 7a484bc..7165e5c 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecordLookupResult.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentRecordLookupResult.java
@@ -3,7 +3,7 @@ package de.gecheckt.pdf.umbenenner.application.port.out;
 /**
  * Sealed result type for a document master record lookup via {@link DocumentRecordRepository}.
  * <p>
- * The use case uses this result to make the per-document processing decision in M4
+ * The use case uses this result to make the per-document processing decision
  * without additional assumptions:
  * <ul>
  *   <li>{@link DocumentUnknown} — the fingerprint is not yet in the persistence store;
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentUnknown.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentUnknown.java
index 8ef6744..90456c8 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentUnknown.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/DocumentUnknown.java
@@ -4,7 +4,7 @@ package de.gecheckt.pdf.umbenenner.application.port.out;
  * Lookup result indicating that the fingerprint is not yet present in the persistence store.
  * <p>
  * The document has never been processed before. The use case must create a new
- * {@link DocumentRecord} and proceed with normal M4 processing.
+ * {@link DocumentRecord} and proceed with normal processing.
  * <p>
  * This variant carries no data because there is no existing record to return.
  *
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FailureCounters.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FailureCounters.java
index f5e504e..d9a9d80 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FailureCounters.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FailureCounters.java
@@ -3,7 +3,7 @@ package de.gecheckt.pdf.umbenenner.application.port.out;
 /**
  * Immutable snapshot of the two independent failure counters maintained per document.
  * <p>
- * M4 tracks two distinct counters separately because they drive different retry rules:
+ * Two distinct counters are tracked separately because they drive different retry rules:
  * <ul>
  *   <li><strong>Content error counter</strong> ({@link #contentErrorCount()}):
  *       counts how many times a deterministic content error occurred for this document
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintPort.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintPort.java
index 3230ea1..4a29a75 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintPort.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintPort.java
@@ -20,7 +20,7 @@ import de.gecheckt.pdf.umbenenner.domain.model.SourceDocumentCandidate;
  * A {@link FingerprintTechnicalError} result means no
  * {@link de.gecheckt.pdf.umbenenner.domain.model.DocumentFingerprint} is available
  * and the candidate cannot be identified; consequently no SQLite attempt record is
- * created for this candidate in M4.
+ * created for this candidate.
  *
  */
 public interface FingerprintPort {
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintSuccess.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintSuccess.java
index 7766f51..ef1b9f3 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintSuccess.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/FingerprintSuccess.java
@@ -9,7 +9,7 @@ import java.util.Objects;
  * <p>
  * Carries the computed {@link DocumentFingerprint} that uniquely identifies the
  * document by its content. The fingerprint can now be used as the primary key
- * for all subsequent persistence operations in M4.
+ * for all subsequent persistence operations.
  *
  * @param fingerprint the successfully computed fingerprint; never null
  */
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/PersistenceSchemaInitializationPort.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/PersistenceSchemaInitializationPort.java
index 5b5ab07..ee6a7e0 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/PersistenceSchemaInitializationPort.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/PersistenceSchemaInitializationPort.java
@@ -5,7 +5,7 @@ package de.gecheckt.pdf.umbenenner.application.port.out;
  * <p>
  * This port is invoked exactly once per program run, <em>before</em> the batch
  * document processing loop begins. The initialisation must ensure that all tables,
- * indices, and constraints required for M4 persistence are present in the SQLite file.
+ * indices, and constraints required for document persistence are present in the SQLite file.
  * <p>
  * <strong>Timing:</strong> The adapter implementation must perform the schema
  * initialisation eagerly and synchronously. Lazy or deferred initialisation during
@@ -27,7 +27,7 @@ package de.gecheckt.pdf.umbenenner.application.port.out;
 public interface PersistenceSchemaInitializationPort {
 
     /**
-     * Creates or verifies the M4 persistence schema.
+     * Creates or verifies the persistence schema.
      * <p>
      * Must be called once at program start, before any document processing begins.
      * The method must be idempotent: calling it on an already-initialised database
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ProcessingAttempt.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ProcessingAttempt.java
index 2f97d21..07dd78f 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ProcessingAttempt.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/ProcessingAttempt.java
@@ -11,7 +11,7 @@ import java.util.Objects;
  * Application-facing representation of exactly one historised processing attempt
  * (Versuchshistorie-Eintrag) for an identified document.
  * <p>
- * <strong>Historisation boundary (M4):</strong> Only attempts for documents whose
+ * <strong>Historisation boundary:</strong> Only attempts for documents whose
  * {@link DocumentFingerprint} was successfully computed are historised. Failures that
  * occur <em>before</em> the fingerprint is available (e.g. the source file is
  * unreadable before hashing) are <em>not</em> represented by a {@code ProcessingAttempt}
@@ -42,9 +42,8 @@ import java.util.Objects;
  *       later run; {@code false} for final failures, successes, and skip attempts.</li>
  * </ul>
  * <p>
- * <strong>Not included in M4:</strong> model name, prompt identifier, AI raw response,
+ * <strong>Not yet included:</strong> model name, prompt identifier, AI raw response,
  * AI reasoning, resolved date, date source, final title, final target file name.
- * These fields are added in later milestones (M5+).
  *
  * @param fingerprint    content-based document identity; never null
  * @param runId          identifier of the batch run; never null
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/RunLockPort.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/RunLockPort.java
index 18c8a2f..b8ba21a 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/RunLockPort.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/port/out/RunLockPort.java
@@ -20,9 +20,6 @@ package de.gecheckt.pdf.umbenenner.application.port.out;
  *   <li>Hold the lock for the entire batch run</li>
  *   <li>Release the lock cleanly at batch end (even on failure, if possible)</li>
  * </ul>
- * <p>
- * This port is used by the batch use case (M2-AP-004) but not implemented in M2;
- * implementation follows in M2-AP-006.
  *
  */
 public interface RunLockPort {
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/DocumentProcessingCoordinator.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/DocumentProcessingCoordinator.java
index 578d6ef..d30c129 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/DocumentProcessingCoordinator.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/DocumentProcessingCoordinator.java
@@ -490,7 +490,7 @@ public class DocumentProcessingCoordinator {
     }
 
     // -------------------------------------------------------------------------
-    // M3 → outcome mapping
+    // Extraction outcome mapping
     // -------------------------------------------------------------------------
 
     /**
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/package-info.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/package-info.java
index 754a750..2b5c995 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/package-info.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/service/package-info.java
@@ -17,14 +17,14 @@
  *       — Pre-check evaluation logic</li>
  *   <li>{@link de.gecheckt.pdf.umbenenner.application.service.DocumentProcessingService}
  *       — Complete document processing pipeline orchestration</li>
- *   <li>{@link de.gecheckt.pdf.umbenenner.application.service.M4DocumentProcessor}
+ *   <li>{@link de.gecheckt.pdf.umbenenner.application.service.DocumentProcessingCoordinator}
  *       — Per-document idempotency, status/counter mapping and consistent
  *       two-level persistence</li>
  * </ul>
  *
- * <h2>Document processing flow ({@code M4DocumentProcessor})</h2>
+ * <h2>Document processing flow ({@code DocumentProcessingCoordinator})</h2>
  * <p>
- * The {@link de.gecheckt.pdf.umbenenner.application.service.M4DocumentProcessor}
+ * The {@link de.gecheckt.pdf.umbenenner.application.service.DocumentProcessingCoordinator}
  * implements the required processing order per candidate:
  * <ol>
  *   <li>Load the document master record by fingerprint.</li>
diff --git a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/usecase/package-info.java b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/usecase/package-info.java
index 85e46e5..d586513 100644
--- a/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/usecase/package-info.java
+++ b/pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/usecase/package-info.java
@@ -17,7 +17,7 @@
  *   <li>If fingerprint computation fails: log as non-identifiable run event;
  *       do NOT write any SQLite record; continue with next candidate.</li>
  *   <li>Run the document extraction and pre-checks pipeline.</li>
- *   <li>Delegate to {@link de.gecheckt.pdf.umbenenner.application.service.M4DocumentProcessor}
+ *   <li>Delegate to {@link de.gecheckt.pdf.umbenenner.application.service.DocumentProcessingCoordinator}
  *       for idempotency check, status/counter mapping, and consistent persistence.</li>
  * </ol>
  * <p>