How dctn/aura_window_app works
Aura is a desktop productivity and wellbeing app: users navigate a desktop shell to manage tasks and calendar events, review capacity and activity, and run focused work sessions. The central AppModel holds application state; domain modules handle task, calendar, capacity, and metrics behavior, while services provide cloud and system integrations. The source index supports several module relationships, but the README is empty and many modules were not sampled, so uncertain integrations and page flows are omitted rather than inferred.
Main entry points: app_model.py App state · shell.py Window shell · capacity_service.py Capacity service · tasks.py Task board
Components 21
Planning and wellbeing
- Domain models
src/aura/core/models.py - Task planning
src/aura/core/tasks.py - Calendar logic
src/aura/core/calendar.py - Capacity model
src/aura/core/capacity.py - Capacity service
src/aura/core/capacity_service.py - Metrics logic
src/aura/core/metrics.py - Work sessions
src/aura/core/work_session.py - Session controls
src/aura/core/session_services.py
Services and sync
- Activity tracking
src/aura/services/activity.py - Cloud sync
src/aura/core/cloud_sync.py - Clarus API
src/aura/services/clarus_api.py - Async work
src/aura/services/tasks.py - System motion
src/aura/services/system_motion.py - Local storage
src/aura/services/storage.py
User interface
- Window shell
src/aura/ui/shell.py - Task board
src/aura/ui/pages/tasks.py - Calendar page
src/aura/ui/pages/calendar.py - Activity trends
src/aura/ui/pages/trends_activity.py
Other components
- User
Connections 22
- User → Window shell: uses
- App entry → App state: initializes
src/aura/__main__.py - Window shell → App state: uses state
src/aura/ui/shell.py - Window shell → Task board: routes to
src/aura/ui/shell.py - Window shell → Calendar page: routes to
src/aura/ui/shell.py - Task board → App state: reads and updates
src/aura/ui/pages/tasks.py - Task board → Task planning: uses rules
src/aura/ui/pages/tasks.py - Calendar page → App state: reads and updates
src/aura/ui/pages/calendar.py - Calendar page → Calendar logic: uses logic
src/aura/ui/pages/calendar.py - App state → Domain models: holds data
src/aura/core/app_model.py - App state → Calendar logic: uses
src/aura/core/app_model.py - App state → Capacity model: uses
src/aura/core/app_model.py - Capacity service → Capacity model: decodes
src/aura/core/capacity_service.py - Capacity service → Clarus API: requests data
src/aura/core/capacity_service.py - Activity trends → Metrics logic: uses metrics
src/aura/ui/pages/trends_activity.py - Activity trends → App state: reads state
src/aura/ui/pages/trends_activity.py - Work sessions → App state: uses state
src/aura/core/work_session.py - Session controls → Activity tracking: records activity
src/aura/core/session_services.py - Cloud sync → Clarus API: calls
src/aura/core/cloud_sync.py - Cloud sync → Domain models: syncs data
src/aura/core/cloud_sync.py - Capacity service → Async work: runs requests
src/aura/core/capacity_service.py - System motion → Work sessions: supports motion