# Dateien

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/files/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}
<Lead>
**Dateien** ist der Ort, an dem alles wohnt, was dein Workspace besitzt: Ergebnisse deiner Tools, eigene Uploads, Fotos und Unterlagen. Statt verstreuter Downloads und E-Mail-Anhänge gibt es eine Vollbild-Ansicht, die sich wie ein echter Datei-Manager bedient: mit Versionen, Suche, Zugriffs-Regeln und Freigabe-Links nach außen.
</Lead>

## Was der Dateispeicher ist

Der Dateispeicher ist ein **Standard-Tool** der Plattform: Er ist in jedem Plan fest enthalten, immer vorinstalliert und lässt sich nicht deinstallieren. Die Nutzung kostet **keine Credits**. Du öffnest ihn unter `/files` als Vollbild-Ansicht; zurück zur Plattform geht es oben links. Die Einstellungen (Speicher, Papierkorb-Richtlinie, Freigaben) liegen unter **Einstellungen > Dateien**. Wie viel Speicherplatz dein Workspace hat, richtet sich nach deinem Plan.

<FeatureGrid>
  <Feature icon="sparkle" title="Explorer wie am Rechner">
    Raster- und Listenansicht, Mehrfachauswahl mit Klick, Cmd/Strg und Umschalt, Ziehen auf Ordner, Rechtsklick-Menü, Schnellvorschau und Tastatur-Hilfe per Taste <Kbd>?</Kbd>.
  </Feature>
  <Feature icon="clock" title="Versionen und Papierkorb">
    Lädst du eine Datei mit gleichem Namen erneut hoch, wird sie ersetzt und der alte Stand als Version gesichert. Gelöschtes bleibt im Papierkorb wiederherstellbar, standardmäßig 30 Tage.
  </Feature>
  <Feature icon="check" title="Suche mit inhaltlichen Treffern">
    Cmd/Strg+K öffnet die Suche. Sie findet Namen sofort und durchsucht bei längeren Anfragen zusätzlich den Inhalt deiner Dokumente, mit passender Textstelle als Ausschnitt.
  </Feature>
  <Feature icon="lock" title="Zugriff pro Ordner">
    Ordner sind offen für den Workspace, bis du sie einschränkst. Ab dem ersten Eintrag sehen nur noch die Berechtigten den Ordner. Dazu hat jede Person einen privaten Bereich.
  </Feature>
  <Feature icon="link" title="Freigabe-Links nach außen">
    Dateien und Ordner per Link ohne Login teilen: mit Ablauf, optionalem Passwort und Download-Schalter. Jederzeit widerrufbar, mit Aufruf-Zähler.
  </Feature>
  <Feature icon="coin" title="Sichtbarer Speicher">
    Die Speicher-Kachel zeigt den Füllstand live. In den Einstellungen siehst du, wohin der Platz geht: nach Herkunft, nach Typ und mit den größten Dateien zum Aufräumen.
  </Feature>
</FeatureGrid>

## Bereiche im Überblick

Die Seitenleiste gliedert den Dateispeicher in feste Bereiche. Einen klassischen Ordnerbaum gibt es nicht: Du navigierst über Bereiche, Brotkrumen und Doppelklick.

<DefinitionList>
  <DefItem term="Start">Die Wurzel deines Workspace-Speichers: hier liegen deine eigenen Ordner und Dateien sowie die System-Bereiche.</DefItem>
  <DefItem term="Zuletzt">Die neuesten Dateien im Schnellzugriff, ohne Suchen und Klicken durch Ordner.</DefItem>
  <DefItem term="Favoriten">Alles, was du mit dem Stern markiert hast, gesammelt an einem Ort.</DefItem>
  <DefItem term="Tools">Jedes Tool legt hier automatisch seinen Ordner an und speichert seine Ergebnisse, zum Beispiel AI-Homestaging, der WhatsApp-Bot und die Website.</DefItem>
  <DefItem term="Objekte">Pro Immobilie ein Ordner mit ihren Fotos und Dokumenten. Wird das Objekt umbenannt, zieht der Ordnername nach.</DefItem>
  <DefItem term="Meine Dateien">Dein privater Bereich. Was hier liegt, siehst nur du, auch Admins können nicht hineinschauen.</DefItem>
  <DefItem term="Papierkorb">Gelöschtes landet hier und bleibt wiederherstellbar, bis die Aufbewahrungsfrist abläuft oder der Papierkorb geleert wird.</DefItem>
