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: *
* 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. *
* 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. *
- * M4 tracks two distinct counters separately because they drive different retry rules: + * Two distinct counters are tracked separately because they drive different retry rules: *
* 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; *
* This port is invoked exactly once per program run, before 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. *
* Timing: 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. *
* 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. *
- * Historisation boundary (M4): Only attempts for documents whose + * Historisation boundary: Only attempts for documents whose * {@link DocumentFingerprint} was successfully computed are historised. Failures that * occur before the fingerprint is available (e.g. the source file is * unreadable before hashing) are not represented by a {@code ProcessingAttempt} @@ -42,9 +42,8 @@ import java.util.Objects; * later run; {@code false} for final failures, successes, and skip attempts.
- * Not included in M4: model name, prompt identifier, AI raw response, + * Not yet included: 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; *
- * 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 *
- * 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: *