Referenz & Datenmodell
Datei (file)
Eine Datei ist die benannte Hülle um eine Versionsreihe; lesbar ist sie nur, wenn ihre aktive Version bereit und virenfrei ist.
Die Datei trägt Name, Art und Endung und zeigt auf ihre aktive Version. Jede Datei liegt in genau einer Ablage, entweder in einem Ordner oder direkt in der Ablage. Anhänge sind gewöhnliche Dateien in der flachen Ablage „Anhänge“; die Zuordnung zum Objekt steckt in der Dateiverknüpfung. (Datenart: Dateidaten, manuell/System)
Wo in der App
Abschnitt betitelt „Wo in der App“Dateiliste im Drive mit den Spalten „Name“, „Typ“, „Größe“, „AV“, „Hochgeladen von“, „Geändert“; Seitenleiste mit Vorschau, Version, „Größe“, „Kategorie“, „Status“, „Sicherheit“, „Typ“, „Erstellt von“, „Version von“, „Erstellt“, „Geändert“, „ID“, „Originalname“, „Endung“. Kontextmenü: „Öffnen“, „Umbenennen“, „Verschieben nach…“, „Details“, „Versionen“, „Herunterladen“, „ID kopieren“, „Löschen“. Upload per „Dateien hochladen“ oder Ziehen („Dateien hier ablegen“). – Guides › Drive & Anhänge
| Feld | Technisch | Typ | Pflicht | Bedeutung | Besonderheit |
|---|---|---|---|---|---|
| Name | title |
Text | ja | Anzeigename, beim Upload = Dateiname | „Umbenennen“; eindeutig je Ordner unter fertigen Dateien |
| Originalname | original_filename |
Text | ja | Dateiname beim Upload | System, unveränderlich |
| Kategorie | kind |
Auswahl | ja | Bild, Video, Audio, Dokument, Archiv, Sonstige | System, aus dem MIME-Typ abgeleitet |
| Endung | extension |
Text | nein | Teil nach dem letzten Punkt | System |
| Aktive Version | active_version_id |
Verweis | nein | Version, die Liste, Vorschau und Download nutzen | System; „Wiederherstellen“ im Versionsverlauf setzt sie um |
| Ordner | folder_id |
Verweis | nein | leer = oberste Ebene der Ablage | „Verschieben nach…“ |
| Größe / Typ / Status / Sicherheit | – | Anzeige | – | Werte der aktiven Version | siehe Dateiversion |
| Erstellt von / Hochgeladen von | created_by |
Verweis | ja | Nutzer, der die Datei anlegte | System |
| Erstellt / Geändert | created_at / updated_at |
Datum | ja | Zeitstempel | System |
Beziehungen
Abschnitt betitelt „Beziehungen“| Zu | Art | Pflicht | Beim Archivieren | Beim Löschen |
|---|---|---|---|---|
| Ablage | gehört zu | ja | – | mitlöschen |
| Ordner | gehört zu | nein | bleibt | mitlöschen |
| Dateiversion | hat viele | – | – | mitlöschen |
| Dateiverknüpfung | hat viele | – | – | mitlöschen |
Zustände
Abschnitt betitelt „Zustände“Die Datei selbst hat keinen Status; angezeigt werden Upload-Status und Virenstatus der aktiven Version. Zusammengefasst gilt:
Upload gestartet ──> Prüfung ──┬─> bereit (status = ready UND av_status = clean) ├─> blockiert (av_status = infected | error | pending) └─> fehlgeschlagen (status = failed)Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- Anlegen nur per Upload. Jeder Upload erzeugt eine neue Datei mit einer ersten Version – auch wenn eine Datei gleichen Namens existiert. Clients können keine Dateizeilen direkt anlegen.
- Lese-Regel (System,
packages/file-acl): „Öffnen“, Vorschau und „Herunterladen“ sind nur möglich, wenn die Datei nicht gelöscht, ihr Ordner nicht archiviert, die Version im Status „Bereit“ und die Virenprüfung „Geprüft“ (clean) ist. „Prüfung läuft“ und „Prüfung fehlgeschlagen“ sperren ebenso wie „Infiziert“. Menüeinträge sind dann ausgegraut; der Server erzwingt dieselbe Regel. - Eindeutige Namen: Erst wenn die erste Version bereit ist, wird die Datei gestempelt (
first_ready_at) und nimmt an der Namenseindeutigkeit teil. Kollidiert der Name mit einer vorhandenen fertigen Datei desselben Ordners, hängt der Server einen Zähler an den Namen. - Verschieben nur in Ordner derselben Ablage; Umbenennen ändert nur
title, nicht den Originalnamen. - Löschen ist ein Soft-Delete (Datei verschwindet aus dem Drive, Verknüpfungen werden mitgelöscht); gelöschte Dateien lassen sich nicht wiederherstellen.
- Die Kategorie leitet der Server aus dem MIME-Typ ab (
image/*→ Bild, PDF/Office/text/*→ Dokument, zip/tar/gz/7z/rar → Archiv, sonst Sonstige).