</DefinitionList>

Details zu allen Bereichen: [Ordner und Bereiche](/tools/dateien/ordner-und-bereiche).

## Erste Schritte

<Steps>
  <Step title="Dateispeicher öffnen">
    Öffne **Dateien** über den Marktplatz oder direkt unter `/files`. Die Seite läuft im Vollbild; oben links geht es zurück zur Plattform.
  </Step>
  <Step title="Etwas hochladen">
    Nutze den **Hochladen**-Knopf, zieh Dateien oder ganze Ordner in die Fläche oder füge einen Screenshot aus der Zwischenablage ein. Bis 2 GB pro Datei, große Dateien laden fortsetzbar in Teilen.
  </Step>
  <Step title="Ordnen">
    Lege Ordner an, benenne um, verschiebe per Ziehen oder über **Verschieben nach...** und gib wichtigen Ordnern eine Akzentfarbe.
  </Step>
  <Step title="Wiederfinden">
    Drücke <Kbd>Cmd/Strg</Kbd> + <Kbd>K</Kbd> und such nach Namen oder in ganzen Worten nach Inhalten. Favoriten und der Bereich Zuletzt halten Wichtiges griffbereit.
  </Step>
  <Step title="Speicher im Blick behalten">
    Die Speicher-Kachel unten in der Seitenleiste zeigt den Füllstand. Ein Klick öffnet **Einstellungen > Dateien** mit Aufschlüsselung, größten Dateien und Papierkorb-Richtlinie.
  </Step>
</Steps>

## Wer darf was

Die Plattform kennt die Rollen Inhaber:in, Admin, Mitglied und Beobachter. In der Tabelle heißen sie Owner, Admin, Employee (= Mitglied) und External Viewer (= Beobachter). Berechtigungen sagen, **was** jemand darf; Ordner-Zugriffslisten sagen zusätzlich, **wo**. Beides muss passen: siehe [Zugriff auf Ordner](/tools/dateien/zugriff).

<PermissionTable
  caption="Berechtigungen für den Dateispeicher"
  roles="tenant_owner,tenant_admin,employee,external_viewer"
>
  <Permission
    action="files.read"
    label="Dateien ansehen und herunterladen"
    allow="yes,yes,yes,yes"
  />
  <Permission
    action="files.write"
    label="Hochladen, Ordner anlegen, umbenennen, verschieben"
    allow="yes,yes,yes,no"
  />
  <Permission
    action="files.delete"
    label="In den Papierkorb legen und wiederherstellen"
    allow="yes,yes,yes,no"
  />
  <Permission
    action="files.delete.hard"
    label="Endgültig löschen und Papierkorb leeren"
    allow="yes,yes,no,no"
  />
  <Permission
    action="files.share"
    label="Freigabe-Links nach außen erstellen"
    allow="yes,yes,no,no"
  />
  <Permission
    action="files.manage_access"
    label="Ordner-Zugriff einschränken"
    allow="yes,yes,no,no"
  />
  <Permission
    action="files.settings"
    label="Speicher-Richtlinien verwalten"
    allow="yes,yes,no,no"
  />
</PermissionTable>

Beobachter-Zugänge (zum Beispiel Notariat oder Bank) können Dateien ansehen und herunterladen, sofern der jeweilige Ordner für sie sichtbar ist. Alle verändernden Aktionen bleiben Mitgliedern, Admins und Inhaber:innen vorbehalten.

## Alle Themen im Detail

