# borconi/openzeekr architecture

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

- Interactive diagram: https://gitdiagram.com/borconi/openzeekr
- Repository: https://github.com/borconi/openzeekr

## Overview

OpenZeekr is an Android companion for Zeekr vehicles, combining cloud-account and remote-control features with an offline BLE digital key; a Wear OS app can borrow that key. The main user journey is sign-in and vehicle setup, then viewing status or issuing a command through cloud or BLE. The graph preserves the documented proximity, provisioning, parking-research, and watch capabilities. Evidence is limited to the README, source index, and sampled excerpts; unsampled implementation details are not inferred.

Main entry points: [`core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt`](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt) (BLE connection), [`core/src/main/java/com/openzeekr/app/Deps.kt`](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/Deps.kt) (App dependencies), [`core/src/main/java/com/openzeekr/app/remote/VehicleControl.kt`](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/VehicleControl.kt) (Command dispatch), [`core/src/main/java/com/openzeekr/app/remote/Repositories.kt`](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/Repositories.kt) (Cloud repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_app_lifecycle["App lifecycle<br/>[App.kt]"]
  node_app_shell["App navigation<br/>[AppRoot.kt]"]
  node_vehicle_ui["Vehicle controls<br/>[VehicleScreen.kt]"]
  node_setup_ui["Account setup"]
  node_deps["App dependencies<br/>[Deps.kt]"]
end

subgraph group_cloud["Cloud services"]
  node_config[("Encrypted settings<br/>[ConfigStore.kt]")]
  node_auth["Account login<br/>[AccountLogin.kt]"]
  node_api["TSP transport<br/>[ApiClient.kt]"]
  node_repositories["Cloud repositories<br/>[Repositories.kt]"]
  node_vehicle_state["Vehicle status"]
  node_cloud_service{{"Zeekr TSP"}}
end

subgraph group_digital_key["Digital key"]
  node_control_dispatch["Command dispatch<br/>[VehicleControl.kt]"]
  node_dk_identity["Key identity<br/>[DkIdentity.kt]"]
  node_provisioning["Key provisioning<br/>[DkProvisioning.kt]"]
  node_ble_manager["BLE connection<br/>[DkBleManager.kt]"]
  node_dk_session["DK session<br/>[RealDkSession.kt]"]
  node_dk_protocol["BLE protocol<br/>[DkProtocol.kt]"]
  node_lock_control["Lock control"]
end

subgraph group_automation["Proximity and parking"]
  node_proximity_service["BLE foreground service"]
  node_proximity["Proximity automation"]
  node_motion["Motion monitoring<br/>[MotionMonitor.kt]"]
  node_rpa["Remote parking<br/>[RpaController.kt]"]
end

subgraph group_wear["Wear companion"]
  node_phone_wear["Phone key sync"]
  node_wear_protocol["Wear key protocol<br/>[WearKeyProtocol.kt]"]
  node_watch_app["Watch controls<br/>[WearApp.kt]"]
  node_watch_link["Watch phone link<br/>[PhoneLink.kt]"]
end

node_user(("Vehicle owner"))
node_vehicle{{"Zeekr vehicle"}}
node_watch(("Wear OS watch"))

node_user -->|"uses"| node_app_shell
node_app_shell -.->|"offers setup"| node_setup_ui
node_app_shell -.->|"offers controls"| node_vehicle_ui
node_app_lifecycle -->|"creates"| node_deps
node_deps -->|"loads"| node_config
node_deps -->|"creates"| node_api
node_deps -->|"creates"| node_repositories
node_setup_ui -.->|"signs in"| node_auth
node_auth -.->|"uses"| node_api
node_api -->|"sends requests"| node_cloud_service
node_repositories -->|"uses"| node_api
node_repositories -.->|"requests vehicle data"| node_cloud_service
node_app_lifecycle -->|"starts polling"| node_vehicle_state
node_vehicle_ui -->|"issues commands"| node_control_dispatch
node_control_dispatch -->|"tries BLE first"| node_ble_manager
node_control_dispatch -->|"falls back cloud"| node_repositories
node_deps -->|"creates"| node_ble_manager
node_deps -->|"loads identity"| node_dk_identity
node_deps -->|"creates"| node_provisioning
node_ble_manager -->|"establishes"| node_dk_session
node_ble_manager -->|"uses framing"| node_dk_protocol
node_lock_control -->|"sends controls"| node_dk_session
node_control_dispatch -.->|"actuates key"| node_lock_control
node_ble_manager -->|"connects over BLE"| node_vehicle
node_provisioning -->|"pairs key"| node_vehicle
node_proximity_service -->|"manages link"| node_ble_manager
node_proximity_service -.->|"runs automation"| node_proximity
node_proximity -->|"monitors RSSI"| node_ble_manager
node_proximity -.->|"locks vehicle"| node_lock_control
node_proximity_service -->|"uses motion"| node_motion
node_rpa -->|"uses session"| node_dk_session
node_phone_wear -->|"encodes messages"| node_wear_protocol
node_watch_link -->|"uses messages"| node_wear_protocol
node_watch_app -->|"communicates through"| node_watch_link
node_watch -->|"uses"| node_watch_app
node_phone_wear -->|"shares key"| node_watch
node_watch_app -->|"controls directly"| node_ble_manager

click node_app_lifecycle "https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/App.kt"
click node_app_shell "https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/ui/AppRoot.kt"
click node_vehicle_ui "https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/ui/VehicleScreen.kt"
click node_setup_ui "https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/ui/OnboardingScreen.kt"
click node_deps "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/Deps.kt"
click node_config "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/config/ConfigStore.kt"
click node_auth "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/net/AccountLogin.kt"
click node_api "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/net/ApiClient.kt"
click node_repositories "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/Repositories.kt"
click node_vehicle_state "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/VehicleStatusHolder.kt"
click node_control_dispatch "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/VehicleControl.kt"
click node_dk_identity "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkIdentity.kt"
click node_provisioning "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkProvisioning.kt"
click node_ble_manager "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt"
click node_dk_session "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/RealDkSession.kt"
click node_dk_protocol "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkProtocol.kt"
click node_lock_control "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkLockController.kt"
click node_proximity_service "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/ProximityService.kt"
click node_proximity "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/ProximityController.kt"
click node_motion "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/MotionMonitor.kt"
click node_rpa "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/rpa/RpaController.kt"
click node_phone_wear "https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/wear/PhoneKeySyncService.kt"
click node_wear_protocol "https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/wear/WearKeyProtocol.kt"
click node_watch_app "https://github.com/borconi/openzeekr/blob/master/wear/src/main/java/com/openzeekr/wear/WearApp.kt"
click node_watch_link "https://github.com/borconi/openzeekr/blob/master/wear/src/main/java/com/openzeekr/wear/PhoneLink.kt"

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_app_lifecycle,node_app_shell,node_vehicle_ui,node_setup_ui,node_deps toneBlue
class node_config,node_auth,node_api,node_repositories,node_vehicle_state,node_cloud_service toneAmber
class node_control_dispatch,node_dk_identity,node_provisioning,node_ble_manager,node_dk_session,node_dk_protocol,node_lock_control toneMint
class node_proximity_service,node_proximity,node_motion,node_rpa toneRose
class node_phone_wear,node_wear_protocol,node_watch_app,node_watch_link,node_user,node_vehicle,node_watch toneIndigo
```

## Components

### Android app

- [App lifecycle](https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/App.kt): `app/src/main/java/com/openzeekr/app/App.kt`
- [App navigation](https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/ui/AppRoot.kt): `app/src/main/java/com/openzeekr/app/ui/AppRoot.kt`
- [Vehicle controls](https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/ui/VehicleScreen.kt): `app/src/main/java/com/openzeekr/app/ui/VehicleScreen.kt`
- [Account setup](https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/ui/OnboardingScreen.kt): `app/src/main/java/com/openzeekr/app/ui/OnboardingScreen.kt`
- [App dependencies](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/Deps.kt): `core/src/main/java/com/openzeekr/app/Deps.kt`

### Cloud services

- [Encrypted settings](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/config/ConfigStore.kt): `core/src/main/java/com/openzeekr/app/config/ConfigStore.kt`
- [Account login](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/net/AccountLogin.kt): `core/src/main/java/com/openzeekr/app/net/AccountLogin.kt`
- [TSP transport](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/net/ApiClient.kt): `core/src/main/java/com/openzeekr/app/net/ApiClient.kt`
- [Cloud repositories](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/Repositories.kt): `core/src/main/java/com/openzeekr/app/remote/Repositories.kt`
- [Vehicle status](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/VehicleStatusHolder.kt): `core/src/main/java/com/openzeekr/app/remote/VehicleStatusHolder.kt`
- **Zeekr TSP**

### Digital key

- [Command dispatch](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/remote/VehicleControl.kt): `core/src/main/java/com/openzeekr/app/remote/VehicleControl.kt`
- [Key identity](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkIdentity.kt): `core/src/main/java/com/openzeekr/app/ble/DkIdentity.kt`
- [Key provisioning](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkProvisioning.kt): `core/src/main/java/com/openzeekr/app/ble/DkProvisioning.kt`
- [BLE connection](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt): `core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt`
- [DK session](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/RealDkSession.kt): `core/src/main/java/com/openzeekr/app/ble/RealDkSession.kt`
- [BLE protocol](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkProtocol.kt): `core/src/main/java/com/openzeekr/app/ble/DkProtocol.kt`
- [Lock control](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/DkLockController.kt): `core/src/main/java/com/openzeekr/app/ble/DkLockController.kt`

### Proximity and parking

- [BLE foreground service](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/ProximityService.kt): `core/src/main/java/com/openzeekr/app/ble/ProximityService.kt`
- [Proximity automation](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/ProximityController.kt): `core/src/main/java/com/openzeekr/app/ble/ProximityController.kt`
- [Motion monitoring](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/MotionMonitor.kt): `core/src/main/java/com/openzeekr/app/ble/MotionMonitor.kt`
- [Remote parking](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/ble/rpa/RpaController.kt): `core/src/main/java/com/openzeekr/app/ble/rpa/RpaController.kt`

### Wear companion

- [Phone key sync](https://github.com/borconi/openzeekr/blob/master/app/src/main/java/com/openzeekr/app/wear/PhoneKeySyncService.kt): `app/src/main/java/com/openzeekr/app/wear/PhoneKeySyncService.kt`
- [Wear key protocol](https://github.com/borconi/openzeekr/blob/master/core/src/main/java/com/openzeekr/app/wear/WearKeyProtocol.kt): `core/src/main/java/com/openzeekr/app/wear/WearKeyProtocol.kt`
- [Watch controls](https://github.com/borconi/openzeekr/blob/master/wear/src/main/java/com/openzeekr/wear/WearApp.kt): `wear/src/main/java/com/openzeekr/wear/WearApp.kt`
- [Watch phone link](https://github.com/borconi/openzeekr/blob/master/wear/src/main/java/com/openzeekr/wear/PhoneLink.kt): `wear/src/main/java/com/openzeekr/wear/PhoneLink.kt`

### Other components

- **Vehicle owner**
- **Zeekr vehicle**
- **Wear OS watch**

## Connections

- Vehicle owner → App navigation: uses (evidence: `README.md`)
- App navigation → Account setup: offers setup
- App navigation → Vehicle controls: offers controls
- App lifecycle → App dependencies: creates (evidence: `app/src/main/java/com/openzeekr/app/App.kt`)
- App dependencies → Encrypted settings: loads (evidence: `core/src/main/java/com/openzeekr/app/Deps.kt`)
- App dependencies → TSP transport: creates (evidence: `core/src/main/java/com/openzeekr/app/Deps.kt`)
- App dependencies → Cloud repositories: creates (evidence: `core/src/main/java/com/openzeekr/app/Deps.kt`)
- Account setup → Account login: signs in
- Account login → TSP transport: uses
- TSP transport → Zeekr TSP: sends requests (evidence: `README.md`)
- Cloud repositories → TSP transport: uses (evidence: `core/src/main/java/com/openzeekr/app/remote/Repositories.kt`)
- Cloud repositories → Zeekr TSP: requests vehicle data
- App lifecycle → Vehicle status: starts polling (evidence: `app/src/main/java/com/openzeekr/app/App.kt`)
- Vehicle controls → Command dispatch: issues commands (evidence: `app/src/main/java/com/openzeekr/app/ui/VehicleScreen.kt`)
- Command dispatch → BLE connection: tries BLE first (evidence: `README.md`)
- Command dispatch → Cloud repositories: falls back cloud (evidence: `README.md`)
- App dependencies → BLE connection: creates (evidence: `core/src/main/java/com/openzeekr/app/Deps.kt`)
- App dependencies → Key identity: loads identity (evidence: `core/src/main/java/com/openzeekr/app/Deps.kt`)
- App dependencies → Key provisioning: creates (evidence: `core/src/main/java/com/openzeekr/app/Deps.kt`)
- BLE connection → DK session: establishes (evidence: `core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt`)
- BLE connection → BLE protocol: uses framing (evidence: `core/src/main/java/com/openzeekr/app/ble/DkBleManager.kt`)
- Lock control → DK session: sends controls (evidence: `core/src/main/java/com/openzeekr/app/ble/DkLockController.kt`)
- Command dispatch → Lock control: actuates key
- BLE connection → Zeekr vehicle: connects over BLE (evidence: `README.md`)
- Key provisioning → Zeekr vehicle: pairs key (evidence: `README.md`)
- BLE foreground service → BLE connection: manages link (evidence: `core/src/main/java/com/openzeekr/app/ble/ProximityService.kt`)
- BLE foreground service → Proximity automation: runs automation
- Proximity automation → BLE connection: monitors RSSI (evidence: `core/src/main/java/com/openzeekr/app/ble/ProximityController.kt`)
- Proximity automation → Lock control: locks vehicle (evidence: `core/src/main/java/com/openzeekr/app/ble/ProximityController.kt`)
- BLE foreground service → Motion monitoring: uses motion (evidence: `core/src/main/java/com/openzeekr/app/ble/ProximityService.kt`)
- Remote parking → DK session: uses session (evidence: `core/src/main/java/com/openzeekr/app/ble/rpa/RpaController.kt`)
- Phone key sync → Wear key protocol: encodes messages (evidence: `app/src/main/java/com/openzeekr/app/wear/PhoneKeySyncService.kt`)
- Watch phone link → Wear key protocol: uses messages (evidence: `wear/src/main/java/com/openzeekr/wear/PhoneLink.kt`)
- Watch controls → Watch phone link: communicates through (evidence: `wear/src/main/java/com/openzeekr/wear/WearApp.kt`)
- Wear OS watch → Watch controls: uses (evidence: `README.md`)
- Phone key sync → Wear OS watch: shares key (evidence: `README.md`)
- Watch controls → BLE connection: controls directly (evidence: `README.md`)
