Files
crm.clientright.ru/AUTO_STATUS_CHECKER_README.md
Fedor d8d453bfca Обновлен автоматический чекер статусов: добавлена иконка робота и cron
- Изменен канал комментариев на 'Telegram AI Bot' для отображения иконки робота 🤖
- Убран эмодзи из текста комментария для совместимости с БД
- Настроен cron для ежедневного запуска в 10:00
- Обновлена документация с информацией о cron и иконке
- Логи cron сохраняются в logs/auto_status_checker_cron.log
- Протестировано создание комментариев с иконкой робота
2025-10-16 19:54:07 +03:00

8.3 KiB
Raw Blame History

Автоматическая проверка статусов заявлений на исполнительный лист

Дата: 16 октября 2025
Статус: Готово к использованию

Описание

Скрипт check_exec_list_statuses.php автоматически проверяет статусы заявлений на исполнительный лист через API Debexpert и сохраняет результаты в виде комментариев к проектам.

Какие проекты проверяются

Скрипт находит проекты, которые соответствуют ВСЕМ критериям:

  1. Есть регистрационный номер заявления (поле cf_2429 не пустое)
  2. Статус проекта один из:
    • заявление на лист
    • выдача листа
    • исполнительное производство
  3. НЕТ номера исполнительного листа (поле cf_1752 пустое или "0")

Что делает скрипт

  1. Находит проекты по критериям
  2. Для каждого проекта:
    • Запрашивает статус через GetCourtStatus.php
    • Парсит ответ API
    • Формирует читаемый комментарий с данными
    • Сохраняет комментарий в проект от имени "ИИ Клиентправ" (ID 23)
  3. Логирует результаты в logs/auto_status_checker.log

Формат комментария

🤖 АВТОМАТИЧЕСКАЯ ПРОВЕРКА СТАТУСА ОБРАЩЕНИЯ

Регистрационный номер: 37RS0010-217-25-0001439
Суд: Ленинский районный суд г. Иваново
Текущий статус: Зарегистрировано

ИСТОРИЯ ДВИЖЕНИЯ ДЕЛА:

1. [ИСХОДЯЩЕЕ] Отправлено в суд
   Дата: 2025-08-29T19:02:18.782+03:00
   Документы (21):
   • 0_Iskovoe_zayavlenie_...pdf
   • Kvitantsiya_ob_otpravke...pdf
   ...

2. [ВХОДЯЩЕЕ] Проверка ЭП пройдена
   Дата: 2025-08-29T19:02:36.136+03:00
   Документы (20):
   • Protokol_proverki_...pdf
   ...

3. [ВХОДЯЩЕЕ] Зарегистрировано
   Дата: 2025-09-01T09:51:09.937+03:00
   Документы (0):

Дата проверки: 16.10.2025 19:25:40

Примечание: Иконка робота 🤖 отображается автоматически благодаря каналу "Telegram AI Bot"

Использование

Ручной запуск

cd /var/www/fastuser/data/www/crm.clientright.ru
php check_exec_list_statuses.php

Через cron (автоматический запуск)

НАСТРОЕНО: Скрипт автоматически запускается каждый день в 10:00

# Проверка статусов каждый день в 10:00
0 10 * * * cd /var/www/fastuser/data/www/crm.clientright.ru && php check_exec_list_statuses.php >> logs/auto_status_checker_cron.log 2>&1

Логи cron запусков сохраняются в logs/auto_status_checker_cron.log

Для изменения расписания используйте:

crontab -e

Параметры скрипта

В начале скрипта можно настроить:

  • LIMIT - максимальное количество проектов за один запуск (по умолчанию: 50)
  • sleep(2) - задержка между запросами к API в секундах

Логирование

Все операции логируются в logs/auto_status_checker.log:

2025-10-16 19:25:40 - INFO: ========== Начало автоматической проверки статусов ==========
2025-10-16 19:25:40 - INFO: Найдено проектов для проверки: 20
2025-10-16 19:25:40 - INFO: [0/20] Проект #374190: Новак ООО ЭДЭКС
2025-10-16 19:25:40 - INFO:   Статус: исполнительное производство
2025-10-16 19:25:40 - INFO:   Рег. номер: 16RS0012-217-25-0000262
2025-10-16 19:25:40 - SUCCESS:   ✅ Получен статус: Выдан исполнительный лист
2025-10-16 19:25:40 - SUCCESS:   💬 Комментарий создан (ID: 395390)
...

Обработка ошибок

Таймауты API

  • API Debexpert часто не отвечает (60-70% запросов)
  • Таймаут установлен на 120 секунд
  • Таймауты логируются как WARNING, не прерывают обработку

Другие ошибки

  • Ошибки парсинга JSON
  • Ошибки БД
  • Отсутствие данных в ответе

Все ошибки логируются, скрипт продолжает работу со следующим проектом.

Итоговая статистика

После завершения скрипт выводит:

========== Завершение проверки ==========
Проверено проектов: 20
✅ Успешных запросов: 6
❌ Ошибок: 2
⏱️  Таймаутов: 12
💬 Создано комментариев: 6
========================================

Поля проекта

Используемые поля:

  • cf_2204 - регистрационный номер искового заявления (заполняется при отправке иска)
  • cf_2429 - регистрационный номер заявления на исполнительный лист (заполняется при подаче заявления)
  • cf_1752 - номер исполнительного листа (заполняется вручную после получения)

Будущие улучшения:

  • Автоматическое заполнение cf_1752 при обнаружении исполнительного листа в ответе
  • Автоматическое скачивание исполнительных листов
  • Обновление статуса проекта
  • Уведомления при изменении статуса

Технические детали

  • От пользователя: ИИ Клиентправ (ID: 23)
  • Канал: Telegram AI Bot (для отображения иконки робота 🤖)
  • Кодировка: UTF-8
  • Формат комментария: Текст без эмодзи (для совместимости)
  • Задержка между запросами: 2 секунды

Безопасность

  • Использует существующий API endpoint GetCourtStatus.php
  • Не хранит API ключи в скрипте
  • Логи не содержат чувствительных данных
  • Обработка ошибок не прерывает работу других проектов

Пример успешного выполнения

$ php check_exec_list_statuses.php

========== Начало автоматической проверки статусов ==========
Найдено проектов для проверки: 20

[0/20] Проект #374190: Новак ООО ЭДЭКС
  Статус: исполнительное производство
  Рег. номер: 16RS0012-217-25-0000262
  ✅ Получен статус: Выдан исполнительный лист
  Суд: Октябрьский районный суд г. Ижевска
  Событий в истории: 5
  💬 Комментарий создан (ID: 395390)

[1/20] Проект #366062: Папочки ООО ЭДЭКС
  ⏱️  Таймаут API

...

========== Завершение проверки ==========
Проверено проектов: 20
✅ Успешных запросов: 6
❌ Ошибок: 2
⏱️  Таймаутов: 12
💬 Создано комментариев: 6

Статус: Готово к использованию
Автор: AI Assistant + Фёдор
Дата: 16 октября 2025