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; *

* By isolating time access behind a port, the application can be tested with * deterministic time values without requiring system clock manipulation. - *

- * 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. *

* 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}. *

- * M4 field semantics: + * Field semantics: *

*

- * Not included in M4: target path, target file name, AI-related fields. - * These are added in later milestones. + * Not yet included: 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}. *

- * 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: *

- *

- * 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 *

  • {@link de.gecheckt.pdf.umbenenner.application.service.DocumentProcessingService} * — Complete document processing pipeline orchestration
  • - *
  • {@link de.gecheckt.pdf.umbenenner.application.service.M4DocumentProcessor} + *
  • {@link de.gecheckt.pdf.umbenenner.application.service.DocumentProcessingCoordinator} * — Per-document idempotency, status/counter mapping and consistent * two-level persistence
  • * * - *

    Document processing flow ({@code M4DocumentProcessor})

    + *

    Document processing flow ({@code DocumentProcessingCoordinator})

    *

    - * 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: *

      *
    1. Load the document master record by fingerprint.
    2. 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 @@ *
    3. If fingerprint computation fails: log as non-identifiable run event; * do NOT write any SQLite record; continue with next candidate.
    4. *
    5. Run the document extraction and pre-checks pipeline.
    6. - *
    7. Delegate to {@link de.gecheckt.pdf.umbenenner.application.service.M4DocumentProcessor} + *
    8. Delegate to {@link de.gecheckt.pdf.umbenenner.application.service.DocumentProcessingCoordinator} * for idempotency check, status/counter mapping, and consistent persistence.
    9. *
    *