...
Регуляторика: передача персональных данных (ФИО, телефон) → требования 152-ФЗ.
В Догма используется логика ручной модерации при неоднозначной уникальности в ЦФО — может противоречить ожиданию «моментального ответа».
Риск DDOS-атак.
...
Агент отправляет заявку в ТА.
Оператор ТА вручную заполняет данные создает лид в ЛК АН, заполняя данные клиента( Телефон клиента, Имя клиента, Объект недвижимости, Комментарий "Клиенту не звонить. Связь через агента 'Имя агента' 'Телефон агента'").
ЛК АН производит проверку и возвращает результат (уникален/неуникален).
Оператор ТА вручную переносит ответ в систему ТА.
Можно работать/Нельзя работать/ Проверка контакта).
- Для ЦФО в случае пересечения номера телефона с лидами в Б24 происходит ручная проверка оператором КЦ Догмы. Во время проверки лид в ЛК АН имеет статус "Проверка контакта".
- В случае уникальности клиента в ЦФО создается лид в Б24 - фиксация на 20 дней за агентством, по другим регионам лид в Б24 не создается.
Оператор ТА просматривает статус полученный в ЛК АН, затем устанавливает статус в интерфейсе ТА. Если лид имеет статус "Нельзя работать" то устанавливает "Неуникальный".
Если лид имеет статус "Можно работать", то:
- для ЦФО устанавливает статус "Зафиксирован" и устанавливает дату фиксацию 20 дней
- для остальных регионов устанавливает статус "Уникальный - не зафиксирован"Агент получает решение.
...
4.2. Процесс TO BE
Агент отправляет заявку в ТрендАгентТА.
ТА автоматически формирует запрос к API Догма.
Догма:
выполняет автоматическую проверку телефона;
если однозначно → возвращает ответ "Уникальный/ Неуникальный" и срок фиксации;
если случай неоднозначный → формирует промежуточный статус "Ручная проверка".ЛК АН производит проверку и отправляет ответ ТА (Можно работать/Нельзя работать/Проверка контакта)
ТА получает ответ API и отображает его агенту(Статус и Дату фиксации, если она есть).
При статусе «Ручная проверка» ТА должен периодически запрашивать «Проверка контакта» после изменения статуса ЛК АН передает актуальный статус статус.
ЛК АН на создание лида( Телефон клиента, Имя клиента, Объект недвижимости, Комментарий "Клиенту не звонить. Связь через агента 'Имя агента' 'Телефон агента'").
...
5. Бизнес-требования
5.1. Пользовательские истории (US)
US1. Как агент, я хочу в интерфейсе ТрендАгент ТА мгновенно проверять уникальность клиента, чтобы понимать, могу ли я работать с ним.
US2. Как оператор ТА, я хочу избавиться от ручного ввода в ЛК Dogma, чтобы избежать ошибок и ускорить обработку лидов.
...
Автоматическая проверка клиента
Система должна автоматически передавать данные клиента из ТА в ЛК АН и получать результат проверки уникальности без участия сотрудников.Возврат статуса проверки
Система должна возвращать один из статусов:Уникальный — с указанием срока фиксацииМожно работать;
Неуникальный;
Ручная проверка Нельзя работать;
Проверка контакта.
- Поддержка ручной модерации
Если по внутренним правилам Догмы требуется участие менеджера, система должна уметь передавать статус ожидания ручной проверки(Проверка контакта) и предоставлять возможность получать итоговый результат позже(Можно работать/Нельзя работать). - Передача даты фиксации
Если объект фиксируется по внутренним правилам Догмы, то система должна передавать данные о крайней дате фиксации. Контроль нагрузки и частоты обращений
Система должна обеспечивать защиту от чрезмерного количества запросов и некорректных обращений, чтобы предотвратить сбои и злоупотребления.Корректная обработка ошибок
В случае некорректных данных или технических проблем система должна возвращать понятные и однозначные статусы ошибок, чтобы ТА мог корректно уведомить пользователей.Поддержка ручной модерации
Если по внутренним правилам Догмы требуется участие менеджера, система должна уметь передавать статус ожидания ручной проверки и предоставлять возможность получать итоговый результат позже.
...
5.3. Нефункциональные требования
...
При запросе от ТА API возвращает корректный статус уникальности.
В ЛК Догма АН корректно фиксируется лид, созданный ТА.Ручные проверки корректно обрабатываются и возвращаются
После ручной проверки(Проверка контакта) обновленный статус лида(Можно работать/Нельзя работать) передается ТА.
- Если объект фиксируется, то крайняя дата фиксации передается ТА.
Сотрудник ТА полностью не участвует в проверке уникальности.
...
6
...
. Соответствие статусов систем
...
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 (договор на обработку персональных данных)?
...