How pradyumnan-ramanathan/cardio-predictor works
Cardio Predictor accepts a user’s health measurements, authenticates the request, obtains a risk prediction from the Python ML service, then generates feedback, emails it, and stores prediction history. The repository also contains a separate Python prediction/history API with its own Firebase verification and MongoEngine persistence. Source excerpts show the Node-to-ML request but not token forwarding; the Python endpoint requires a bearer token, so that integration detail remains uncertain. No README was provided, and training artifacts are not mapped because their runtime use is not evidenced.
Main entry points: predict.js Prediction Workflow · server.js HTTP Server · app.py Prediction API · authRoutes.js User Sync
Components 19
Node API
- HTTP Server
backend/src/server.js - Express App
backend/src/app.js - Prediction Workflow
backend/src/routes/predict.js
Identity
- User Sync
backend/src/routes/authRoutes.js - Token Verification
backend/src/middleware/verifyFirebaseToken.js - Firebase Admin
backend/src/config/firebase.js - Firebase Auth
ML Service
- Prediction API
backend/ml-service/app.py - Firebase Setup
backend/ml-service/firebase_admin_setup.py - Prediction Record
backend/ml-service/models/Prediction.py
Persistence
- User Records
backend/src/models/User.js - Mongo Connection
backend/src/config/db.js - MongoDB
Feedback
- AI Messages
backend/src/utils/genAiMessages.js - Groq Client
backend/src/utils/groqClient.js - Groq API
- Email Sender
backend/src/utils/mailer.js - SMTP Email
Other components
- User
Connections 23
- User → HTTP Server: sends requests
backend/src/server.js - HTTP Server → Express App: starts
backend/src/server.js - HTTP Server → Mongo Connection: connects
backend/src/server.js - HTTP Server → User Sync: mounts routes
backend/src/server.js - HTTP Server → Prediction Workflow: mounts routes
backend/src/server.js - Express App → Prediction Workflow: mounts routes
backend/src/app.js - User Sync → Token Verification: verifies with
backend/src/routes/authRoutes.js - User Sync → User Records: reads and creates
backend/src/routes/authRoutes.js - Token Verification → Firebase Admin: uses
backend/src/middleware/verifyFirebaseToken.js - Firebase Admin → Firebase Auth: verifies tokens
backend/src/config/firebase.js - Prediction Workflow → Token Verification: verifies with
backend/src/routes/predict.js - Prediction Workflow → User Records: reads and saves
backend/src/routes/predict.js - Prediction Workflow → Prediction API: posts measurements
backend/src/routes/predict.js - Prediction Workflow → AI Messages: generates feedback
backend/src/routes/predict.js - Prediction Workflow → Email Sender: requests email
backend/src/routes/predict.js - Mongo Connection → MongoDB: connects
- Prediction API → Firebase Setup: initializes
backend/ml-service/app.py - Prediction API → Prediction Record: creates and queries
backend/ml-service/app.py - Prediction API → MongoDB: connects
backend/ml-service/app.py - Prediction API → Firebase Auth: verifies tokens
backend/ml-service/app.py - AI Messages → Groq Client: uses
backend/src/utils/genAiMessages.js - Groq Client → Groq API: sends prompts
- Email Sender → SMTP Email: sends mail