# Architektura Synapse
SUMMARY: Jak zbudowany jest Synapse — Fastify, PostgreSQL, FTS5, osadzenia, serwer MCP.

Architektura Synapse
Synapse to wielodostępne API pamięci zbudowane na Fastify, PostgreSQL z FTS5
oraz opcjonalnej usłudze osadzeń do wyszukiwania semantycznego.
Architektura wysokiego poziomu
[CODE BLOCK]
Główne komponenty
1. Synapse API (Fastify)
Główny serwer HTTP. Obsługuje:
- Endpointy REST (, ,  itp.)
- Autoryzację (Mind Key dla agentów, JWT dla ludzi)
- Limity żądań (tylko autoryzacja )
- Serwowanie plików statycznych (interfejs WWW pod ,  itp.)
- Wysyłanie webhooków
Zbudowany na Fastify 5 dla wydajności. W środowisku produkcyjnym działa na
porcie 12800.
2. PostgreSQL z FTS5
Główny magazyn danych. Wykorzystuje PostgreSQL z rozszerzeniem FTS5 do
wyszukiwania pełnotekstowego.
Kluczowe tabele:
| Tabela | Przeznaczenie |
|-------|---------|
|  | Konta użytkowników |
|  | Zakresy umysłów (każdy ma Mind Key) |
|  | Rekordy wspomnień z tabelą wirtualną FTS5 |
|  | Zarządzanie zadaniami |
|  | Historia czatu |
|  | Trwałe skrypty |
|  | Rejestracje webhooków |
|  | Zaplanowane zadania |
|  | Magazyn klucz-wartość |
|  | Ścieżka audytu |
FTS5 umożliwia wyszukiwanie pełnotekstowe poniżej milisekundy w całej treści
wspomnień. Szczegóły w sekcji Wyszukiwanie FTS5.
3. Usługa osadzeń (opcjonalna)
Do wyszukiwania semantycznego Synapse generuje wektorowe osadzenia treści
wspomnień. Są one przechowywane razem ze wspomnieniami i używane do wyszukiwania
podobieństwa.
- Dostawca: konfigurowalny (OpenAI, model lokalny itp.)
- Przechowywane jako kolumna  w tabeli 
- Używane przez endpoint 
- Patrz Wyszukiwanie semantyczne
4. Serwer MCP (osobna usługa)
Serwer MCP Synapse działa jako osobny proces (port 13100). Spełnia funkcje:
- Udostępnia 79 narzędzi przez Model Context Protocol
- Obsługuje transporty stdio, HTTP/SSE oraz WebSocket
- Tłumaczy wywołania narzędzi MCP na wywołania API Synapse
- Wielodostępność: jeden Mind Key na sesję
5. Proxy przeglądarki (osobna usługa)
Do automatyzacji przeglądarki działa osobna usługa oparta na Playwright na
porcie 13000. Serwer MCP może ją wywoływać dla narzędzi .
6. Proxy SSH (osobna usługa)
Do zdalnych poleceń opartych na SSH działa osobna usługa na porcie 12900.
Model wielodostępności
[CODE BLOCK]
Każdy umysł jest w pełni izolowany. Mind Key daje dostęp dokładnie do jednego
umysłu. JWT dają dostęp do konta użytkownika (do zarządzania umysłami).
Szczegóły w sekcji Wielodostępność.
Przepływ żądania
Żądanie zapisu wspomnienia
[CODE BLOCK]
Żądanie wyszukiwania wspomnień
[CODE BLOCK]
Wdrożenie
Synapse jest wdrażany jako kontener Docker. Patrz :
[CODE BLOCK]
Charakterystyka wydajności
| Operacja | Opóźnienie | Przepustowość |
|-----------|---------|------------|
| Zapis wspomnienia | 5 ms | 1000+ żądań/s |
| Recall wspomnień | 20 ms | 500 żądań/s |
| Wyszukiwanie FTS5 | 10 ms | 800 żądań/s |
| Wyszukiwanie semantyczne | 50 ms | 200 żądań/s |
| Odpytywanie czatu | 5 ms | 2000 żądań/s |
Następne kroki
- Model pamięci
- Wielodostępność
- Wyszukiwanie FTS5