AnnexOffice – Handbuch
1. Überblick
AnnexOffice ist das Büro- und Verwaltungszentrum der Suite AnnexCREATE. Es richtet sich an Freelancer, Selbständige und kleine Agenturen, die Kunden, Projekte, Zeiten und Rechnungen an einem Ort führen wollen. Die App bündelt ein schlankes Projektmanagement mit Rechnungsstellung und DATEV-Export und integriert die Textverarbeitung (AnnexTextKit) und Tabellenkalkulation (AnnexCalcKit) direkt als eigene Arbeitsbereiche.
Kernnutzen:
- Kunden, Projekte, Aufgaben, Zeiten, Angebote, Rechnungen und Freigaben in einem Dokument.
- Rechnungsstellung mit Nummernkreis und automatischen Summen (Netto/MwSt./Brutto).
- Angebote mit eigenem Nummernkreis und Umwandlung in Rechnungen per Klick.
- DATEV-Export der Ausgangsrechnungen als Buchungsstapel (EXTF).
- Eingebettete Textverarbeitung und Tabellenkalkulation als eigene Arbeitsbereiche.
AnnexOffice ist Bestandteil des „Creative OS": Die App teilt Design-System, Asset-Bibliothek, Brandkits und Diagnostik mit den übrigen Apps. Über offene Formate, die Asset-Bibliothek und die MCP-Automatisierung lässt sie sich in bestehende Abläufe integrieren.
2. Installation & Aktivierung
AnnexOffice wird über AnnexHub bezogen und verwaltet:
- Download & Updates: AnnexHub ist die zentrale Anlaufstelle für Apps, Updates und Lizenzen.
- Lizenzaktivierung: zentral über AnnexHub (AnnexLicenseKit); Offline-Aktivierung möglich.
- Offline-Betrieb: AnnexOffice ist Offline-first und läuft ohne Serververbindung; alle Daten bleiben lokal auf dem Mac.
3. Grundworkflow
Der typische Ablauf vom Start bis zur Rechnung:
- Starten: AnnexOffice aus AnnexHub öffnen oder eine vorhandene
.axofficeöffnen (Ablage ▸ Öffnen…, ⌘O). - Überblick verschaffen: Auf dem Dashboard die Kennzahlen (Kunden, Projekte, offene Aufgaben/Rechnungen, Umsatz) prüfen.
- Kunde anlegen: In der Kundenverwaltung per Plus-Button einen Kunden anlegen.
- Projekt anlegen: Ein Projekt mit Kundenbezug, Budget und Stundensatz anlegen.
- Aufgaben & Zeiten erfassen: Aufgaben zum Projekt anlegen und Arbeitszeit buchen.
- Beleg erstellen: Ein Angebot erstellen und nach Annahme per Klick in eine Rechnung umwandeln – oder direkt eine Rechnung mit Positionen anlegen.
- Sichern & exportieren: als
.axofficespeichern (⌘S) und bei Bedarf einen DATEV-Export der Ausgangsrechnungen erzeugen.
4. Kernfunktionen
4.1 Arbeitsplatz, Menüleiste & Dashboard
AnnexOffice nutzt das Drei-Spalten-Design der Suite: Sidebar links mit Bereichsnavigation und Asset-Bibliothek, Arbeitsfläche in der Mitte, Inspector rechts; transparente Titlebar und gebrandeter App-Header. Die Menüleiste (verdrahtet über WindowActions, .commands) bietet:
Ablage ▸ Öffnen…– ⌘OAblage ▸ Neues Angebot…– ⌥⌘NAblage ▸ Angebot in Rechnung umwandeln– ohne KürzelAblage ▸ Speichern…– ⌘SAnnexOffice ▸ Einstellungen…– ⌘,
Das Dashboard zeigt Kennzahlen-Kacheln (Kunden, Projekte, offene Aufgaben, offene Rechnungen, Umsatzsumme, Freigaben) sowie die fünf zuletzt aktiven Projekte.
4.2 Kundenverwaltung
Der Kundenstamm (CustomerListView, Modell Customer) führt pro Kunde Ansprechpartner, E-Mail, Telefon, Adresse, USt-IdNr., Zahlungsbedingungen und Standardrabatt. Kunden legst du per Plus-Button an.
4.3 Projektverwaltung
Projekte (ProjectListView, Modell Project) haben einen Kundenbezug, einen Status-Workflow (Entwurf → Angefragt → In Bearbeitung → In Freigabe → Abgeschlossen/Abgebrochen), Budget, Stundensatz, Starttermin, Deadline und Notizen.
4.4 Aufgabenverwaltung
Aufgaben (TaskListView, Modell Task) gehören zu einem Projekt und haben einen Status (Offen/In Bearbeitung/In Prüfung/Erledigt), eine Priorität (Niedrig/Mittel/Hoch), eine Deadline, einen geschätzten Aufwand und Notizen.
4.5 Zeiterfassung
Zeitbuchungen (TimeTrackingView, Modell TimeEntry) haben einen Projekt- und optionalen Aufgabenbezug, Start-/Endzeitpunkt und eine Notiz. Die Stunden werden automatisch berechnet (durationHours); Summen pro Projekt stehen über OfficeDocument.totalHours zur Verfügung.
4.6 Rechnungsstellung
Rechnungen (InvoiceListView, InvoiceDetailView, Modell Invoice) bekommen ihre Nummer aus dem Nummernkreis (Format RE-<Jahr>-<fortlaufend>, z. B. RE-2026-0001). Sie haben ein Ausstellungs- und Fälligkeitsdatum (Standard 14 Tage), einen Status (Entwurf/Versendet/Bezahlt/Überfällig/Storniert) und freie Positionen (Beschreibung, Menge, Einzelpreis). Die Summen – Netto, MwSt. (Steuersatz pro Rechnung, Standard 19 %) und Brutto – werden automatisch berechnet. Per Drag & Drop hängst du Assets aus der Suite-Bibliothek als Belege/Referenzen an Rechnungen (mit Thumbnails und Entfernen-Funktion).
4.7 Angebote
Angebote (QuoteListView, QuoteDetailView, Modell Quote) sind ein eigener Belegtyp mit eigener Liste in der Sidebar, eigenem Nummernkreis (ANG-<Jahr>-<fortlaufend>), Status-Workflow (Entwurf/Gesendet/Angenommen/Abgelehnt), Gültigkeitsdatum (Standard 30 Tage) und freien Positionen mit denselben Summen wie Rechnungen. Die Kernfunktion „In Rechnung umwandeln" erzeugt per Klick eine echte Rechnung mit denselben Positionen, Kunde und Beträgen und einer neuen Nummer aus dem Rechnungskreis, markiert das Angebot als angenommen und verknüpft beide Belege bidirektional. Bereits umgewandelte Angebote sind gegen Doppel-Umwandlung gesperrt.
4.8 Freigaben
Der Freigabe-Workflow (ApprovalListView, Modelle Approval/ApprovalRevision) verwaltet Freigaben für kreative Entwürfe mit Projektbezug, Asset-Verknüpfungen, Revisionshistorie und Status-Auswahl direkt in der Liste (Ausstehend/Genehmigt/Abgelehnt/Nachbesserung). .axapproval-Dateien importierst du über einen Dateidialog.
4.9 Eingebettete Textverarbeitung & Tabellenkalkulation
AnnexOffice integriert beide Office-Editoren als eigene Arbeitsbereiche:
- Textverarbeitung: vollwertiger AnnexText-Editor (
TextDocumentEditorViewaus AnnexTextKit). Export als DOCX und ODT. - Tabellenkalkulation: vollwertiger AnnexCalc-Editor (
SpreadsheetEditorViewaus AnnexCalcKit) mit Formel-Engine. Export als XLSX, ODS und CSV.
Der Export erfolgt jeweils per Export-Dialog im Editor.
4.10 DATEV-Export
Der DATEV-Export (DATEVExportSheet, DATEVExportService) bietet einen Dialog mit Zeitraum, Kontenrahmen (SKR03/SKR04), Debitoren-Startkonto sowie Berater- und Mandantennummer. Er erzeugt einen Buchungsstapel der Ausgangsrechnungen als echte Datei. Details zum Format siehe Abschnitt 5.
4.11 Brandkits & Assets
- Brandkits: Du verknüpfst Brandkits aus der Suite-Bibliothek per Inspector mit dem Dokument; deren Assets erscheinen als Schnellzugriff in der Sidebar – ein Klick kopiert den lokalen Dateipfad in die Zwischenablage.
- Asset-Bibliothek: Die suite-weite
AssetLibraryView(AnnexAssetKit) ist fest in der Sidebar eingebunden.
5. Formate & Interoperabilität
- Eigenformat
.axoffice: Annex-Container (AnnexCoreKitAnnexDocument) mitoffice.json-Snapshot (Kunden, Projekte, Aufgaben, Zeiten, Rechnungen, Angebote, Freigaben, Brandkit-Verknüpfungen). Speichern und Öffnen sind verdrahtet (⌘O/⌘S); schlägt das Laden fehl, erscheint ein Fehler-Alert statt stiller Beispieldaten. Dateien aus Ständen vor Etappe 0.2.M (ohne Angebote) laden abwärtskompatibel mit leerer Angebotsliste. - DATEV-Export: Buchungsstapel im EXTF-Format (Formatversion 13) als CSV – UTF-8, CRLF, Semikolon-Trennung, Dezimalkomma. Pro Rechnung eine Buchungszeile (Debitor gegen Erlöskonto), USt-Schlüssel 9 (19 %) bzw. 2 (7 %), steuerfreie Umsätze auf SKR03 8125 / SKR04 4125; Debitorenkonten werden stabil aus dem Kundenstamm im Bereich 10000–69999 vergeben.
- Beleg-Export (HTML/PDF):
PDFExportServiceerzeugt Rechnungen und Angebote als HTML-Datei und als echtes PDF (A4-Rendering mit Positionstabelle, Summenblock und Notizen). Der Service ist implementiert; die Anbindung an die Oberfläche folgt noch. - Freigabe-Austausch: Import von
.axapproval-Dateien (AnnexInteropKitApprovalExchangeService) über Dateidialog; die Konvertierung zwischen Office-Freigaben und dem suite-weiten Austauschformat ist in beide Richtungen implementiert. - Export aus den eingebetteten Editoren: Textdokumente als DOCX/ODT (AnnexTextKit), Tabellen als XLSX/ODS/CSV (AnnexCalcKit).
- Suite-Interop: Asset-Referenzen aus der gemeinsamen Asset-Bibliothek (inkl. Drag & Drop auf Rechnungen und Thumbnail-Anzeige) und Brandkit-Verknüpfungen über die suite-weite
BrandkitLibrary. - Zentrale Suche (AnnexHub): Beim Speichern wird das Dokument best-effort in den geteilten Versions-Index (
SharedVersionIndexStore) geschrieben und taucht dadurch in der AnnexHub-Suche auf. - iCloud/Cloud-Sync: nicht verdrahtet.
6. MCP-Bedienung
Der MCP-Host läuft in AnnexHub, JSON-RPC 2.0 via STDIO, und wird von dort gestartet. Damit ist das Öffnen von AnnexOffice-Dokumenten für KI-Agenten und Automatisierung erreichbar.
Suite-weite Tools (für alle Apps): list_apps, open_app, open_document, get_active_document, get_license_status, search_assets.
App-spezifisches Tool für AnnexOffice:
office.open_document– öffnet ein AnnexOffice-Dokument.
Skills (suite-weit): suite.discover, brandkit.apply.
AnnexHub selbst stellt keine eigenen Tools bereit, ist aber der Startpunkt: Der MCP-Host wird von dort aus gestartet.
7. Diagnostik & Privatsphäre
AnnexOffice protokolliert Fehler und Aktionen lokal über AnnexDiagnosticsKit in rotierende JSON-Log-Dateien unter ~/Library/Logs/AnnexCREATE/AnnexOffice/, gespiegelt nach os_log (Subsystem com.annexcreative.annexoffice), mit PII-Filter. Die Diagnostik ist in der Entwicklungsphase per Default aktiv und in den Einstellungen (Datenschutz) abschaltbar; es findet keine Übertragung statt. AnnexOffice loggt u. a. Speichern/Laden, Rechnungs- und DATEV-Exporte, Freigabe-Importe und Fehlerfälle. Telemetrie ist verdrahtet (TelemetryClient.shared.configure) und läuft ausschließlich per Opt-in (Default aus). Alle Daten bleiben auf dem Mac.
8. FAQ
Braucht AnnexOffice eine Internetverbindung? Nein. Die App ist Offline-first und läuft ohne Serververbindung; Cloud-Sync ist nicht verdrahtet.
Wie vergebe ich Rechnungsnummern?
Automatisch aus dem Nummernkreis im Format RE-<Jahr>-<fortlaufend> (z. B. RE-2026-0001). Angebote haben einen eigenen Kreis (ANG-…).
Kann ich ein Angebot in eine Rechnung übernehmen? Ja. Per Klick („In Rechnung umwandeln") entsteht eine echte Rechnung mit denselben Positionen und einer neuen Rechnungsnummer; Angebot und Rechnung sind bidirektional verknüpft, und eine Doppel-Umwandlung ist gesperrt.
Kann ich Rechnungen als PDF versenden?
Der HTML-/PDF-Export für Rechnungen und Angebote existiert als Service (PDFExportService), ist aber noch nicht über die Oberfläche erreichbar; ein Versand per E-Mail fehlt.
Wie bearbeite ich Kunden, Projekte oder Rechnungen im Detail? Die Detailpflege ist noch schmal: Die Listen erlauben das Anlegen, dedizierte Bearbeitungsformulare für Kunden, Projekte, Aufgaben und Zeitbuchungen fehlen noch; die Rechnungsdetailansicht ist derzeit eine reine Leseansicht.
Gibt es Mail, Kalender und Kontakte?
Groupware/PIM (Mail, Kalender, Kontakte) ist noch nicht implementiert; das Konzept liegt als eigenes Dokument unter docs/, die Umsetzung steht im Backlog.
In welchen Sprachen ist die Oberfläche verfügbar? Deutsch, Englisch, Spanisch, Französisch und Italienisch. Neue Dokumente starten mit deutschsprachigen Beispieldaten.