101 lines
3.0 KiB
Markdown
101 lines
3.0 KiB
Markdown
# 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.
|