4aiman
84a2b786ca
- applyBearing: use h, not h - rotOffset. The .rec-screen (map + panel) is CSS-rotated by rotOffset in landscape and setBearing adds another rotate on the map pane; subtracting rotOffset cancelled the screen rotation for the map only, gluing course to the portrait top edge while the panel turned. Using h lets the map turn with the screen -> course points to physical top. - Poll: guard the requestAnimationFrame yield with !document.hidden. rAF never fires while the screen is off, so awaiting it there hung the import loop and froze point import mid-walk (regression from the progressive-draw change). - recoverSession: import missing native points by the SET of existing timestamps instead of ts > maxDbTs. Sparse screen-gated points can have a late max ts, so the old check imported nothing and left the track full of gaps; also pass sensorData so bearing/accel/gyro are stored.
12 KiB
12 KiB
PROJECT MAP — BalDav
Трекер здоровья и активности. Pure JS + Tauri 2 + SQLite. Без фреймворков и бандлеров.
Статистика
| Метрика | Значение |
|---|---|
| Строк кода | ~22000 |
| Файлов исходников | 50+ |
| Язык | JS 70%, Rust 6%, Kotlin 12%, CSS 12% |
| Таблиц в БД | 20 |
| Экранов | 7 основных + 15 модалок |
| IPC команд (Tauri) | 14 |
| Библиотеки | Leaflet, Chart.js, Hammer.js, JSZip |
| Платформы | Android (Kotlin), Desktop (Tauri) |
Структура файлов
Frontend (frontend/)
| Файл | Строк | Назначение |
|---|---|---|
js/main.js |
~5800 | Экраны, навигация, модалки, графики, нутриенты, HR UI, компас (EMA + gimbal lock), ландшафт (3 режима), дороги |
js/db.js |
~1500 | SQLite через Tauri IPC. Миграции, CRUD, 41 поле добавок, water_pct, reserves, sync |
js/gps.js |
~1400 | GPS запись, физика ккал (power model), altitude filter, BLE HR polling, dead reckoning. Импорт нативных точек: JS-поллинг (экран-gated) + ПОЛНЫЙ до-импорт по множеству ts на «Стоп»/recoverSession (без потерь при экране-офф), отбор по точности (minAccuracyM), bearing_deg |
js/sync.js |
~300 | Синхронизация между устройствами (LAN, PHP сервер на роутере) |
js/tilecache.js |
178 | Оффлайн кэш тайлов карты (IndexedDB) |
js/bmr.js |
~70 | BMR (Mifflin-St Jeor), РСП из БД (33 нутриента), полураспад |
css/styles.css |
~2100 | Темная тема, мобильный дизайн, HR зоны, ландшафтный режим |
index.html |
28 | Точка входа, порядок загрузки скриптов |
img/gps-placeholder.png |
63KB | Пиксельарт заглушка при поиске GPS |
data/products_seed.db |
~12MB | 24443 продукта (HD 8090, magnit 7690, 5ka 3354, ashan 2000, ion 1079, kdv 667, mcdonalds 619, kfc 361, dodo 258, gridnev 217) |
Библиотеки (lib/): leaflet.js (1.9.4), leaflet-rotate.js (компас), chart.min.js, chartjs-plugin-zoom.min.js, hammer.min.js, jszip.min.js
Бэкенд Rust (src-tauri/)
| Файл | Строк | Назначение |
|---|---|---|
src/lib.rs |
~700 | Миграции v1, IPC команды, seed import, update check, tile import, road map rebuild |
src/ble.rs |
~470 | BLE HR: btleplug (desktop), file IPC (Android), FitPro + Standard HR |
src/main.rs |
5 | Точка входа |
Cargo.toml |
— | tauri, tauri-plugin-sql, rusqlite, serde, btleplug, tokio, uuid |
tauri.conf.json |
— | Конфиг приложения, плагины, ресурсы |
Android Kotlin (src-tauri/gen/android/.../dev/baldav/app/)
| Файл | Строк | Назначение |
|---|---|---|
MainActivity.kt |
~300 | FileObserver IPC, seed DB, safe insets, SAF, BLE commands, OTA check |
GpsRecorderService.kt |
~500 | Foreground service GPS, WakeLock, JSONL (один файл на сессию до Стоп, идемпотентный onStartCommand при START_STICKY-перезапуске ОС), 50Hz акселерометр/гироскоп, dead reckoning, raw sensor files |
BleHrService.kt |
~340 | Foreground service BLE HR, FitPro protocol, GATT queue, scan/connect |
generated/*.kt |
~1100 | Tauri-сгенерированные: WebView, IPC, permissions |
Инструменты (tools/)
| Скрипт | Назначение |
|---|---|
5ka_scraper.user.js |
Tampermonkey скрейпер 5ka.ru (BFS категорий, Load JSON) |
magnit_scraper.user.js |
Tampermonkey скрейпер magnit.ru (NUXT_DATA парсинг) |
ion_scraper.user.js |
Tampermonkey скрейпер web.ion.ru (fetch, без перезагрузок) |
import_ion.js |
Импорт ION продуктов в seed DB |
import_with_dedup.js |
Импорт с дедупликацией по имени |
enrich_nutrients.js |
Обогащение микронутриентами из ION |
parse_magnit.js |
Парсер HTML каталога Магнит |
parse_kdv.js |
Парсер HTML каталога KDV |
download_tiles.js |
Скачивание тайлов карт для оффлайна |
pack_tiles.js |
Упаковка PNG тайлов региона в SQLite для импорта |
healthdiet_scraper.user.js |
Tampermonkey скрейпер health-diet.ru (КБЖУ + 37 нутриентов) |
import_healthdiet.js |
Импорт health-diet.ru JSON в seed DB (авто-бамп версии) |
fetch_openfoodfacts.js |
OpenFoodFacts API |
fuzzy_dedup.js |
Нечёткая дедупликация |
Корень
| Файл | Назначение |
|---|---|
build.sh |
Сборка: android/debug/release, sync frontend, версионирование, -u upload на VPS |
BUILD_NUMBER |
Автоинкремент номера сборки |
ion_products.json |
1111 продуктов ION (сырые данные скрейпера) |
5ka_products_fresh.json |
3103 продукта 5ka (сырые данные) |
База данных
Таблицы (Rust v1 миграция + JS миграции)
| Таблица | Назначение | Ключевые поля |
|---|---|---|
profile |
Key-value настройки | key, value |
products |
Продукты (13480) | name, kcal/protein/fat/carbs per 100g, витамины, минералы, nutrients_guessed |
food_log |
Дневник еды | date, time, product_id/recipe_id, amount_g, unit_id, unit_amount, ккал/БЖУ |
recipes |
Рецепты | name, cooking_method_id, servings, notes |
recipe_ingredients |
Ингредиенты рецептов | recipe_id, product_id, custom_name, amount_g, cooking_method_id |
cooking_methods |
Способы готовки (6 шт) | name, потери витаминов/БЖУ в % |
serving_units |
Единицы измерения (5 шт) | name (шт/ст.л./ч.л./стакан/мл), grams_equivalent |
product_units |
Привязка единиц к продуктам | product_id, unit_id, grams_per_unit |
weight_log |
Лог веса | date, time, weight_kg |
sleep_log |
Лог сна | date, bed/asleep/wake time, nap_minutes |
activity_log |
Лог активности | date, type, minutes, kcal, activity_type (squats/jumprope/stretch/swim/manual), sets, reps, distance_m |
supplements |
Добавки (БАД) | name, daily_dose_g, витамины/минералы |
supplement_log |
Приём добавок | date, supplement_id, dose_g |
gps_sessions |
GPS тренировки | date, activity_type, distance, kcal, speed, elevation, bike_id |
gps_points |
Точки трека | session_id, ts, lat, lon, altitude_gps_m, altitude_srtm_m, speed_ms, seq, bearing_deg, heart_rate, spo2, bp_sys, bp_dia, accel_rms/max, gyro_pitch/yaw |
bikes |
Велосипеды | name, weight_kg, wheel, звёзды, surface_type, is_active |
rdi_standards |
Стандарты РСП (RU/EU/US) | code, name |
rdi_values |
Нормы нутриентов | standard_id, nutrient_key, value, norm_type (rdi/aup) |
nutrient_halflife |
Полураспад нутриентов | nutrient_key, halflife_avg_days |
nutrient_reserves |
Запасы нутриентов по дням | date, reserves (JSON) |
road_points |
Дедуплицированные точки всех треков | lat, lon, atype (bike/walk) |
Seed DB (products_seed.db)
| Источник | Продуктов | Микронутриенты |
|---|---|---|
| magnit | 8627 | нет |
| 5ka | 3103 | нет |
| ION | 1078 | витамины + минералы |
| kdv | 672 | нет |
| Всего | 13480 | 1398 обогащены (nutrients_guessed) |
Экраны и навигация
Нижний навбар (5 табов)
[Сегодня] [Продукты] [Трек] [Добавки] [Настройки]
Экраны
- Сегодня — баланс ккал, еда (продукты + блюда), GPS тренировки, активность, вес, сон, добавки, прогресс-бар жидкости, нутриенты (приход + запасы)
- Продукты — подтабы [Продукты | Рецепты], поиск, карточки с КБЖУ, добавление в дневник
- Трек — GPS тренировки (запись с HR), карта с компасом (leaflet-rotate), course-up по GPS-курсу (карта и панель доворачиваются в ландшафт вместе,
bearing = h), ландшафтный режим (CSS rotation), графики скорости/высоты/ЧСС, импорт GPX/FTB, dead reckoning, placeholder до GPS, карта дорог (дедуп 2м, вело/пешие) - Добавки — 41 нутриент (витамины, минералы, жирные кислоты, женьшень, ресвератрол, CoQ10)
- Настройки — профиль, образ жизни, нормы ЧСС/давления, BLE пульсометр, велосипеды, GPS конфиг, OTA обновления, импорт тайлов, карта дорог
Модалки
- Еда: showFoodModal, showEditFoodModal, showFoodFromRecipeModal
- Рецепты: showRecipeDetailModal, showRecipeEditorModal, showAddIngredientModal
- Тренировки: showSessionDetail (карта, графики скорости/высоты, пересчёт)
- Прочее: showWeightModal, showSleepModal, showActivityModal, showProfileModal, showBikeModal, showMapDownloadModal, showLogSupplementModal
IPC команды (Rust → JS)
| Команда | Назначение |
|---|---|
import_seed_products |
Импорт продуктов из seed DB, прогресс-события |
get_safe_insets |
Отступы Android status/nav bar |
gps_service_command |
start/stop GPS + BLE команды (ble_scan/connect/disconnect) |
gps_service_read_points |
Чтение JSONL файла точек |
save_file |
SAF диалог сохранения (GPX экспорт) |
get_app_info |
Версия, git hash, дата сборки |
get_update_info |
Проверка OTA обновления (BUILD_NUMBER с VPS) |
ble_scan |
Сканирование BLE устройств |
ble_scan_results |
Результаты скана (Android) |
ble_connect |
Подключение к BLE устройству |
ble_disconnect |
Отключение BLE |
ble_get_hr |
Последние данные HR/SpO2/BP |
ble_is_connected |
Статус подключения |
ble_check_bluetooth |
Состояние Bluetooth адаптера |
ble_save_device |
Сохранение привязанного устройства |
import_tiles |
Чтение тайлового SQLite батчами (base64) |
download_file |
Скачивание бинарного файла по URL (без лимита размера) |
rebuild_roads |
Перестройка road_points из всех треков (2м дедуп) |
get_road_points |
Чтение road_points батчами (обход лимита SQL plugin) |
Формула ккал (GPS)
Велосипед — физическая модель
Power = v * (m*g*sin(gradient) + Crr*m*g*cos(gradient) + 0.5*CdA*rho*v^2)
m = rider_kg + bike_kg
Crr = 0.004 (асфальт) / 0.006 (смешанный) / 0.008 (грунт)
CdA = 0.6, rho = 1.225, efficiency = 0.25
Power > 0: педалирование → kcal = power*dt / (0.25 * 4184)
Power <= 0: каботаж → kcal = базальный метаболизм
Ходьба/бег — MET-таблица
<4 км/ч = 2.5 MET, 4-5.5 = 3.5, 5.5-7 = 5.0, 7-9 = 8.0, 9-12 = 10.0, 12-16 = 12.5, 16+ = 15.0
kcal = (dt/60) * (MET * 3.5 * weight_kg) / 200
Сборка
./build.sh -d android # debug APK
./build.sh android # release APK
./build.sh -i android -d # debug + install