<CardGrid>
  <Card title="Oberfläche im Detail" href="/tools/dateien/explorer">
    Seitenleiste, Ansichten, Mehrfachauswahl, Kontextmenü, Details-Spalte, Ordner-Farben, Vorschau und Tastatur-Kurzbefehle.
  </Card>
  <Card title="Upload und Versionen" href="/tools/dateien/upload-und-versionen">
    Die drei Upload-Wege, Grenzen bis 2 GB, blockierte Typen, Namenskonflikte, Datei-Verlauf und ZIP-Download.
  </Card>
  <Card title="Ordner und Bereiche" href="/tools/dateien/ordner-und-bereiche">
    Tools-, Objekte- und Import-Ordner, der private Bereich Meine Dateien, reservierte Namen und Verschieben per Ziehen.
  </Card>
  <Card title="Suche" href="/tools/dateien/suche">
    Spotlight mit Cmd/Strg+K, Filter-Chips, Zeitraum, inhaltliche Treffer und was die Suche bewusst nicht zeigt.
  </Card>
  <Card title="Zugriff auf Ordner" href="/tools/dateien/zugriff">
    Zugriffslisten mit den Stufen Ansehen, Bearbeiten und Verwalten, Vererbung, Schloss-Badge und Offboarding.
  </Card>
  <Card title="Nach außen freigeben" href="/tools/dateien/freigeben">
    Externe Links ohne Login: Ablauf, Passwort, Download-Schalter, Aufruf-Zähler und Widerruf.
  </Card>
  <Card title="Papierkorb und Speicher" href="/tools/dateien/papierkorb-und-speicher">
    Aufbewahrungsfristen, Speicher-Kontingente je Plan, die Speicher-Einstellungen und was bei vollem Speicher passiert.
  </Card>
  <Card title="Fehlerbehebung" href="/tools/dateien/troubleshooting">
    Häufige Fragen: Upload schlägt fehl, Datei verschwunden, Link funktioniert nicht, Suche findet nichts.
  </Card>
</CardGrid>

## Häufige Fragen

<Faq>
  <FaqItem q="Was kostet der Dateispeicher?">
    Nichts extra: Das Tool ist in jedem Plan enthalten und verbraucht keine Credits. Nur die Größe des Speichers hängt am Plan, von 5 GB im Trial bis 5 TB im Max+. Details: [Papierkorb und Speicher](/tools/dateien/papierkorb-und-speicher).
  </FaqItem>
  <FaqItem q="Was passiert, wenn ich eine Datei mit gleichem Namen erneut hochlade?">
    Sie wird **ersetzt**, und der alte Stand wird automatisch als Version gesichert (bis zu 15 Versionen, Wiederherstellen über den Verlauf in der Details-Spalte). Eine „(2)“-Nummer bekommen nur Ablagen von Tools und Importen sowie Ordner und Umbenennungen bei Namenskonflikt.
  </FaqItem>
  <FaqItem q="Findet die Suche auch Datei-Inhalte?">
    Ja. Bei längeren Anfragen in ganzen Worten zeigt die Suche zusätzlich **Inhaltliche Treffer** aus deinen Dokumenten, mit der passenden Textstelle als Ausschnitt. Das läuft im Hintergrund und kostet keine Credits.
  </FaqItem>
  <FaqItem q="Wie lange bleibt Gelöschtes im Papierkorb?">
    Standardmäßig 30 Tage. Unter **Einstellungen > Dateien** kannst du die Aufbewahrung auf 7, 14, 30 oder 90 Tage stellen; 90 Tage gibt es ab dem Standard-Plan. Der Papierkorb belegt weiter Speicher, bis er geleert wird.
  </FaqItem>
  <FaqItem q="Sehen Admins meinen Bereich Meine Dateien?">
    Nein. Der Inhalt ist privat, auch für Admins und Inhaber:innen. In den Einstellungen erscheint pro Person nur die Gesamtgröße, nie der Inhalt. Erst wenn jemand den Workspace verlässt, kann die Inhaber:in den verwaisten Bereich übernehmen oder löschen.
  </FaqItem>
  <FaqItem q="Kann ich Dateien mit Externen teilen?">
    Ja. Inhaber:innen und Admins erstellen über **Freigeben...** einen Link ohne Login, mit Ablauf zwischen 7 und 90 Tagen, optionalem Passwort und Download-Schalter. Details: [Nach außen freigeben](/tools/dateien/freigeben).
  </FaqItem>
</Faq>