Архитектура

Этот раздел — визуальный справочник по тому, как устроен AACsearch. Пять встроенных Mermaid-диаграмм охватывают наиболее важные потоки запросов для интеграторов, инженеров эксплуатации и аудиторов безопасности.

Если вам нужно текстовое описание структуры монорепозитория, границ сервисов и технологических решений — начните с Обзор → Архитектура. Этот раздел приближает фокус к runtime-потокам.

Диаграммы

• Путь записи — как запись документа попадает в AACsearch через SearchIngestBuffer / SearchSyncOutbox и далее в alias Typesense.
• Путь чтения — как поисковый запрос проходит от SDK к multi_search Typesense и возвращается.
• Типы ключей и модель безопасности — четыре категории ключей, их префиксы ss_*, хранение только хешей и HMAC + TTL scoped-токенов.
• Жизненный цикл коннектора — шесть операций коннектора: handshake, heartbeat, full-sync, delta-sync, delete, диагностика.
• Аналитический контур обратной связи — как события search → click → conversion агрегируются и возвращаются в настройку релевантности.