mxDadata
Подсказки DaData и валидация адреса для MiniShop3 в MODX 3
Админка в MODX
Раздел Extras → mxDadata: дашборд, ключи API, настройки интеграции с MiniShop3, кэш, логи, тест Party по ИНН. Интерфейс на Vue (сборка в assets/components/mxdadata/js/mgr/vue-dist/).
Скриншоты
Иллюстрации раздела (дашборд, API, логи) планируется добавить в эту страницу после публикации стабильных превью. Пока ориентируйтесь на раздел Вкладки (обзор) ниже.
Требования
Нужен VueTools. Без него пункт меню может открываться с предупреждением. На витрину и сниппеты VueTools не влияет.
Вкладки (обзор)
| Раздел | Назначение |
|---|---|
| Dashboard | KPI: статус API, баланс (руб.), запросы и ошибки за сегодня, блоки «Подключение», «Юрлица», «Логи» |
| API | Token, Secret, таймаут, retry, Тест соединения |
| miniShop3 | Валидация, блокировка заказа, нормализация адреса, обязательный FIAS/индекс, маппинг JSON |
| Кеш | TTL, текущее состояние, Очистить кеш |
| Логи | Таблица запросов, фильтры, просмотр request/response, Ротация логов |
| Юрлица | Поиск по ИНН, таблица полей автозаполнения (как в сниппете Party), сырой JSON |
| Общие | Включение компонента, режим разработки, хранение логов (дней), уровень логирования, throttling |
Dashboard
- Карточки Статус, Баланс, Запросы сегодня, Ошибки сегодня
- Блок Подключение — тест API, текущий TTL кэша, кнопка очистки кэша
- Блок Юрлица — поле ИНН, кнопка поиска, таблица соответствия полей формы
- Блок Логи — краткий доступ к фильтрам и ротации
API
- Кабинет DaData — скопируйте Token и Secret
- Вставьте в поля, Сохранить
- Тест соединения — при успехе отображается подтверждение
Кеш
Удаляет записи в таблице mxdadata_cache (не файловый кэш MODX). После смены TTL или подозрения на устаревшие подсказки нажмите Очистить кеш.
Логи
- Фильтры: тип запроса, статус, даты
- Просмотр: модальное окно с request/response
- Ротация: удаление записей старше N дней (
mxdadata_log_retention_days). Для cron можно использовать пакет Scheduler (если настроен в проекте)
Юрлица (Party)
Проверка соответствия API и справочника: введите ИНН — увидите те поля, которые mxDadataPartySuggest может подставить в форму (inn, company_name, kpp, ogrn, юр. адрес и т.д.).
Режим разработки
Общие → Режим разработки — усиливает детализацию в логах. Для отладки на витрине см. также mxdadata_debug_mode и ?mxdadata_debug=1 в Интеграции.