mirror of
https://mau.dev/maunium/synapse.git
synced 2024-12-15 20:13:51 +01:00
379d2a8c39
Converting some of the rst documentation to markdown. Attempted to preserve whitespace and line breaks to minimize cosmetic change.
65 lines
3.5 KiB
Markdown
65 lines
3.5 KiB
Markdown
# Synapse Architecture
|
|
|
|
As of the end of Oct 2014, Synapse's overall architecture looks like:
|
|
|
|
synapse
|
|
.-----------------------------------------------------.
|
|
| Notifier |
|
|
| ^ | |
|
|
| | | |
|
|
| .------------|------. |
|
|
| | handlers/ | | |
|
|
| | v | |
|
|
| | Event*Handler <--------> rest/* <=> Client
|
|
| | Rooms*Handler | |
|
|
HS <=> federation/* <==> FederationHandler | |
|
|
| | | PresenceHandler | |
|
|
| | | TypingHandler | |
|
|
| | '-------------------' |
|
|
| | | | |
|
|
| | state/* | |
|
|
| | | | |
|
|
| | v v |
|
|
| `--------------> storage/* |
|
|
| | |
|
|
'--------------------------|--------------------------'
|
|
v
|
|
.----.
|
|
| DB |
|
|
'----'
|
|
|
|
- Handlers: business logic of synapse itself. Follows a set contract of BaseHandler:
|
|
- BaseHandler gives us onNewRoomEvent which: (TODO: flesh this out and make it less cryptic):
|
|
- handle_state(event)
|
|
- auth(event)
|
|
- persist_event(event)
|
|
- notify notifier or federation(event)
|
|
- PresenceHandler: use distributor to get EDUs out of Federation.
|
|
Very lightweight logic built on the distributor
|
|
- TypingHandler: use distributor to get EDUs out of Federation.
|
|
Very lightweight logic built on the distributor
|
|
- EventsHandler: handles the events stream...
|
|
- FederationHandler: - gets PDU from Federation Layer; turns into
|
|
an event; follows basehandler functionality.
|
|
- RoomsHandler: does all the room logic, including members - lots
|
|
of classes in RoomsHandler.
|
|
- ProfileHandler: talks to the storage to store/retrieve profile
|
|
info.
|
|
- EventFactory: generates events of particular event types.
|
|
- Notifier: Backs the events handler
|
|
- REST: Interfaces handlers and events to the outside world via
|
|
HTTP/JSON. Converts events back and forth from JSON.
|
|
- Federation: holds the HTTP client & server to talk to other servers.
|
|
Does replication to make sure there's nothing missing in the graph.
|
|
Handles reliability. Handles txns.
|
|
- Distributor: generic event bus. used for presence & typing only
|
|
currently. Notifier could be implemented using Distributor - so far
|
|
we are only using for things which actually /require/ dynamic
|
|
pluggability however as it can obfuscate the actual flow of control.
|
|
- Auth: helper singleton to say whether a given event is allowed to do
|
|
a given thing (TODO: put this on the diagram)
|
|
- State: helper singleton: does state conflict resolution. You give it
|
|
an event and it tells you if it actually updates the state or not,
|
|
and annotates the event up properly and handles merge conflict
|
|
resolution.
|
|
- Storage: abstracts the storage engine.
|