DOC-16: ret-05-client-aufbewahrungsklasse-registrieren-vernichtungs-rueckruf

- dms/internal/retentionclient: HTTP-Client fuer Archive RET-05/RET-09
- dms/internal/retentiondestroy: RegisterOrRequeue (FDN-04-Requeue bei
  Fehlschlag, kein Absturz/stilles Verwerfen), DestroyCallbackHandler
  (physische Loeschung aller Datei-Revisionen ueber storage.Service,
  markiert Dokument als vernichtet, 2xx erst danach)
- dms/cmd/app: mountet destroy-callback, registriert beim Start
- dms/cmd/worker: verarbeitet Requeue-Jobs (Retry)
- nur dms_document registriert (DOC-01/FDN-02 kennen keinen separaten
  Anhang-Typ, kein Umbau angrenzender Bereiche)
- real getestet: registrierung gegen echten fake-RET-05-Server, echte
  Loeschung inkl. Storage-Byte-Nachweis, echter Requeue-Eintrag bei
  Fehlschlag, erfolgreicher Retry
- live auf 131 gegen echten RET-09-Dienst (Port 8095) verifiziert,
  echter curl-Vernichtungs-Rueckruf mit real geloeschter Datei
- reale Core-API-06-Deploy-Luecke dokumentiert (nicht verschwiegen):
  /internal/resync/usage auf 131 aktuell nicht gemountet

Pruefungen siehe dms/docs/DOC-16-PRUEFPROTOKOLL.md

dms/cmd/worker/main.go

@@ -1,16 +1,23 @@
 // worker ist der Hintergrund-Dienst des DMS — verarbeitet lange laufende
 // Aufgaben (Indexierung, OCR, Storage-Vorgaenge in spaeteren Kacheln),
-// getrennt vom App-Prozess (siehe cmd/app).
+// getrennt vom App-Prozess (siehe cmd/app). DOC-16: verarbeitet zusaetzlich
+// Requeue-Jobs fuer fehlgeschlagene RET-05-Registrierungen.
 package main
 
 import (
 	"context"
+	"errors"
 	"log"
 	"os"
 	"os/signal"
 	"syscall"
 	"time"
 
+	"github.com/jackc/pgx/v5/pgxpool"
+
+	"gitea.perlbach24.de/scripte/nexarch/dms/internal/jobqueue"
+	"gitea.perlbach24.de/scripte/nexarch/dms/internal/retentionclient"
+	"gitea.perlbach24.de/scripte/nexarch/dms/internal/retentiondestroy"
 	"gitea.perlbach24.de/scripte/nexarch/dms/internal/shared"
 )
 
@@ -20,6 +27,21 @@ func main() {
 	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
 	defer stop()
 
+	var (
+		queue  *jobqueue.Queue
+		client *retentionclient.Client
+	)
+	if dsn := os.Getenv("NEXARCH_DMS_WORKER_TENANT_DSN"); dsn != "" {
+		pool, err := pgxpool.New(ctx, dsn)
+		if err != nil {
+			log.Fatalf("dms-worker: datenbankverbindung: %v", err)
+		}
+		queue = jobqueue.NewQueue(pool, 5*time.Minute)
+		client = retentionclient.New(os.Getenv("NEXARCH_DMS_WORKER_RETENTION_BASE_URL"))
+	} else {
+		log.Print("dms-worker: NEXARCH_DMS_WORKER_TENANT_DSN nicht gesetzt, DOC-16-Requeue-Verarbeitung deaktiviert")
+	}
+
 	ticker := time.NewTicker(30 * time.Second)
 	defer ticker.Stop()
 	for {
@@ -28,8 +50,37 @@ func main() {
 			log.Println("dms-worker beendet")
 			return
 		case <-ticker.C:
-			// Platzhalter fuer Job-Verarbeitung (FDN-02 ff.) — Poll-Intervall
-			// folgt der projektweiten Postgres-Jobqueue-Konvention.
+			if queue != nil {
+				processRetentionRegisterJobs(ctx, queue, client)
+			}
+		}
+	}
+}
+
+// processRetentionRegisterJobs holt und verarbeitet ALLE aktuell
+// abholbaren doc16_retention_register-Jobs (Akzeptanzkriterium 3: Requeue
+// statt Absturz/Verwerfen — Fail() haengt selbst nie ab, sondern setzt
+// pending mit Backoff oder dead_letter, siehe FDN-04).
+func processRetentionRegisterJobs(ctx context.Context, queue *jobqueue.Queue, client *retentionclient.Client) {
+	for {
+		job, err := queue.Dequeue(ctx, "dms-worker", []string{retentiondestroy.JobTypeRegister})
+		if err != nil {
+			if !errors.Is(err, jobqueue.ErrNoJobAvailable) {
+				log.Printf("dms-worker: dequeue fehlgeschlagen: %v", err)
+			}
+			return
+		}
+		if err := retentiondestroy.ProcessRegisterJob(ctx, client, job.Payload); err != nil {
+			log.Printf("dms-worker: retention-registrierung erneut fehlgeschlagen (job %s): %v", job.ID, err)
+			if failErr := queue.Fail(ctx, job.ID, err); failErr != nil {
+				log.Printf("dms-worker: job als fehlgeschlagen markieren: %v", failErr)
+			}
+			continue
+		}
+		if err := queue.Complete(ctx, job.ID); err != nil {
+			log.Printf("dms-worker: job abschliessen: %v", err)
+		} else {
+			log.Printf("dms-worker: retention-registrierung erfolgreich nachgeholt (job %s)", job.ID)
 		}
 	}
 }