---
title: "System map — how everything connects"
description: "How ComStack's channels, website surfaces, knowledge brain, and employee tools connect — a system map written for AI agents and integrators."
url: "https://comstack.ai/docs/concepts/system-map/"
---
## One map of the whole system

Every ComStack deployment is one system: customers reach the business through remote, web, and in-person channels; every channel draws on the same Knowledge Brain; and employees maintain that brain through the MCP server and the app. This page is the canonical topology — written primarily for AI agents that need to understand how the pieces connect before acting on them.

```mermaid
flowchart TD

  user["User"]

  %% Remote channels
  subgraph remoteChannels["Remote channels"]
    direction TB

    mobileRemote["Mobile"]
    phoneLine["Phone Line"]
    whatsapp["WhatsApp"]

    mobileRemote --> phoneLine
  end

  %% AI-assisted discovery
  subgraph aiDiscovery["AI-assisted discovery"]
    direction TB

    llmUser["LLM<br/>(User)"]

    subgraph websiteGroup["Website"]
      direction TB

      subgraph aiSurfaces["AI-facing surfaces"]
        direction TB
        llmsTxt["llms.txt<br/>LLM reads this first"]
        knowledgePages["Knowledge Pages<br/>AEO-optimized pages"]
        apis["APIs<br/>Structured access for tools and agents"]

        llmsTxt --> knowledgePages
        llmsTxt --> apis
      end

      subgraph humanSurfaces["Human-facing surfaces"]
        direction TB
        customPages["Custom Pages<br/>Rich webpages for humans"]
        livePage["Live Page<br/>Talk to the page, widgets appear"]
      end
    end

    llmUser --> llmsTxt
  end

  %% In-person location
  subgraph locationChannels["In-person location"]
    direction TB

    mobileLocation["Mobile"]
    qrCode["QR Code<br/>Opened on the user's mobile"]
    kiosk["Kiosk<br/>iPad, tablet, or similar"]

    mobileLocation --> qrCode
  end

  brain["Knowledge Brain<br/>Knowledge base, skill library, documents, workflows, tools"]

  %% Employee side
  subgraph employeeTools["Employee tools"]
    direction TB

    mcp["MCP Server"]
    llmEmployee["LLM<br/>(Employee)"]
    app["App<br/>Voice management, VoIP, updates, admin actions"]
    employee["Employee"]

    mcp --> llmEmployee
    llmEmployee --> employee
    app --> employee
  end

  %% User entry points
  user --> mobileRemote
  user --> whatsapp
  user --> websiteGroup
  user --> llmUser
  user --> mobileLocation
  user --> kiosk

  %% Channels into brain
  phoneLine --> brain
  whatsapp --> brain

  knowledgePages --> brain
  apis --> brain
  customPages --> brain
  livePage --> brain

  qrCode --> brain
  kiosk --> brain

  %% Employee tools from brain
  brain --> mcp
  brain --> app
```

## Connection rules

These rules are the contract the diagram draws. They hold for every ComStack deployment.

* The user can interact with the business remotely through the website, WhatsApp, and the phone line.
* The user reaches the phone line through mobile.
* The user can also open a QR code through mobile when physically present at the company location.
* The QR code and the kiosk belong to the in-person location channel.
* The kiosk is a physical device such as an iPad, tablet, or similar.
* The website is a grouped channel with AI-facing and human-facing surfaces.
* The user-facing LLM sits between the user and the website.
* The user-facing LLM reads `llms.txt` first.
* `llms.txt` points to knowledge pages and APIs.
* `llms.txt` does not point to custom pages or the live page.
* The phone line, WhatsApp, the website, the QR code, and the kiosk all connect to the same Knowledge Brain.
* The Knowledge Brain represents the company knowledge base, skill library, documents, workflows, tools, and structured business logic.
* Employees interact with the Knowledge Brain through the MCP server → LLM → employee path.
* Employees also interact through the app.
* The app includes voice management, VoIP, content updates, admin actions, and operational workflows.

## What each part is

**Remote channels.** The phone line answers calls in any language and is reached from a mobile phone; WhatsApp carries voice and chat in one thread. Both draw answers from the Knowledge Brain. See [channels](/product/channels.md).

**AI-assisted discovery.** When a user asks their own AI assistant about the business, that assistant reads `llms.txt` first, which points it to the AEO-optimized knowledge pages and the structured APIs. Custom pages and the live page are built for humans, not for assistant ingestion — they are deliberately absent from `llms.txt`. See [AI discovery](/docs/concepts/ai-discovery.md).

**Human-facing web surfaces.** Custom pages are rich, free-form webpages; the live page is the voice surface where a visitor talks to the site and interactive widgets appear in the conversation. See [custom pages](/docs/custom-pages.md).

**In-person location.** A QR code opens the same assistant on the visitor's own phone; a kiosk — an iPad, tablet, or similar — offers it at the front desk. Both are the live experience bound to the physical location.

**Knowledge Brain.** The single source of truth: the company knowledge base, skill library, documents, workflows, tools, and structured business logic. Every channel above reads from it, so an answer is the same on a phone call, in WhatsApp, on the website, and at the kiosk — in every language. See [translations](/docs/concepts/translations.md).

**Employee tools.** Employees maintain the brain in two ways: through the [MCP server](/docs/mcp.md) — connecting Claude, ChatGPT, or any MCP-capable agent to edit content, manage settings, and publish — and through the app, which covers voice management, VoIP, content updates, admin actions, and operational workflows. The [REST APIs](/docs/api.md) underpin both.

## Related

* [AI discovery and SEO](/docs/concepts/ai-discovery.md)
* [Translation system](/docs/concepts/translations.md)
* [MCP server overview](/docs/mcp.md)
* [REST API overview](/docs/api.md)
* [Custom pages](/docs/custom-pages.md)
* [Channels — reach customers everywhere](/product/channels.md)