4aiman
56c2ff4ec7
- native_root(): pick app root by presence of gps_live/gps_points files. app_data_dir() is the root directly on this Tauri; the old .parent().parent() read the wrong dir, so background (screen-off) points were never imported. - recoverFromFiles: match file->session by id/date, plus session id stamped into the native file name (gps_points_<ms>_s<id>.jsonl) for exact binding (gps_set_session_id -> Kotlin bindSessionIfPending). Proximity dedup +-2.5s, recalc with noDelete (never runs the destructive glitch/>24h filter that once wiped real rides), delete already-imported files. Progress bar UI. - bike kcal is NET (daily balance already books BMR*activityLevel): pedaling = max(physics power/efficiency, MET-net by speed), coasting (power<=0, the bike would roll unpowered) = basal only. Elevation via cumulative hysteresis. recomputeAllStats + "recompute elevation/kcal" menu refresh stored tracks without touching points. - live recording: the native file is the DB source of truth; watchPosition only drives the live marker, so a fix is not stored twice with two timestamps. - track list pagination, SAF local-file picker, tile regions from router.
80 lines
8.6 KiB
Markdown
80 lines
8.6 KiB
Markdown
# BalDav
|
||
|
||
Персональный трекер здоровья и физической активности.
|
||
|
||
## Возможности
|
||
|
||
- **Дневник питания** — 24400+ продуктов (Магнит, 5ка, Health-Diet.ru, Ашан, Макдоналдс, KFC, Додо Пицца, KDV, ИОН, Гриднев). 37 нутриентов (витамины, минералы, omega-3/6, вода, клетчатка). Рецепты с термообработкой. Формулы порций (4*30, 300+50).
|
||
- **GPS трекинг** — запись маршрутов на велосипеде/пешком в фоне (foreground service, точки пишутся при выключенном экране; один файл на сессию с id сессии в имени `gps_points_<ms>_s<id>.jsonl` для однозначной привязки, переживает START_STICKY-перезапуск ОС; полный до-импорт нативных точек по timestamp при финализации — без потерь, даже если экран был выключен всю запись, а при пробуждении экрана точки видимо нарастают на карте по мере импорта). При живой записи нативный файл — источник истины для БД, watchPosition только рисует маркер (без дублей одного фикса с разными ts). Восстановление точек из файлов на устройстве — матч файла к сессии по id/дате, дозаполнение разрывов с дедупом по близости ±2.5с, безопасный пересчёт без удаления точек, чистка уже импортированных файлов. Оффлайн карты (Leaflet + IndexedDB кэш). Импорт GPX/FTB (FitoTrack). Экспорт GPX. Фильтр altitude outlier'ов и GPS-залипаний. Отбор точек по точности (жёсткий порог по настройке «Мин. точность» — рубит грубые сотовые фиксы ~800м, оставляет слабый но точный GPS; где сигнала нет — честный разрыв). Направление (bearing) каждой точки пишется в БД. Вращение карты по компасу (leaflet-rotate, EMA-сглаживание, gimbal lock компенсация) и course-up по GPS-курсу (в ландшафте карта доворачивается вместе с экраном — курс к физическому верху). Ландшафтный режим (CSS rotation + панель справа, 3 режима: off/auto/lock). Dead reckoning при потере GPS (гироскоп + акселерометр). Placeholder до GPS (пиксельарт). Карта проезженных дорог (дедупликация 2м, вело/пешие). Импорт тайлов по регионам (SQLite, роутер LAN).
|
||
- **BLE пульсометр** — подключение к FitPro браслетам и стандартным HR датчикам (0x180D). ЧСС, SpO2, давление в реальном времени при записи трека.
|
||
- **Расчёт ккал** — велосипед: НЕТТО-модель (суточный баланс уже учитывает BMR, поэтому активность считается сверх покоя). Кручение = max(физика мощности из gradient+Crr+CdA / КПД, эмпирический MET-нетто по скорости); накат (freewheel, `power≤0` — «велик катился бы сам») = только базовый обмен. MET-таблица для ходьбы/бега и тренировок (приседания 6.0, скакалка 12.3, растяжки 2.3, бассейн 8.0). Набор высоты — кумулятивный гистерезис (устойчив на плотных треках, где per-point разница <1м). Пункт меню «Пересчитать высоту/калории» пересчитывает статистику всех треков без изменения точек. Профили велосипедов. BMR по Mifflin-St Jeor с коэффициентом активности.
|
||
- **Тренировки** — приседания (подходы x повторения), скакалка, растяжки, бассейн (дистанция). Автоматический расчёт ккал по MET и весу.
|
||
- **Нутриенты** — 37 микронутриентов (витамины, минералы, жирные кислоты, женьшень, ресвератрол, CoQ10). Нормы РСП/АУП (РФ/ЕС/США). Фармакокинетика — запасы в организме по полураспаду.
|
||
- **Трекинг жидкости** — water_pct в продуктах, прогресс-бар, настраиваемая норма.
|
||
- **Графики** — скорость, высота, ЧСС тренировки с зумом и pan. Тренд веса. Донат макронутриентов. Баланс ккал (приход/расход).
|
||
- **OTA обновления** — проверка BUILD_NUMBER на роутере (LAN) или VPS, скачивание через браузер.
|
||
- **Ручные маршруты** — рисование трека на карте тапами, elevation из прошлых треков или open-meteo API.
|
||
- **Экспорт/импорт** — свои продукты, рецепты и добавки одним файлом (JSON).
|
||
- **Вес, сон, добавки** — логирование с историей.
|
||
|
||
## Стек
|
||
|
||
- **Frontend**: чистый JavaScript, HTML, CSS. Без React/Vue/bundler.
|
||
- **Backend**: Rust (Tauri 2) — SQLite, IPC, seed import, BLE (btleplug на десктопе).
|
||
- **Android**: Kotlin — foreground GPS service, BLE HR service, WakeLock, SAF.
|
||
- **Библиотеки**: Leaflet 1.9.4 (карты), leaflet-rotate (компас), Chart.js (графики), Hammer.js (жесты), JSZip.
|
||
|
||
## Сборка
|
||
|
||
```bash
|
||
# Зависимости: Rust, Node.js, Android SDK + NDK
|
||
./build.sh -d android # debug APK
|
||
./build.sh android # release APK
|
||
./build.sh -i android -d # debug + установка на устройство
|
||
./build.sh -u android # release + upload на VPS (OTA)
|
||
./build.sh -d -i -u android # debug + install + upload
|
||
```
|
||
|
||
## Структура
|
||
|
||
Подробно: [PROJECT_MAP.md](PROJECT_MAP.md)
|
||
|
||
```
|
||
frontend/
|
||
js/main.js — UI, навигация, модалки, компас, ландшафт (~5500 строк)
|
||
js/db.js — БД, миграции, CRUD (~1500)
|
||
js/gps.js — GPS, физика ккал, BLE HR polling (~1200)
|
||
js/bmr.js — BMR формула, РСП, полураспад нутриентов
|
||
js/sync.js — синхронизация между устройствами (LAN)
|
||
js/tilecache.js — оффлайн тайлы (IndexedDB)
|
||
css/styles.css — стили, тёмная тема, ландшафтный режим
|
||
img/gps-placeholder.png — пиксельарт заглушка до GPS
|
||
data/products_seed.db — 13480 продуктов
|
||
src-tauri/
|
||
src/lib.rs — Rust бэкенд, seed import
|
||
src/ble.rs — BLE HR (btleplug десктоп, file IPC Android)
|
||
gen/android/ — Kotlin: MainActivity, GpsRecorderService, BleHrService
|
||
tools/
|
||
5ka_scraper.user.js — Tampermonkey скрейпер 5ка
|
||
magnit_scraper.user.js — Tampermonkey скрейпер Магнит
|
||
ion_scraper.user.js — Tampermonkey скрейпер ИОН
|
||
smart/
|
||
protocol.js — FitPro BLE протокол (reverse-engineered)
|
||
hr-reader.js — Node.js прототип чтения ЧСС
|
||
```
|
||
|
||
## Данные продуктов
|
||
|
||
| Источник | Продуктов | Витамины/минералы |
|
||
|----------|-----------|-------------------|
|
||
| Health-Diet.ru | 8090 | да (37 нутриентов, omega-3/6, вода) |
|
||
| Магнит (SSR парсинг) | 7690 | нет |
|
||
| 5ка (API скрейпер) | 3354 | нет |
|
||
| Ашан (HD) | 2000 | да |
|
||
| ИОН (web.ion.ru) | 1079 | да |
|
||
| KDV (SSR парсинг) | 667 | нет |
|
||
| Макдоналдс (HD) | 619 | да |
|
||
| KFC (HD) | 361 | да |
|
||
| Додо Пицца | 258 | КБЖУ |
|
||
| Гриднев (PDF) | 217 | да |
|
||
| **Всего** | **~24400** | |
|