...
Регуляторика: передача персональных данных (ФИО, телефон) → требования 152-ФЗ.
В Догма используется логика ручной модерации при неоднозначной уникальности в ЦФО — может противоречить ожиданию «моментального ответа».
Риск DDOS-атак.
...
Агент отправляет заявку в ТА.
Оператор ТА вручную заполняет данные создает лид в ЛК АН, заполняя данные клиента( Телефон клиента, Имя клиента, Объект недвижимости, Комментарий "Клиенту не звонить. Связь через агента 'Имя агента' 'Телефон агента'").
ЛК АН производит проверку и возвращает результат (Контакт уникален/неуникален).
Оператор ТА вручную переносит ответ в систему ТА.
Контакт не уникален/ Проверка контакта).
- Для ЦФО в случае пересечения номера телефона с лидами в Б24 происходит ручная проверка оператором КЦ Догмы. Во время проверки лид в ЛК АН имеет статус "Проверка контакта".
- В случае уникальности клиента в ЦФО создается лид в Б24 - фиксация на 20 дней за агентством, по другим регионам лид в Б24 не создается.
Оператор ТА просматривает статус полученный в ЛК АН, затем устанавливает статус в интерфейсе ТА. Если лид имеет статус "Контакт не уникален" то устанавливает "Неуникальный".
Если лид имеет статус "Контакт уникален", то:
- для ЦФО устанавливает статус "Зафиксирован" и устанавливает дату фиксацию 20 дней
- для остальных регионов устанавливает статус "Уникальный - не зафиксирован"Агент получает решение.
...
4.2. Процесс TO BE
Агент отправляет заявку в ТрендАгентТА.
ТА автоматически формирует запрос к API Догма.
Догма:
выполняет автоматическую проверку телефона;
если однозначно → возвращает ответ "Уникальный/ Неуникальный" и срок фиксации;
если случай неоднозначный → формирует промежуточный статус "Ручная проверка".
ЛК АН на создание лида( Телефон клиента, Имя клиента, Объект недвижимости, Комментарий "Клиенту не звонить. Связь через агента 'Имя агента' 'Телефон агента'").
ЛК АН производит проверку и отправляет ответ ТА (Контакт уникален/Контакт не уникален/Проверка контакта)
ТА получает ответ API и отображает его агенту(Статус и Дату фиксации, если она есть).
При статусе «Ручная проверка» ТА должен периодически запрашивать актуальный «Проверка контакта» после изменения статуса ЛК АН передает актуальный статус статус.
...
5. Бизнес-требования
...
US1. Как агент, я хочу в интерфейсе ТрендАгент ТА мгновенно проверять уникальность клиента, чтобы понимать, могу ли я работать с ним.
US2. Как оператор ТА, я хочу избавиться от ручного ввода в ЛК Dogma, чтобы избежать ошибок и ускорить обработку лидов.
...
Автоматическая проверка клиента
Система должна автоматически передавать данные клиента из ТА в ЛК АН и получать результат проверки уникальности без участия сотрудников.Возврат статуса проверки
Система должна возвращать один из статусов:Уникальный — с указанием срока фиксацииКонтакт уникален;
Неуникальный;
Ручная проверка Контакт не уникален;
Проверка контакта.
- Поддержка ручной модерации
Если по внутренним правилам Догмы требуется участие менеджера, система должна уметь передавать статус ожидания ручной проверки(Проверка контакта) и предоставлять возможность получать итоговый результат позже(Контакт уникален/Контакт не уникален). - Передача даты фиксации
Если объект фиксируется по внутренним правилам Догмы, то система должна передавать данные о крайней дате фиксации. Контроль нагрузки и частоты обращений
Система должна обеспечивать защиту от чрезмерного количества запросов и некорректных обращений, чтобы предотвратить сбои и злоупотребления.Корректная обработка ошибок
В случае некорректных данных или технических проблем система должна возвращать понятные и однозначные статусы ошибок, чтобы ТА мог корректно уведомить пользователей.Поддержка ручной модерации
Если по внутренним правилам Догмы требуется участие менеджера, система должна уметь передавать статус ожидания ручной проверки и предоставлять возможность получать итоговый результат позже.
...
5.3. Нефункциональные требования
...
При запросе от ТА API возвращает корректный статус уникальности.
В ЛК Догма АН корректно фиксируется лид, созданный ТА.Ручные проверки корректно обрабатываются и возвращаются
После ручной проверки(Проверка контакта) обновленный статус лида(Контакт уникален/Контакт не уникален) передается ТА.
- Если объект фиксируется, то крайняя дата фиксации передается ТА.
Сотрудник ТА полностью не участвует в проверке уникальности.
...
6.
...
Соответствие статусов систем
| № | ЛК АН | ТА | Комментарий |
|---|---|---|---|
| 1 | Процесс | Проверка уникальности клиента | Автоматическая проверка лида на уникальность |
| 2 | Контакт уникален | Уникальный - не зафиксирован/ Зафиксирован | Положительный результат. В зависимости от региона, в ЦФО - Зафиксирован, в остальных Уникальный - не зафиксирован |
| 3 | Контакт не уникален | Неуникальный | Отрицательный результат |
| 4 | Проверка контакта | Проверка уникальности клиента | Ручная проверка лида специалистом КЦ Догмы |
...
7. Артефакты
- Запись процесса работы оператора ТА без фиксации: https://disk.360.yandex.ru/d/Bjuu8wtNdbvnfA
- Запись процесса работы оператора ТА с фиксацией: https://disk.360.yandex.ru/i/SGVnlUXfncnMZQ
...
API Dogma — конечная точка /clients/fixation (из спецификации).
Интерфейс ТрендАгент — форма подачи заявки и отображение результата проверки.
Интерфейс ЛК Dogma — карточка клиента, статусы фиксации.
7. Артефакты
Спецификация API фиксации клиента ТрендАгент (PDF)
TrendAgent интеграция
Запись встречи (текст протокола).
Бизнес-логика проверки уникальности в Dogma (внутренний документ — необходимо получить).
Блок 2 — Список уточняющих вопросов
К бизнесу Dogma
Какие SLA считаются приемлемыми для API проверки уникальности (время ответа)?
Требуется ли поддержка промежуточного статуса для ручной модерации через API? Как должен выглядеть ответ API в таких случаях?
Нужен ли механизм получения статуса вручную проверяемых лидов (pull или webhook)?
Как должен вести себя API, если сервис уникальности временно недоступен?
Нужно ли ограничивать количество запросов от ТрендАгент? Какие лимиты?
Каков срок хранения логов API?
Нужно ли выводить историю проверок со стороны ТА в ЛК Dogma?
К ТрендАгент
Обязательны ли для передачи все поля ФИО или можно ограничиться phone + name?
Как отображается статус «ожидает ручной проверки» в интерфейсе ТА?
Нужно ли агенту возвращать финальный статус автоматически или по запросу?
К архитектору / разработке Dogma
Есть ли тестовое API-окружение или его нужно создать?
Существуют ли ограничения на интеграцию внешних сервисов в ЛК агент?
Какой формат должен быть у токена для ТА?
Как будет идентифицироваться юрлицо «Платформа Юг» при фиксации?
Как обрабатывается логика «агрегатор» — действительно ли фиксированный срок фиксации и отсутствие плавающих параметров?
К службе безопасности
Какие требования предъявляются к внешним интеграциям (IP whitelist, VPN, frequency limits)?
Можно ли ТА получить доступ к боевому API напрямую или потребуется шлюз?
- Требуется ли заключения DPA (договор на обработку персональных данных)?
...