AFFiNE für IT-Dienstleistungen

IT-Dokumentation für Kundenprojekte.

IT-Dokumentation erklärt, wie ein System aufgebaut, konfiguriert, betrieben und übergeben wird. Verknüpfen Sie in AFFiNE Architekturdiagramme mit Konfigurationsnotizen, Entscheidungen und Supportverfahren. Eine hilfreiche Übergabe benennt die aktuell verantwortliche Person, Quellenverweise, ungelöste Probleme und den nächsten Schritt für das übernehmende Team.

30 Minuten per Google Meet Arbeitsabläufe, Bereitstellung und Eignung für Ihr Team

Beispiel-Arbeitsbereich: Lösungskonzept — Portalmigration

Arbeitsbereichsansicht
Lösungskonzept — PortalmigrationUmsetzungsarbeitsbereichTechnische ÜbergabeSupport-WissensnotizBesprechungsnotizen

Seite · Lösungsteam · synthetisches Beispiel

Lösungskonzept — Portalmigration

Umfang
Dokumentenzugang ersetzen
Entscheidung
Bestehenden Identitätsanbieter beibehalten
Übergabe
Betriebsfragen

Offene Designfrage: Aufbewahrungsanforderungen mit dem Kunden klären.

Dasselbe Projekt · Edgeless-Canvas
Lösungskonzept — Portalmigration — beispielhafter CanvasKnoten: Benutzer, Neues Portal, Dokumentenspeicher, Identitätsanbieter, Betriebsübergabe. Verbindungen: Benutzer zu Neues Portal; Neues Portal zu Dokumentenspeicher; Neues Portal zu Identitätsanbieter (Anmeldung · beibehalten); Identitätsanbieter zu Betriebsübergabe (Fragen).
Benutzer
Neues Portal
Dokumentenspeicher
Identitätsanbieter
Betriebsübergabe
Anmeldung · beibehalten
Fragen
  • Der neue Zugang im Projektumfang, zwischen Benutzern und bestehendem Dokumentenspeicher.
  • Die Entscheidung, den aktuellen Identitätsanbieter beizubehalten, am Anmeldepfad dargestellt.
  • Fragen für das Betriebsteam sind vom Diagramm mit der Übergabe verknüpft.

Edgeless

Umsetzungsarbeitsbereich

Zeichnen Sie Systemkomponenten und Verbindungen. Erläutern Sie Designentscheidungen, Annahmen und offene Fragen in einem Lösungskonzept neben dem Diagramm.

Annahme
Bestehender Identitätsdienst
Option
Gemeinsamer Dokumentenzugang
Frage
Aufbewahrungsbedarf bestätigen
Dasselbe Projekt · Edgeless-Canvas
Umsetzungsarbeitsbereich — beispielhafter CanvasKnoten: Kundenbedarf, Systemübersicht, Optionen, Entscheidung, Aufbewahrungsbedarf?. Verbindungen: Kundenbedarf zu Systemübersicht; Systemübersicht zu Optionen; Optionen zu Entscheidung (gewählt); Aufbewahrungsbedarf? zu Entscheidung (blockiert).
Kundenbedarf
Systemübersicht
Optionen
Entscheidung
Aufbewahrungsbedarf?
gewählt
blockiert

Seite + Tabelle

Technische Übergabe

Bündeln Sie Projektumfang, Konfigurationsnotizen und Liefercheckliste. Führen Sie Zuständigkeiten und offene Punkte in einer vom Projektteam aktualisierten Tabelle.

PunktVerantwortlichStatus
Pilotprojekt zur DokumentenmigrationProjektteamAnnahmen prüfen
AufbewahrungsbedarfLösungsarchitektOffene Frage
BetriebsverfahrenBeraterIn Bearbeitung

Manuell gepflegte Tabelle · keine Ticketautomatisierung

