How kimpearce888/supportos-plusplus works
SupportOS++ is a local-first support-desk desktop application. Users work in the Leptos UI to manage conversations, customers, search, reporting, and AI assistance; the UI reaches the Rust core through a loopback HTTP API, while the core synchronizes Help Scout data into SQLite and runs background jobs. The graph preserves README capabilities and major indexed modules. Some feature routes and implementations were not sampled, so their internal links are omitted rather than inferred.
Main entry points: workers.rs Background workers · db.rs SQLite database · sync_engine.rs Help Scout sync · server.rs Loopback API server
Components 24
Desktop and UI
- Tauri shell
crates/app/src-tauri/src/lib.rs - Leptos frontend
crates/ui/src/lib.rs - UI API client
crates/ui/src/api.rs
Local API
- Loopback API server
crates/core/src/http/server.rs - HTTP routes
crates/core/src/http/routes
Support workflows
- Help Scout sync
crates/core/src/sync_engine.rs - Help Scout adapter
crates/core/src/helpscout.rs - Inbox and conversations
crates/core/src/conversation_ops.rs - Customer timeline
crates/core/src/customer_events.rs - Shared domain types
crates/catalog/src
Search and AI
- Full-text search
crates/core/src/search.rs - Embedding pipeline
crates/core/src/embeddings.rs - Embedded vector store
crates/core/src/vectorstore_qdrant.rs - AI workflow
crates/core/src/ai_pipeline.rs - AI center
crates/core/src/ai_center.rs
Data and background runtime
- SQLite database
crates/core/src/db.rs - Schema migrations
crates/core/src/migrations.rs - Background workers
crates/core/src/workers.rs - Persistent job queue
crates/core/src/jobs.rs - Webhook processing
crates/core/src/webhook_handler.rs - Settings and secrets
crates/core/src/settings.rs - Encrypted backups
crates/core/src/backup_service.rs
Other components
- Support agent
- Local AI service
Connections 26
- Support agent → Leptos frontend: uses
README.md - Leptos frontend → UI API client: requests data
crates/ui/src/lib.rs - UI API client → Loopback API server: calls loopback API
README.md - Tauri shell → Loopback API server: bridges to core
README.md - Loopback API server → HTTP routes: routes requests
crates/core/src/http/server.rs - HTTP routes → Help Scout sync: exposes sync API
- Help Scout sync → Help Scout adapter: fetches remote data
crates/core/src/sync_engine.rs - Help Scout sync → SQLite database: updates local mirror
crates/core/src/sync_engine.rs - Help Scout sync → Customer timeline: records activity
crates/core/src/sync_engine.rs - Inbox and conversations → SQLite database: reads and writes
- Customer timeline → SQLite database: stores timeline
crates/core/src/customer_events.rs - Shared domain types → Leptos frontend: provides shared types
README.md - Full-text search → SQLite database: queries SQLite
crates/core/src/search.rs - Embedding pipeline → Embedded vector store: stores vectors
crates/core/src/embeddings.rs - Embedding pipeline → Local AI service: requests embeddings
crates/core/src/embeddings.rs - AI workflow → AI center: uses AI services
crates/core/src/ai_pipeline.rs - AI workflow → Local AI service: runs model stages
- Loopback API server → Background workers: starts background work
crates/core/src/http/server.rs - Background workers → Persistent job queue: claims jobs
crates/core/src/workers.rs - Background workers → Help Scout sync: runs sync jobs
crates/core/src/workers.rs - Background workers → Webhook processing: dispatches processing
crates/core/src/workers.rs - Webhook processing → Persistent job queue: enqueues work
crates/core/src/webhook_handler.rs - Background workers → Encrypted backups: runs backup
crates/core/src/workers.rs - Settings and secrets → SQLite database: stores configuration
crates/core/src/settings.rs - SQLite database → Schema migrations: applies schema
crates/core/src/db.rs - Background workers → Embedding pipeline: runs embedding work
crates/core/src/workers.rs