CRM - Проверка надёжности клиентов

Компоненты решения:

Примеры инструментов:

Сфера:

Контекст

В твоей компании есть CRM с собственной базой данных в которой хранятся сведения о контрагентах. При заключении сделок с b2b контрагентами нужно учитывать признаки неблагонадежности, но в БД сейчас нет таких данных.

Задание

Перед тобой поставлена задача дополнить данные о контрагентах результатами проверок.
Тебе нужно помочь компании упростить проверку клиентов перед заключением договоров - особенно важно предотвратить сотрудничество с неблагонадежными организациями - теми, которые находятся в состоянии банкротства или счета которых заблокированы.

Итак, тебе нужно дополнить данные клиентов-юридических лиц на основе уже имеющихся сведений, добавив из портала открытых данных информацию об их руководителях, ИНН и ОКВЭД, признаки банкротства или блокировки счетов.
Получить эти данные можно через api ФНС https://api-fns.ru/api_help#section_check

Сейчас для большинства компаний эта информация не заполнена и при заключении договора приходится тратить время на проверки и запросы.

Изменения в структуру таблиц должны вноситься кодом, язык программирования на твое усмотрение, использовать ORM или нет - решать тебе.
Должно быть реализовано подробное логирование.

Мы подготовили для тебя тестовую базу в docker контейнере, скачать можно по ссылке (тут будет ссылка), для запуска выполни в директории проекта

docker compose up

База данных будут доступна по адресу 127.0.0.1:3306, логин admin, пароль admin.
Мы рекомендуем дополнительно реализовать простой API или пару веб-страниц для демонстрации результатов:

• для получения списка всех контрагентов с отметками о блокировках счета и банкротстве;
• для получения полных сведений о результате проверки конкретного контрагента по его id в БД.

У вас есть часть выгрузки клиентов компании - таблица с полями:
a. Название компании
b. Адрес
c. ИНН
d. ОКВЭД
e. Фио Директора
f. Должность директора

Название компании и адрес заполнены всегда. Остальные поля могут быть заполнены или не заполнены.

Ваша задача - получить через API с портала открытых данных недостающие данные для этих компаний. Выполните проверку полученных с помощью API внешних данных на корректность, а также проверьте, не существует ли уже эта информация в таблице. Если она существует и выглядит соответственно нужному формату, то такую информацию перезаписывать нельзя. Если информация не существует или явно некорректна (слишком мало символов, не те символы), то ее нужно перезаписать. По итогам работы вашей программы должен создаваться подробный файл лога, отражающий количество найденных и ненайденных сведений, возможные ошибки.

Артефакты проекта:
API открытых данных юр.лиц - https://api-fns.ru/api_help#section_poisk
Вводный датасет тут.

Уровень

Как отправить результaт на проверку

1. Скачайте шаблон презентации для решения задачи (ссылка).
2. Оформите свое решение в шаблоне презентации.
3. Загрузите исходные материалы в облачное хранилище (Google Drive, Яндекс.Диск).
4. Проверьте настройки доступа к просмотру и комментированию всех материалов.
5. Заполнить форму на сайте и отправьте ссылку на презентацию с решением кейса.

Есть вопросы по решению, нужна дополнительная консультация или фидбек от эксперта-разработчика?
Cсылка на телеграм-канал Ясенкейс: https://t.me/+2JBtbJfoT94yMTNi

Упакуй результат в Git-портфолио:

• Код (репозиторий GitHub / GitLab) и APK-файл.
• Макеты интерфейса (скриншоты, Figma).
• Конкурентный анализ - таблица или описание аналогичных сервисов.
• Документация о ходе решения: Что требовалось сделать (краткое резюме задания кейса); Что было сделано; Какие решения были приняты, что дополнено, додумано, усовершенствовано по сравнению с исходными требованиями.
• С какими проблемами ты столкнулся (столкнулась) и как они были преодолены.
• Видеопрезентация 3-5 минут (опционально).

Образец выполненного кейса: ссылка

Представители компаний подтвердили актуальность кейса и свою заинтересованность в специалистах, способных представить его решение.