How n4hkro/dobby works
Dobby is a Windows desktop host for authenticated, plugin-based business workflows. The main user journey is startup and login, followed by session establishment and presentation of the shell, where users navigate plugin pages and manage ongoing work sessions; plugin installation, licensing, administration, and settings support that experience. The architecture separates host orchestration, plugin runtime, security/licensing, and persistence. The README is empty, so product capabilities are inferred from the supplied source tree; edges are limited to relationships shown by excerpts or SOURCE INDEX references.
Main entry points: PluginServiceRegistrationBridge.cs Plugin activation · ShellViewModel.cs Shell view model · App.xaml.cs Host startup · LicenseImportService.cs License import
Components 28
Host and shell
- Host startup
src/Dobby.Host/App.xaml.cs - Login runtime
src/Dobby.Host/Login/HostLoginRuntime.cs - Login and recovery UI
src/Dobby.Host/Login - Shell view model
src/Dobby.Shell/ShellViewModel.cs - Navigation registry
src/Dobby.Navigation/RouteRegistry.cs - Work sessions
src/Dobby.Shell/WorkSessions/WorkSessionRegistry.cs - Session close flow
src/Dobby.Shell/WorkSessions/WorkSessionCloseCoordinator.cs - Host settings
src/Dobby.Host/Settings - Print output
src/Dobby.Host/Printing/HostPrintOutputService.cs - Admin command host
src/Dobby.Admin/Commands/AdminCommandHost.cs
Plugin runtime
- Plugin packages
src/Dobby.PluginFramework/Packaging/PluginPackageInstaller.cs - Plugin activation
src/Dobby.PluginFramework/Activation/PluginServiceRegistrationBridge.cs - Plugin lifetime
src/Dobby.PluginFramework/Activation/PluginLifetimeManager.cs - Plugin storage
src/Dobby.Host/Plugins/HostPluginStorage.cs - Plugin pages
src/Dobby.Shell/PluginPages/PluginPageRenderRegistry.cs
Identity and licensing
- Authentication
src/Dobby.Security/Authentication/LoginService.cs - Session lifecycle
src/Dobby.Security/Authentication/SessionLifecycleService.cs - Managed users
src/Dobby.Security/Authentication/ManagedUserService.cs - Operation authorization
src/Dobby.Security/Authorization/OperationAuthorizationPolicy.cs - License import
src/Dobby.Licensing/LicenseImportService.cs - Deployment context
src/Dobby.Security/CurrentContext/CurrentCustomerDeploymentContextService.cs
Persistence and services
- Audit trail
src/Dobby.Audit/Persistence/DurableAuditTrail.cs - Host persistence
src/Dobby.Infrastructure/Persistence/HostPersistenceMaintenanceService.cs - Persistence commands
src/Dobby.Infrastructure/Persistence/IHostPersistenceCommandExecutor.cs - SQLite database
src/Dobby.Infrastructure/Persistence/EncryptedSqliteConnectionFactory.cs - Diagnostics export
src/Dobby.Diagnostics/DiagnosticsExportPackageBuilder.cs
Other components
- Desktop user
- Print device
Connections 31
- Desktop user → Host startup: starts app
src/Dobby.Host/App.xaml.cs - Host startup → Login runtime: prepares login
src/Dobby.Host/App.xaml.cs - Host startup → Login and recovery UI: shows login
src/Dobby.Host/App.xaml.cs - Desktop user → Login and recovery UI: authenticates
- Login and recovery UI → Authentication: submits credentials
- Login runtime → Session lifecycle: prepares session
- Host startup → Shell view model: presents shell
src/Dobby.Host/App.xaml.cs - Desktop user → Shell view model: uses shell
- Shell view model → Navigation registry: resolves routes
- Shell view model → Work sessions: tracks work
- Session close flow → Work sessions: closes sessions
src/Dobby.Shell/WorkSessions/WorkSessionCloseCoordinator.cs - Shell view model → Session close flow: requests closure
- Desktop user → Plugin packages: installs plugins
- Plugin packages → Plugin activation: activates plugins
- Plugin activation → Plugin lifetime: tracks disposables
src/Dobby.PluginFramework/Activation/PluginServiceRegistrationBridge.cs - Plugin activation → Operation authorization: provides policy
- Plugin activation → Plugin pages: registers pages
- Plugin activation → Plugin storage: provides storage
- Plugin storage → Persistence commands: executes commands
src/Dobby.Host/Plugins/HostPluginStorage.cs - Persistence commands → SQLite database: uses database
- Desktop user → License import: imports license
- License import → Deployment context: validates binding
src/Dobby.Licensing/LicenseImportService.cs - License import → Operation authorization: updates runtime mode
- Managed users → Operation authorization: checks permissions
src/Dobby.Security/Authentication/ManagedUserService.cs - Session lifecycle → Audit trail: records changes
- Host persistence → SQLite database: maintains store
src/Dobby.Infrastructure/Persistence/HostPersistenceMaintenanceService.cs - Desktop user → Host settings: changes preferences
- Desktop user → Admin command host: runs commands
- Desktop user → Print output: requests printing
- Print output → Print device: sends output
- Desktop user → Diagnostics export: exports diagnostics