VitVital — Architecture Map

Vitruvius Ecosystem · Architecture Map · Phase 1 Full Auto-Sync · 14 Milestones

HARDWARE & SOURCES

מקורות נתונים

⚖ Xiaomi S400 — BLE 4.2

◉

Qingping CGSPR1 Gateway

BLE → WiFi → Qingping Cloud

משקל BMI שומן% שריר kg עצם kg מים% BMR שומן קרביים חלבון% גיל מטבולי LBM שריר שלד% שומן תת-עורי% עכבה Ω

14 מדדים · M1.3

⌚ Samsung Galaxy Watch 7

◷

Wear OS → Samsung Health → HC

סנכרון אוטומטי לHealth Connect

צעדים מרחק קל׳ פעיל קל׳ בסיס קומות דופק (רצף) דופק מנוחה HRV RMSSD SpO2% קצב נשימה טמפרטורה°C שינה כוללת שינה עמוקה שינה קלה REM ערנות לילית אימון session לחץ דם

18 מדדים · M1.4

🏋 אימוני כוח — Gym Tracker

▷

הזנה ידנית פר-אימון

חדר כושר · ביתי · חיצוני

תרגיל סטים × חזרות משקל kg משקל גוף RPE קבוצת שריר נפח כולל

M1.14 — Gym Tracker UI

שאר מקורות

▷

Precor P82 — Preva Mobile

הליכון חדר כושר · אין API פומבי

M1.5 — חקירת Share Intent

◎

Maps Timeline · Gmail · Photos

ריצה/רכיבה אוטומטית · תורים · ארוחות

M1.9 / M1.11

📄

PDF רפואיים

בדיקות · מרשמים · הזנה ידנית

M1.6 / M1.12

INGESTION LAYER

שכבת הספיגה

Android Health Connect

♥

health_connect_service.dart

package:health ^11 · 18 data types
readDaySnapshot() → DailyWearable
readWorkouts() → List<Workout>
writeWeight() after Qingping sync

M1.2

Qingping Cloud API

☁

OAuth2 · GET /v1/apis/devices

14 מדדי הרכב גוף מלאים
deduplication by timestamp
→ BodyComposition model

M1.3 · developer.qingping.co

Firebase — project: vitvital

▣

Auth · Firestore · Storage · FCM

Google Sign-In · 10 OAuth scopes
users/{uid}/ collections
Security: auth.uid == userId

Google APIs

◈

Calendar · Tasks · Drive

Gmail · Photos · Maps Timeline
Activity Recognition API

M1.9–M1.12

📬 Summary Delivery — M1.13

◉

FCM Push + Email + TTS

Cloud Function scheduled/on-demand
Firebase Email Extension (SendGrid)
flutter_tts — קריאה קולית עברית
flutter_local_notifications

M1.13 · NEW

VITVITAL APP

Flutter · Android + Web · RTL Hebrew

VitVital — מרכז הבריאות

Google Auth · Dark/Light · IndexedStack · RTL

M1.1 — Foundation ✓

6 Tabs — BottomNavigationBar

▦

DASHBOARD

סיכום יומי · משקל · צעדים · דופק · קלוריות

M1.2

◉

BODY

14 מדדי S400 · גרפים fl_chart
HRV · SpO2 · שינה שלבים · טמפ׳

M1.3 / M1.4 / M1.6

▤

NUTRITION

ארוחות · מאקרוז · קלוריות · Photos import

M1.6 / M1.11

▷

WORKOUTS ★ מורחב

Galaxy Watch auto · Preva · Maps
🏋 Gym Tracker (M1.14)
‣ בחירת קטגוריה: חדר כושר / ביתי / חיצוני
‣ הוספת תרגילים ידנית לכל אימון
‣ סטים × חזרות × משקל / משקל גוף
‣ ספריית 25 תרגילים מובנים + מותאמים
‣ דשבורד התקדמות — גרף max weight פר תרגיל

M1.4 / M1.5 / M1.9

M1.14 — Gym Tracker

✚

MEDICAL

תיק רפואי · PDF → Drive → NotebookLM

M1.6 / M1.12

✦

INSIGHTS

ניתוחי Gemini · טרנדים · המלצות

M1.7

📊 Summaries — M1.13 · NEW

◎

סיכום יומי + שבועי

‣ Settings: שעה + יום בשבוע + תדירות
‣ תצוגה גרפית — fl_chart rings + bars
‣ Push Notification עם נתוני המפתח
‣ מייל HTML dark-style
‣ 🔊 קריאה קולית עברית (flutter_tts)
‣ בחירת סקשנים: גוף·אימונים·שינה·בריאות

M1.13

Google Assistant · M1.8

◈

App Actions — BII

"Hey Google, start a run" · START_EXERCISE

