Reference & Data Model
File version (file_version)
A file version is one concrete content of a file with upload status and virus scan result.
Purpose
Section titled “Purpose”Versions carry the content: MIME type, size, storage location and the two status axes upload and virus scan. A file has at least one version; currently no path creates further versions; older files may still carry earlier versions (preview, restore). Uploading the same file again creates no version but a new file. (Data type: file data, system)
Where in the app
Section titled “Where in the app”Dialog „Versionsverlauf“ (Version history) (menu „Versionen“ (Versions) or sidebar „Versionen (n)“): per version the version label, badge „Aktuell“ (Current), virus status, size, creator, date, upload status as well as the buttons „Vorschau“ (Preview) and „Wiederherstellen“ (Restore). The sidebar shows the values of the active version. – Guides › Drive & attachments
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Version label | version_label |
Text | no | identifier of the version | System; empty for uploads („v?“) |
| Type (MIME) | mime_type |
Text | yes | content type; corrected to the detected type after the scan if needed | System |
| Size | bytes |
Number | no | bytes, formatted as B/KB/MB/GB | System |
| Status | status |
Selection | yes | upload state (table below) | System |
| Security | av_status |
Selection | yes | result of the virus scan (table below) | System, written by the server only |
| Version by | created_by |
Reference | yes | user or service account that created the version | System |
| Created | created_at |
Date | yes | point in time | System |
Not shown: storage location, checksums, timestamps uploaded_at/ready_at/av_scanned_at, scan reason, MIME comparison (mime_status).
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| File | belongs to | yes | – | deleted along |
States
Section titled “States”Upload status (status)
Section titled “Upload status (status)”| Value | Label | Set by |
|---|---|---|
pending |
Ausstehend (Pending) | server on reservation (upload start) |
uploading |
Wird hochgeladen (Uploading) | upload server during transfer |
processing |
Wird verarbeitet (Processing) | provided for in the schema, currently not set |
ready |
Bereit (Ready) | upload server after complete transfer; engine after a clean scan |
failed |
Fehlgeschlagen (Failed) | server on abort/error („Erneut hochladen“ (Upload again) in attachments) |
deleted |
Gelöscht (Deleted) | server; hidden in the version history |
Virus scan (av_status)
Section titled “Virus scan (av_status)”| Value | Label | Meaning |
|---|---|---|
pending |
Prüfung läuft (Scan running) | not yet scanned |
clean |
Geprüft (Scanned) | clean; the only clearance for reading |
infected |
Infiziert (Infected) | detection; permanently blocked |
error |
Prüfung fehlgeschlagen (Scan failed) | scanner error; blocked until rescanned |
Upload: pending ──> uploading ──> ready ──┐ └──> failed │ virus scan (automatic once ready) ├──> clean → readable ├──> infected → blocked └──> error → blocked (rescan possible)Rules & automation
Section titled “Rules & automation”- Scan is mandatory (system): After the upload a scan workflow starts; only
cleanreleases preview and download (read rule in File). During the scan the actual content type is detected andmime_typecorrected on mismatch. Archives cannot be scanned for content („Keine Virenprüfung möglich“ – No virus scan possible). - New versions are currently not created by any path. A file from a Polaris conversation’s workspace reaches the Drive only as a NEW file: via “In Drive kopieren” in the Files tab, or when Polaris saves it (
save_to_drive), each with the virus scan. - Restore sets the file’s
active_version_idto the chosen version – only for “scanned, ready versions”, never for the one already current. No copy is created. - The server is the sole writer of all status fields; clients cannot set them.