M8 Abschlussdokumentation und Betriebsdoku final geschärft

pdf-umbenenner-adapter-out/src/main/java/de/gecheckt/pdf/umbenenner/adapter/out/lock/FilesystemRunLockPortAdapter.java

@@ -14,7 +14,7 @@ import de.gecheckt.pdf.umbenenner.application.port.out.RunLockUnavailableExcepti
 /**
  * File-based implementation of {@link RunLockPort} that uses a lock file to prevent concurrent runs.
  * <p>
- * AP-006 Implementation: Creates an exclusive lock file on acquire and deletes it on release.
+ * Creates an exclusive lock file on acquire and deletes it on release.
  * If the lock file already exists, {@link #acquire()} throws {@link RunLockUnavailableException}
  * to signal that another instance is already running.
  * <p>

pdf-umbenenner-adapter-out/src/main/java/de/gecheckt/pdf/umbenenner/adapter/out/pdfextraction/PdfTextExtractionPortAdapter.java

@@ -102,7 +102,7 @@ public class PdfTextExtractionPortAdapter implements PdfTextExtractionPort {
             try {
                 int pageCount = document.getNumberOfPages();
 
-                // AP-003: Handle case of zero pages as technical error
+                // Handle case of zero pages as technical error
                 // (PdfPageCount requires >= 1, so this is a constraint violation)
                 if (pageCount < 1) {
                     return new PdfExtractionTechnicalError(
@@ -124,7 +124,7 @@ public class PdfTextExtractionPortAdapter implements PdfTextExtractionPort {
             }
 
         } catch (IOException e) {
-            // All I/O and PDFBox loading/parsing errors are technical errors in AP-003
+            // All I/O and PDFBox loading/parsing errors are technical errors
             String errorMessage = e.getMessage() != null ? e.getMessage() : e.toString();
             return new PdfExtractionTechnicalError(
                 "Failed to load or parse PDF: " + errorMessage,

pdf-umbenenner-adapter-out/src/main/java/de/gecheckt/pdf/umbenenner/adapter/out/sourcedocument/SourceDocumentCandidatesPortAdapter.java

@@ -14,7 +14,7 @@ import de.gecheckt.pdf.umbenenner.domain.model.SourceDocumentLocator;
 /**
  * File-system based implementation of {@link SourceDocumentCandidatesPort}.
  * <p>
- * AP-002 Implementation: Scans a configured source folder and returns only PDF files
+ * Scans a configured source folder and returns only PDF files
  * (by extension) as {@link SourceDocumentCandidate} objects.
  * <p>
  * Design:
@@ -29,13 +29,11 @@ import de.gecheckt.pdf.umbenenner.domain.model.SourceDocumentLocator;
  * <p>
  * Non-goals:
  * <ul>
- *   <li>No PDF validation (that is AP-003)</li>
+ *   <li>No PDF structure validation</li>
  *   <li>No recursion into subdirectories</li>
- *   <li>No content evaluation (that happens in AP-004: brauchbarer Text assessment)</li>
+ *   <li>No content evaluation (text usability is assessed during document processing)</li>
  *   <li>No fachlich evaluation of candidates</li>
  * </ul>
- *
- * @since M3-AP-002
  */
 public class SourceDocumentCandidatesPortAdapter implements SourceDocumentCandidatesPort {
 

pdf-umbenenner-adapter-out/src/main/java/de/gecheckt/pdf/umbenenner/adapter/out/sqlite/SqliteSchemaInitializationAdapter.java

@@ -43,7 +43,7 @@ import de.gecheckt.pdf.umbenenner.application.port.out.PersistenceSchemaInitiali
  *   <li>Target-copy column ({@code final_target_file_name}) to {@code processing_attempt}</li>
  * </ul>
  *
- * <h2>M4→current-schema status migration</h2>
+ * <h2>Legacy-state migration</h2>
  * <p>
  * Documents in an earlier positive intermediate state ({@code SUCCESS} recorded without
  * a validated naming proposal) are idempotently migrated to {@code READY_FOR_AI} so that
@@ -178,7 +178,7 @@ public class SqliteSchemaInitializationAdapter implements PersistenceSchemaIniti
     };
 
     // -------------------------------------------------------------------------
-    // M4→current-schema status migration
+    // Legacy-state status migration
     // -------------------------------------------------------------------------
 
     /**