AnnexCalc – Handbuch

1. Überblick

AnnexCalc ist die Tabellenkalkulation der Suite AnnexCREATE. Sie richtet sich an Freelancer, Selbständige und kleine Agenturen, die Budgets, Angebotskalkulationen und einfache Auswertungen ohne Schwerfälligkeit erledigen wollen. Die App bietet ein klassisches Zellraster mit Formeln, speichert in einem eigenen Containerformat .axsheet und exportiert in gängige Büroformate.

Kernnutzen:

• Klassisches Zellraster mit Formeln und Zellbezügen statt überladener Ribbon-Bedienung.
• Formel-Engine mit den Grundrechenarten, Bereichen und den Funktionen SUM, AVG, MIN, MAX.
• Anzeigeformate pro Zelle (Währung, Datum, Prozent), die Export und Druck übernehmen.
• Export in gängige Büroformate (CSV, XLSX, ODS, PDF) über einen gemeinsamen Anzeigepfad.
• Verzahnung mit der Suite über die Annex-Zwischenablage (CSV) und die gemeinsame Asset-Bibliothek.

AnnexCalc ist Bestandteil des „Creative OS": Die App teilt Design-System, Asset-Bibliothek, Zwischenablage und Diagnostik mit den übrigen Apps. Über offene Formate und die MCP-Automatisierung lässt sie sich in bestehende Abläufe integrieren.

2. Installation & Aktivierung

AnnexCalc 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: AnnexCalc ist Offline-first und läuft ohne Serververbindung; alle Tabellen bleiben lokal auf dem Mac.

3. Grundworkflow

Der typische Ablauf vom Start bis zur fertigen Tabelle:

1. Starten: AnnexCalc aus AnnexHub öffnen oder eine vorhandene .axsheet öffnen (Ablage ▸ Öffnen…, ⌘O).
2. Werte eintragen: Zelle anklicken, Wert oder Formel eingeben, mit Enter bestätigen.
3. Rechnen: Formeln mit Zellbezügen und Funktionen schreiben, etwa =SUM(B1:B5).
4. Blatt strukturieren: Titel im Inspector setzen, Zeilen und Spalten per Toolbar erweitern.
5. Formatieren: Für eine Zelle ein Anzeigeformat wählen (Standard, Währung, Datum, Prozent) über das Format-Menü oder den Inspector.
6. Auswerten: Spaltensumme und Gesamtsumme im Inspector ablesen; Formelzellen in der Sidebar prüfen.
7. Sichern & weitergeben: als .axsheet speichern (⌘S) und als CSV, XLSX, ODS oder PDF exportieren oder drucken (⌘P).

4. Kernfunktionen

4.1 Arbeitsplatz & Menüleiste

AnnexCalc nutzt das Drei-Spalten-Design der Suite: Sidebar links (Blatt-Infos und Asset-Bibliothek), Zellraster in der Mitte, Inspector rechts; transparente Titlebar und App-Header. Die Menüleiste (verdrahtet über WindowActions/@FocusedObject) bietet:

• Ablage ▸ Öffnen… – ⌘O
• Ablage ▸ Speichern – ⌘S
• Ablage ▸ Speichern unter… – ⌘⇧S
• Ablage ▸ Exportieren… – ohne Kürzel
• Ablage ▸ Drucken… – ⌘P
• AnnexCalc ▸ Einstellungen… – ⌘,

Zusätzlich gibt es ein eigenes Format-Menü für die Zahlenformate der selektierten Zelle (Häkchen am aktiven Format).

4.2 Zellraster & Bearbeitung

Das scrollbare Raster (SpreadsheetGridView, CalcCellView) hat Zeilen- und Spaltenköpfe. Du selektierst eine Zelle per Klick und bearbeitest sie per Textfeld; die Eingabe wird mit Enter übernommen (Commit).

4.3 Formeln

Die Formel-Engine (SpreadsheetFormulaEngine in AnnexCalcKit) unterstützt:

