Web Form Receiver

Модуль BPM2B Web Form Receiver принимает формы со статических лендингов (типично — Astro) и создаёт Lead в платформе BPM2B. Из коробки — шесть слоёв защиты (Origin whitelist, honeypot, валидация, reCAPTCHA, rate limit, дедупликация), сохранение полного аналитического контекста и аккуратная работа с дубликатами без фрагментации истории клиента.

Основные функциональные возможности:

• Два публичных endpoint без авторизации: POST /WebForm (приём заявки) и GET /WebFormConfig (публичная часть настроек капчи без секретного ключа); регистрируются с noAuth: true в routes.json.
• Origin whitelist с масками: OriginMatcher сверяет HTTP-заголовок Origin со списком масок из metadata (app.webFormReceiver.allowedOriginPatterns); * в маске превращается в regex [^/]+ — не пропустит хитрый https://evil.com/?x=crmp.kz.
• Honeypot и валидация: скрытое поле (по умолчанию website) отбрасывает заполненные ботами формы; обязательны email, sourceSiteCode, name.
• reCAPTCHA через Integration: сущность Integration WebFormCaptcha хранит captchaType (none / recaptcha), siteKey, secretKey; verify через https://www.google.com/recaptcha/api/siteverify; HTTP-вызовы идут через ApiRequest из bpm2bApiLog для логирования.
• Sliding-window rate limit: отдельная сущность WebFormRateLimit с составным индексом ipAddress + createdAt; параметры rateLimit.windowMinutes и rateLimit.maxRequests в metadata; ScheduledJob CleanupWebFormRateLimit ежедневно в 03:00 удаляет записи старше cleanupOlderThanHours.
• Дедупликация без фрагментации: при совпадении emailAddress ИЛИ phoneNumber новая заявка не создаёт второй Lead — вместо этого публикуется Note (type=Post) в ленту существующего Lead с JSON-дампом payload.
• Сохранение аналитического контекста: UTM-метки, yamClientId (Яндекс.Метрика), gid (GA-cookie), referrer, siteSessionId — пишутся в поля Lead через hasAttribute (если поле существует на конкретной инсталляции) и всегда сохраняются в description как JSON.
• Переносимость: модуль не добавляет аналитические поля сам, не меняет enum Lead.source (всегда «Web Site») и не трогает layout — на чистой инсталляции аналитика просто не записывается, зато всегда лежит в description.

Модуль предназначен для случаев, когда лендинги живут отдельно от платформы (например, Astro-сайты на CDN), а заявки должны попадать в CRM как штатные Lead-ы — с защитой от ботов и накоплением аналитики. Зависит от bpm2bApiLog (логирование внешних HTTP-запросов к siteverify).