How eitaar/yot works
yot is a single-user calendar product: a browser user pairs with a PIN, then uses the Vue calendar UI to manage calendars, events, tags, imports, and images through the authenticated REST API. The backend services persist domain data in SQLite and publish changes to an event bus for the SSE feed. MCP exposes calendar tools over stdio and can relay mutations to the HTTP server’s feed. The graph retains documented OAuth, plugin, and ask capabilities; unsampled route internals are represented at their exact paths, and edges are limited to README or source-index evidence.
Main entry points: rest/mod.rs REST router · server.rs MCP tools · db/mod.rs SQLite database · event.rs Event service
Components 28
Browser application
- Vue application
web/src/App.vue - Calendar views
web/src/views/CalendarView.vue - Web API client
web/src/api/client.ts - Pairing UI
web/src/views/PairView.vue
HTTP and identity
- REST router
src/rest/mod.rs - API authentication
src/auth/middleware.rs - PIN pairing
src/auth/pairing.rs - OAuth endpoints
src/rest/oauth.rs
Calendar services
- Calendar routes
src/rest/calendars.rs - Event routes
src/rest/events.rs - Import routes
src/rest/import.rs - Image uploads
src/rest/uploads.rs - Tag routes
src/rest/tags.rs - Plugin sources
src/rest/plugins.rs - Ask API
src/rest/ask.rs - Calendar service
src/services/calendar.rs - Event service
src/services/event.rs - ICS import
src/services/import.rs - Image service
src/services/image.rs - Tag service
src/services/tag.rs - Plugin service
src/services/plugin_source.rs
Realtime and MCP
- Event bus
src/core/event_bus.rs - SSE feed
src/rest/stream.rs - MCP tools
src/mcp/server.rs - MCP SSE relay
src/mcp/relay.rs
Persistence
- SQLite database
src/db/mod.rs - Database schema
src/db/schema.rs
Other components
- Calendar user
Connections 42
- Calendar user → Vue application: uses
README.md - Vue application → Calendar views: renders
- Calendar views → Web API client: requests
- Vue application → Pairing UI: offers pairing
- Web API client → REST router: calls REST
README.md - Pairing UI → REST router: redeems PIN
README.md - REST router → API authentication: guards routes
src/rest/mod.rs - REST router → Calendar routes: routes to
src/rest/mod.rs - REST router → Event routes: routes to
src/rest/mod.rs - REST router → Import routes: routes to
src/rest/mod.rs - REST router → Image uploads: routes to
src/rest/mod.rs - REST router → Tag routes: routes to
src/rest/mod.rs - REST router → Plugin sources: routes to
src/rest/mod.rs - REST router → Ask API: routes to
src/rest/mod.rs - REST router → OAuth endpoints: exposes
src/rest/mod.rs - API authentication → SQLite database: authenticates via
src/auth/middleware.rs - API authentication → PIN pairing: uses
src/rest/mod.rs - Calendar routes → Calendar service: delegates
README.md - Event routes → Event service: delegates
README.md - Import routes → ICS import: delegates
README.md - Image uploads → Image service: delegates
README.md - Tag routes → Tag service: delegates
README.md - Plugin sources → Plugin service: uses
src/rest/plugins.rs - Calendar service → SQLite database: reads and writes
README.md - Event service → SQLite database: reads and writes
README.md - Event service → Calendar service: checks calendar
src/services/event.rs - ICS import → SQLite database: imports into
README.md - Image service → SQLite database: stores metadata
- Tag service → SQLite database: reads and writes
README.md - Plugin service → SQLite database: uses schema
src/services/plugin_source.rs - SQLite database → Database schema: initializes
src/db/mod.rs - REST router → SSE feed: routes to
src/rest/mod.rs - SSE feed → Event bus: streams events
README.md - Calendar user → MCP tools: connects via stdio
README.md - MCP tools → Calendar service: calls
src/mcp/server.rs - MCP tools → Event service: calls
src/mcp/server.rs - MCP tools → ICS import: calls
src/mcp/server.rs - MCP tools → Image service: calls
src/mcp/server.rs - MCP tools → Tag service: calls
src/mcp/server.rs - MCP tools → Event bus: emits changes
src/mcp/server.rs - MCP SSE relay → Event bus: subscribes
src/mcp/relay.rs - MCP SSE relay → SSE feed: relays to feed
README.md