Arquitectura
Referencia visual para las entrañas de AACsearch — ruta de escritura, ruta de lectura, modelo de seguridad, ciclo de vida del conector y el bucle de feedback analítico.
Esta sección es la referencia visual de cómo está construido AACsearch. Cinco diagramas Mermaid embebidos cubren los flujos de petición más relevantes para integradores, operadores y revisores de seguridad.
Si buscas la explicación en prosa del layout del monorepo, los límites de servicio y las decisiones tecnológicas, comienza por Resumen → Arquitectura. Esta sección hace zoom en los flujos de runtime.
Diagramas
- Ruta de escritura — cómo una escritura de
documento entra en AACsearch a través de
SearchIngestBuffer/SearchSyncOutboxhasta el alias de Typesense. - Ruta de lectura — cómo una consulta de búsqueda
fluye desde el SDK hasta el
multi_searchde Typesense y vuelve. - Tipos de claves y modelo de seguridad
— las cuatro categorías de claves, sus prefijos
ss_*, almacenamiento solo-hash y HMAC + TTL del scoped-token. - Ciclo de vida del conector — las seis operaciones del conector: handshake, heartbeat, full-sync, delta-sync, delete, diagnóstico.
- Bucle de feedback analítico — cómo los eventos search → click → conversion se agregan y retroalimentan el ajuste de relevancia.
Plans & Limits
The canonical AACsearch plan matrix, Search-Unit definition, quota catalog, soft/hard semantics, and the code paths that enforce them.
Ruta de escritura
Cómo una escritura de documento entra en AACsearch — desde POST /v1/indexes/.../documents a través de SearchIngestBuffer / SearchSyncOutbox y el worker, hasta el alias de Typesense.