# Kosmos Storage Audit

`Kosmos Storage Audit` hilft Spielleitern dabei, fehlende, veraltete und moeglicherweise verwaiste Mediendateien in einer FoundryVTT-Installation zu finden.

Das Modul ist als Pruefwerkzeug gedacht. Es aendert keine Weltdaten und verschiebt oder loescht keine Dateien.

## Installation

Manifest-URL:

```text
https://gitea.kosmos.ac/kosmos/kosmos-storage-audit/raw/branch/main/module.json
```

Alternativ:

- Projektseite: `https://gitea.kosmos.ac/kosmos/kosmos-storage-audit`
- ZIP-Download: `https://gitea.kosmos.ac/kosmos/kosmos-storage-audit/archive/main.zip`

## Was das Modul prueft

Der Report zeigt drei Arten von Problemen:

- `Fehlt`
  Dateien werden noch von Objekten in der Welt verwendet, sind aber im geprueften Bestand nicht vorhanden.
- `Veraltet`
  Die Welt verweist auf Dateien in Modul- oder Systemordnern, die dort nicht mehr wie regulaerer Paketinhalt aussehen.
- `Verwaist`
  Dateien liegen noch im Storage, fuer die im aktuell geprueften Datenbestand keine Verwendung mehr gefunden wurde.

## Wobei das hilft

Typische Faelle sind:

- kaputte Bilder, Videos oder Sounds
- Uploads eines Spielleiters in ungeeignete Modulordner
- Dateien aus alten Modulversionen, die noch in Weltdaten referenziert werden
- Altlasten, die sich ueber Jahre in `data` oder `public` ansammeln

## Was der Report nicht macht

- keine Dateien loeschen
- keine Referenzen automatisch reparieren
- keine Weltdaten migrieren
- keine Dateien verschieben oder kopieren

Das Modul zeigt nur, was geprueft werden sollte.

## Hinweise zur Auswertung

`Fehlt`

- Diese Treffer sollte man in der Regel zuerst anschauen.
- Meist wurde eine Datei geloescht, verschoben oder durch ein Update ersetzt.

`Veraltet`

- Diese Treffer deuten oft auf alte Moduldateien oder unguenstige Upload-Orte hin.
- In manchen Faellen kann eine neue Initialisierung oder ein erneuter Import des betroffenen Moduls helfen.

`Verwaist`

- Diese Treffer sind bewusst vorsichtiger zu lesen.
- Das Modul kann derzeit technisch nicht pruefen, ob eine Datei eventuell noch im Kontext einer anderen Welt verwendet wird.

## Hinweise im Report

Im Abschnitt `Hinweise` tauchen Faelle auf, die absichtlich nicht als Findings gezaehlt werden, zum Beispiel:

- Verweise auf Dateien aus inaktiven Modulen
- Verweise auf Modulordner, die von Foundry derzeit nicht mehr als installierte Module erkannt werden

Diese Hinweise sollen beim Einordnen helfen, ohne die eigentliche Ergebnisliste mit moeglichen False Positives aufzublaehen.

## Filter fuer Verwaist

Bei `Verwaist` kann man bestimmte Pfadgruppen direkt ausblenden, zum Beispiel:

- `modules/*`
- `systems/*`
- `canvas/cards/docs/icons/nue/sounds/toolclips/ui`

Das ist hilfreich, wenn man sich zuerst auf spielleiternahe Upload-Bereiche konzentrieren moechte.

## Sicherheit

Der aktuelle Stand des Moduls ist reine Analyse.

Es werden:

- Dateien gelesen
- Referenzen ausgewertet
- Findings angezeigt
- Reports exportiert

Es werden keine Daten veraendert.

## Sprache

Die Oberflaeche unterstuetzt Deutsch und Englisch und richtet sich nach der eingestellten Foundry-Sprache.