Глоссарий
Термины, которые встретятся по всему порталу и в ответах самой платформы.
| Термин | Значение |
|---|---|
| Контракт | Центральная единица работы: одна ниша + один бренд + один целевой сайт, со своей конфигурацией и исследовательским корпусом. Формально — сущность salescontracts. |
| Инстанс | Один задеплоенный целевой сайт (статический, собирается publishing hub), связанный с контрактом. |
| Онтология | Заявленное тематическое пространство контракта — сущности и темы его контента; используется для ранжирования источников и выравнивания драфтов. |
| Корпус / исследовательский факт | Накопленная база фактов контракта с привязкой к источникам. Генерация заземляет числа и утверждения здесь, а не выдумывает. |
| RAG / заземление | Retrieval-augmented generation: драфт пишется по найденным фактам корпуса и живым источникам. «Заземлено» — значит утверждение может указать на свой источник. |
| Карв | Создание новой неизменяемой версии пайплайна: копия директории предыдущей версии, правка, регистрация в каталоге. Существующие версии не редактируются никогда. |
| Пин | Явный выбор версии пайплайна (на контракт или для ночного прогона), перекрывающий latest каталога. |
| Дейлиран | Ночной батч по расписанию, прогоняющий Collect → Generate → publish по всем активным контрактам. |
| Dedup defer | Вердикт гейта дедупликации для слишком похожей статьи: публикация откладывается (тема может освободиться), а не отменяется. |
| Карантин | Состояние-отстойник для контента или фактов, не прошедших гейт, — исключены из использования до разбора. |
| Grounding-гейт | Проверка на пути публикации: численные/нормативные утверждения сверяются с источниками, незаземлённые блокируются. |
| Бренд-защита | Механизмы, не дающие статье продвигать конкурента вместо бренда контракта: заявленные списки конкурентов, demote и сигналы детектора. |
Лайфцикл (lcid/lcstep) | Стейт-машина бизнес-сущности из метамодели; «активный контракт» — шаг лайфцикла, а не флаг. |
| Прогон / шаг прогона | Записанное исполнение пайплайна и его пошаговый прогресс — истина платформы о том, «что произошло». |
| Proof-of-publication | Публикация засчитывается только после того, как живой URL получен и проверен на доступность. |
| Агент-токен | Scoped JWT для LLM-агентов: чтение платформы с вымаранными секретами, запись — только в явно выданный пул контрактов. |
SPEC / spec_ref | Непрозрачный идентификатор внутренней записи-спецификации (SPEC-…), на которую может ссылаться задача или тикет; публичный контракт показывает только форму (SPEC-NNN) — сами записи не публикуются. |
| Грант-пул | Набор контрактов агента (с capabilities), в которые его токен может писать. Перевыпуск токена заменяет пул. |
| Урожайность темы (topic yield) | Главная метрика петли обратной связи тем: показы, заработанные на статью темы, в окне с фильтром зрелости. |
| Explore-пол | Защищённая минимальная доля ночного отбора, зарезервированная под новые и недосэмплированные темы, — эксплуатация не может съесть весь батч. |
| Health score | Ежедневный композитный SEO-скор сайта с булевыми флагами (канонизация, молчание краулеров, всплески 404…), считается одной общей функцией. |
| Fail-loud | Философия ошибок платформы: пустой обязательный вход или сломанный инвариант останавливает прогон и фиксируется — вместо тихого дефолта. |
| Проектор (projector) | Единственный компонент, который читает поток событий прогонов и пишет состояние прогонов/шагов в базу — единственный писатель состояния прогонов, поэтому порядок и идемпотентность живут в одном месте. |
| Reaper | Цикл обслуживания, снимающий зависшие транзакции базы и протухшие прогоны, чтобы повисший шаг не держал блокировки и слоты вечно. |
| Watchdog / dead-man’s switch | Внешние проверки живости, ожидающие heartbeat; тишина сама по себе — тревога («ноль — это провал»). |
| Hub (хаб) | Сервис публикации, который собирает и выкладывает статические сайты назначения и проверяет живые URL. |
| Native worker | Исполнитель пайплайна внутри процесса (в отличие от прежнего subprocess-раннера), запускающий шаги под контролем конкурентности движка прогонов. |
| Шов (seam) | Точка, где один общий механизм вызывается с двух путей (например, компаратор дедупа тем и на стороне Collect, и на пути публикации) — одно ядро, два шва. |
| Хартия (charter) | Контракт каждого шага фреймворка написания: одна забота, один владелец, объявленные входы и выходы. |
| Контур | Среда: dev (локальный интеграционный стек) или prod (прод-хост). |
| Донор | Существующий сайт или версия, чья конфигурация/контент засевает новый (новый инстанс клонируется с донора). |
| Site chrome | Всё на опубликованной странице, что не статья: навигация, подвал, карточка автора, юридические страницы. |
| Штамп (stamp) | Детерминированный сигнал или скор, записанный на карточку статьи как телеметрия (не вердикт гейта). |
| Батарея сигналов | Набор детерминированных детекторов, прогоняемых вместе по статье (brand-safety, согласованность языка, структурные проверки). |
| BOLA | Broken Object Level Authorization — класс ошибок, когда вызывающий достаёт до чужого объекта; грант-пул агента — слой, который это предотвращает. |
| AIMD | Additive-increase / multiplicative-decrease — правило адаптивной конкурентности, которым движок прогонов отвечает на лимиты провайдера. |
| E-E-A-T | Experience, Expertise, Authoritativeness, Trust — рамка поискового качества, вокруг которой построена модель авторства. |
| IndexNow | Push-протокол уведомления поисковиков о новых и изменённых URL (реализован; пока не включён). |
Одно и то же — под разными именами
Заголовок раздела «Одно и то же — под разными именами»REST API, MCP-инструменты и база росли в разное время и сохранили свои слова. Соответствие:
| Понятие | REST API | MCP-инструменты | База / прочее |
|---|---|---|---|
| Контракт | contracts, contract_guid | contract, sc_id в payload | таблица salescontracts, сущность SalesContract |
| Тикет | tickets (kind: defect или improvement) | entherium_report_defect, entherium_propose_improvement, entherium_list_defects | ticket |
| Задача | tasks | entherium_create_task, entherium_list_tasks, … | task |
| Идентификатор | guid | task_id, defect_id | первичный ключ guid |
| Исполнитель | assignee_id (целочисленный id пользователя) | assignee (имя человека, разрешается на сервере) | users.guid |