96 lines
5.1 KiB
Markdown
96 lines
5.1 KiB
Markdown
# 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.
|