# Synapse Mimarisi
SUMMARY: Synapse nasıl inşa edilmiştir — Fastify, PostgreSQL, FTS5, gömmeler, MCP sunucusu.

Synapse Mimarisi
Synapse, Fastify, FTS5 ile PostgreSQL ve anlamsal arama için isteğe bağlı bir gömme hizmeti üzerine inşa edilmiş çok kiracılı bir bellek API'sidir.
Üst Düzey Mimari
[CODE BLOCK]
Çekirdek Bileşenler
1. Synapse API (Fastify)
Ana HTTP sunucusu. Şunları ele alır:
- REST uç noktaları (, ,  vb.)
- Kimlik doğrulama (ajanlar için Mind Key, insanlar için JWT)
- Hız sınırlaması (yalnızca  kimlik doğrulaması)
- Statik dosya sunumu (,  vb. web arayüzü)
- Webhook dağıtımı
Performans için Fastify 5 ile inşa edilmiştir. Üretimde 12800 portunda çalışır.
2. FTS5 ile PostgreSQL
Birincil veri deposu. Tam metin arama için FTS5 uzantısına sahip PostgreSQL kullanır.
Önemli tablolar:
| Tablo | Amaç |
|-------|---------|
|  | Kullanıcı hesapları |
|  | Mind kapsamları (her birinin bir Mind Key'i vardır) |
|  | FTS5 sanal tablosuyla bellek kayıtları |
|  | Görev yönetimi |
|  | Sohbet geçmişi |
|  | Kalıcı betikler |
|  | Webhook kayıtları |
|  | Zamanlanmış görevler |
|  | Anahtar-değer deposu |
|  | Denetim izi |
FTS5, tüm bellek içeriğinde milisaniyenin altında tam metin arama sağlar. Detaylar için bkz. FTS5 Arama.
3. Gömme Hizmeti (İsteğe Bağlı)
Anlamsal arama için Synapse, bellek içeriğinin vektör gömmelerini üretir. Bunlar belleklerle birlikte saklanır ve benzerlik araması için kullanılır.
- Sağlayıcı: yapılandırılabilir (OpenAI, yerel model vb.)
-  tablosunda  sütunu olarak saklanır
-  uç noktası tarafından kullanılır
- Bkz. Anlamsal Arama
4. MCP Sunucusu (Ayrı Hizmet)
Synapse MCP sunucusu ayrı bir süreç (port 13100) olarak çalışır. Şunları yapar:
- Model Context Protocol üzerinden 79 araç sunar
- stdio, HTTP/SSE ve WebSocket taşıyıcılarını destekler
- MCP araç çağrılarını Synapse API çağrılarına çevirir
- Çok kiracılı: oturum başına bir Mind Key
5. Browser Proxy (Ayrı Hizmet)
Tarayıcı otomasyonu için, 13000 portunda Playwright tabanlı ayrı bir hizmet çalışır. MCP sunucusu bunu  araçları için çağırabilir.
6. SSH Proxy (Ayrı Hizmet)
SSH tabanlı uzak komutlar için, 12900 portunda ayrı bir hizmet çalışır.
Çok Kiracılılık Modeli
[CODE BLOCK]
Her mind tamamen izoledir. Mind Key'ler tam olarak bir mind'e erişim sağlar. JWT'ler kullanıcı hesabına erişim sağlar (mind'leri yönetmek için).
Detaylar için bkz. Çok Kiracılılık.
İstek Akışı
Bellek Saklama İsteği
[CODE BLOCK]
Bellek Arama İsteği
[CODE BLOCK]
Dağıtım
Synapse bir Docker konteyneri olarak dağıtılır. Bkz. :
[CODE BLOCK]
Performans Karakteristikleri
| İşlem | Gecikme | Verim |
|-----------|---------|------------|
| Bellek saklama | 5ms | 1000+ istek/sn |
| Bellek geri çağırma | 20ms | 500 istek/sn |
| FTS5 arama | 10ms | 800 istek/sn |
| Anlamsal arama | 50ms | 200 istek/sn |
| Sohbet poll | 5ms | 2000 istek/sn |
Sonraki Adımlar
- Bellek Modeli
- Çok Kiracılılık
- FTS5 Arama