Referenz & Datenmodell
Dateiversion (file_version)
Eine Dateiversion ist ein konkreter Inhalt einer Datei mit Upload-Status und Virenprüfungs-Ergebnis.
Versionen tragen den Inhalt: MIME-Typ, Größe, Speicherort und die beiden Statusachsen Upload und Virenprüfung. Eine Datei hat mindestens eine Version; derzeit legt kein Pfad weitere Versionen an; ältere Dateien können frühere Versionen tragen (Vorschau, Wiederherstellen). Ein erneuter Upload derselben Datei erzeugt keine Version, sondern eine neue Datei. (Datenart: Dateidaten, System)
Wo in der App
Abschnitt betitelt „Wo in der App“Dialog „Versionsverlauf“ (Menü „Versionen“ oder Seitenleiste „Versionen (n)“): je Version Versionsbezeichnung, Badge „Aktuell“, Virenstatus, Größe, Ersteller, Datum, Upload-Status sowie die Knöpfe „Vorschau“ und „Wiederherstellen“. Die Seitenleiste zeigt Werte der aktiven Version. – Guides › Drive & Anhänge
| Feld | Technisch | Typ | Pflicht | Bedeutung | Besonderheit |
|---|---|---|---|---|---|
| Versionsbezeichnung | version_label |
Text | nein | Kennzeichen der Version | System; bei Uploads leer („v?“) |
| Typ (MIME) | mime_type |
Text | ja | Inhaltstyp; nach der Prüfung ggf. auf den erkannten Typ korrigiert | System |
| Größe | bytes |
Zahl | nein | Bytes, formatiert als B/KB/MB/GB | System |
| Status | status |
Auswahl | ja | Upload-Zustand (Tabelle unten) | System |
| Sicherheit | av_status |
Auswahl | ja | Ergebnis der Virenprüfung (Tabelle unten) | System, nur Server schreibt |
| Version von | created_by |
Verweis | ja | Nutzer bzw. Dienstkonto, das die Version erzeugte | System |
| Erstellt | created_at |
Datum | ja | Zeitpunkt | System |
Nicht angezeigt: Speicherort, Prüfsummen, Zeitpunkte uploaded_at/ready_at/av_scanned_at, Prüfgrund, MIME-Abgleich (mime_status).
Beziehungen
Abschnitt betitelt „Beziehungen“| Zu | Art | Pflicht | Beim Archivieren | Beim Löschen |
|---|---|---|---|---|
| Datei | gehört zu | ja | – | mitlöschen |
Zustände
Abschnitt betitelt „Zustände“Upload-Status (status)
Abschnitt betitelt „Upload-Status (status)“| Wert | Label | Wer setzt |
|---|---|---|
pending |
Ausstehend | Server beim Reservieren (Upload-Start) |
uploading |
Wird hochgeladen | Upload-Server während der Übertragung |
processing |
Wird verarbeitet | im Schema vorgesehen, derzeit nicht gesetzt |
ready |
Bereit | Upload-Server nach vollständiger Übertragung; Engine nach sauberem Scan |
failed |
Fehlgeschlagen | Server bei Abbruch/Fehler („Erneut hochladen“ in Anhängen) |
deleted |
Gelöscht | Server; im Versionsverlauf ausgeblendet |
Virenprüfung (av_status)
Abschnitt betitelt „Virenprüfung (av_status)“| Wert | Label | Bedeutung |
|---|---|---|
pending |
Prüfung läuft | noch nicht gescannt |
clean |
Geprüft | sauber; einzige Freigabe zum Lesen |
infected |
Infiziert | Fund; dauerhaft gesperrt |
error |
Prüfung fehlgeschlagen | Scanner-Fehler; gesperrt bis zum erneuten Scan |
Upload: pending ──> uploading ──> ready ──┐ └──> failed │ Virenscan (automatisch nach Bereitschaft) ├──> clean → lesbar ├──> infected → blockiert └──> error → blockiert (Rescan möglich)Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- Scan ist Pflicht (System): Nach dem Upload startet ein Prüf-Workflow; erst
cleangibt Vorschau und Download frei (Lese-Regel in Datei). Beim Scan wird der tatsächliche Inhaltstyp erkannt undmime_typebei Abweichung korrigiert. Archive können inhaltlich nicht geprüft werden („Keine Virenprüfung möglich“). - Neue Versionen legt derzeit kein Pfad an. Eine Datei aus dem Arbeitsbereich einer Polaris-Unterhaltung gelangt nur als NEUE Datei in den Drive: per „In Drive kopieren“ im Dateien-Reiter oder indem Polaris sie speichert (
save_to_drive), jeweils mit Virenprüfung. - Wiederherstellen setzt
active_version_idder Datei auf die gewählte Version – nur für „geprüfte, bereite Versionen“, nie für die bereits aktuelle. Es entsteht keine Kopie. - Der Server ist alleiniger Schreiber aller Statusfelder; Clients können sie nicht setzen.