Wofür das Modul gedacht ist
KI-Assistent ist Teil des aktiven Modul-Katalogs und deckt einen klaren Ausschnitt des Produktalltags ab.
KI-gestützter Chat-Assistent mit Kontextwissen über Projekte, Aufgaben und Finanzdaten, inklusive GPT-5.5 in den Stufen Schnell, Standard und Gründlich. Im tenantweiten Kontext sorgt der Bereich dafür, dass wiederkehrende Entscheidungen, Stammdaten oder Übersichten nicht in Nebensysteme ausweichen müssen.
KI-Assistent ist als eigenständiger Produktbaustein gedacht. Gerade deshalb lohnt sich ein Blick darauf, wie der Bereich mit Rollen, Datenkontext und angrenzenden Modulen zusammenspielt.
Typische Einsatzfälle
Diese Situationen zeigen, wann der Bereich in einem sauberen Rollout oder im laufenden Betrieb konkret Mehrwert liefert.
GPT-5.5 passend wählen
Je nach Aufgabenkomplexität stehen GPT-5.5 Schnell, Standard und Gründlich mit 300, 600 oder 1.500 Credits pro Nachricht zur Verfügung.
Zusammenhänge erklären
Der Assistent eignet sich, um Daten zusammenzufassen, Rückfragen vorzubereiten oder nächste Schritte strukturiert aufzubereiten.
Facharbeit beschleunigen
Gerade in Kombination mit Dokumenten, Projektübersichten und Finanzmodulen wird KI praktisch nutzbar statt Zusatzfenster.
Wie das Modul mit anderen Bereichen zusammenspielt
struct-i-vio ist als zusammenhängende Plattform gedacht. Diese Module liegen fachlich am nächsten bei diesem Bereich.
Dashboard
Dashboard ergänzt KI-Assistent, weil beide Bereiche im Alltag direkt aufeinander aufbauen oder dieselben Verantwortlichen berühren.
DetailsDokumente
Dokumente ergänzt KI-Assistent, weil beide Bereiche im Alltag direkt aufeinander aufbauen oder dieselben Verantwortlichen berühren.
DetailsFinanzen
Finanzen ergänzt KI-Assistent, weil beide Bereiche im Alltag direkt aufeinander aufbauen oder dieselben Verantwortlichen berühren.
DetailsBerechtigungen und Sichtbarkeit
Die öffentliche Dokumentation beschreibt die Logik auf Produktniveau - nicht als technische Policy-Liste, sondern als Rollout-Leitfaden.
Best Practices
So bleibt der Bereich bei Einführung und Nutzung anschlussfähig an den restlichen Produktfluss.
Entwickler Info
4 Permissions ohne _all/scoped-Pair. KEINE RLS-Policies — Enforcement vollständig im API-Layer. view ist Subscription-Plan-Flag (Plan inkludiert AI), use_chat ist irreführend benannt (gates execute-write-Endpoint, nicht den Chat selbst). manage_credits/manage_models haben Level-Bypass über positionLevel≤1.
Entwickler-Info aufklappen (7)
⚠ KRITISCHuse_chat ist irreführend benannt
use_chat suggeriert "Chat nutzen", aber der Chat selbst wird durch view gegated. use_chat gates ausschließlich /api/ai/execute-write — also den Endpoint, an dem der User AI-Schreib-Vorschläge approve/reject. Effektiver Action-Name wäre approve_ai_writes oder execute_ai_proposals. Live-Preview muss erklären: "Diese Permission betrifft nicht den Chat — sie betrifft das Ausführen von AI-Tool-Vorschlägen."
pages/api/ai/execute-write.ts:36-42
⚠ KRITISCHview ist Subscription-Feature-Flag, kein Permission-Toggle
view fungiert primär als Subscription-Plan-Flag — "Plan inkludiert AI". In den Permission-Presets ist visibility=1 für Free-Tier (Modul gar nicht sichtbar) und visibility=4-6 für Pro/Enterprise. Beim Plan-Wechsel kann diese Permission serverseitig geändert werden. Live-Preview sollte beim Schließen warnen: "Das sperrt das gesamte AI-Modul für den User — inkl. Chat, Credits, Tool-Calls."
lib/permission-presets.ts:90,176,269,362
⚠ KRITISCHCross-Modul-Coupling: AI-Tool-Calls verlangen Modul-Permissions
Auch mit voller AI-Permission kann der User nicht alles per AI machen. Bei jedem AI-Tool-Aufruf prüft chat-stream.ts + lib/ai/toolContext.ts ZUSÄTZLICH die jeweilige Modul-Permission: contacts.create_contact für Kontakt-Anlegen, admin_projects.create_project für Projekt-Anlegen, project_tasks für Lese-Operationen auf Tasks etc. Wer manage_credits + view hat, aber kein contacts.create_contact, kann den AI nicht zum Anlegen verleiten.
pages/api/ai/chat-stream.ts:1245, 2710-2732lib/ai/toolContext.ts
Level-Bypass für manage_credits/manage_models
Beide Manage-Endpoints prüfen: canManage OR positionLevel≤1. Tenant-Admins (Level 0-1) bekommen die Permission per Level-Bypass automatisch — auch ohne expliziten Toggle im Permission-System. Beim Schließen der Permissions auf höheren Levels muss die Live-Preview anzeigen: "Hat keine Wirkung auf Tenant-Admins (Level ≤1) — die bekommen es per Level-Bypass."
pages/api/ai/admin/credits.ts:39, 69pages/api/ai/credits.ts:55-59
DSGVO-Consent als zweite Schicht NACH view
chat-stream prüft NACH ai_assistant.view auch has_ai_consent() RPC. Wer den DSGVO-Consent nicht erteilt hat, sieht 451 (Unavailable For Legal Reasons), egal welche Permissions gesetzt sind. Consent lebt pro Employee in einer separaten Tabelle und kann nur vom User selbst gegeben werden — kein Admin-Override.
pages/api/ai/chat-stream.ts:3083-3087
manage_models: Conditional Pre-Check
manage_models wird nur dann geprüft, wenn die Bulk-Allocation tatsächlich allowed_models ändert. Wer manage_credits hat aber kein manage_models, kann Bulk-Allocations speichern — solange er keine Modell-Beschränkungen mitgibt.
pages/api/ai/admin/credits.ts:62-72
Subscription-Budget-Limit
manage_credits kann nicht über das Tenant-AI-Budget aus der Subscription hinaus verteilen. Beim Bulk-Allocate prüft der Endpoint die Summen-Allocation gegen das Plan-Limit. Auch mit voller manage_credits-Permission gilt das Plan-Cap.