# dctn/aura_window_app architecture

> Architecture diagram of the GitHub repository dctn/aura_window_app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dctn/aura_window_app
- Repository: https://github.com/dctn/aura_window_app

## Overview

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: [`src/aura/core/app_model.py`](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/app_model.py) (App state), [`src/aura/ui/shell.py`](https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/shell.py) (Window shell), [`src/aura/core/capacity_service.py`](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/capacity_service.py) (Capacity service), [`src/aura/ui/pages/tasks.py`](https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/pages/tasks.py) (Task board)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_entry["App entry<br/>[__main__.py]"]
  node_model["App state<br/>[app_model.py]"]
end

subgraph group_domain["Planning and wellbeing"]
  node_models["Domain models<br/>[models.py]"]
  node_tasks["Task planning<br/>[tasks.py]"]
  node_calendar["Calendar logic<br/>[calendar.py]"]
  node_capacity["Capacity model<br/>[capacity.py]"]
  node_capacityservice["Capacity service"]
  node_metrics["Metrics logic<br/>[metrics.py]"]
  node_work["Work sessions<br/>[work_session.py]"]
  node_sessionservices["Session controls"]
end

subgraph group_integrations["Services and sync"]
  node_activity["Activity tracking<br/>[activity.py]"]
  node_cloud["Cloud sync<br/>[cloud_sync.py]"]
  node_api["Clarus API<br/>[clarus_api.py]"]
  node_async["Async work<br/>[tasks.py]"]
  node_systemmotion["System motion<br/>[system_motion.py]"]
  node_storage[("Local storage<br/>[storage.py]")]
end

subgraph group_presentation["User interface"]
  node_shell["Window shell<br/>[shell.py]"]
  node_taskpage["Task board<br/>[tasks.py]"]
  node_calendarpage["Calendar page<br/>[calendar.py]"]
  node_trends["Activity trends<br/>[trends_activity.py]"]
end

node_user(("User"))

node_user -.->|"uses"| node_shell
node_entry -->|"initializes"| node_model
node_shell -->|"uses state"| node_model
node_shell -->|"routes to"| node_taskpage
node_shell -->|"routes to"| node_calendarpage
node_taskpage -->|"reads and updates"| node_model
node_taskpage -->|"uses rules"| node_tasks
node_calendarpage -->|"reads and updates"| node_model
node_calendarpage -->|"uses logic"| node_calendar
node_model -->|"holds data"| node_models
node_model -->|"uses"| node_calendar
node_model -->|"uses"| node_capacity
node_capacityservice -->|"decodes"| node_capacity
node_capacityservice -->|"requests data"| node_api
node_trends -->|"uses metrics"| node_metrics
node_trends -->|"reads state"| node_model
node_work -->|"uses state"| node_model
node_sessionservices -->|"records activity"| node_activity
node_cloud -->|"calls"| node_api
node_cloud -->|"syncs data"| node_models
node_capacityservice -.->|"runs requests"| node_async
node_systemmotion -.->|"supports motion"| node_work

