fa/breadcrumb-the-shire
1
0
Fork 1
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
25370a1a5543c222501c171ed8444f7c4befcaf5
breadcrumb-the-shire/docs/importe.md
fs 25370a1a55 add composer-unused, comprehensive docs, and project restructure 
- Add icanhazstring/composer-unused as dev dependency for dependency hygiene checks
- Add German documentation (docs/) covering architecture, conventions, workflows, and developer checklists
- Add API layer (ApiAuth, ApiBootstrap, ApiResponse), audit, scheduler, custom fields, and SSO services
- Add Microsoft OIDC SSO, API token management, and user lifecycle features
- Add swagger-ui vendor integration and OpenAPI spec
- Add production Docker setup and bin/ scripts
- Update composer dependencies, config, templates, and frontend assets throughout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 15:27:35 +01:00

3.2 KiB
Raw Blame History

Importe

Letzte Aktualisierung: 2026-02-21

Diese Seite beschreibt den V1 CSV-Import unter /admin/imports.

Scope (V1)

  • Profile: users, departments.
  • Create-only: bestehende Einträge werden übersprungen.
  • CSV mit , oder ;, UTF-8 (BOM wird toleriert).
  • Limits: 10MB und 20.000 Datenzeilen.
  • Fehlerausgabe nur in der UI (kein Download in V1).

Permissions

  • imports.view: Zugriff auf die Import-Seite.
  • imports.audit.view: Zugriff auf Import-Protokolle unter /admin/import-audit.
  • users.import: User-Import ausführen.
  • users.import_assignments: Tenant/Role/Department aus CSV verwenden.
  • departments.import: Department-Import ausführen.

Ablauf

  1. Upload
    • Entität wählen (Users oder Departments) und CSV hochladen.
    • Header/Delimiter/Zeilenlimit werden direkt geprüft.
  2. Mapping
    • CSV-Header auf Zielfelder mappen.
    • Pflichtziele sind profilabhängig.
  3. Preview (Dry run)
    • Keine DB-Schreibvorgänge.
    • Summary + erste Fehler (maximal 500 Einträge).
  4. Commit
    • Zeilenweise Verarbeitung (best effort).
    • Gültige Zeilen werden erstellt, fehlerhafte reportet.

Assignment-Regeln

  • Users: optional tenant, role, department (jeweils 1:1).
  • Departments: optional tenant.
  • Identifier-Auflösung:
    • Users: UUID zuerst, ID als Fallback.
    • Departments: tenant ist UUID-only (kein ID-Fallback).
  • Nur aktive Datensätze sind gültig.
  • Department muss zum Tenant passen.
  • Fehlen Assignment-Werte, greifen Defaults aus Settings.
  • Ohne users.import_assignments wird ein Mapping mit Assignment-Spalten sofort abgelehnt.

Duplikate und Skip-Verhalten

  • In-File-Duplikate: erste Zeile gewinnt, spätere duplicate_in_file.
  • Users:
    • bestehende E-Mail: email_exists
  • Departments:
    • bestehender Code: code_exists
    • bestehende Kombination aus Tenant + Description: department_exists

Temporäre Dateien

  • Uploads liegen unter APP_STORAGE_PATH/imports/tmp.
  • Dateinamen werden randomisiert.
  • Cleanup entfernt alte Temp-Dateien opportunistisch (älter als 24h).

Import-Audit (V1)

  • Pro Commit-Lauf wird ein Audit-Run gespeichert (import_audit_runs).
  • Analyze/Preview werden bewusst nicht protokolliert.
  • Gespeichert werden nur Metadaten:
    • Profil (users/departments), Status (success/partial/failed)
    • Laufzeit, Counter (rows_total, created, skipped, failed)
    • User, aktueller Tenant, Dateiname (basename), gemappte Felder
    • aggregierte Fehlercodes (kein Zeileninhalt)
  • Keine CSV-Zeilenpayload oder PII-Details im Audit.
  • Retention: 90 Tage, bereinigbar über /admin/import-audit (Purge-Action mit settings.update).

Fehlercodes (V1)

  • Struktur: upload_missing, upload_too_large, invalid_file_type, invalid_csv_header, empty_csv, max_rows_exceeded, mapping_required_missing, assignment_permission_required
  • Zeilenvalidierung: invalid_email, invalid_tenant_uuid, duplicate_in_file, email_exists, code_exists, department_exists, invalid_locale, invalid_active, invalid_hire_date, tenant_not_found, role_not_found, department_not_found, department_tenant_mismatch, assignment_out_of_scope, create_failed, unexpected_error
Reference in New Issue View Git Blame Copy Permalink