AI × 1C Guide v0.4.0 — связка трёх систем

Новая инструкция для сценария, где одна и та же работа живёт в трёх системах: клиент пишет заявку в 1С-Коннект, консультант ведёт задачу в Bitrix24, разработчик правит код по задаче Jira. Ни одна из трёх не знает о двух других.

Три находки, ради которых это писалось

• У 1С-Коннект нет исходящих вебхуков. Это не REST, а SOAP 1.2 на веб-сервисах «1С:Предприятие 8.3» (PartnerWebAPI2). Единственный способ увидеть новую заявку — опрашивать ServiceRequestRead, храня метку последнего чтения у себя. Нужен планировщик с состоянием, а не обработчик события.
• Часовой лимит переворачивает наивное решение. 120 вызовов в час на список заявок и всего 50 на историю: агент, читающий историю по одной заявке в цикле, блокирует сервис на 50 тикетах. При этом ServiceRequestHistory принимает пакет до 550 ID за вызов.
• Jira Cloud и Data Center — разные API. В Cloud старые /rest/api/2/search и /rest/api/3/search отключены в 2025 году, замена — POST /rest/api/3/search/jql с nextPageToken и без total. В Data Center старый endpoint работает. Модель уверенно пишет код не под тот вариант и потом «чинит» токен вместо endpoint'а.

Уровни проверки указаны раздельно

Часть	Уровень	Что сделано
Jira Data Center	live-smoke	Анонимные вызовы к публичному Jira фонда Apache: JQL-поиск, startAt/total, чтение задачи по ключу, форма ошибки 400. Повторяется читателем без учётной записи
Jira Cloud	docs	Endpoint и пагинация по документации Atlassian, вызовов не было
1С-Коннект	docs	Операции, параметры, структура ValueTable и лимиты — из официальной публичной документации; SOAP-конверт собран по опубликованному образцу. Live-вызовов не было: нет доступа к порталу
Bitrix24	без изменений	Переиспользован проверенный read-only tasks.task.list

Связка не заявлена как end-to-end. Это написано и в инструкции, и в VERIFICATION.md.

Безопасность примера

connect_jira_bridge_example.py не вызывает ни одной операции записи: разрешены только ServiceRequestRead и ServiceRequestHistory, сборка конверта для чего-либо ещё падает с ошибкой; Bitrix24 ограничен tasks.task.list. Плюс локальный часовой бюджет вызовов, отказ от редиректов, скрытие тем и маркеров без --show-sensitive, отказ от http:// и URL с учётными данными.

Автосоздание задач сознательно не реализовано: ошибка сопоставления, размноженная по трём системам, дороже сэкономленной работы. Связь систем — через настраиваемые поля заявки Field1…Field5; заявки без ключа попадают в отдельную корзину, а не сопоставляются по времени и клиенту.

Также в релизе

• Английские версии главной страницы и всех инструкций по подключению, переключатель языка в обе стороны.
• Каталог recipes/ переименован в guides/; слово «рецепт» убрано из русского текста.
• validate_guide.py проверяет английский заголовок ## Verification status и взаимные ссылки языковых версий.
• 21 новый unit-тест, всего 44 — без сети и без секретов.

Реальные учётные данные и запись в рабочие системы при подготовке релиза не использовались.

AI × 1C Guide v0.3.0 — реальные интеграции

Три практических маршрута из проектов автора:

• 1С:Фреш OData: metadata, чтение списка и объекта, guarded create непроведённого документа;
• Bitrix24 Tasks: classic REST webhook, список задач, карточка и пагинация;
• 1cProductMap → Bitrix24 CRM: backend webhook и современный crm.item.add вместо deprecated crm.lead.*.

В релиз также входят два stdlib-only CLI, redacted output по умолчанию, запрет redirects с секретами, привязанные к endpoint write-confirmations, идемпотентность, расширенный secret scan и 23 безсетевых unit-теста.

Private live-проверки автора явно отделены от публично воспроизводимых доказательств. Реальные credentials и production-запись при подготовке релиза не использовались.

AI × 1C Guide v0.2.1 — устойчивый upstream-аудит

Patch-релиз после проверки weekly workflow в GitHub Actions.

• Обновлены official checkout/setup-python actions до Node 24 releases v7.
• Проверенный commit остаётся воспроизводимым pin, даже когда upstream ветка движется.
• Недоступный commit, архивирование, смена default branch или лицензии по-прежнему ломают audit.
• Обычный новый upstream commit создаёт заметное warning; строгий ручной режим --strict-upstream требует переаудита.
• Финальный workflow_dispatch: local-validation и online-audit прошли.

AI × 1C Guide v0.2.0 — проверяемость и границы риска

Повторный технический аудит каталога и рецептов.

• 14 проектов зафиксированы до commit SHA и сверены с GitHub metadata.
• Добавлены prerequisites, лицензии, поверхность доступа и mutating/destructive operations.
• Разделены docs, artifact, CLI smoke, live smoke и end-to-end статусы.
• Исправлено ключевое ограничение: стандартный OData 1С не является read-only.
• Уточнены EDT-MCP, code-index-mcp, mcp-1c-v1, Bitrix24 MCP и OpenIntegrations.
• CI проверяет schema v2, локальные ссылки, формулировки и еженедельный upstream drift.

Полные результаты и непроверенные этапы перечислены в VERIFICATION.md.

AI × 1C Guide v0.1.0 — первый публичный релиз

Первый публичный релиз практического русскоязычного гида по AI в экосистеме 1С:Предприятия.

Что вошло

• каталог из 14 open-source проектов для 1С, MCP, Agent Skills, OData и Bitrix24;
• выбор стека по задаче и уровню риска;
• четыре воспроизводимых сценария: аудит, разработка, выбор стека и Bitrix24;
• security-first рекомендации: read-only доступ, минимальные права, dry-run и human approval;
• русская основная версия и английское краткое описание;
• machine-readable каталог catalog/tools.json;
• шаблоны issue, правила вкладов и GitHub Actions для проверки каталога.

Куда дальше

В следующих версиях планируются compatibility matrix, проверенные конфигурации запуска и дополнительные практические рецепты.

Если вы поддерживаете инструмент из каталога или используете AI с 1С — откройте issue или PR: замечания по совместимости и безопасности особенно полезны.