Zum Inhalt springen
craftdexDocs

Dateien und Prüfsummen

Wo die Fotos und Dokumente in der ZIP-Datei liegen und wie man prüft, dass sie vollständig sind.

Alle hochgeladenen Dateien liegen im Original unter dateien/<ablage>/ in der ZIP-Datei. Für jede Datei steht in craftdex-export.json unter files die SHA-256-Prüfsumme. Damit lässt sich nachweisen, dass eine Datei beim Herunterladen, Entpacken oder Weitergeben nicht verändert wurde.

Ablagen

OrdnerInhalt
site-photosFotos zu Baustellen, auch Foto-Nachweise
site-defectsFotos zu Mängeln
site-documentsDokumente zu Baustellen
site-plansPläne
checklist-filesAnhänge an Aufgaben und Checklisten
invoice-pdfsfestgeschriebene Rechnungen als PDF, XRechnung als XML
tool-photosFotos von Werkzeugen und Baumaschinen
tool-receiptsKaufbelege zu Werkzeugen und Baumaschinen
material-imagesBilder zum Material
warehouse-imagesBilder zu Lagern
user-avatarsProfilfotos der Mitarbeiter
company-logosLogo und Briefpapier des Betriebs
support-screenshotsBildschirmfotos zu Meldungen an CraftDex

Leere Ablagen fehlen in der ZIP-Datei.

Prüfsumme kontrollieren

Die Prüfsumme einer entpackten Datei muss mit dem Wert sha256 des passenden Eintrags in files übereinstimmen.

Linux und macOS
sha256sum dateien/site-photos/c7e2…/1795190678846.jpg
Windows (PowerShell)
Get-FileHash -Algorithm SHA256 "dateien\site-photos\c7e2…\1795190678846.jpg"

PowerShell zeigt die Prüfsumme in Großbuchstaben, craftdex-export.json in Kleinbuchstaben. Beides ist gleichwertig.

Alle Dateien auf einmal prüfen

pruefen.py (im entpackten Ordner ausführen)
import hashlib, json

export = json.load(open("craftdex-export.json", encoding="utf-8"))
fehler = 0
for f in export["files"]:
    with open(f["zip_path"], "rb") as datei:
        if hashlib.sha256(datei.read()).hexdigest() != f["sha256"]:
            print("abweichend:", f["zip_path"])
            fehler += 1
print(f"{len(export['files'])} Dateien geprüft, {fehler} abweichend")

Auf dieser Seite