# U-Navigator

Unraid File Navigator.

Ziel: Eine optische Dateiverwaltung fuer Unraid, inspiriert von Synology File Station.

Aktueller Stand:

- Machbarkeitsstudie: [docs/MACHBARKEITSSTUDIE.md](docs/MACHBARKEITSSTUDIE.md)
- Prototyp: In-App-Fenstermanager, Explorer-Fenster, Eigenschaften-Fenster, Transfer-Queue, lokaler Upload und interne Move/Copy-Jobs.

Kurzentscheidung:

U-Navigator ist als natives Unraid-Dynamix-Plugin umgesetzt. Die Weboberflaeche wird direkt im Unraid-WebGUI geladen; die API-Endpunkte laufen als PHP-Dateien im Plugin.

Naechster sinnvoller Schritt:

Robuste Hintergrundjobs fuer grosse Copy/Move-Operationen und eine Konfigurationsseite fuer erlaubte Roots.

## Unraid Plugin installieren

Plugin-URL:

```text
https://git.casaderoll.de/michael/Unraid-Navigator/raw/branch/main/u-navigator.plg
```

Installation per Unraid Terminal:

```sh
installplg https://git.casaderoll.de/michael/Unraid-Navigator/raw/branch/main/u-navigator.plg
```

Oder im WebGUI:

```text
Plugins -> Install Plugin -> URL einfuegen -> Install
```

Danach oeffnen:

```text
U-Navigator
```

Es wird kein extra Webserver und kein Node.js auf Unraid benoetigt.

## Lokal testen

Der historische Node-Prototyp ist fuer lokale API-Tests noch im Repo. Auf Entwicklungsmaschinen ohne `/mnt/user` kann ein Root gesetzt werden:

```sh
U_NAV_ROOT="$PWD" PORT=8088 npm start
```

Danach im Browser oeffnen:

```text
http://127.0.0.1:8088
```

## Tests

```sh
npm test
```

Die Tests starten einen lokalen HTTP-Server und pruefen Listing, Upload, Move-Jobs, Zielkonflikte und Pfad-Sandboxing.