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.
Was diese Datenart ausmacht
Abschnitt betitelt „Was diese Datenart ausmacht“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 …).
Entitäten und Beziehungen
Abschnitt betitelt „Entitäten und Beziehungen“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 → Lesefreigabefile ──< 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 |
Verbindungen zu anderen Kapiteln
Abschnitt betitelt „Verbindungen zu anderen Kapiteln“- 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).