Техническое задание

Android Broadcast Generator для эмуляции xDrip+ CGM данных

1. Цель проекта

Разработать Android-приложение (Foreground Service), генерирующее реалистичные CGM/glucose данные и отправляющее их через xDrip-compatible broadcast:

Intent("com.eveningoutpost.dexdrip.BgEstimate")

Приложение предназначено для:

• тестирования Nightscout backend,
• тестирования Telegram alerts,
• тестирования ingestion pipeline,
• тестирования Android receiver,
• демонстраций,
• CI/staging environments,
• разработки SaaS для CGM.

2. Основные требования

Приложение должно:

• работать без сенсора,
• не требовать BLE hardware,
• работать offline,
• поддерживать Foreground Service,
• работать в фоне,
• переживать reboot,
• автоматически восстанавливаться,
• поддерживать Android 10–16,
• поддерживать xDrip+ совместимость.

3. Broadcast формат

Action

com.eveningoutpost.dexdrip.BgEstimate

Extras

Пример broadcast

val intent = Intent(
    "com.eveningoutpost.dexdrip.BgEstimate"
)

intent.putExtra("mgdl", 126.0)

intent.putExtra(
    "timestamp",
    System.currentTimeMillis()
)

intent.putExtra("direction", "Flat")
intent.putExtra("noise", 1)

sendBroadcast(intent)

4. Реалистичная модель glucose

Вместо random generator использовать curve engine

Generator должен строить:

• плавные изменения,
• realistic slopes,
• realistic delays,
• realistic variability.

5. Поддерживаемые состояния

5.1 Normal glucose

Диапазон:

80–140 mg/dL

Изменения:

• плавные,
• без резких скачков,
• realistic drift.

5.2 Meal simulation

Поддержка:

• small meal,
• medium meal,
• high carb meal.

Поведение:

После meal:

• рост через 10–20 минут,
• peak через 45–90 минут,
• постепенное снижение.

Пример curve

100
110
125
145
165
180
170
150
130
115

5.3 Insulin simulation

Поддержка:

• rapid insulin,
• correction bolus.

Поведение:

• delayed onset,
• gradual reduction,
• hypo prevention logic.

Пример

190
180
165
150
135
120
105

5.4 Hypoglycemia simulation

Диапазон:

40–69 mg/dL

Поддержка:

• gradual hypo,
• rapid hypo,
• nocturnal hypo.

Direction values

Поддержка:

• DoubleUp
• SingleUp
• FortyFiveUp
• Flat
• FortyFiveDown
• SingleDown
• DoubleDown

5.5 Compression lows

Симуляция:

• резкого ложного падения,
• noisy readings,
• быстрого восстановления.

Пример

120
118
85
60
52
48
110
115

5.6 Sensor errors

Поддержка:

• temporary invalid readings,
• impossible values,
• timestamp gaps,
• stuck values.

Типы ошибок

Error spike

400 mg/dL

Sensor freeze

120
120
120
120

Missing packets

Отсутствие broadcasts.

5.7 Warmup simulation

После запуска:

• 30–120 минут warmup,
• optional no-data mode,
• optional unstable readings.

6. Packet loss simulation

Поддержка:

• configurable packet drop rate,
• delayed packets,
• duplicated packets.

Примеры

Drop:

каждый 10-й packet пропускается

Delay:

packet отправляется с задержкой 30–90 сек

7. Noise simulation

Noise levels:

8. Foreground Service

Требования

Приложение должно:

• показывать persistent notification,
• не выгружаться системой,
• работать после lock screen,
• поддерживать autostart.

9. UI требования

Главный экран

Должен отображать:

• текущий glucose,
• текущий trend,
• текущий mode,
• active simulation,
• packet counter,
• broadcast status.

Кнопки

10. Настройки

Интервал отправки

Настраиваемый:

1–5 минут

Unit

Поддержка:

• mg/dL
• mmol/L

Speed multiplier

Для accelerated simulation:

x1
x2
x5
x10

11. Архитектура

Рекомендуемый stack

12. Логирование

Логировать:

• sent broadcasts,
• glucose values,
• packet drops,
• errors,
• simulation state.

13. Экспорт

Поддержка:

• JSON export,
• CSV export,
• replay sessions.

14. Дополнительные функции (optional)

MQTT support

Публикация:

glucose/current

HTTP POST

Отправка на backend:

{
  "glucose": 125,
  "timestamp": 1234567890,
  "direction": "Flat"
}

15. Совместимость

Проверить совместимость с:

• xDrip+
• Nightscout
• Juggluco listeners
• custom BroadcastReceiver
• AndroidAPS

16. Критерии готовности

Проект считается готовым если:

• broadcasts принимаются xDrip+,
• glucose отображается корректно,
• simulation работает стабильно,
• background execution не останавливается,
• packet loss корректно симулируется,
• realistic curves выглядят правдоподобно.