TorbatYar/docs/architecture/ai-architecture.md
Mortezakoohjani a483b47369 feat(workspace): complete production workspace and content operations
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-12 11:54:17 +03:30

1.6 KiB

AI Architecture

Independence Rule

AI capabilities are an independent module family. Business modules may consume AI via API/events but must remain functional when AI is disabled or unavailable.

Boundaries

AI may AI must not
Suggest, classify, draft, route Be the sole authority for money, compliance, or authorization
Read tenant-scoped knowledge bases Cross tenant data
Emit assistance events Bypass entitlement checks

Planned Module

ai_assistant — chat assistance, knowledge bases, handoff to humans. Database: ai_assistant_db. Feature prefix: ai_assistant.*.

Torbat Workspace may declare capability workspace.ai-assistant and consume this module via contracts only (ADR-024). Workspace work-management must remain functional when AI is disabled. Workspace must not own ai_assistant_db or model-provider credentials.

Provider Independence

Model providers are registered like any other provider (provider-registry.md). Swapping vendors must not rewrite CRM/Accounting domain logic.