How batdorj-s/system_design_eotoch works
Eotoch is a Mongolian health-risk assessment web app: people complete a questionnaire, receive disease-risk estimates with SHAP explanations and tailored advice, then can find hospitals and book appointments. The frontend also supports accounts, health history, insights, staff and admin dashboards, and offline ONNX assessment. The backend provides authentication, encrypted persistence, risk inference, knowledge-based advice, hospital services, and administration. Training scripts prepare and export models. Arrows follow the shown imports and calls or README-documented flows; unsampled implementation details are not inferred.
Main entry points: main.py FastAPI application · App.tsx Web app routes · predictor.py Risk inference · db.py Application data
Components 30
User experience
- Web app routes
src/app/App.tsx - Assessment wizard
src/app/pages/Assessment.tsx - Results and chat
src/app/pages/Result.tsx - Hospital booking
src/app/components/BookingDialog.tsx - Admin dashboard
src/app/pages/admin/AdminDashboard.tsx - Staff dashboard
src/app/pages/staff/StaffDashboard.tsx - ML insights
src/app/pages/Insights.tsx
Client services
- Offline inference
src/app/lib/offline.ts - Client controllers
src/app/domain/controllers.ts - REST client
src/app/domain/ApiController.ts
API services
- FastAPI application
backend/app/main.py - Authentication
backend/app/routers/auth.py - Security and audit
backend/app/security.py - Application data
backend/app/db.py - Assessment API
backend/app/routers/assessments.py - Hospital services
backend/app/routers/hospitals.py - Administration API
backend/app/routers/admin.py - ML information API
backend/app/routers/ml.py - Runtime configuration
backend/app/config.py
Risk and advice
- Feature conversion
backend/app/ml/features.py - Risk inference
backend/app/ml/predictor.py - SHAP explanation
backend/app/ml/explain.py - Advice generation
backend/app/services/advice.py - Knowledge retrieval
backend/app/services/knowledge.py
Model development
- Dataset analysis
ai-model/eda.py - Synthetic cohort
ai-model/synthetic.py - Model training
ai-model/train.py
Other components
- Person
- Gemini or Ollama
- Hospital staff
Connections 43
- Person → Web app routes: uses
- Web app routes → Assessment wizard: routes to
src/app/App.tsx - Web app routes → Results and chat: routes to
src/app/App.tsx - Web app routes → Hospital booking: offers booking
- Web app routes → Admin dashboard: routes to
src/app/App.tsx - Web app routes → Staff dashboard: routes to
src/app/App.tsx - Web app routes → ML insights: routes to
src/app/App.tsx - Assessment wizard → Offline inference: runs offline
src/app/pages/Assessment.tsx - Assessment wizard → REST client: submits online
- Client controllers → REST client: sends requests
src/app/domain/controllers.ts - REST client → FastAPI application: calls REST API
- FastAPI application → Authentication: registers router
backend/app/main.py - FastAPI application → Assessment API: registers router
backend/app/main.py - FastAPI application → Hospital services: registers router
backend/app/main.py - FastAPI application → Administration API: registers router
backend/app/main.py - FastAPI application → ML information API: registers router
backend/app/main.py - FastAPI application → Application data: seeds data
backend/app/main.py - FastAPI application → Risk inference: preloads models
backend/app/main.py - FastAPI application → Knowledge retrieval: seeds knowledge
backend/app/main.py - Authentication → Application data: reads and writes
backend/app/routers/auth.py - Authentication → Security and audit: uses tokens
backend/app/routers/auth.py - Assessment API → Risk inference: calculates risk
backend/app/routers/assessments.py - Assessment API → Advice generation: requests advice
backend/app/routers/assessments.py - Assessment API → Application data: stores assessments
backend/app/routers/assessments.py - Hospital services → Application data: reads and writes
backend/app/routers/hospitals.py - Administration API → Application data: manages records
backend/app/routers/admin.py - Administration API → Risk inference: manages models
backend/app/routers/admin.py - ML information API → Risk inference: serves model data
backend/app/routers/ml.py - Risk inference → Feature conversion: converts answers
backend/app/ml/predictor.py - Risk inference → SHAP explanation: builds explanations
backend/app/ml/predictor.py - Advice generation → Knowledge retrieval: retrieves knowledge
backend/app/services/advice.py - Advice generation → Gemini or Ollama: requests generation
- Person → Hospital booking: requests appointment
- Hospital booking → Hospital services: books appointment
- Hospital staff → Staff dashboard: manages bookings
- Staff dashboard → Hospital services: updates bookings
- Admin dashboard → Administration API: requests administration
- ML insights → ML information API: loads insights
- Model training → Feature conversion: shares conversion
backend/app/ml/features.py - Model training → Synthetic cohort: uses fallback data
ai-model/train.py - Model training → SHAP explanation: uses explanations
ai-model/train.py - Dataset analysis → Synthetic cohort: uses fallback cohort
ai-model/eda.py - Runtime configuration → Application data: configures database
backend/app/db.py