kosmos-storage-audit/README.md

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:

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.