# provincialcxz/worktimertrackerswift architecture

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

- Interactive diagram: https://gitdiagram.com/provincialcxz/worktimertrackerswift
- Repository: https://github.com/provincialcxz/worktimertrackerswift

## Overview

1. **Project shape**
   - This is a **Swift Package Manager** macOS app, not a server or library.
   - The runtime is a **desktop timer application** with a UI layer, a timer/pomodoro engine, persistence via SQLite, and a set of user-facing services like notifications, sound, export, and Dock/menu-bar behavior.

2. **Top-level entry points**
   - `WorkTimerTrackerApp.swift` is the SwiftUI app entry.
   - `AppDelegate.swift` likely bridges macOS app lifecycle concerns that SwiftUI doesn’t handle cleanly on its own, especially Dock/menu bar visibility and app behavior.
   - `AppModel.swift` is the main shared state/orchestration layer connecting views to core logic and services.

3. **UI layer**
   - The `Views/` folder contains the main screens:
     - `MainView` as the container/root screen
     - `TimerView` for live timer control
     - `HistoryView` for session browsing and filtering
     - `StatsView` for aggregated reporting
     - `SettingsView` for preferences
     - `EditSessionView` for modifying stored work sessions
     - `DayTimelineView` for a date-based visual breakdown
   - `AppTheme.swift` centralizes visual styling.
   - The UI is likely state-driven: views read from `AppModel` and trigger actions back into it.

4. **Core timer/pomodoro subsystem**
   - `Core/TimerEngine.swift` is the low-level timing engine for start, pause, resume, stop, and reset behavior.
   - `Core/PomodoroManager.swift` sits above the raw timer and manages pomodoro-specific state: work intervals, short/long breaks, and daily cycle counting.
   - This is the heart of the app’s time progression logic and should be treated as separate from persistence and UI.

5. **Domain model**
   - `Models/WorkSession.swift` represents a tracked session record, likely including timestamps, duration, project/tags, and status.
   - `Models/Formatters.swift` is a presentation/helper layer for converting dates, durations, and related values for display/export.
   - The domain model sits between the timer engine and the database/UI.

6. **Persistence boundary**
   - `Database/DatabaseManager.swift` owns SQLite setup and database access.
   - `Database/SessionRepository.swift` is the session-focused persistence API used by the rest of the app.
   - The database is explicitly stored in the user’s Application Support directory:
     `~/Library/Application Support/WorkTimerTracker/worktimertracker.sqlite3`
   - This is the main durable store for historical sessions and any edits.

7. **Data flow: live timer to stored session**
   - User actions in the UI start or control the timer.
   - `AppModel` passes those actions into the core timer/pomodoro layer.
   - When a work interval completes or a session is stopped, the app persists a `WorkSession` through the repository/database layer.
   - Historical views and stats read back from the repository, not from the live timer engine.

8. **History, stats, and editing**
   - `HistoryView` and `StatsView` are read-heavy consumers of the repository.
   - Filtering by date/project/tag is part of the history/query boundary, meaning the repository or model layer likely exposes query methods rather than the views filtering raw data themselves.
   - `EditSessionView` represents a write-back path from the UI to stored session records, so persistence is not append-only.

9. **Ancillary services**
   - `Services/NotificationService.swift` handles user notifications, probably for interval transitions and completion events.
   - `Services/SoundService.swift` handles alert sounds for timer events.
   - `Services/DockVisibilityService.swift` manages macOS-specific behavior around Dock/menu-bar presentation.
   - `Services/ExportService.swift` produces CSV and JSON exports from stored sessions, making the database a source for external reports.

10. **Platform and deployment behavior**
    - The README emphasizes running as a real `.app` for correct Dock/menu bar behavior, which implies some app behavior depends on macOS application packaging rather than plain `swift run`.
    - There are scripts to build the app bundle, package a DMG, generate icons, and create a DMG background, so distribution is a first-class concern.

11. **Repository-level boundaries**
    - `Sources/WorkTimerTrackerSwift/` is organized by concern: `Core`, `Database`, `Models`, `Services`, `Views`.
    - That separation suggests a clean flow:
      **UI → AppModel → Core/Services → Repository/SQLite**
      with read paths returning back up to the views.

