Architektur
Visuelle Referenz für die Interna von AACsearch — Schreibpfad, Lesepfad, Sicherheitsmodell, Konnektor-Lebenszyklus und der Analyse-Feedback-Loop.
Dieser Abschnitt ist die visuelle Referenz für den inneren Aufbau von AACsearch. Fünf eingebettete Mermaid-Diagramme decken die wichtigsten Request-Flows für Integratoren, Betreiber und Sicherheitsprüfer ab.
Wenn du nach der Prosa-Erklärung von Monorepo-Layout, Service-Grenzen und Technologieentscheidungen suchst, beginne bei Übersicht → Architektur. Dieser Abschnitt zoomt auf die Laufzeit-Flows.
Diagramme
- Schreibpfad — wie ein Dokument-Write durch
SearchIngestBuffer/SearchSyncOutboxin den Typesense-Alias gelangt. - Lesepfad — wie eine Suchanfrage vom SDK bis zu
Typesense
multi_searchund zurück fließt. - Schlüsseltypen & Sicherheitsmodell —
die vier Schlüsselkategorien, ihre
ss_*-Präfixe, ausschließlich gehashte Speicherung und Scoped-Token HMAC + TTL. - Konnektor-Lebenszyklus — die sechs Konnektor-Operationen: Handshake, Heartbeat, Full-Sync, Delta-Sync, Delete, Diagnose.
- Analyse-Feedback-Loop — wie Search → Click → Conversion-Events aggregiert werden und ins Relevanz-Tuning zurückfließen.
Plans & Limits
The canonical AACsearch plan matrix, Search-Unit definition, quota catalog, soft/hard semantics, and the code paths that enforce them.
Schreibpfad
Wie ein Dokument-Write in AACsearch ankommt — von POST /v1/indexes/.../documents über SearchIngestBuffer / SearchSyncOutbox und den Worker bis in den Typesense-Alias.