Architecture
Référence visuelle des rouages internes d'AACsearch — chemin d'écriture, chemin de lecture, modèle de sécurité, cycle de vie du connecteur et boucle de feedback analytique.
Cette section est la référence visuelle de la construction d'AACsearch. Cinq diagrammes Mermaid intégrés couvrent les flux de requêtes les plus importants pour les intégrateurs, opérateurs et auditeurs sécurité.
Si vous cherchez l'explication en prose du layout du monorepo, des frontières de service et des choix technologiques, commencez par Vue d'ensemble → Architecture. Cette section zoome sur les flux d'exécution.
Diagrammes
- Chemin d'écriture — comment une écriture de
document entre dans AACsearch via
SearchIngestBuffer/SearchSyncOutboxjusqu'à l'alias Typesense. - Chemin de lecture — comment une requête de
recherche transite du SDK jusqu'au
multi_searchde Typesense, puis revient. - Types de clés et modèle de sécurité
— les quatre catégories de clés, leurs préfixes
ss_*, stockage en hash uniquement et HMAC + TTL des scoped tokens. - Cycle de vie du connecteur — les six opérations du connecteur : handshake, heartbeat, full-sync, delta-sync, delete, diagnostics.
- Boucle de feedback analytique — comment les événements search → click → conversion sont agrégés et nourrissent l'ajustement de pertinence.
Plans & Limits
The canonical AACsearch plan matrix, Search-Unit definition, quota catalog, soft/hard semantics, and the code paths that enforce them.
Chemin d'écriture
Comment une écriture de document entre dans AACsearch — depuis POST /v1/indexes/.../documents via SearchIngestBuffer / SearchSyncOutbox et le worker, jusqu'à l'alias Typesense.