12. **Testing and tooling**
    - There is a small XCTest target under `Tests/`, indicating at least some unit coverage, likely for core logic and model behavior.
    - `scripts/` contains packaging automation rather than build-time business logic, so it should be shown as a release/deployment support lane, not part of runtime architecture.

13. **What to show in an architecture diagram**
    - A macOS SwiftUI app shell at the top.
    - A central state/orchestration node (`AppModel`) connecting:
      - UI screens
      - timer/pomodoro engine
      - notifications/sound/Dock services
      - session repository/database
      - export service
    - A persistent SQLite store in Application Support as the system of record.
    - Separate packaging/release tooling outside the runtime path.

Main entry points: [`WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppModel.swift`](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppModel.swift) (AppModel), [`WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/MainView.swift`](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/MainView.swift) (Main View), [`WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/SessionRepository.swift`](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/SessionRepository.swift) (Sessions), [`WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/HistoryView.swift`](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/HistoryView.swift) (History)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_shell["App Shell"]
  node_worktimertracker_app["App<br/>swiftui entry"]
  node_app_delegate["Delegate<br/>lifecycle bridge<br/>[AppDelegate.swift]"]
  node_app_model["AppModel<br/>orchestrator<br/>[AppModel.swift]"]
end

subgraph group_ui["UI"]
  node_main_view["Main View<br/>root screen<br/>[MainView.swift]"]
  node_timer_view["Timer<br/>control view<br/>[TimerView.swift]"]
  node_history_view["History<br/>browse view<br/>[HistoryView.swift]"]
  node_stats_view["Stats<br/>report view<br/>[StatsView.swift]"]
  node_settings_view["Settings<br/>prefs view<br/>[SettingsView.swift]"]
  node_edit_session_view["Edit Session<br/>edit view"]
  node_day_timeline_view["Day Timeline<br/>timeline view"]
  node_app_theme["Theme<br/>styling<br/>[AppTheme.swift]"]
end

subgraph group_core["Core"]
  node_timer_engine["Timer Engine<br/>clock engine<br/>[TimerEngine.swift]"]
  node_pomodoro_manager["Pomodoro<br/>interval manager"]
end

subgraph group_data["Data"]
  node_work_session["WorkSession<br/>domain record<br/>[WorkSession.swift]"]
  node_formatters["Formatters<br/>presentation helpers<br/>[Formatters.swift]"]
  node_database_manager[("Database<br/>sqlite store")]
  node_session_repository["Sessions"]
end

subgraph group_services["Services"]
  node_notification_service["Notifications<br/>user alerts"]
  node_sound_service["Sound<br/>audio alerts<br/>[SoundService.swift]"]
  node_dock_visibility_service["Dock Visibility<br/>macOS behavior"]
  node_export_service["Export"]
end

subgraph group_tooling["Tooling"]
  node_build_script["Build App<br/>shell script<br/>[build_app.sh]"]
  node_package_script["Package DMG<br/>shell script<br/>[package_dmg.sh]"]
  node_icon_script["App Icon<br/>swift script"]
  node_dmg_bg_script["DMG Background<br/>swift script"]
end

node_worktimertracker_app -->|"lifecycle"| node_app_delegate
node_worktimertracker_app -->|"creates"| node_app_model
node_app_delegate -->|"controls"| node_dock_visibility_service
node_app_model -->|"binds"| node_main_view
node_main_view -->|"contains"| node_timer_view
node_main_view -->|"contains"| node_history_view
node_main_view -->|"contains"| node_stats_view
node_main_view -->|"contains"| node_settings_view
node_main_view -->|"contains"| node_day_timeline_view
node_app_model -->|"drives"| node_pomodoro_manager
node_pomodoro_manager -->|"uses"| node_timer_engine
node_app_model -->|"reads/writes"| node_session_repository
node_session_repository -->|"backed by"| node_database_manager
node_database_manager -->|"stores"| node_work_session
node_history_view -->|"queries"| node_session_repository
node_stats_view -->|"aggregates"| node_session_repository
node_edit_session_view -->|"updates"| node_session_repository
node_app_model -->|"triggers"| node_notification_service
node_app_model -->|"triggers"| node_sound_service
node_app_model -->|"exports"| node_export_service
node_history_view -->|"formats"| node_formatters
node_stats_view -->|"formats"| node_formatters
node_build_script -->|"supports"| node_package_script
node_package_script -->|"uses"| node_dmg_bg_script
node_package_script -->|"uses"| node_icon_script

