Architecture Layers

ConversionIQ is designed around layered separation to support enterprise scale, multi-brand, and multi-workspace operation.

Layers

The current platform model is not a simple linear Knowledge Base -> Channel chain. In practice:

Workspaces scope and govern operational entities.
Knowledge Bases provide the canonical AI source of truth.
Agents operationalize KBs for agent-managed conversation flows.
Channels enter the system through either KB-owned or agent-owned patterns depending on the channel family.

This document describes the entity and responsibility stack of the platform. For the future runtime execution stack (input, intent, orchestration, execution, learning, trust), see:

1) Workspaces

Enterprise containers that isolate:

Users and roles/permissions
Policies and compliance constraints
Connected channels and credentials (scoped)
Knowledge base ownership and access

Source of truth: Domain: Workspaces

2) Knowledge Bases

Structured sources of truth used by AI and automation:

Brand voice / tone rules
Compliance statements / disallowed outputs
Product/service facts
Mappings between concepts and channel-specific entities

Source of truth: Domain: Knowledge Bases

3) Agents

Operational AI entities that connect workspace-scoped configuration to live conversation handling:

Bind a workspace and a knowledge base
Own behavior for agent-managed channel families
Control activation state and channel assignment readiness
Serve as the effective KB owner for FB Messenger, Web chat, WhatsApp, and SMS flows

Source of truth: Agents (Domain)

4) Channels

Integrations where conversations originate (e.g., social, reviews, web chat, WhatsApp, SMS, email). Channels provide:

Identity mapping (accounts/pages/numbers)
Message/review ingestion
Outbound reply capability
Platform-specific constraints (rate limits, policies)

Channel ownership model:

KB-owned channels: Social comments and Review platforms map directly to a knowledge base.
Agent-owned channels: FB Messenger, Web chat, WhatsApp, and SMS inherit their effective knowledge base from the assigned agent.

Source of truth: Domain: Channels

5) Apps

User-facing workflows that apply AI + policy + KB knowledge to a task:

Comment Responder (reviews/comments automation + moderation)
Chatti Live (real-time conversations + agent support)
Account (workspace + admin management)
Billing and subscription management

Source of truth: Domain: Apps (Surfaces)

Rule of thumb

Routes/pages document composition and UX states.
Domain docs define canonical rules (permissions, compliance, automation constraints).