How dowon-kang/vibecare-pilot works
VibeCare Pilot is a Flutter research prototype backed by an API: users authenticate, review FITRUS measurement history and quality, calculate a recommendation, complete a safety check, simulate a Mock session, and submit feedback. The mobile app also supports web-demo booking and attendance; the README says those records are browser-local and can be linked to Supabase Auth. Backend excerpts show route-owned recommendation, measurement, session, and feedback actions. Mobile implementation details and some backend internals were not sampled, so those connections are documented at a high level only; physical-device execution is prohibited.
Components 23
Mobile Experience
- Flutter App
mobile-app/lib/main.dart - App Authentication
mobile-app/lib/services/auth_repository.dart - Booking & Attendance
mobile-app/lib/screens/booking_editor_screen.dart - Pilot Workflow UI
mobile-app/lib/controllers/pilot_controller.dart - Mobile Algorithm
mobile-app/lib/algorithm/vibration_algorithm.dart - Device State Machine
mobile-app/lib/services/device_state_machine.dart - Backend Device Gateway
mobile-app/lib/services/backend_device_gateway.dart
Measurement Pipeline
- API Router
backend-api/src/index.ts - Authentication Routes
backend-api/src/routes/auth-routes.ts - Token Verification
backend-api/src/http.ts - Measurement Routes
backend-api/src/routes/measurement-routes.ts - FITRUS Provider
backend-api/src/fitrus-client.ts - FITRUS Normalization
backend-api/src/fitrus-normalizer.ts
Recommendation Safety
- Recommendation Authorization
backend-api/src/routes/recommendation-routes.ts - Recommendation Engine
backend-api/src/algorithm.ts - Algorithm Rules
backend-api/src/rule-store.ts
Mock Sessions
- Session Routes
backend-api/src/routes/session-routes.ts - Feedback Routes
backend-api/src/routes/feedback-routes.ts - Feedback Adjustment
backend-api/src/feedback.ts
Backend Persistence
- SQL Database
backend-api/src/storage/postgres-database.ts
Other components
- Participant
- Supabase Auth & DB
- FITRUS API
Connections 28
- Participant → Flutter App: uses
README.md - Flutter App → App Authentication: authenticates via
README.md - Flutter App → Booking & Attendance: records bookings
README.md - Booking & Attendance → Supabase Auth & DB: stores Auth-linked data
README.md - Flutter App → Pilot Workflow UI: presents pilot flow
README.md - Pilot Workflow UI → Mobile Algorithm: calculates recommendation
README.md - Pilot Workflow UI → Backend Device Gateway: uses backend API
README.md - Pilot Workflow UI → Device State Machine: starts Mock simulation
README.md - Flutter App → API Router: calls API
README.md - API Router → Authentication Routes: registers routes
backend-api/src/index.ts - API Router → Measurement Routes: registers routes
backend-api/src/index.ts - API Router → Recommendation Authorization: registers routes
backend-api/src/index.ts - API Router → Session Routes: registers routes
backend-api/src/index.ts - API Router → Feedback Routes: registers routes
backend-api/src/index.ts - Authentication Routes → Token Verification: uses token auth
backend-api/src/routes/auth-routes.ts - Measurement Routes → Token Verification: checks participant
backend-api/src/routes/measurement-routes.ts - Measurement Routes → FITRUS Provider: requests measurement
backend-api/src/routes/measurement-routes.ts - FITRUS Provider → FITRUS API: sends requests
backend-api/src/fitrus-client.ts - Measurement Routes → FITRUS Normalization: normalizes responses
backend-api/src/routes/measurement-routes.ts - Recommendation Authorization → Recommendation Engine: calculates result
backend-api/src/routes/recommendation-routes.ts - Recommendation Authorization → Algorithm Rules: loads rules
backend-api/src/routes/recommendation-routes.ts - Recommendation Authorization → SQL Database: stores authorization
- Session Routes → Algorithm Rules: loads rules
backend-api/src/routes/session-routes.ts - Session Routes → SQL Database: reads and writes sessions
backend-api/src/routes/session-routes.ts - Feedback Routes → Feedback Adjustment: calculates adjustment
backend-api/src/routes/feedback-routes.ts - Feedback Routes → SQL Database: stores feedback
backend-api/src/routes/feedback-routes.ts - Recommendation Authorization → SQL Database: reads measurements
- Measurement Routes → SQL Database: stores measurements