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

33 lines
1.6 KiB
Markdown

# 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](adr/ADR-024.md)). 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](../provider-registry.md)). Swapping vendors must not rewrite CRM/Accounting domain logic.
## Related Documents
- [Module Registry](../module-registry.md)
- [Compliance Architecture](compliance-architecture.md)
- [Phases / AI](../phases/AI/README.md)
- [Project Principles](../development/project-principles.md)
- [Enterprise / AI Development Framework](../ai-framework/README.md) (implementation process — distinct from this product AI architecture)
- [ADR-013](adr/ADR-013.md) · [ADR-018](adr/ADR-018.md) · [ADR-019](adr/ADR-019.md)