Zum Inhalt springen

Referenz & Datenmodell

Übersicht

Fünf Entitäten bilden das Dateisystem von Aligia: die Ablage als Wurzel, Ordner als Baum, Datei als Hülle, Version als Inhalt, Verknüpfung als Anhang.

Eine Ablage (volume) ist die Wurzel eines Dateibaums. Es gibt zwei Ablagen je Besitzer: „Dateien“ (der sichtbare Drive) und „Anhänge“ (eine flache, nicht sichtbare Ablage für Objektanhänge). Besitzer ist entweder die Organisation oder ein Projekt. Ordner (folder) und Dateien (file) hängen an der Ablage; ein fehlender Elternordner bedeutet „direkt in der Ablage“ – es gibt keinen Wurzelordner.

Die Datei ist nur die Hülle (Name, Art, Endung). Der Inhalt liegt in Dateiversionen (file_version); die Datei zeigt auf ihre aktive Version. Jede Version durchläuft Upload und Virenprüfung. Die Dateiverknüpfung (file_link) hängt eine Datei an ein Objekt (Aufgabe, Issue, Erkenntnis …).

Organisation ──┬─ volume „Dateien“ (slug files, Drive unter Projekt & Portfolio › Drive)
└─ volume „Anhänge“ (slug attachments, flach, unsichtbar)
Projekt ───────┬─ volume „Dateien“ (Tab „Drive“, benannt nach dem Projekt)
└─ volume „Anhänge“
volume ──< folder ──< folder (Unterordner) …
│ └──< file ──< file_version (file.active_version_id → aktive Version)
└──< file (direkt in der Ablage) │
└── av_status / status → Lesefreigabe
file ──< file_link ──> Objekt (issue, task, document, takeaway,
technical_structure_node, technical_structure_good, conversation)
Entität Zweck Wo in der App
Ablage (volume) Wurzel und Eigentümer eines Dateibaums nicht als Objekt sichtbar; Einstieg Projekt & Portfolio › Drive und Projekt › „Drive“ – Guides › Drive (global), Guides › Drive
Ordner (folder) Baumstruktur innerhalb einer Ablage Ordnerbaum links im Drive – Guides › Drive & Anhänge
Datei (file) Hülle mit Name, Art, Endung, aktiver Version Dateiliste und Seitenleiste im Drive; Bereich „Dateien“ an Objekten
Dateiversion (file_version) Inhalt, Größe, MIME-Typ, Upload- und Virenstatus „Versionsverlauf“, Seitenleiste
Dateiverknüpfung (file_link) Anhang einer Datei an ein Objekt Bereich „Dateien“/„Dateien anhängen“ in Dialogen
  • Projekt-Ablagen gehören zum Projekt; das Projekt-Drive trägt dessen Titel.
  • Anhänge hängen an Aufgabe, Issue, Erkenntnis, Technischer Knoten, Komponente sowie an Agenten-Unterhaltungen.
  • Workflows und Agenten lesen Dateien über die Engine; der Polaris-Agent schreibt in den Arbeitsbereich seiner Unterhaltung und kann eine Datei von dort als neue Datei in den Drive speichern (nach Prüfung des Aufrufs); Workflows schreiben neue Dateien mit file.csv, file.xlsx, file.json (siehe Dateiversion, Automation & AI).