Справочник
Статус публичных утверждений
Фактчек утверждений о производительности, безопасности и Enterprise-возможностях, которые встречаются в документации и маркетинге AACSearch. Соотносит каждое публичное утверждение с текущей реализацией.
Эта страница — аудит повторяющихся утверждений, которые встречаются в маркетинге, документации и SoftwareApplication JSON-LD AACSearch. Сюда заходят, когда покупатель, админ или аудитор спрашивает: "А этот показатель правда поддержан кодом?"
В каждой строке:
- Утверждение — точная формулировка, которая ушла наружу.
- Статус — из таксономии.
- Реальность — что код/эксплуатация поддерживают сегодня.
- Источник — файл или план
wiki/tasks/*с деталями.
Аудит не исчерпывающий. Нашли публичное утверждение, которого нет в таблице — заведите issue и добавьте строку.
Производительность и доступность
| Утверждение | Статус | Реальность | Источник |
|---|---|---|---|
| "SLA 99,95% аптайма" | Roadmap (v1.0) | Опубликованного SLA нет, окно измерения и политика кредитов не определены. Алёрты Prometheus срабатывают при p95/p99 > 300 мс. | wiki/tasks/performance-infrastructure.md (раздел 14.4) |
| "SLA 99,9% аптайма" (Scale/Pro) | Roadmap (v1.0) | То же самое. На pricing-странице формулировка должна быть смягчена до "цель", пока SLA не закреплён контрактом. | wiki/tasks/performance-infrastructure.md (раздел 14.4) |
| "p99 < 50 мс" | Beta | Лучший случай в EU-регионе под лёгкой нагрузкой. Публичной методологии нет, автокомплит не измеряется. | wiki/tasks/performance-infrastructure.md (14.4.1–14.4.3), packages/api/observability.ts |
| "Выделенные кластеры" | Roadmap (v1.0) | Один Typesense + один Postgres на регион. Нет шардинга, read-реплик, выделения per-tenant. | wiki/tasks/performance-infrastructure.md (14.5.1, 14.5.6) |
| "Мульти-регион" | Доступно | 3 региона: eu, us, ru. Только маршрутизация запросов. Резидентность данных per-tenant пока не закреплена. | deploy/regions/README.md, wiki/tasks/performance-infrastructure.md (14.5.6) |
| "Резидентность данных" | Enterprise | Привязка региона к организации — только по контракту. На Pro/Scale нет self-serve переключателя. | wiki/tasks/performance-infrastructure.md (15.x) |
Безопасность и идентификация
| Утверждение | Статус | Реальность | Источник |
|---|---|---|---|
| "SOC 2 compliant" | Roadmap | Есть чек-лист SOC 2 (apps/docs/content/docs/ru/security/soc2-checklist.mdx). Аудит ещё не пройден. | apps/docs/content/docs/ru/security/soc2-checklist.mdx |
| "SCIM 2.0 provisioning" | Beta | Эндпоинты Users + Groups в /scim/v2, модели в схеме. UI в дашборде частичный. | packages/api/modules/search/scim-public.ts, scim-config.ts |
| "Аутентификация по API-ключу" | Доступно | Ключи ss_search_* / ss_connector_* / ss_scoped_*, хеш at rest, scoped-токены подписаны HMAC. | packages/search/lib/keys.ts, packages/api/v1/auth.ts |
| "White-label / кастомный брендинг" | Enterprise | Feature gates (customBranding, customDomain) присутствуют, end-to-end UI кастомизации пока не поставляется. | packages/api/modules/entitlements/middleware/feature-gate.ts, wiki/tasks/self-hosted-licensing.md |
Self-hosted и деплой
| Утверждение | Статус | Реальность | Источник |
|---|---|---|---|
| "Self-hosted деплой" | Roadmap (v1.0) | Docker-тулинг есть для dev/CI. Нет выдачи лицензионных ключей, нет валидированного guide под продакшн self-hosting. | wiki/tasks/self-hosted-licensing.md |
| "Air-gapped / offline" | Roadmap (v1.0) | Все AI-функции (embeddings, LLM, OCR) зависят от облачных провайдеров. Оффлайн-бандла моделей нет. | wiki/tasks/self-hosted-licensing.md |
| "Helm chart / Kubernetes" | Roadmap (v1.0) | Не упаковано. Документированы только Coolify и Docker Compose. | wiki/deploy/self-hosting.md |
| "Open source / MIT" | Доступно | SDK (@aacsearch/client, @aacsearch/widget и т. д.) под MIT. Сам дашборд/control plane не open source. | packages/search-client/LICENSE, корневой LICENSE |
AI и модальности поиска
| Утверждение | Статус | Реальность | Источник |
|---|---|---|---|
| "AI search / RAG / Модуль Knowledge" | Beta | 10 oRPC-процедур, модели Knowledge, GraphRAG-ноды/рёбра. Прод-готово для дизайн-партнёров; цена в движении. | packages/api/modules/knowledge/ |
| "GraphRAG" | Beta | Prisma-модели GraphNode / GraphEdge + ингест. UI-поверхность и качество extraction зависят от типа источника. | packages/api/modules/knowledge/ |
| "Visual search" | Internal preview | Упоминается только в AI-демо на главной; нет shipped-эндпоинта, нет docs-страницы. Из списков функций вне демо — убирать. | apps/marketing/modules/home/components/AiAssistantChat.tsx (только демо) |
| "Voice search" | Internal preview | То же самое — строка демо. Нет streaming-эндпоинта транскрипции за search API. | apps/marketing/modules/home/components/AiAssistantChat.tsx (только демо) |
| "Встраиваемый виджет (Vanilla / React)" | Доступно | Vanilla виджет в packages/widget/ (Shadow DOM, ~18 КБ). React-хуки в @aacsearch/react. | packages/widget/, packages/react-hooks/ |
Что делать, если утверждение не подтверждается
- В маркетинге или JSON-LD — заведите issue, потом либо удалите
утверждение, либо смягчите ("цель", "по Enterprise", "Beta — по
запросу"). Маркетинг-страницы не должны заявлять цифру, которую эта
таблица помечает как
Roadmap. - В docs — добавьте бейдж из Feature status в верхней части страницы, где функция описана. Ссылайтесь на нужную строку этой таблицы.
- В дашборде / empty states — закройте поверхность через entitlements middleware. Нельзя показывать UI, который обещает функцию вне плана пользователя.
Цель — каждое публичное число AACSearch либо демонстрируемо верно сегодня, либо явно помечено разрывом.
Таксономия статусов фич
Как AACSearch размечает доступность функций в документации, маркетинге и панели управления. Каждая функция, отмеченная в docs, попадает в одно из шести состояний.
Гайд по позиционированию
Каноническое позиционирование AACSearch OS. Эта страница держит блог, comparison-страницы, маркетинг и кейсы в рамках Search Operating System.