OUTPUTS

שירותים ואינטגרציות

Google Workspace

◷

Google Calendar

Push לאישור: בישול · תורים · אימונים

M1.10

✓

Google Tasks

רשימת מכולת · תרופות · משימות שבועיות

M1.11

▤

Google Drive

VitVital-Medical/ → NotebookLM source

M1.12

📬 Summary Output — M1.13

◉

Push · Email · Voice

FCM Rich Push — נתוני מפתח
HTML Email — dark-style טבלה
🔊 TTS קריאה קולית פתיחת אפליקציה
History — ארכיון סיכומים קודמים

M1.13

AI & Intelligence

✦

Gemini AI

ניתוח טרנדים · המלצות · Insights tab

M1.7

◈

NotebookLM

שאילתות חופשיות על תיק רפואי

M1.12

Phase 2 — VitPMIS Bridge

▤

VitPMIS

health widget · Gemini cross-app · energy context

Phase 2

⟳ FIREBASE CLOUD FUNCTIONS — Node.js / TypeScript

pollQingping

מושך 14 מדדי S400 מ-Qingping Cloud, כותב ל-Firestore + FCM → HC write

SCHEDULE · every 5 min · M1.3

refreshQingpingToken

מרענן OAuth2 access token לפני פקיעה, שומר ב-oauth_tokens/

SCHEDULE · every 6 days · M1.3

generateDailySummaries

בודק משתמשים לפי SummarySettings, בונה data map, שולח FCM + email

SCHEDULE · hourly · M1.13

generateWeeklySummaries

בודק יום + שעה לפי הגדרות, בונה סיכום שבוע שלם, משלוח גרפי

SCHEDULE · hourly :30 · M1.13

parseGmailAppointments

זיהוי תורים רפואיים ממיילים, הצעות Calendar לאישור

TRIGGER · gmail.onIncoming · M1.11

syncDriveToNotebookLM

PDF חדש ב-Storage → העתקה ל-Google Drive folder

TRIGGER · storage.onFinalize · M1.12

▦ FIRESTORE SCHEMA — users/{uid}/

body_composition/{id}

weight · bmi
bodyFat · muscleMass
boneMass · waterPct
bmr · visceralFat
proteinPct ★
metabolicAge ★
leanBodyMass ★
skeletalMusclePct ★
subcutaneousFat ★
impedance ★
source · deviceId · raw

daily_wearable/{date}

steps · distanceKm
activeCalories · basalCal
floorsClimbed
restingHeartRate
avgHeartRate · maxHR
hrvRmssd ★
spo2Pct ★
respiratoryRate ★
bodyTemperatureC ★
sleepTotalMin
sleepDeep/Light/Rem
sleepAwakeMin
stressScore

workouts/{id}

startTime · endTime
type · duration
category ★
distanceKm · calories
avgHR · maxHR · pace
elevationGainM
exercises[] ★
· exerciseName
· muscleGroup
· sets[]{reps,kg,RPE}
source · deviceModel

exercise_library/{id}

name
primaryMuscle
secondaryMuscles[]
equipment
isBodyweight
isCustom
notes

25 built-in ★
+ custom entries

meals/{id}

date · mealType
name · kcal
protein · carbs
fat · photoUrl

medical/{id}

date · category
provider · title
notes · attachmentUrl
driveFileId
driveFolderId

settings/summary

frequency
dailySchedule
· hour · minute
weeklySchedule
· dayOfWeek
delivery
· push · email
· voice (TTS)
content{}
emailAddress

summaries/{id}

type (daily/weekly)
periodStart/End
data{}
· body{}
· workouts{}
· activity{}
· sleep{}
· health{}
delivered
createdAt

◎ MILESTONE ROADMAP — Phase 1 · 14 Milestones

M1.1 ✓

Foundation
Auth · Scaffold
6 empty tabs
23 קבצים

M1.2

Health Connect
18 data types
Weight + Workout
Dashboard

M1.3

Qingping OAuth
14 S400 metrics
Cloud Function
Body tab charts

M1.4

Galaxy Watch
Samsung → HC
Sleep · HRV · SpO2
Firestore mirror

M1.5 – M1.9

Preva · Manual
Gemini · Assistant
Maps Timeline
Calendar push

M1.10 – M1.12

Tasks · Photos
Gmail parser
Drive + PDF
NotebookLM

M1.13 ★ NEW

Summaries
יומי + שבועי
Push · Email
🔊 TTS Voice

M1.14 ★ NEW

Gym Tracker UI
Logger screen
Exercise library
Progress graphs

PHASE 2 — VitPMIS Bridge · health widget בדשבורד · Gemini cross-app context · Task creation with energy state · multi-project Firebase Auth

VitVital — מרכז הבריאות האישי