Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)
    1. Документация
    2. /Функции
    3. /Email AI-CRM
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Документация
    2. /Функции
    3. /Email AI-CRM
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Документация
    2. /Функции
    3. /Email AI-CRM
    Обновлено 10 июн. 2026 г.2 мин прослушивания
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    Email AI-CRM

    AI-управляемый CRM для публичных почтовых ящиков (например info@example.com). Входящая почта классифицируется и собирается в треды; Claude формирует черновики ответов; админы утверждают отправку и видят расходы API.

    EN canonical: полные диаграммы, таблицы API и runbook — Email AI-CRM (EN) · Архитектура · API · Гайд разработчика

    Обзор

    СлойОтветственность
    СборCron POST /api/cron/email-processor (action: poll) или webhook
    Процессорservices/email/email-processor.ts — parse, security, AI, CRM
    ХранениеPostgreSQL JSONB: email_threads, email_contacts, email_messages, email_drafts, email_tasks, email_api_usage
    ИсходящиеEmailSenderService (nodemailer), In-Reply-To / References
    Админ UIinbox, drafts, contacts, analytics, tasks

    Бизнес-правила

    • Дедуп Message-ID — один RFC Message-ID не обрабатывается дважды.
    • Auto-send выключен — EMAIL_AUTO_SEND_ENABLED=false до SMTP smoke test.
    • Cron poll в продакшне — каждые 1–5 мин; IDLE только для долгоживущего Node (EMAIL_PROCESSOR_AUTOSTART).
    • Admin API — auth() + isPlatformAdmin на /api/admin/email/*.

    Путь админа

    Маршруты админ UI

    МаршрутНазначение
    /{locale}/admin/crm/inboxСписок тредов
    /{locale}/admin/crm/inbox/[id]Детали треда + сообщения
    /{locale}/admin/crm/draftsЧерновики AI — approve / reject / send
    /{locale}/admin/crm/contactsCRM-контакты
    /{locale}/admin/crm/analyticsОбъём, intent/sentiment, стоимость API
    /{locale}/admin/crm/tasksFollow-up и эскалации

    Пайплайн

    1. Parse → 2. 4-слойный security → 3. AI (Haiku + Sonnet) → 4. CRM + tasks → 5. Очередь черновиков → 6. Уведомления (in-app / Slack).

    База данных

    МиграцияТаблицы
    009_email_crm_jsonb.sqlemail_threads, email_contacts, email_messages, email_drafts
    010_email_crm_tasks_jsonb.sqlemail_tasks, email_api_usage

    Локальная конфигурация

    Добавьте в .env.local (см. env.local.template, блок EMAIL CRM):

    ПеременнаяОписание
    IMAP_* / SMTP_*Ваш community inbox (любой IMAP/SMTP)
    ANTHROPIC_API_KEYIntent, sentiment, генерация черновиков
    CRON_SECRETBearer для /api/cron/email-processor
    EMAIL_AUTO_SEND_ENABLEDfalse до SMTP smoke test
    EMAIL_CRM_PERSISTENCEmemory для быстрого dev; omit + миграции 009/010 для Postgres

    Продакшн

    Те же переменные — в secret store (k8s/Vercel). Миграции 009+010, cron poll каждые 1–5 мин. См. гайд разработчика.

    Связанное

    • Миграции
    • Environment — Email AI-CRM
    • Backend modes

    Email AI-CRM

    AI-управляемый CRM для публичных почтовых ящиков (например info@example.com). Входящая почта классифицируется и собирается в треды; Claude формирует черновики ответов; админы утверждают отправку и видят расходы API.

    EN canonical: полные диаграммы, таблицы API и runbook — Email AI-CRM (EN) · Архитектура · API · Гайд разработчика

    Обзор

    СлойОтветственность
    СборCron POST /api/cron/email-processor (action: poll) или webhook
    Процессорservices/email/email-processor.ts — parse, security, AI, CRM
    ХранениеPostgreSQL JSONB: email_threads, email_contacts, email_messages, email_drafts, email_tasks, email_api_usage
    ИсходящиеEmailSenderService (nodemailer), In-Reply-To / References
    Админ UIinbox, drafts, contacts, analytics, tasks

    Бизнес-правила

    • Дедуп Message-ID — один RFC Message-ID не обрабатывается дважды.
    • Auto-send выключен — EMAIL_AUTO_SEND_ENABLED=false до SMTP smoke test.
    • Cron poll в продакшне — каждые 1–5 мин; IDLE только для долгоживущего Node (EMAIL_PROCESSOR_AUTOSTART).
    • Admin API — auth() + isPlatformAdmin на /api/admin/email/*.

    Путь админа

    Маршруты админ UI

    МаршрутНазначение
    /{locale}/admin/crm/inboxСписок тредов
    /{locale}/admin/crm/inbox/[id]Детали треда + сообщения
    /{locale}/admin/crm/draftsЧерновики AI — approve / reject / send
    /{locale}/admin/crm/contactsCRM-контакты
    /{locale}/admin/crm/analyticsОбъём, intent/sentiment, стоимость API
    /{locale}/admin/crm/tasksFollow-up и эскалации

    Пайплайн

    1. Parse → 2. 4-слойный security → 3. AI (Haiku + Sonnet) → 4. CRM + tasks → 5. Очередь черновиков → 6. Уведомления (in-app / Slack).

    База данных

    МиграцияТаблицы
    009_email_crm_jsonb.sqlemail_threads, email_contacts, email_messages, email_drafts
    010_email_crm_tasks_jsonb.sqlemail_tasks, email_api_usage

    Локальная конфигурация

    Добавьте в .env.local (см. env.local.template, блок EMAIL CRM):

    ПеременнаяОписание
    IMAP_* / SMTP_*Ваш community inbox (любой IMAP/SMTP)
    ANTHROPIC_API_KEYIntent, sentiment, генерация черновиков
    CRON_SECRETBearer для /api/cron/email-processor
    EMAIL_AUTO_SEND_ENABLEDfalse до SMTP smoke test
    EMAIL_CRM_PERSISTENCEmemory для быстрого dev; omit + миграции 009/010 для Postgres

    Продакшн

    Те же переменные — в secret store (k8s/Vercel). Миграции 009+010, cron poll каждые 1–5 мин. См. гайд разработчика.

    Связанное

    • Миграции
    • Environment — Email AI-CRM
    • Backend modes

    Email AI-CRM

    AI-управляемый CRM для публичных почтовых ящиков (например info@example.com). Входящая почта классифицируется и собирается в треды; Claude формирует черновики ответов; админы утверждают отправку и видят расходы API.

    EN canonical: полные диаграммы, таблицы API и runbook — Email AI-CRM (EN) · Архитектура · API · Гайд разработчика

    Обзор

    СлойОтветственность
    СборCron POST /api/cron/email-processor (action: poll) или webhook
    Процессорservices/email/email-processor.ts — parse, security, AI, CRM
    ХранениеPostgreSQL JSONB: email_threads, email_contacts, email_messages, email_drafts, email_tasks, email_api_usage
    ИсходящиеEmailSenderService (nodemailer), In-Reply-To / References
    Админ UIinbox, drafts, contacts, analytics, tasks

    Бизнес-правила

    • Дедуп Message-ID — один RFC Message-ID не обрабатывается дважды.
    • Auto-send выключен — EMAIL_AUTO_SEND_ENABLED=false до SMTP smoke test.
    • Cron poll в продакшне — каждые 1–5 мин; IDLE только для долгоживущего Node (EMAIL_PROCESSOR_AUTOSTART).
    • Admin API — auth() + isPlatformAdmin на /api/admin/email/*.

    Путь админа

    Маршруты админ UI

    МаршрутНазначение
    /{locale}/admin/crm/inboxСписок тредов
    /{locale}/admin/crm/inbox/[id]Детали треда + сообщения
    /{locale}/admin/crm/draftsЧерновики AI — approve / reject / send
    /{locale}/admin/crm/contactsCRM-контакты
    /{locale}/admin/crm/analyticsОбъём, intent/sentiment, стоимость API
    /{locale}/admin/crm/tasksFollow-up и эскалации

    Пайплайн

    1. Parse → 2. 4-слойный security → 3. AI (Haiku + Sonnet) → 4. CRM + tasks → 5. Очередь черновиков → 6. Уведомления (in-app / Slack).

    База данных

    МиграцияТаблицы
    009_email_crm_jsonb.sqlemail_threads, email_contacts, email_messages, email_drafts
    010_email_crm_tasks_jsonb.sqlemail_tasks, email_api_usage

    Локальная конфигурация

    Добавьте в .env.local (см. env.local.template, блок EMAIL CRM):

    ПеременнаяОписание
    IMAP_* / SMTP_*Ваш community inbox (любой IMAP/SMTP)
    ANTHROPIC_API_KEYIntent, sentiment, генерация черновиков
    CRON_SECRETBearer для /api/cron/email-processor
    EMAIL_AUTO_SEND_ENABLEDfalse до SMTP smoke test
    EMAIL_CRM_PERSISTENCEmemory для быстрого dev; omit + миграции 009/010 для Postgres

    Продакшн

    Те же переменные — в secret store (k8s/Vercel). Миграции 009+010, cron poll каждые 1–5 мин. См. гайд разработчика.

    Связанное

    • Миграции
    • Environment — Email AI-CRM
    • Backend modes
    bash
    
psql "$DATABASE_URL" -f data/migrations/009_email_crm_jsonb.sql
psql "$DATABASE_URL" -f data/migrations/010_email_crm_tasks_jsonb.sql
    bash
    
# .env.local
IMAP_HOST=mail.example.com
IMAP_USER=info@example.com
IMAP_PASSWORD=

SMTP_HOST=mail.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=info@example.com
SMTP_PASSWORD=

ANTHROPIC_API_KEY=

CRON_SECRET=generate-a-long-random-string
EMAIL_AUTO_SEND_ENABLED=false
EMAIL_CRM_PERSISTENCE=memory
    bash
    
psql "$DATABASE_URL" -f data/migrations/009_email_crm_jsonb.sql
psql "$DATABASE_URL" -f data/migrations/010_email_crm_tasks_jsonb.sql
    bash
    
# .env.local
IMAP_HOST=mail.example.com
IMAP_USER=info@example.com
IMAP_PASSWORD=

SMTP_HOST=mail.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=info@example.com
SMTP_PASSWORD=

ANTHROPIC_API_KEY=

CRON_SECRET=generate-a-long-random-string
EMAIL_AUTO_SEND_ENABLED=false
EMAIL_CRM_PERSISTENCE=memory
    bash
    
psql "$DATABASE_URL" -f data/migrations/009_email_crm_jsonb.sql
psql "$DATABASE_URL" -f data/migrations/010_email_crm_tasks_jsonb.sql
    bash
    
# .env.local
IMAP_HOST=mail.example.com
IMAP_USER=info@example.com
IMAP_PASSWORD=

SMTP_HOST=mail.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=info@example.com
SMTP_PASSWORD=

ANTHROPIC_API_KEY=

CRON_SECRET=generate-a-long-random-string
EMAIL_AUTO_SEND_ENABLED=false
EMAIL_CRM_PERSISTENCE=memory