How cattr-app/desktop-application works
Cattr Desktop is an Electron time-tracking client. Users authenticate, select tasks and track time; the main process records intervals locally and supports offline operation and later synchronization with Cattr. The map separates the Vue workflow, IPC routing, domain controllers, tracking/OS integration and persistence. The excerpts establish only selected call paths; other documented capabilities are shown without speculative connections.
Main entry points: task-tracker.js Tracking engine · index.js SQLite database · routes/tasks.js Task routes · controller/tasks.js Task controller
Components 27
Desktop interface
- Renderer bootstrap
app/renderer/js/app.js - App shell
app/renderer/js/components/App.vue - Login
app/renderer/js/components/auth/Login.vue - User workspace
app/renderer/js/components/user/User.vue - Tracking controls
app/renderer/js/components/user/tasks/Tracker.vue - Task management
app/renderer/js/components/user/tasks/List.vue - Offline sync
app/renderer/js/components/user/pages/OfflineSync.vue - User settings
app/renderer/js/components/user/pages/Settings.vue
Electron and IPC
- Electron app
app/src/app.js - IPC routes
app/src/routes/index.js - Task routes
app/src/routes/tasks.js - Authentication routes
app/src/routes/authentication.js
Tracking domain
- Authentication
app/src/base/authentication.js - Task controller
app/src/controller/tasks.js - Time controller
app/src/controller/time.js - Interval controller
app/src/controller/time-intervals.js - Tracking engine
app/src/base/task-tracker.js - Tracking features
app/src/controller/tracking-features.js - Offline mode
app/src/base/offline-mode.js - OS integration
app/src/base/os-integration.js - User preferences
app/src/base/user-preferences.js - Cattr API client
app/src/base/api.js - Screenshot capture
app/src/utils/screenshot.js
Local persistence
- Data models
app/src/models/task.js - SQLite database
app/src/models/index.js
Other components
- Desktop user
- Cattr service
Connections 37
- Desktop user → Renderer bootstrap: uses
README.md - Renderer bootstrap → App shell: mounts
app/renderer/js/app.js - App shell → Login: routes to
- App shell → User workspace: routes to
- User workspace → Tracking controls: renders
app/renderer/js/components/user/User.vue - App shell → Screenshot capture: captures via
app/renderer/js/components/App.vue - Electron app → SQLite database: initializes
app/src/app.js - Electron app → IPC routes: configures
app/src/app.js - Electron app → OS integration: loads
app/src/app.js - IPC routes → Task routes: registers
- Task routes → Task controller: calls
app/src/routes/tasks.js - Task routes → Time controller: calls
app/src/routes/tasks.js - Task routes → Tracking engine: uses
app/src/routes/tasks.js - Task routes → User preferences: reads
app/src/routes/tasks.js - Authentication routes → Authentication: calls
app/src/routes/authentication.js - Authentication → Cattr API client: requests
app/src/base/authentication.js - Authentication → Offline mode: uses
app/src/base/authentication.js - Authentication → Tracking features: uses
app/src/base/authentication.js - Task controller → Cattr API client: requests
app/src/controller/tasks.js - Task controller → SQLite database: queries
app/src/controller/tasks.js - Time controller → Task controller: uses
app/src/controller/time.js - Time controller → SQLite database: queries
app/src/controller/time.js - Interval controller → Cattr API client: requests
app/src/controller/time-intervals.js - Interval controller → SQLite database: queries
app/src/controller/time-intervals.js - Tracking engine → Task controller: uses
app/src/base/task-tracker.js - Tracking engine → Time controller: uses
app/src/base/task-tracker.js - Tracking engine → Interval controller: uses
app/src/base/task-tracker.js - Tracking engine → Offline mode: checks
app/src/base/task-tracker.js - Tracking engine → Tracking features: checks
app/src/base/task-tracker.js - Tracking engine → Screenshot capture: captures
app/src/base/task-tracker.js - OS integration → Tracking engine: uses
app/src/base/os-integration.js - OS integration → User preferences: reads
app/src/base/os-integration.js - Tracking features → SQLite database: queries
app/src/controller/tracking-features.js - SQLite database → Data models: loads
app/src/models/index.js - Cattr API client → Cattr service: communicates
- Offline sync → Interval controller: sync requests
- User settings → User preferences: updates