# 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](https://nuxt.com), 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 ```bash npm install ``` `.env` anlegen (siehe `.env.example`): ```bash 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 ```bash 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 ```bash 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.