• Grundrechenarten + - * /, Klammern und unäre Vorzeichen.
• Zellbezüge (A1, B2, AA10) und Bereiche (A1:B5).
• Die Funktionen SUM, AVG, MIN, MAX.
• Zirkelbezugserkennung und das deutsche Dezimalkomma.

Der Formel-Umfang ist bewusst schmal gehalten (vier Funktionen); Sortierung und Charts sind nicht implementiert.

4.4 Blatt verwalten

Den Blatt-Titel änderst du im Inspector. Zeilen und Spalten erweiterst du per Toolbar (CalcDocumentController.addRow/addColumn). Pro Dokument gibt es ein Blatt; mehrere Tabellenblätter pro Datei sind noch nicht vorhanden.

4.5 Zell- und Zahlenformate

Zellen tragen ein optionales Zahlenformat (CellNumberFormat): Standard, Währung (EUR, locale-aware über NumberFormatter), Datum (kurzes Datumsformat) oder Prozent. Das Format gilt nur für die Anzeige (Inspector-Zeile „Anzeige", Druck/PDF, Exporte) – der gespeicherte Rohwert und die Formelberechnung bleiben unverändert. Die Auswahl für die selektierte Zelle erfolgt über das Format-Menü (Häkchen am aktiven Format) oder den Format-Picker im Inspector. Alte .axsheet-Dateien ohne Formatinformation laden als „Standard".

4.6 Inspector & Sidebar-Auswertungen

• Inspector (CalcInspectorView): Rohwert/Formel und Ergebnis der ausgewählten Zelle, Format-Picker, Anzeigewert, Spaltensumme, Gesamtsumme aller numerischen Zellen und die Seitenzahl für den Druck.
• Sidebar (CalcSidebarView): Blattgröße, Anzahl benutzter Zellen und eine klickbare Liste aller Formelzellen (selektiert die Zelle in Raster und Inspector).

4.7 Speichern & Autosave

AnnexCalc speichert im eigenen .axsheet-Containerformat über AnnexCoreKit. Bekannte Dateiorte werden direkt gespeichert (⌘S), sonst „Speichern unter" (⌘⇧S); Öffnen per Dateiauswahl (⌘O). Der Autosave sichert intervallbasiert still an den bekannten Dateiort – Aktivierung und Intervall konfigurierst du in den Einstellungen.

4.8 Export & Druck

Über den Export-Dialog (Ablage ▸ Exportieren… oder Toolbar-Button „Exportieren") erzeugst du echte Dateien:

• CSV (Semikolon, mit Quoting; exportiert die formatierten Anzeigewerte inkl. Formelergebnissen).
• XLSX (Office Open XML, eigener ZIP-Writer via AnnexArchiveKit).
• ODS (OpenDocument Spreadsheet).
• PDF – XLSX/ODS/PDF übernehmen die Zahlenformate über den gemeinsamen Anzeigepfad.

Drucken (Ablage ▸ Drucken…, ⌘P) nutzt den gemeinsamen Druckpfad der Suite (AnnexPrintSheet, AnnexPrintOperation) mit DIN-A4-Layout (CalcPrintLayout) – derselbe Renderpfad wie der PDF-Export, inkl. Kopfzeile, Zeilennummern und Gitter.

4.9 Asset-Integration & Annex-Zwischenablage

• Asset-Bibliothek (suite-weite AssetLibraryView) liegt in der Sidebar. Ziehst du eine Asset-Referenz ins Raster, schreibt AnnexCalc einen sichtbaren Dateireferenz-Eintrag in die ausgewählte Zelle (Inline-Assets unterstützt das Format nicht).
• Annex-Zwischenablage (CalcInteropService): „Blatt kopieren" legt das ganze Blatt als CSV in die Suite-Zwischenablage (mit Text-Fallback für fremde Apps); „Einfügen" übernimmt mehrzeiligen, Semikolon-getrennten Text als CSV-Import, einzelne Werte in die ausgewählte Zelle.

5. Formate & Interoperabilität

• Eigenformat .axsheet: Annex-Container (AnnexCoreKit) mit sheet.json-Snapshot (Titel, Zeilen/Spalten, Zellen inkl. optionalem Zahlenformat; abwärtskompatibel, alte Dateien laden mit Format „Standard"). Laden und Speichern sind verdrahtet.
• Import: CSV-Import in das bestehende Blatt (aus Datei oder Zwischenablage; Zeilen/Spalten werden bei Bedarf erweitert). In der App erreichst du ihn über Einfügen. XLSX-/ODS-Import ist nicht implementiert (nur Export).
• Export: CSV, XLSX, ODS, PDF – alle im Export-Dialog verdrahtet und als echte Dateien geschrieben.
• Suite-Interop: Annex-Zwischenablage (AnnexInteropKit) mit Text-Fallback gegen andere Annex-Apps und fremde Apps; Asset-Referenzen aus der gemeinsamen Asset-Bibliothek (AnnexAssetKit).
• Zentrale Suche (AnnexHub): Beim Speichern wird der zentrale Versions-/Entwurfs-Index (SharedVersionIndexStore) best-effort aktualisiert, sodass Tabellen in der AnnexHub-Suche auffindbar sind.
• iCloud/Cloud-Sync: nicht verdrahtet; Dokumente leben rein lokal.

6. MCP-Bedienung

Der MCP-Host läuft in AnnexHub, JSON-RPC 2.0 via STDIO, und wird von dort gestartet. Damit sind die Aktionen von AnnexCalc 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-spezifische Tools für AnnexCalc:

• calc.create_document – legt eine echte .axsheet-Datei an (Zeilen/Spalten konfigurierbar).
• calc.set_cell – echte Dateiänderung: setzt einen Zellwert oder eine Formel (mit führendem =).
• calc.open_document – öffnet ein Tabellendokument.

Skills (suite-weit): suite.discover, brandkit.apply.

Über diese Schnittstelle sind Tabellen-Erstellung, Zell-Bearbeitung und Öffnen vollständig automatisierbar.

7. Diagnostik & Privatsphäre

AnnexCalc protokolliert Fehler und Aktionen lokal über AnnexDiagnosticsKit in rotierende JSON-Log-Dateien unter ~/Library/Logs/AnnexCREATE/AnnexCalc/, gespiegelt nach os_log (Subsystem com.annexcreative.annexcalc), mit PII-Filter. Die Diagnostik ist in der Entwicklungsphase per Default aktiv und in den Einstellungen (Datenschutz) abschaltbar; es findet keine Übertragung statt. AnnexCalc loggt u. a. Öffnen, Speichern, Export 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 AnnexCalc eine Internetverbindung? Nein. Die App ist Offline-first und läuft ohne Serververbindung; Cloud-Sync ist nicht verdrahtet.

Kann ich Excel- oder LibreOffice-Dateien öffnen? XLSX-/ODS-Import ist nicht implementiert – nur der Export. Importieren kannst du CSV (über Einfügen); nativ lädt AnnexCalc .axsheet.

Welche Formeln gibt es? Grundrechenarten, Klammern, Zellbezüge, Bereiche und die Funktionen SUM, AVG, MIN, MAX – mit Zirkelbezugserkennung und deutschem Dezimalkomma. Mehr Funktionen, Sortierung und Charts sind (noch) nicht Teil der App.

Ändert ein Zahlenformat meine Werte? Nein. Währung, Datum und Prozent sind reine Anzeigeformate; der gespeicherte Rohwert und die Berechnung bleiben unverändert.

Wie viele Tabellenblätter hat ein Dokument? Derzeit genau ein Blatt pro Dokument. Mehrere Blätter pro Datei sind noch nicht vorhanden.

Wo finde ich meine Log-Dateien? Unter ~/Library/Logs/AnnexCREATE/AnnexCalc/. Die Diagnostik ist in der Entwicklungsphase aktiv und in den Einstellungen abschaltbar.

In welchen Sprachen ist die Oberfläche verfügbar? Deutsch, Englisch, Spanisch, Französisch und Italienisch.