Dasselbe Projekt · Edgeless-Canvas
Technische Übergabe — beispielhafter CanvasKnoten: Benutzer, Neues Portal, Dokumentenspeicher, Identitätsanbieter, Betriebsübergabe. Verbindungen: Benutzer zu Neues Portal; Neues Portal zu Dokumentenspeicher; Neues Portal zu Identitätsanbieter (Anmeldung · beibehalten); Identitätsanbieter zu Betriebsübergabe (Fragen).
Benutzer
Neues Portal
Dokumentenspeicher
Identitätsanbieter
Betriebsübergabe
Anmeldung · beibehalten
Fragen
  • Der neue Zugang im Projektumfang, zwischen Benutzern und bestehendem Dokumentenspeicher.
  • Die Entscheidung, den aktuellen Identitätsanbieter beizubehalten, am Anmeldepfad dargestellt.
  • Fragen für das Betriebsteam sind vom Diagramm mit der Übergabe verknüpft.

Seite

Support-Wissensnotiz

Verlinken Sie Architekturübersicht, Betriebsverfahren und offene Probleme auf einer Übergabeseite. Prüfen Sie vor der Übergabe das Teilen oder den Markdown-Export.

Systemkontext
Architekturnotizen
Betrieb
Bekannte Verfahren
Offene Punkte
Fragen für das nächste Team

Markdown-Export verfügbar · Methode zum Teilen zuerst testen

Eingebetteter Edgeless-Rahmen

Markdown-Export — Ergebnis vor der Übergabe testen

Dasselbe Projekt · Edgeless-Canvas
Support-Wissensnotiz — beispielhafter CanvasKnoten: Benutzer, Neues Portal, Dokumentenspeicher, Identitätsanbieter, Betriebsübergabe. Verbindungen: Benutzer zu Neues Portal; Neues Portal zu Dokumentenspeicher; Neues Portal zu Identitätsanbieter (Anmeldung · beibehalten); Identitätsanbieter zu Betriebsübergabe (Fragen).
Benutzer
Neues Portal
Dokumentenspeicher
Identitätsanbieter
Betriebsübergabe
Anmeldung · beibehalten
Fragen
  • Der neue Zugang im Projektumfang, zwischen Benutzern und bestehendem Dokumentenspeicher.
  • Die Entscheidung, den aktuellen Identitätsanbieter beizubehalten, am Anmeldepfad dargestellt.
  • Fragen für das Betriebsteam sind vom Diagramm mit der Übergabe verknüpft.

Seite

Besprechungsnotizen

Machen Sie aus wiederkehrenden Supportfragen wiederverwendbare Seiten. Ergänzen Sie Konfiguration, Begründung und einen Link zu den Umsetzungsnotizen.

Warum diese Konfiguration?

Designbegründung einmal dokumentiert und aus Supportnotizen verlinkt.

Verwandt
Umsetzungsnotiz
Dasselbe Projekt · Edgeless-Canvas
Besprechungsnotizen — beispielhafter CanvasKnoten: Benutzer, Neues Portal, Dokumentenspeicher, Identitätsanbieter, Betriebsübergabe. Verbindungen: Benutzer zu Neues Portal; Neues Portal zu Dokumentenspeicher; Neues Portal zu Identitätsanbieter (Anmeldung · beibehalten); Identitätsanbieter zu Betriebsübergabe (Fragen).
Benutzer
Neues Portal
Dokumentenspeicher
Identitätsanbieter
Betriebsübergabe
Anmeldung · beibehalten
Fragen
  • Der neue Zugang im Projektumfang, zwischen Benutzern und bestehendem Dokumentenspeicher.
  • Die Entscheidung, den aktuellen Identitätsanbieter beizubehalten, am Anmeldepfad dargestellt.
  • Fragen für das Betriebsteam sind vom Diagramm mit der Übergabe verknüpft.
Beispiel-Arbeitsbereich — synthetische Inhalte, kein Produkt-Screenshot und keine Kundenfallstudie. In Edgeless: Objekte ziehen, mit Hand verschieben oder mit Ctrl/⌘ + Scrollen zoomen. Zeichenwerkzeuge dienen der Veranschaulichung.
  • Architekturentscheidungen neben dem Diagramm erläutern

    Gezeigt in Arbeitsablauf 01

  • Umsetzungsumfang und Zuständigkeiten sichtbar halten

    Gezeigt in Arbeitsablauf 02

  • Antworten auf wiederkehrende Supportfragen wiederverwenden

    Gezeigt in Arbeitsablauf 04

