Klassifikationsnummern-Pflege

Text-basiert (O2/Vodafone) — ELMOTEXT-basierte Nummern mit Datums-/Lizenz-Suffixen.

Leer — Leerer ELMOTEXT (Kundennummern etc.), in der Regel irrelevant.

Phase 3: Automatisches Matching

ELMO-Format Matching

Referenz-Einträge anhand von ELMONUMBER-Prefix und Namensmustern finden:

Wichtig: Prefix allein reicht nicht! Immer einen kategorisierten Referenz-Eintrag mit ähnlichem ELMOTEXT suchen und die Zuordnung bestätigen:

$ref = \App\Models\Klassifikationsnummer::with('category')
    ->whereNotNull('category_id')
    ->where('ELMONUMBER', 'like', $prefix . '%')
    ->where('ELMOTEXT', 'like', '%' . substr($elmotext, 0, 20) . '%')
    ->first();

Text-basiertes Matching

ELMOTEXT bereinigen (Datums-Suffixe, Lizenzanzahlen, anteilige Tage entfernen) und dann die ersten 25 Zeichen gegen bestehende kategorisierte Einträge vergleichen:

$clean = preg_replace('/\s*-\s*\d{2}\.\d{2}\.\d{4}$/', '', $text);
$clean = preg_replace('/\s*\(?\d{2}\.\d{2}\.\d{4}\s*-\s*\d{2}\.\d{2}\.\d{4}\)?/', '', $clean);
$clean = preg_replace('/\s*\(anteilig \d+ Tage\)/', '', $clean);
$clean = preg_replace('/\s*\d+\s*Lizenz(en)?/', '', $clean);
$clean = preg_replace('/\s*\d+\s*Minute\(n\)/', '', $clean);
$clean = preg_replace('/\s*\d+\s*(MB|GB)/', '', $clean);
$short = substr(trim($clean), 0, 25);

$match = \App\Models\Klassifikationsnummer::with('category')
    ->whereNotNull('category_id')
    ->where('ELMOTEXT', 'like', $short . '%')
    ->first();

Phase 4: Ergebnisse dem User präsentieren

Übersichtliche Tabelle mit allen gefundenen Einträgen zeigen, gruppiert nach:

1. Sicher zuordenbar (ELMO mit Referenz-Match oder Text-Match) — mit vorgeschlagener Kategorie
2. Nicht zuordenbar (kein Referenz-Match) — manuell zu prüfen
3. Irrelevant (leerer ELMOTEXT)

Dem User die Zahlen und vorgeschlagenen Zuordnungen zeigen. Erst nach User-Bestätigung weiter.

Phase 5: Migration erstellen

Nach Bestätigung eine Laravel-Migration generieren mit folgenden Anforderungen:

• Branch: hotfix/fix-missing-klassifikationsnummer-categories (oder ähnlich)
• Idempotent: Nur updaten wenn category_id IS NULL
• Abgesichert gegen frische DBs: Prüfen ob Tabelle und IDs existieren
• Reversibel: down() setzt category_id auf NULL zurück
• Dokumentiert: Docblock mit Root Cause, betroffenen Einträgen, und Referenz-Quellen

Migrations-Template:

public function up(): void
{
    if (! DB::getSchemaBuilder()->hasTable('klassifikationsnummern')) {
        return;
    }

    $mappings = $this->getMappings();
    $existingIds = DB::table('klassifikationsnummern')
        ->whereIn('id', array_keys($mappings))
        ->whereNull('category_id')
        ->pluck('id')
        ->all();

    if (empty($existingIds)) {
        Log::info('Migration: No matching Klassifikationsnummern to fix');
        return;
    }

    $updated = 0;
    foreach ($existingIds as $id) {
        [$categoryId, $type] = $mappings[$id];
        DB::table('klassifikationsnummern')
            ->where('id', $id)
            ->update([
                'category_id' => $categoryId,
                'type' => json_encode($type),
                'updated_at' => now(),
            ]);
        $updated++;
    }

    Log::info("Migration: Fixed {$updated} Klassifikationsnummern");
}

Phase 6: Nach Deployment

Den User darauf hinweisen, dass nach dem Deployment die PDF-Kostenübersichten für betroffene Kunden neu generiert werden müssen. Betroffene EdiCostOverviews identifizieren durch Verknüpfung der gefixten Klassifikationsnummern mit EdiFactDocuments.

Kategorie-Referenz

Type-Flags

Jede Klassifikationsnummer hat ein type JSON-Feld mit 5 Flags:

Wichtige Hinweise

• shouldShowInCostTable() prüft zuerst category_id != NULL, dann ob Kategorie in COST_CATEGORIES ist oder type.costs/type.costsrebate true ist
• Einträge mit category_id = NULL werden immer ignoriert — sie tauchen nie in Kostenübersichten auf
• Die klassifikationsnummern-Tabelle hat Soft Deletes (deleted_at)
• Alle Kategorien abrufbar via: \App\Models\KlassifikationsnummerCategory::all(['id', 'name'])