# winemug/omnicore architecture

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

- Interactive diagram: https://gitdiagram.com/winemug/omnicore
- Repository: https://github.com/winemug/omnicore

## Overview

OmniCore is a mobile companion platform for monitoring and controlling Omnipod devices, with RileyLink radio support and documented closed-loop RADD capabilities. The principal runtime path visible here is the Android core service initializing persistence and the Eros pod service; radio discovery and pod setup are separate domain stages. The model contracts define the service boundaries, while the README describes broader app and automation features. Some UI, integration, and automation implementations are unsampled, so their runtime links are not asserted.

Main entry points: [`Pod/OmniCore.Eros/ErosPodService.cs`](https://github.com/winemug/omnicore/blob/main/Pod/OmniCore.Eros/ErosPodService.cs) (Eros pod service), [`Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs`](https://github.com/winemug/omnicore/blob/main/Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs) (RileyLink service), [`Model/OmniCore.Model/Interfaces`](https://github.com/winemug/omnicore/tree/main/Model/OmniCore.Model/Interfaces) (Core domain contracts), [`Client/OmniCore.Client.Droid/Services/DroidCoreService.cs`](https://github.com/winemug/omnicore/blob/main/Client/OmniCore.Client.Droid/Services/DroidCoreService.cs) (Android core host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile client"]
  node_mobileui["App interface<br/>[Views]"]
  node_viewmodels["App view models<br/>[ViewModels]"]
  node_android["Android core host"]
  node_appservices["Platform services"]
end

subgraph group_core["Core services"]
  node_composition["Service composition<br/>[OmniCore.Services]"]
  node_automation["Therapy automation<br/>[OmniCore.Services]"]
  node_integrations["External integrations<br/>[OmniCore.Services]"]
end

subgraph group_devices["Device communication"]
  node_podservice["Eros pod service<br/>[ErosPodService.cs]"]
  node_podruntime["Pod request runtime"]
  node_radioservice["RileyLink service"]
  node_bleadapter["Platform BLE adapter"]
end

subgraph group_data["Domain and storage"]
  node_modelcontracts["Core domain contracts<br/>[Interfaces]"]
  node_therapy["Therapy profiles<br/>[Profiles]"]
  node_repositoryservice["Repository service"]
  node_podrepository["Pod repository<br/>[PodRepository.cs]"]
  node_radiorepositories["Radio repositories<br/>[Repositories]"]
  node_sqlite[("SQLite database<br/>[Entity.cs]")]
end

node_user(("Mobile user"))
node_radiohardware(("RileyLink radio"))

node_user -.->|"uses"| node_mobileui
node_android -->|"resolves"| node_appservices
node_android -->|"initializes"| node_repositoryservice
node_android -->|"starts"| node_podservice
node_composition -->|"registers"| node_podservice
node_composition -->|"registers"| node_radioservice
node_podservice -->|"loads and creates"| node_podrepository
node_podservice -.->|"resolves"| node_podruntime
node_podservice -->|"uses provider"| node_radioservice
node_radioservice -.->|"discovers via"| node_bleadapter
node_radioservice -->|"scans"| node_radiohardware
node_radioservice -->|"persists radio events"| node_radiorepositories
node_repositoryservice -->|"opens connection"| node_sqlite
node_repositoryservice -->|"initializes"| node_podrepository
node_podservice -->|"implements contracts"| node_modelcontracts
node_radioservice -->|"implements contracts"| node_modelcontracts
node_therapy -.->|"implements profiles"| node_modelcontracts
node_automation -.->|"uses profiles"| node_therapy
node_integrations -.->|"uses service contracts"| node_modelcontracts

click node_mobileui "https://github.com/winemug/omnicore/tree/main/Client/OmniCore.Client/Views"
click node_viewmodels "https://github.com/winemug/omnicore/tree/main/Client/OmniCore.Client/ViewModels"
click node_android "https://github.com/winemug/omnicore/blob/main/Client/OmniCore.Client.Droid/Services/DroidCoreService.cs"
click node_appservices "https://github.com/winemug/omnicore/blob/main/Client/OmniCore.Client.Droid/Platform/CoreApplicationServices.cs"
click node_composition "https://github.com/winemug/omnicore/tree/main/Configuration/OmniCore.Services"
click node_automation "https://github.com/winemug/omnicore/tree/main/Configuration/OmniCore.Services"
click node_integrations "https://github.com/winemug/omnicore/tree/main/Configuration/OmniCore.Services"
click node_podservice "https://github.com/winemug/omnicore/blob/main/Pod/OmniCore.Eros/ErosPodService.cs"
click node_podruntime "https://github.com/winemug/omnicore/blob/main/Pod/OmniCore.Eros/ErosPodRequestProcessor.cs"
click node_radioservice "https://github.com/winemug/omnicore/blob/main/Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs"
click node_bleadapter "https://github.com/winemug/omnicore/blob/main/Client/OmniCore.Client/Platform/CrossBleRadioAdapter.cs"
click node_modelcontracts "https://github.com/winemug/omnicore/tree/main/Model/OmniCore.Model/Interfaces"
click node_therapy "https://github.com/winemug/omnicore/tree/main/Therapy/OmniCore.Therapy/Profiles"
click node_repositoryservice "https://github.com/winemug/omnicore/blob/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/RepositoryService.cs"
click node_podrepository "https://github.com/winemug/omnicore/blob/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Repositories/PodRepository.cs"
click node_radiorepositories "https://github.com/winemug/omnicore/tree/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Repositories"
click node_sqlite "https://github.com/winemug/omnicore/blob/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Entities/Entity.cs"

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_mobileui,node_viewmodels,node_android,node_appservices,node_user toneBlue
class node_composition,node_automation,node_integrations toneAmber
class node_podservice,node_podruntime,node_radioservice,node_bleadapter toneMint
class node_modelcontracts,node_therapy,node_repositoryservice,node_podrepository,node_radiorepositories,node_sqlite toneRose
class node_radiohardware toneIndigo
```

## Components

### Mobile client

- [App interface](https://github.com/winemug/omnicore/tree/main/Client/OmniCore.Client/Views): `Client/OmniCore.Client/Views`
- [App view models](https://github.com/winemug/omnicore/tree/main/Client/OmniCore.Client/ViewModels): `Client/OmniCore.Client/ViewModels`
- [Android core host](https://github.com/winemug/omnicore/blob/main/Client/OmniCore.Client.Droid/Services/DroidCoreService.cs): `Client/OmniCore.Client.Droid/Services/DroidCoreService.cs`
- [Platform services](https://github.com/winemug/omnicore/blob/main/Client/OmniCore.Client.Droid/Platform/CoreApplicationServices.cs): `Client/OmniCore.Client.Droid/Platform/CoreApplicationServices.cs`

### Core services

- [Service composition](https://github.com/winemug/omnicore/tree/main/Configuration/OmniCore.Services): `Configuration/OmniCore.Services`
- [Therapy automation](https://github.com/winemug/omnicore/tree/main/Configuration/OmniCore.Services): `Configuration/OmniCore.Services`
- [External integrations](https://github.com/winemug/omnicore/tree/main/Configuration/OmniCore.Services): `Configuration/OmniCore.Services`

### Device communication

- [Eros pod service](https://github.com/winemug/omnicore/blob/main/Pod/OmniCore.Eros/ErosPodService.cs): `Pod/OmniCore.Eros/ErosPodService.cs`
- [Pod request runtime](https://github.com/winemug/omnicore/blob/main/Pod/OmniCore.Eros/ErosPodRequestProcessor.cs): `Pod/OmniCore.Eros/ErosPodRequestProcessor.cs`
- [RileyLink service](https://github.com/winemug/omnicore/blob/main/Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs): `Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs`
- [Platform BLE adapter](https://github.com/winemug/omnicore/blob/main/Client/OmniCore.Client/Platform/CrossBleRadioAdapter.cs): `Client/OmniCore.Client/Platform/CrossBleRadioAdapter.cs`

### Domain and storage

- [Core domain contracts](https://github.com/winemug/omnicore/tree/main/Model/OmniCore.Model/Interfaces): `Model/OmniCore.Model/Interfaces`
- [Therapy profiles](https://github.com/winemug/omnicore/tree/main/Therapy/OmniCore.Therapy/Profiles): `Therapy/OmniCore.Therapy/Profiles`
- [Repository service](https://github.com/winemug/omnicore/blob/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/RepositoryService.cs): `Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/RepositoryService.cs`
- [Pod repository](https://github.com/winemug/omnicore/blob/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Repositories/PodRepository.cs): `Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Repositories/PodRepository.cs`
- [Radio repositories](https://github.com/winemug/omnicore/tree/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Repositories): `Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Repositories`
- [SQLite database](https://github.com/winemug/omnicore/blob/main/Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Entities/Entity.cs): `Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/Entities/Entity.cs`

### Other components

- **Mobile user**
- **RileyLink radio**

## Connections

- Mobile user → App interface: uses (evidence: `README.md`)
- Android core host → Platform services: resolves (evidence: `Client/OmniCore.Client.Droid/Services/DroidCoreService.cs`)
- Android core host → Repository service: initializes (evidence: `Client/OmniCore.Client.Droid/Services/DroidCoreService.cs`)
- Android core host → Eros pod service: starts (evidence: `Client/OmniCore.Client.Droid/Services/DroidCoreService.cs`)
- Service composition → Eros pod service: registers (evidence: `Configuration/OmniCore.Services/CoreDataServices.cs`)
- Service composition → RileyLink service: registers (evidence: `Configuration/OmniCore.Services/CoreDataServices.cs`)
- Eros pod service → Pod repository: loads and creates (evidence: `Pod/OmniCore.Eros/ErosPodService.cs`)
- Eros pod service → Pod request runtime: resolves
- Eros pod service → RileyLink service: uses provider (evidence: `Pod/OmniCore.Eros/ErosPodService.cs`)
- RileyLink service → Platform BLE adapter: discovers via
- RileyLink service → RileyLink radio: scans (evidence: `Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs`)
- RileyLink service → Radio repositories: persists radio events (evidence: `Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs`)
- Repository service → SQLite database: opens connection (evidence: `Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/RepositoryService.cs`)
- Repository service → Pod repository: initializes (evidence: `Repository/OmniCore.Repository.Sqlite/OmniCore.Repository.Sqlite/RepositoryService.cs`)
- Eros pod service → Core domain contracts: implements contracts (evidence: `Pod/OmniCore.Eros/ErosPodService.cs`)
- RileyLink service → Core domain contracts: implements contracts (evidence: `Radios/OmniCore.Radios.RileyLink/RileyLinkRadioService.cs`)
- Therapy profiles → Core domain contracts: implements profiles
- Therapy automation → Therapy profiles: uses profiles
- External integrations → Core domain contracts: uses service contracts (evidence: `Configuration/OmniCore.Services/CoreDataServices.cs`)