Von der Aufgabe zum Arbeitsbereich

IT-Dokumentation von der Architektur bis zum Support.

Erstellen Sie ein Lösungskonzept, pflegen Sie Umsetzungsnotizen, bereiten Sie eine Übergabe vor und nutzen Sie Supportantworten erneut.

Zuordnung von Aufgaben zu Funktionen für die vier Beispiele dieser Seite
AufgabeDokumenteEdgelessTabellenTeamExportErgebnis
01 · LösungsarchitektSoftwarearchitektur dokumentierenDokumenteEdgelessLösungskonzept
02 · ProjektleitungUmsetzungsdokumentation organisierenDokumenteTabellenTeamUmsetzungsarbeitsbereich
03 · BeraterTechnische Übergabe vorbereitenDokumenteEdgelessExportTechnische Übergabe
04 · SupportteamIT-Wissensdatenbank aufbauenDokumenteTeamSupport-Wissensnotiz

01Lösungsarchitekt

Softwarearchitektur dokumentieren

Zeichnen Sie Systemkomponenten und Verbindungen. Erläutern Sie Designentscheidungen, Annahmen und offene Fragen in einem Lösungskonzept neben dem Diagramm.

Aufgabe
Dem Kunden eine vorgeschlagene Architektur erläutern
In AFFiNE
Systembeziehungen in Edgeless gezeichnet; jede Entscheidung auf der Seite erklärt
Ergebnis
Lösungskonzept

Verwendete Funktionen

EdgelessSynthetisches Beispiel

Lösungskonzept

Lösungskonzept — beispielhafter CanvasKnoten: Kundenbedarf, Systemübersicht, Optionen, Entscheidung, Aufbewahrungsbedarf?. Verbindungen: Kundenbedarf zu Systemübersicht; Systemübersicht zu Optionen; Optionen zu Entscheidung (gewählt); Aufbewahrungsbedarf? zu Entscheidung (blockiert).
Kundenbedarf
Systemübersicht
Optionen
Entscheidung
Aufbewahrungsbedarf?
gewähltblockiert
Annahme
Bestehender Identitätsdienst
Option
Gemeinsamer Dokumentenzugang
Frage
Aufbewahrungsbedarf bestätigen
Beispielansicht mit synthetischen Inhalten — kein Produkt-Screenshot.

02Projektleitung

Umsetzungsdokumentation organisieren

Bündeln Sie Projektumfang, Konfigurationsnotizen und Liefercheckliste. Führen Sie Zuständigkeiten und offene Punkte in einer vom Projektteam aktualisierten Tabelle.

Aufgabe
Ein Projekt mit dem aktuellen Diskussionsstand an einem Ort starten
In AFFiNE
Seite zum Projektumfang mit einfacher, vom Team gepflegter Tabelle
Ergebnis
Umsetzungsarbeitsbereich

Verwendete Funktionen

Seite + TabelleSynthetisches Beispiel

Umsetzungsarbeitsbereich

PunktVerantwortlichStatus
Pilotprojekt zur DokumentenmigrationProjektteamAnnahmen prüfen
AufbewahrungsbedarfLösungsarchitektOffene Frage
BetriebsverfahrenBeraterIn Bearbeitung

Manuell gepflegte Tabelle · keine Ticketautomatisierung

Beispielansicht mit synthetischen Inhalten — kein Produkt-Screenshot.

03Berater

Technische Übergabe vorbereiten

Verlinken Sie Architekturübersicht, Betriebsverfahren und offene Probleme auf einer Übergabeseite. Prüfen Sie vor der Übergabe das Teilen oder den Markdown-Export.

Aufgabe
Dem Kundenteam eine übersichtliche Übergabe hinterlassen
In AFFiNE
Übergabeseite mit Links zu Architekturnotizen und Canvas; Markdown-Export vor der Übergabe getestet
Ergebnis
Technische Übergabe

Verwendete Funktionen

SeiteSynthetisches Beispiel

Technische Übergabe

Systemkontext

Architekturnotizen

Betrieb

Bekannte Verfahren

Offene Punkte

