🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00
🎉 Init
2026-08-21 15:29:01 +02:00

r9t Frontend

Schlankes Web-UI für den r9t Object-Storage (S3-kompatibel). Buckets durchsuchen, Objekte anschauen/downloaden/löschen, Dateien per Drag & Drop hochladen — mehr braucht's nicht.

Gebaut mit Nuxt 4, Vue 3 und Tailwind CSS 4.

Was das Ding tut

  • Buckets auflisten – linke Sidebar zeigt alle verfügbaren Buckets.
  • Objekte browsen – Tabelle mit Key, Größe, Änderungsdatum, sortierbar per Klick auf die Spaltenköpfe, filterbar über die Suchleiste im Header.
  • Objekt-Details – rechtes Panel mit Metadaten (ETag, Größe, Content-Type-Erkennung anhand der Dateiendung), Vorschau für Text-Dateien, Download- und Lösch-Aktion.
  • Upload – Drag & Drop oder Dateiauswahl, optionaler Zielpfad-Prefix innerhalb des Buckets, Mehrfach-Upload mit Fortschrittsanzeige pro Datei und Retry für fehlgeschlagene Uploads.
  • Toast-Benachrichtigungen für Erfolg/Fehler bei Aktionen.

Alle S3-Requests laufen direkt aus dem Browser gegen die API, signiert per AWS SigV4 (siehe unten) — kein eigenes Backend nötig, das Objekte durchreicht.

Architektur

app/
├── app.vue                    # Root-Komponente, State-Management (Buckets/Objects/Selection)
├── components/
│   ├── BucketList.vue         # Sidebar mit Bucket-Auswahl
│   ├── ObjectTable.vue        # Objekt-Liste mit Sortierung & Leerzustand
│   ├── SortHeader.vue         # Klickbarer Tabellen-Header für Sortierung
│   ├── ObjectDetail.vue       # Detail-Panel (Metadaten, Vorschau, Download, Löschen)
│   ├── PathBreadcrumb.vue     # Breadcrumb-Anzeige für den Objekt-Pfad
│   ├── FileTypeBadge.vue      # Icon/Badge je nach Dateityp
│   ├── CopyField.vue          # Feld mit "In Zwischenablage kopieren"-Button
│   ├── FieldLabel.vue         # Label-Wrapper für Formularfelder
│   ├── ChunkBar.vue           # Fortschrittsbalken (z. B. Storage-Auslastung)
│   ├── AppToast.vue           # Toast-Benachrichtigungen
│   └── popup/
│       ├── PopupSlot.vue          # Mount-Point für das Popup-System
│       ├── UploadPopup.vue        # Upload-Dialog mit Queue & Retry
│       ├── ConfirmPopup.vue       # Generischer Bestätigungs-Dialog (z. B. Löschen)
│       └── TextPreviewPopup.vue   # Textvorschau für Objektinhalte
├── composables/
│   ├── useS3Client.ts          # Zentraler S3-Client: list/get/put/delete, signiert Requests
│   └── usePopup.ts             # Kleines Popup-Verwaltungssystem (open/close/callback)
└── utils/
    ├── sigv4.ts                # AWS SigV4 Signing (im Browser via Web Crypto API)
    ├── s3xml.ts                # Parser für S3-XML-Antworten (ListBuckets/ListObjects)
    ├── format.ts                # Formatierungshelfer (Bytes, Datum, etc.)
    └── popup.ts                 # Popup-Builder-API (Popup.component(...).setConfig(...))

S3-Kommunikation

useS3Client.ts bündelt alle Operationen gegen den Object-Storage:

  • listBuckets() / listObjects(bucket) — parsen die XML-Antworten der S3-API.
  • downloadObject, getObjectText, uploadObject, deleteObject — Standard-Objekt-Operationen.

Jeder Request wird client-seitig mit AWS Signature V4 signiert (utils/sigv4.ts, reine Web-Crypto-Implementierung, keine externe Lib). Region ist hart auf us-east-1 gesetzt, Service s3. Access-Key und Secret-Key kommen aus der Runtime-Config (siehe unten) — das ist für ein internes Tool ok, aber niemals produktive Root-Credentials hier reinpacken, sondern beschränkte Zugangsdaten für genau diesen Zweck.

Requests laufen über den Nuxt-Dev-Proxy (/api/* → http://localhost:8080, siehe nuxt.config.ts), damit CORS im lokalen Setup kein Thema ist. In Produktion muss das je nach Deployment entsprechend über Reverse-Proxy/Ingress gelöst werden.

Setup

npm install

.env anlegen (siehe .env.example):

NUXT_PUBLIC_S3_ACCESS_KEY=devkey
NUXT_PUBLIC_S3_SECRET_KEY=devsecret

Diese Werte müssen zum S3-kompatiblen Backend passen, das auf Port 8080 lauscht (siehe Proxy-Config in nuxt.config.ts).

Entwicklung

npm run dev

Läuft dann auf http://localhost:3000. Erwartet ein S3-kompatibles Backend auf http://localhost:8080 (per Proxy erreichbar unter /api).

Build & Deployment

npm run build
npm run preview   # lokale Vorschau des Production-Builds

Die Pipeline (Jenkinsfile) baut ein Docker-Image (Dockerfile, Node 22 Alpine) und pusht es nach harbor.dinauer.dev/r9t/frontend. Läuft automatisch über Jenkins bei entsprechendem Trigger.

Bekannte Lücken / offene Punkte

  • Der "Bucket erstellen"-Button in der Sidebar ist aktuell nur ein Mock (mockAction() in app.vue) — es gibt noch keine Backend-Anbindung dafür.
  • Keine Pagination bei listObjects — bei sehr großen Buckets (>1000 Keys, S3-Standardlimit) werden nicht alle Objekte geladen.
  • Secret Key liegt in der öffentlichen Runtime-Config (runtimeConfig.public) und landet damit im Client-Bundle. Für ein rein internes Tool mit eingeschränkten Credentials akzeptabel, für alles andere nicht.
S
Description
No description provided
Readme
187 KiB
Languages
Vue 75.8%
TypeScript 21.5%
CSS 2.3%
Dockerfile 0.4%