AACsearch
Справочник

Таксономия статусов фич

Как AACSearch размечает доступность функций в документации, маркетинге и панели управления. Каждая функция, отмеченная в docs, попадает в одно из шести состояний.

Любая функция, упомянутая в документации и маркетинге AACSearch, попадает в одно из шести состояний ниже. Метка — это контракт. Если функция не имеет явной метки Доступно, считайте, что она не общедоступна.

Шесть состояний

СостояниеЧто значитМаркеры
ДоступноРеализовано, поддерживается, тарифицируется на текущих планах. Можно строить продакшен-нагрузки."Доступно на всех планах", бейдж не нужен
BetaФункционально готово и работает на продакшен у части клиентов, но интерфейс, цена или лимиты ещё могут меняться.Бейдж Beta на странице docs
EnterpriseПоставляется, но за условиями Enterprise-плана или контракта. Цена/охват — индивидуально.Бейдж Enterprise; строка в таблице /overview/plans-and-limits
Internal previewЗапущено на продакшене внутри AACSearch или для дизайн-партнёров. Пока не тарифицируется. SLA для клиентов нет.Бейдж Internal preview; обычно без отдельной docs-страницы
RoadmapЗакреплено за конкретным релизом (v0.x, v1.0 и т. п.), но ещё не реализовано. Нельзя продавать как доступное.Бейдж Roadmap (vX.Y) со ссылкой на Status & Roadmap
Не доступноВне рамок продукта. Либо отброшено, либо закрывается другим продуктом/партнёром.Упоминается только в разделе Out of scope Status & Roadmap

Когда вешать бейдж

Бейдж нужен на любой docs-странице или маркетинг-блоке, где функция не является Доступно везде. Дефолт: "нет бейджа = общедоступно на всех живых планах". В частности:

  • Функция зашита под план → бейдж с указанием тира (например Enterprise).
  • Функция требует контракта/SLA → бейдж + ссылка на sales.
  • Roadmap-функция упомянута как контекст → бейдж с целевым релизом и ссылкой на Status & Roadmap.
  • Сквозное утверждение о производительности, аптайме или масштабе, которое нельзя проверить на текущем плане → либо убираем, либо заменяем на цель и ссылку на Claim status.

Антипаттерны

Эти варианты ломали доверие в прошлых аудитах — избегайте их:

  • Мечтательные SLA-формулировки. "99,99% аптайм" без опубликованного окна измерения, списка исключений и политики кредитов. Если число не закреплено контрактом — не печатаем число.
  • "Скоро" без релиза. Используйте бейдж Roadmap (vX.Y) с конкретным таргетом — читатель может подписаться на правильную веху.
  • Чужая терминология для функций AACSearch с другим поведением. В приоритете — термин из Глоссария (когда выйдет), а не словарь Algolia/Elasticsearch.
  • Маркетинг-онли функции. На странице функции должна быть ссылка на docs-страницу, oRPC-процедуру, Prisma-модель или env-флаг. Иначе — Roadmap или Не доступно.

Источник истины

Для любой названной функции порядок источников такой:

  1. Код — процедура / модель / пакет из Status & Roadmap.
  2. wiki/tasks/*.md — инженерный план с текущим статусом (на каждое утверждение ссылается Claim status).
  3. Таблица планов — лимит задают Планы и лимиты, а не маркетинг.

Если маркетинг и один из источников выше расходятся — побеждает код. Открывайте задачу против маркетинга, а не правьте docs под брошюру.

On this page