click node_worktimertracker_app "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/WorkTimerTrackerApp.swift"
click node_app_delegate "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppDelegate.swift"
click node_app_model "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppModel.swift"
click node_main_view "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/MainView.swift"
click node_timer_view "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/TimerView.swift"
click node_history_view "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/HistoryView.swift"
click node_stats_view "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/StatsView.swift"
click node_settings_view "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/SettingsView.swift"
click node_edit_session_view "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/EditSessionView.swift"
click node_day_timeline_view "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/DayTimelineView.swift"
click node_app_theme "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/AppTheme.swift"
click node_timer_engine "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Core/TimerEngine.swift"
click node_pomodoro_manager "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Core/PomodoroManager.swift"
click node_work_session "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Models/WorkSession.swift"
click node_formatters "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Models/Formatters.swift"
click node_database_manager "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/DatabaseManager.swift"
click node_session_repository "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/SessionRepository.swift"
click node_notification_service "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/NotificationService.swift"
click node_sound_service "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/SoundService.swift"
click node_dock_visibility_service "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/DockVisibilityService.swift"
click node_export_service "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/ExportService.swift"
click node_build_script "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/build_app.sh"
click node_package_script "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/package_dmg.sh"
click node_icon_script "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/make_app_icon.swift"
click node_dmg_bg_script "https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/make_dmg_background.swift"

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_worktimertracker_app,node_app_delegate,node_app_model toneBlue
class node_main_view,node_timer_view,node_history_view,node_stats_view,node_settings_view,node_edit_session_view,node_day_timeline_view,node_app_theme toneAmber
class node_timer_engine,node_pomodoro_manager toneMint
class node_work_session,node_formatters,node_database_manager,node_session_repository toneRose
class node_notification_service,node_sound_service,node_dock_visibility_service,node_export_service toneIndigo
class node_build_script,node_package_script,node_icon_script,node_dmg_bg_script toneTeal
```

## Components

### App Shell

macOS app entry and lifecycle coordination

- [App](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/WorkTimerTrackerApp.swift): swiftui entry · SwiftUI application entry point · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/WorkTimerTrackerApp.swift`
- [Delegate](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppDelegate.swift): lifecycle bridge · Bridges macOS app lifecycle behavior SwiftUI does not cover cleanly · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppDelegate.swift`
- [AppModel](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppModel.swift): orchestrator · Shared state and coordination layer connecting UI, core logic, and services · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/AppModel.swift`

### UI

SwiftUI screens and theme

