baldav/PROJECT_MAP.md

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	~5500	Экраны, навигация, модалки, графики, нутриенты, HR UI, компас, ландшафт
js/db.js	~1500	SQLite через Tauri IPC. Миграции, CRUD, 41 поле добавок, water_pct, reserves, sync
js/gps.js	~1200	GPS запись, физика ккал (power model), altitude filter, BLE HR polling, dead reckoning
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, 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, speed, seq, heart_rate, spo2, bp_sys, bp_dia
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), ландшафтный режим (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