Skip to main content
Этот документ объясняет основные типы данных в системе: пользователи, компании, объявления, чаты и сообщения.

​
1. Пользователь

​
Что это

Пользователь = человек, который работает в системе

​
Какая информация хранится

ИнформацияПримерОбязательно
IDuser123Да
ИмяИванНет
ФамилияИвановНет
Номер телефона+7 999 123-45-67Да
Фото профиляURL на фотоНет
Дата регистрации2025-01-10Да
Тип последнего входаТелефон или TelegramДа

​
Связи с другими сущностями

​
Роли пользователя в компании

Пользователь может иметь одну из трёх ролей в каждой компании:
  • MAINTAINER — владелец/администратор
  • RESPONSIBLE — ответственный
  • MANAGER — менеджер
Более подробно в документе Роли и права доступа

​
2. Компания

​
Что это

Компания = агентство недвижимости, индивидуальный риэлтор или call-центр

​
Какая информация хранится

ИнформацияПримерОбязательно
IDcompany123Да
НазваниеИванов и партнёрыДа
Юридический адресг. Москва, ул. Пушкина, 10Нет
ИНН7701234567Нет
ОГРН102700009000Нет
БанкСбербанкBusinessНет
Расчётный счёт40702810000000000000Нет
СтатусCOMPLETEDДа
Использует AvitoДа/НетДа
Использует CianДа/НетДа
Использует DomclickДа/НетДа
Дата создания2025-01-10Да

​
Статусы компании

Компания всегда в одном из статусов:
  • NEW — только что создана
  • WAITING_FOR_PROVIDER_SELECTION — нужно выбрать платформы
  • WAITING_FOR_AVITO_FEED — нужно указать XML фид
  • WAITING_FOR_AVITO_ACCESS — нужна OAuth авторизация в Avito
  • WAITING_FOR_CIAN_ACCESS — нужен токен Cian (если выбран)
  • WAITING_FOR_DOMCLICK_ACCESS — нужны токены Domclick (если выбран)
  • WAITING_FOR_FULL_SYNCHRONIZATION — идёт синхронизация данных
  • COMPLETED — готова к работе
Подробнее: Статусы

​
Связи с другими сущностями

​
3. Объявление

​
Что это

Объявление = конкретное предложение недвижимости (квартира, дом, комната и т.д.)

​
Какая информация хранится

ИнформацияПримерГде берётся
IDad123Генерируется системой
Адресг. Москва, ул. Пушкина, д. 10, кв. 5XML фид Avito
Описание2-комнатная квартира, свежий ремонтXML фид
Цена50000 рублейXML фид
Количество комнат2XML фид
Площадь65.5 кв.мXML фид
Номер телефона менеджера+7 999 111-22-33XML фид
ФотографияURL на главное фотоXML фид
Координаты (GPS)55.7558, 37.6173XML фид или сама система
Этаж3XML фид
Всего этажей5XML фид
ID на Avitoavito_456789API Avito
ID на Ciancian_555666API Cian (если подключен)
ID на Domclickdomclick_777888API Domclick (если подключен)

​
Привязка к менеджерам

Объявление привязано к менеджеру через номер телефона:

​
4. Чат

​
Что это

Чат = переписка с одним клиентом по одному объявлению

​
Какая информация хранится

ИнформацияПримерОписание
IDchat123Уникальный ID в Chat Bridge
Внешний IDavito_12345ID на исходной платформе
Имя клиентаМарина СмирноваКак клиент представился
Номер телефона клиента+7 999 555-66-77Если известен
Объявлениеad123К какому объявлению обсуждение
ПлатформаAvito/Cian/DomclickОткуда этот чат
Первое сообщение2025-01-12 14:20Когда начался чат
Последнее сообщение2025-01-14 15:30Когда последний раз писали
Количество сообщений5Сколько всего в чате
Непрочитанные2Сколько ещё не прочитаны

​
Привязка к менеджеру

Чат видит менеджер, к которому привязано объявление:

​
Типы сообщений в чате

В каждом чате могут быть разные типы сообщений:
  • Text — обычное текстовое сообщение
  • Image — фотография
  • File — документ или файл
  • Link — ссылка
  • Location — геолокация (адрес на карте)
  • System — системное сообщение (например, “Чат был переведён”)
  • Call — информация о звонке

​
5. Сообщение

​
Что это

Сообщение = одно отдельное сообщение в чате

​
Какая информация хранится

ИнформацияПримерОписание
IDmsg123Уникальный ID
ID в системеavito_msg_456ID на исходной платформе
Чатchat123К какому чату относится
Текст”Можно ли посмотреть в 18:00?”Содержание сообщения
ТипText, Image, File и т.д.Какой тип сообщения
НаправлениеВходящее/ИсходящееКто написал
АвторМарина / ИванКто именно написал
Дата отправки2025-01-14 15:30Когда написано
Дата прочтения2025-01-14 15:35Когда прочитано
Статус доставкиОтправлено/Доставлено/ПрочитаноСтатус доставки

​
Направление сообщения

Каждое сообщение либо входящее, либо исходящее: Входящее (In) = клиент написал менеджеру: Исходящее (Out) = менеджер ответил клиенту:

​
Статусы сообщения

  • PENDING ⏳ — сообщение в процессе отправки
  • SENT ✓ — отправлено на платформу
  • DELIVERED ✓✓ — доставлено клиенту (клиент получил уведомление)
  • READ ✓✓✓ — клиент прочитал сообщение
Не все платформы поддерживают все статусы — некоторые не отправляют информацию о прочтении.

​
6. Пригласительная ссылка

​
Что это

Пригласительная ссылка = временный “билет” для присоединения к компании

​
Какая информация хранится

ИнформацияПримерОписание
IDlink123Уникальный ID ссылки
Токенa1b2c3d4e5f6…32 символа, которые шлют новому пользователю
Компанияcompany123К какой компании привязана
Роль при входеMANAGERКакую роль получит новый пользователь
Макс. использований5Сколько раз её можно использовать (или бесконечно)
Текущее использование2Сколько раз уже использовали
Дата истечения2025-02-10Когда ссылка перестанет работать (или никогда)
Кто создалИван ИвановКакой MAINTAINER создал ссылку
Дата создания2025-01-10Когда создана

​
Как работает ссылка

​
7. Токены интеграций

​
Что это

Токен интеграции = пароль для доступа к API платформ (Avito, Cian, Domclick)

​
Avito Token

ИнформацияОписание
Access TokenИспользуется для запросов к API Avito (действует ~1 год)
Refresh TokenИспользуется для получения нового access token
Дата истеченияКогда токен перестанет работать
Статус доступностиРаботает ли токен или нет
Автоматизм: Система сама обновляет токен за час до истечения

​
Cian Token

ИнформацияОписание
Client SecretAPI токен для доступа к API Cian
Статус активностиАктивен или отключен
Обновление: Нужно обновлять вручную (генерировать новый на сайте Cian)

​
Domclick Token

ИнформацияОписание
Stats SecretТокен для доступа к статистике
Chats SecretТокен для доступа к чатам
Company IDID компании в системе Domclick
Статус активностиАктивны или отключены
Обновление: Нужно обновлять вручную (генерировать на сайте Domclick)

​
Связи между сущностями (диаграмма)

​
Примеры реальных данных

​
Пример 1: Компания с менеджерами

​
Пример 2: Чат с историей

Информация о чате:
  • Клиент: Марина Смирнова (+7 999 555-66-77)
  • Объявление: Квартира на ул. Пушкина, д. 10
  • Менеджер: Петр Петров
  • Платформа: Avito
  • Всего сообщений: 5
  • Непрочитанных: 1