Fragen für das nächste Team

Eingebetteter Edgeless-Rahmen

Markdown-ExportErgebnis vor der Übergabe testen

Markdown-Export verfügbar · Methode zum Teilen zuerst testen

Beispielansicht mit synthetischen Inhalten — kein Produkt-Screenshot.

04Supportteam

IT-Wissensdatenbank aufbauen

Machen Sie aus wiederkehrenden Supportfragen wiederverwendbare Seiten. Ergänzen Sie Konfiguration, Begründung und einen Link zu den Umsetzungsnotizen.

Aufgabe
Eine wiederkehrende Frage einmal mit Begründung beantworten
In AFFiNE
Wiederverwendbare Seite im gemeinsamen Arbeitsbereich, mit der Umsetzungsnotiz verknüpft
Ergebnis
Support-Wissensnotiz

Verwendete Funktionen

SeiteSynthetisches Beispiel

Support-Wissensnotiz

Warum diese Konfiguration?

Designbegründung einmal dokumentiert und aus Supportnotizen verlinkt.

VerwandtUmsetzungsnotiz

Beispielansicht mit synthetischen Inhalten — kein Produkt-Screenshot.

Vom Beispiel zur Bewertung

Besprechen Sie Ihren Ablauf für Kundendokumentation.

Besprechen Sie Architekturnotizen, Projektübergaben und Zugriffsanforderungen Ihres Teams.

Demo buchen

Wählen Sie einen Termin mit dem AFFiNE-Team.

Ein vernetzter Arbeitsbereich

Auf einer Seite schreiben. Dasselbe Dokument als Canvas öffnen.

Die Beispiele oben nutzen dieselben Bausteine.

  • Anschauliches Beispiel

    Dokumente

    Gut lesbare Seiten mit Verweisen, Bildern und vielseitigen Blöcken.

    Docs entdecken
  • Anschauliches Beispiel

    Edgeless-Whiteboard

    Ein Canvas zur Darstellung von Beziehungen zwischen Ideen und Systemen.

    Edgeless entdecken
  • Anschauliches Beispiel

    Tabellen und Teamarbeitsbereich

    Offene Punkte verfolgen und gemeinsam in geteilten Arbeitsbereichen bearbeiten.

    Teamhub entdecken

Beispielhafte Dokumente, Whiteboards und Tabellen — keine Produkt-Screenshots oder Branchenfallstudien.

Bereitstellung und Bewertung

Wählen Sie die Betriebsform des Arbeitsbereichs.

Bewerten Sie Einsatzfall, Infrastruktur und KI-Konfiguration gemeinsam mit den künftigen Betriebsverantwortlichen.

Illustration eines gehosteten Cloud-Arbeitsbereichs

Gehosteter Arbeitsbereich

Erproben Sie einen Ablauf mit zulässigem Beispielmaterial, bevor Sie skalieren.

  • AFFiNE-Web-App
  • Ein Teamarbeitsbereich
  • Keine eigenen Server nötig
Cloud-Bereitstellung besprechen
AFFiNE selbst hosten

Voraussetzungen

1 / Docker

Installieren Sie Docker und Docker Compose auf Ihrem Rechner.

2 / Aktuelle Compose-Datei herunterladen

Laden Sie compose.yml aus dem AFFiNE-Repository herunter.

3 / Umgebungsdatei vorbereiten

Prüfen Sie die Umgebungsvariablen für Ihre Bereitstellung.

Selbst gehostet

Für selbst gehostetes AFFiNE ist Docker Compose der dokumentierte Bereitstellungsweg. Arbeitsbereichsdaten und Uploads nutzen die von Ihnen konfigurierte Infrastruktur und den von Ihnen konfigurierten Speicher.

  • Docker Compose
  • PostgreSQL
  • Datei- oder S3-Speicher
  • OIDC-Anmeldung
  • Anmeldung über Ihren IdentitätsanbieterSelbst gehostetes AFFiNE unterstützt OIDC. Prüfen Sie Arbeitsbereichsrollen und Dokumentzugriff anhand Ihrer Anforderungen.
  • KI ist optionalKI in selbst gehostetem AFFiNE benötigt einen konfigurierten Anbieter und lässt sich deaktivieren. Bring-your-own-key ist als experimentell gekennzeichnet.
  • Lizenzierung für eingeschränkte NetzwerkeEine installierbare Lizenz wird ohne Verbindung zu AFFiNE-Lizenzservern aktiviert. Das allein macht nicht jede Funktion offline verfügbar.
  • Sicherung und WiederherstellungDer Ablauf einschließlich Testwiederherstellung ist dokumentiert. Führen Sie ihn in Ihrer eigenen Umgebung durch.

