RET-07: fristablauf-benachrichtigungen
- archive/internal/notifyclient: HTTP-Client fuer Core CFG-05 (gleiches Muster wie rbacclient/RET-08 fuer RBAC-06) - archive/internal/retentionnotify.Run: ermittelt faellige Objekte ueber dieselbe Funktion wie RET-02-Job/RET-06-API-Preview, filtert je Klasse nach Vorlauf+Ein-Aus-Schalter, Postgres-persistente Dedupe (retention_notifications), Fehlschlag wird protokolliert statt verworfen (kein Eintrag -> Retry beim naechsten Durchlauf) - archive/cmd/retention-notify-job: systemd-Timer-CLI, analog scrub-cli - Abweichung vom urspruenglichen Ticket-Text dokumentiert: CFG-05 statt direktem CFG-02-Import (Modul-Trennung), konfigurierte zustaendige Rolle statt Objekt-Owner (RET-01 fuehrt keinen) - real deployed auf 131 (timer taeglich 07:00 UTC), end-zu-ende bewiesen: echte notification_jobs-Zeile in Core-DB, zweiter Dienststart ohne Doppelversand Pruefungen siehe archive/docs/RET-07-PRUEFPROTOKOLL.md
This commit is contained in:
sysops
@@ -0,0 +1,158 @@
|
||||
// Package retentionnotify implementiert RET-07: Benachrichtigung einer
|
||||
// konfigurierten zuständigen Rolle (Tenant-Admin — RET-01 führt bewusst
|
||||
// keine Objekt-Owner-Beziehung) vor Ablauf einer Aufbewahrungsfrist,
|
||||
// konfigurierbarer Vorlauf je Aufbewahrungsklasse. Erzeugt NUR das
|
||||
// Ereignis über Core CFG-05 (archive/internal/notifyclient) — versendet
|
||||
// selbst keine E-Mail.
|
||||
package retentionnotify
|
||||
|
||||
import (
|
||||
"context"
|
||||
"fmt"
|
||||
"time"
|
||||
|
||||
"github.com/jackc/pgx/v5/pgxpool"
|
||||
|
||||
"gitea.perlbach24.de/scripte/nexarch/archive/internal/notifyclient"
|
||||
"gitea.perlbach24.de/scripte/nexarch/archive/internal/retentionengine"
|
||||
)
|
||||
|
||||
// EventType ist der an CFG-05 übergebene Ereignistyp — muss mit dem im
|
||||
// Frontend/Core bekannten Namen übereinstimmen (siehe CFG-05-Tests).
|
||||
const EventType = "retention_due_soon"
|
||||
|
||||
// Recipient benennt Tenant-Slug, User-ID und E-Mail-Adresse der
|
||||
// konfigurierten zuständigen Rolle (Tenant-Admin), an die alle
|
||||
// Fristablauf-Benachrichtigungen dieses Tenants gehen.
|
||||
type Recipient struct {
|
||||
TenantSlug string
|
||||
UserID string
|
||||
Email string
|
||||
}
|
||||
|
||||
// Result ist das Ergebnis EINES benachrichtigten (oder fehlgeschlagenen)
|
||||
// Objekts — der Aufrufer (cmd/retention-notify-job) protokolliert Err
|
||||
// explizit, kein stillschweigendes Verwerfen (Pflichtprüfung 3).
|
||||
type Result struct {
|
||||
RetentionObjectID string
|
||||
RetentionClass string
|
||||
JobID string
|
||||
Skipped bool
|
||||
Err error
|
||||
}
|
||||
|
||||
type classRuleLead struct {
|
||||
leadDays int
|
||||
enabled bool
|
||||
}
|
||||
|
||||
// Run führt EINEN Durchlauf des Benachrichtigungs-Jobs aus: ermittelt je
|
||||
// aktiver, benachrichtigungs-aktivierter Aufbewahrungsklasse die Objekte,
|
||||
// deren Stichtag innerhalb des konfigurierten Vorlaufs liegt, überspringt
|
||||
// bereits benachrichtigte Objekte (Akzeptanzkriterium 2, Postgres-
|
||||
// persistent — übersteht einen Job-Neustart) und löst für den Rest je ein
|
||||
// Ereignis über CFG-05 aus.
|
||||
func Run(ctx context.Context, pool *pgxpool.Pool, client *notifyclient.Client, now time.Time, recipient Recipient) ([]Result, error) {
|
||||
// notify_lead_days/notify_enabled sind nicht Teil von
|
||||
// retentionengine.ClassRule (RET-02/RET-06 kennen sie nicht) — direkt
|
||||
// gelesen, um retentionengine nicht um RET-07-eigene Felder zu
|
||||
// erweitern (kein Umbau angrenzender Bereiche).
|
||||
leadByClass := make(map[string]classRuleLead)
|
||||
maxLeadDays := 0
|
||||
leadRows, err := pool.Query(ctx, `SELECT retention_class, notify_lead_days, notify_enabled FROM retention_class_rules WHERE active`)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("retentionnotify: benachrichtigungs-konfiguration laden: %w", err)
|
||||
}
|
||||
for leadRows.Next() {
|
||||
var class string
|
||||
var lead classRuleLead
|
||||
if err := leadRows.Scan(&class, &lead.leadDays, &lead.enabled); err != nil {
|
||||
leadRows.Close()
|
||||
return nil, fmt.Errorf("retentionnotify: konfigurationszeile lesen: %w", err)
|
||||
}
|
||||
leadByClass[class] = lead
|
||||
if lead.leadDays > maxLeadDays {
|
||||
maxLeadDays = lead.leadDays
|
||||
}
|
||||
}
|
||||
if err := leadRows.Err(); err != nil {
|
||||
return nil, fmt.Errorf("retentionnotify: benachrichtigungs-konfiguration lesen: %w", err)
|
||||
}
|
||||
leadRows.Close()
|
||||
|
||||
if maxLeadDays == 0 {
|
||||
return nil, nil
|
||||
}
|
||||
|
||||
// Nutzt DIESELBE Funktion wie der RET-02-Job/RET-06-API-Preview
|
||||
// (kein zweiter Ermittlungspfad) — asOf auf den größten konfigurierten
|
||||
// Vorlauf gesetzt, je Klasse wird unten mit deren EIGENEM Vorlauf
|
||||
// gefiltert.
|
||||
candidates, err := retentionengine.ListExpiringObjects(ctx, pool, now.AddDate(0, 0, maxLeadDays))
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("retentionnotify: ablaufende objekte ermitteln: %w", err)
|
||||
}
|
||||
|
||||
alreadyNotified, err := loadAlreadyNotified(ctx, pool)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
var results []Result
|
||||
for _, obj := range candidates {
|
||||
lead, known := leadByClass[obj.RetentionClass]
|
||||
if !known || !lead.enabled {
|
||||
continue
|
||||
}
|
||||
if !obj.DueDate.Before(now.AddDate(0, 0, lead.leadDays+1)) {
|
||||
// Ausserhalb des klassen-eigenen Vorlaufs (nur mit dem
|
||||
// globalen maxLeadDays vorselektiert).
|
||||
continue
|
||||
}
|
||||
if alreadyNotified[obj.RetentionObjectID] {
|
||||
continue
|
||||
}
|
||||
|
||||
res := Result{RetentionObjectID: obj.RetentionObjectID, RetentionClass: obj.RetentionClass}
|
||||
enq, err := client.Enqueue(ctx, recipient.TenantSlug, recipient.UserID, EventType, "email", recipient.Email, map[string]any{
|
||||
"object_type": obj.ObjectType,
|
||||
"object_reference": obj.ObjectReference,
|
||||
"retention_class": obj.RetentionClass,
|
||||
"due_date": obj.DueDate.Format(time.RFC3339),
|
||||
})
|
||||
if err != nil {
|
||||
res.Err = err
|
||||
results = append(results, res)
|
||||
// Kein INSERT in retention_notifications bei Fehler — das
|
||||
// Objekt wird beim naechsten Durchlauf erneut versucht,
|
||||
// statt stillschweigend als erledigt zu gelten.
|
||||
continue
|
||||
}
|
||||
res.JobID = enq.JobID
|
||||
res.Skipped = enq.Skipped
|
||||
|
||||
if _, err := pool.Exec(ctx, `INSERT INTO retention_notifications (retention_object_id) VALUES ($1)`, obj.RetentionObjectID); err != nil {
|
||||
res.Err = fmt.Errorf("retentionnotify: benachrichtigung als versendet markieren: %w", err)
|
||||
}
|
||||
results = append(results, res)
|
||||
}
|
||||
return results, nil
|
||||
}
|
||||
|
||||
func loadAlreadyNotified(ctx context.Context, pool *pgxpool.Pool) (map[string]bool, error) {
|
||||
rows, err := pool.Query(ctx, `SELECT retention_object_id FROM retention_notifications`)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("retentionnotify: bereits benachrichtigte objekte laden: %w", err)
|
||||
}
|
||||
defer rows.Close()
|
||||
|
||||
out := make(map[string]bool)
|
||||
for rows.Next() {
|
||||
var id string
|
||||
if err := rows.Scan(&id); err != nil {
|
||||
return nil, fmt.Errorf("retentionnotify: zeile lesen: %w", err)
|
||||
}
|
||||
out[id] = true
|
||||
}
|
||||
return out, rows.Err()
|
||||
}
|
||||
Reference in New Issue
Block a user