click node_entry "https://github.com/dctn/aura_window_app/blob/main/src/aura/__main__.py"
click node_shell "https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/shell.py"
click node_model "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/app_model.py"
click node_models "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/models.py"
click node_tasks "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/tasks.py"
click node_taskpage "https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/pages/tasks.py"
click node_calendar "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/calendar.py"
click node_calendarpage "https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/pages/calendar.py"
click node_capacity "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/capacity.py"
click node_capacityservice "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/capacity_service.py"
click node_trends "https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/pages/trends_activity.py"
click node_metrics "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/metrics.py"
click node_work "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/work_session.py"
click node_sessionservices "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/session_services.py"
click node_activity "https://github.com/dctn/aura_window_app/blob/main/src/aura/services/activity.py"
click node_cloud "https://github.com/dctn/aura_window_app/blob/main/src/aura/core/cloud_sync.py"
click node_api "https://github.com/dctn/aura_window_app/blob/main/src/aura/services/clarus_api.py"
click node_async "https://github.com/dctn/aura_window_app/blob/main/src/aura/services/tasks.py"
click node_systemmotion "https://github.com/dctn/aura_window_app/blob/main/src/aura/services/system_motion.py"
click node_storage "https://github.com/dctn/aura_window_app/blob/main/src/aura/services/storage.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_model,node_user toneBlue
class node_models,node_tasks,node_calendar,node_capacity,node_capacityservice,node_metrics,node_work,node_sessionservices toneAmber
class node_activity,node_cloud,node_api,node_async,node_systemmotion,node_storage toneMint
class node_shell,node_taskpage,node_calendarpage,node_trends toneRose
```

## Components

### Desktop app

- [App entry](https://github.com/dctn/aura_window_app/blob/main/src/aura/__main__.py): `src/aura/__main__.py`
- [App state](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/app_model.py): `src/aura/core/app_model.py`

### Planning and wellbeing

- [Domain models](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/models.py): `src/aura/core/models.py`
- [Task planning](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/tasks.py): `src/aura/core/tasks.py`
- [Calendar logic](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/calendar.py): `src/aura/core/calendar.py`
- [Capacity model](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/capacity.py): `src/aura/core/capacity.py`
- [Capacity service](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/capacity_service.py): `src/aura/core/capacity_service.py`
- [Metrics logic](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/metrics.py): `src/aura/core/metrics.py`
- [Work sessions](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/work_session.py): `src/aura/core/work_session.py`
- [Session controls](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/session_services.py): `src/aura/core/session_services.py`

### Services and sync

- [Activity tracking](https://github.com/dctn/aura_window_app/blob/main/src/aura/services/activity.py): `src/aura/services/activity.py`
- [Cloud sync](https://github.com/dctn/aura_window_app/blob/main/src/aura/core/cloud_sync.py): `src/aura/core/cloud_sync.py`
- [Clarus API](https://github.com/dctn/aura_window_app/blob/main/src/aura/services/clarus_api.py): `src/aura/services/clarus_api.py`
- [Async work](https://github.com/dctn/aura_window_app/blob/main/src/aura/services/tasks.py): `src/aura/services/tasks.py`
- [System motion](https://github.com/dctn/aura_window_app/blob/main/src/aura/services/system_motion.py): `src/aura/services/system_motion.py`
- [Local storage](https://github.com/dctn/aura_window_app/blob/main/src/aura/services/storage.py): `src/aura/services/storage.py`

### User interface

- [Window shell](https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/shell.py): `src/aura/ui/shell.py`
- [Task board](https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/pages/tasks.py): `src/aura/ui/pages/tasks.py`
- [Calendar page](https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/pages/calendar.py): `src/aura/ui/pages/calendar.py`
- [Activity trends](https://github.com/dctn/aura_window_app/blob/main/src/aura/ui/pages/trends_activity.py): `src/aura/ui/pages/trends_activity.py`

### Other components

- **User**

## Connections

- User → Window shell: uses
- App entry → App state: initializes (evidence: `src/aura/__main__.py`)
- Window shell → App state: uses state (evidence: `src/aura/ui/shell.py`)
- Window shell → Task board: routes to (evidence: `src/aura/ui/shell.py`)
- Window shell → Calendar page: routes to (evidence: `src/aura/ui/shell.py`)
- Task board → App state: reads and updates (evidence: `src/aura/ui/pages/tasks.py`)
- Task board → Task planning: uses rules (evidence: `src/aura/ui/pages/tasks.py`)
- Calendar page → App state: reads and updates (evidence: `src/aura/ui/pages/calendar.py`)
- Calendar page → Calendar logic: uses logic (evidence: `src/aura/ui/pages/calendar.py`)
- App state → Domain models: holds data (evidence: `src/aura/core/app_model.py`)
- App state → Calendar logic: uses (evidence: `src/aura/core/app_model.py`)
- App state → Capacity model: uses (evidence: `src/aura/core/app_model.py`)
- Capacity service → Capacity model: decodes (evidence: `src/aura/core/capacity_service.py`)
- Capacity service → Clarus API: requests data (evidence: `src/aura/core/capacity_service.py`)
- Activity trends → Metrics logic: uses metrics (evidence: `src/aura/ui/pages/trends_activity.py`)
- Activity trends → App state: reads state (evidence: `src/aura/ui/pages/trends_activity.py`)
- Work sessions → App state: uses state (evidence: `src/aura/core/work_session.py`)
- Session controls → Activity tracking: records activity (evidence: `src/aura/core/session_services.py`)
- Cloud sync → Clarus API: calls (evidence: `src/aura/core/cloud_sync.py`)
- Cloud sync → Domain models: syncs data (evidence: `src/aura/core/cloud_sync.py`)
- Capacity service → Async work: runs requests (evidence: `src/aura/core/capacity_service.py`)
- System motion → Work sessions: supports motion