Fragen für das Gespräch

  1. Teilen Kundeninhalte einen Arbeitsbereich mit internem Wissen?
  2. Wie wird jede Übergabe geteilt oder exportiert?
  3. Welchen Identitätsanbieter soll das Pilotprojekt nutzen?

Diese Seite trifft keine Aussage zu SAML, SCIM, Branchenzertifizierungen oder der Freigabe für bestimmte Einsatzfälle.

Produktreferenzen: AFFiNE Enterprise sowie englischsprachige Dokumentation zu Docker Compose, OIDC-Anmeldung und KI-Konfiguration.

Weiter entdecken · Allgemeine Vorlage

Bestehende SOP-Vorlage

Eine allgemeine Verfahrensvorlage, um eine wiederholbare Betriebsaufgabe zu dokumentieren.

Vor dem Start

Fragen Ihres Teams.

Wie können Serviceteams AFFiNE für IT-Dokumentation nutzen?

Nutzen Sie Dokumente für Konfigurationsnotizen und Betriebsverfahren, Whiteboards für Architekturdiagramme und Tabellen für Zuständigkeiten und offene Fragen. Diese Beispiele betreffen die Dokumentation; Inventarerfassung, Passworttresore, RMM und Ticketautomatisierung bleiben in Spezialwerkzeugen.

Was gehört in eine Softwarearchitekturdokumentation?

Dokumentieren Sie Systemzweck, Nutzer, Komponenten, Schnittstellen und Bereitstellungskontext. Erläutern Sie anschließend Designentscheidungen und offene Fragen. Beschriften Sie Diagrammelemente und Verbindungen so, dass ein anderes Team sie ohne den ursprünglichen Autor verstehen kann. Halten Sie in AFFiNE das Diagramm zusammen mit seinen Annahmen, Quellenverweisen und Entscheidungsnotizen fest.

Referenz für Diagramme (Englisch): C4-Modell für Softwarearchitektur.

Können wir Informationen verschiedener Kunden trennen?

Prüfen Sie Mitgliedschaften, Dokumentzugriff und Freigabeeinstellungen anhand Ihrer Anforderungen, bevor Sie Kundeninhalte verwenden. Das Beispiel belegt keine Mandantentrennung.

Können wir Self-Hosting evaluieren?

Ja. Docker Compose ist der dokumentierte Self-Hosting-Weg, mit Anmeldung über Ihren Identitätsanbieter per OIDC. Prüfen Sie die Enterprise-Dokumentation mit Ihrem Infrastrukturteam und testen Sie vor einer breiteren Einführung einen repräsentativen Ablauf.

Ist KI für diesen Arbeitsbereich erforderlich?

Nein. Diese Abläufe nutzen Seiten, Canvases und Tabellen und benötigen keine KI. In selbst gehostetem AFFiNE benötigt KI einen konfigurierten Anbieter und kann deaktiviert werden. Prüfen Sie den Anbieter und die Datenflüsse vor der Aktivierung.

Wie sollte unser Team beginnen?

Wählen Sie eine aktuelle Dokumentationsaufgabe und eine kleine Auswahl zulässiger Beispielinhalte. Prüfen Sie vor der Ausweitung, ob das Team die Arbeit finden, verstehen und übergeben kann.

Ein Gespräch über Ihr Team

Bewerten Sie AFFiNE für Kundenprojekte.

Besprechen Sie Architekturnotizen, Projektübergaben und Zugriffsanforderungen Ihres Teams.

30 Minuten per Google Meet · Verfügbaren Termin wählen

Lieber per E-Mail? Vertrieb kontaktieren