- [Main View](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/MainView.swift): root screen · Root container for the app's visible UI · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/MainView.swift`
- [Timer](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/TimerView.swift): control view · Live timer controls and active session display · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/TimerView.swift`
- [History](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/HistoryView.swift): browse view · Session history browsing and filtering · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/HistoryView.swift`
- [Stats](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/StatsView.swift): report view · Aggregated reporting and session summaries · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/StatsView.swift`
- [Settings](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/SettingsView.swift): prefs view · User preferences and app settings · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/SettingsView.swift`
- [Edit Session](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/EditSessionView.swift): edit view · Write-back UI for modifying stored sessions · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/EditSessionView.swift`
- [Day Timeline](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/DayTimelineView.swift): timeline view · Date-based breakdown of work activity · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/DayTimelineView.swift`
- [Theme](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/AppTheme.swift): styling · Shared visual styling and UI appearance constants · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Views/AppTheme.swift`

### Core

Timer and pomodoro progression

- [Timer Engine](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Core/TimerEngine.swift): clock engine · Low-level start, pause, resume, stop, and reset timing logic · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Core/TimerEngine.swift`
- [Pomodoro](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Core/PomodoroManager.swift): interval manager · Pomodoro-specific work/break cycle and session progression · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Core/PomodoroManager.swift`

### Data

Domain model and SQLite persistence

- [WorkSession](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Models/WorkSession.swift): domain record · Tracked session model stored and edited by the app · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Models/WorkSession.swift`
- [Formatters](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Models/Formatters.swift): presentation helpers · Date, duration, and display formatting helpers · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Models/Formatters.swift`
- [Database](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/DatabaseManager.swift): sqlite store · SQLite setup and access layer; persists in Application Support · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/DatabaseManager.swift`
- [Sessions](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/SessionRepository.swift): repository · Session-focused persistence API used by the app · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Database/SessionRepository.swift`

### Services

macOS notifications, sound, export, and Dock behavior

- [Notifications](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/NotificationService.swift): user alerts · Local notifications for timer transitions and completion events · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/NotificationService.swift`
- [Sound](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/SoundService.swift): audio alerts · Alert sound playback for timer events · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/SoundService.swift`
- [Dock Visibility](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/DockVisibilityService.swift): macOS behavior · Controls Dock/menu-bar presentation behavior on macOS · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/DockVisibilityService.swift`
- [Export](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/ExportService.swift): csv/json export · Exports stored sessions for external reporting · `WorkTimerTrackerSwift/Sources/WorkTimerTrackerSwift/Services/ExportService.swift`

### Tooling

Packaging and release scripts

- [Build App](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/build_app.sh): shell script · Builds the app bundle for distribution · `WorkTimerTrackerSwift/scripts/build_app.sh`
- [Package DMG](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/package_dmg.sh): shell script · Creates the distributable DMG package · `WorkTimerTrackerSwift/scripts/package_dmg.sh`
- [App Icon](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/make_app_icon.swift): swift script · Generates application icons · `WorkTimerTrackerSwift/scripts/make_app_icon.swift`
- [DMG Background](https://github.com/provincialcxz/worktimertrackerswift/blob/master/WorkTimerTrackerSwift/scripts/make_dmg_background.swift): swift script · Generates DMG background artwork · `WorkTimerTrackerSwift/scripts/make_dmg_background.swift`

## Connections

- App → Delegate: lifecycle · Application startup and macOS lifecycle integration
- App → AppModel: creates · App entry constructs the shared model
- Delegate → Dock Visibility: controls · Lifecycle bridge influences Dock/menu-bar presentation
- AppModel → Main View: binds · Shared state is observed by the root UI
- Main View → Timer: contains · Root screen hosts the live timer screen
- Main View → History: contains · Root screen hosts session history
- Main View → Stats: contains · Root screen hosts reporting views
- Main View → Settings: contains · Root screen hosts preferences
- Main View → Day Timeline: contains · Root screen hosts day breakdown view
- AppModel → Pomodoro: drives · Model sends timer control into pomodoro progression
- Pomodoro → Timer Engine: uses · Pomodoro logic is built atop the raw timer engine
- AppModel → Sessions: reads/writes · Model persists and queries tracked sessions
- Sessions → Database: backed by · Repository delegates to SQLite storage
- Database → WorkSession: stores · Persistent records are session domain objects
- History → Sessions: queries · History screen reads stored sessions and filters them
- Stats → Sessions: aggregates · Stats screen reads persisted sessions for summaries
- Edit Session → Sessions: updates · Editing screen writes changes back to persistence
- AppModel → Notifications: triggers · Timer transitions can produce notifications
- AppModel → Sound: triggers · Timer events can play alert sounds
- AppModel → Export: exports · Shared model coordinates CSV/JSON export from stored sessions
- History → Formatters: formats · History display uses shared presentation formatting
- Stats → Formatters: formats · Stats display uses shared presentation formatting
- Build App → Package DMG: supports · Build step feeds packaging workflow
- Package DMG → DMG Background: uses · DMG packaging relies on generated background assets
- Package DMG → App Icon: uses · Packaging workflow relies on generated app icons
