# batdorj-s/system_design_eotoch architecture

> Architecture diagram of the GitHub repository batdorj-s/system_design_eotoch, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/batdorj-s/system_design_eotoch
- Repository: https://github.com/batdorj-s/system_design_eotoch

## Overview

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: [`backend/app/main.py`](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/main.py) (FastAPI application), [`src/app/App.tsx`](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/App.tsx) (Web app routes), [`backend/app/ml/predictor.py`](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/ml/predictor.py) (Risk inference), [`backend/app/db.py`](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/db.py) (Application data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user_app["User experience"]
  node_app["Web app routes<br/>[App.tsx]"]
  node_assessment_ui["Assessment wizard<br/>[Assessment.tsx]"]
  node_results_ui["Results and chat<br/>[Result.tsx]"]
  node_booking_ui["Hospital booking<br/>[BookingDialog.tsx]"]
  node_admin_ui["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_staff_ui["Staff dashboard<br/>[StaffDashboard.tsx]"]
  node_insights_ui["ML insights<br/>[Insights.tsx]"]
end

subgraph group_client_core["Client services"]
  node_offline["Offline inference<br/>[offline.ts]"]
  node_domain_controllers["Client controllers<br/>[controllers.ts]"]
  node_api_controller["REST client<br/>[ApiController.ts]"]
end

subgraph group_api_core["API services"]
  node_backend["FastAPI application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_security["Security and audit<br/>[security.py]"]
  node_storage[("Application data<br/>[db.py]")]
  node_assessment_api["Assessment API<br/>[assessments.py]"]
  node_hospital_api["Hospital services<br/>[hospitals.py]"]
  node_admin_api["Administration API<br/>[admin.py]"]
  node_ml_api["ML information API<br/>[ml.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
end

subgraph group_risk_advice["Risk and advice"]
  node_features["Feature conversion<br/>[features.py]"]
  node_predictor["Risk inference<br/>[predictor.py]"]
  node_explain["SHAP explanation<br/>[explain.py]"]
  node_advice["Advice generation<br/>[advice.py]"]
  node_knowledge["Knowledge retrieval<br/>[knowledge.py]"]
end

subgraph group_model_build["Model development"]
  node_eda["Dataset analysis<br/>[eda.py]"]
  node_synthetic["Synthetic cohort<br/>[synthetic.py]"]
  node_training["Model training<br/>[train.py]"]
end

node_person(("Person"))
node_llm["Gemini or Ollama"]
node_hospital_user(("Hospital staff"))

node_person -->|"uses"| node_app
node_app -->|"routes to"| node_assessment_ui
node_app -->|"routes to"| node_results_ui
node_app -->|"offers booking"| node_booking_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_staff_ui
node_app -->|"routes to"| node_insights_ui
node_assessment_ui -->|"runs offline"| node_offline
node_assessment_ui -->|"submits online"| node_api_controller
node_domain_controllers -->|"sends requests"| node_api_controller
node_api_controller -->|"calls REST API"| node_backend
node_backend -->|"registers router"| node_auth
node_backend -->|"registers router"| node_assessment_api
node_backend -->|"registers router"| node_hospital_api
node_backend -->|"registers router"| node_admin_api
node_backend -->|"registers router"| node_ml_api
node_backend -->|"seeds data"| node_storage
node_backend -->|"preloads models"| node_predictor
node_backend -->|"seeds knowledge"| node_knowledge
node_auth -->|"reads and writes"| node_storage
node_auth -->|"uses tokens"| node_security
node_assessment_api -->|"calculates risk"| node_predictor
node_assessment_api -->|"requests advice"| node_advice
node_assessment_api -->|"stores assessments"| node_storage
node_hospital_api -->|"reads and writes"| node_storage
node_admin_api -->|"manages records"| node_storage
node_admin_api -->|"manages models"| node_predictor
node_ml_api -->|"serves model data"| node_predictor
node_predictor -->|"converts answers"| node_features
node_predictor -->|"builds explanations"| node_explain
node_advice -->|"retrieves knowledge"| node_knowledge
node_advice -.->|"requests generation"| node_llm
node_person -->|"requests appointment"| node_booking_ui
node_booking_ui -->|"books appointment"| node_hospital_api
node_hospital_user -->|"manages bookings"| node_staff_ui
node_staff_ui -->|"updates bookings"| node_hospital_api
node_admin_ui -->|"requests administration"| node_admin_api
node_insights_ui -->|"loads insights"| node_ml_api
node_training -->|"shares conversion"| node_features
node_training -->|"uses fallback data"| node_synthetic
node_training -->|"uses explanations"| node_explain
node_eda -->|"uses fallback cohort"| node_synthetic
node_config -->|"configures database"| node_storage

click node_app "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/App.tsx"
click node_assessment_ui "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/Assessment.tsx"
click node_results_ui "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/Result.tsx"
click node_booking_ui "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/components/BookingDialog.tsx"
click node_admin_ui "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/admin/AdminDashboard.tsx"
click node_staff_ui "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/staff/StaffDashboard.tsx"
click node_insights_ui "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/Insights.tsx"
click node_offline "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/lib/offline.ts"
click node_domain_controllers "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/domain/controllers.ts"
click node_api_controller "https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/domain/ApiController.ts"
click node_backend "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/main.py"
click node_auth "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/auth.py"
click node_security "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/security.py"
click node_storage "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/db.py"
click node_assessment_api "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/assessments.py"
click node_hospital_api "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/hospitals.py"
click node_admin_api "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/admin.py"
click node_ml_api "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/ml.py"
click node_config "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/config.py"
click node_features "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/ml/features.py"
click node_predictor "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/ml/predictor.py"
click node_explain "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/ml/explain.py"
click node_advice "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/services/advice.py"
click node_knowledge "https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/services/knowledge.py"
click node_eda "https://github.com/batdorj-s/system_design_eotoch/blob/main/ai-model/eda.py"
click node_synthetic "https://github.com/batdorj-s/system_design_eotoch/blob/main/ai-model/synthetic.py"
click node_training "https://github.com/batdorj-s/system_design_eotoch/blob/main/ai-model/train.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_assessment_ui,node_results_ui,node_booking_ui,node_admin_ui,node_staff_ui,node_insights_ui toneBlue
class node_offline,node_domain_controllers,node_api_controller toneAmber
class node_backend,node_auth,node_security,node_storage,node_assessment_api,node_hospital_api,node_admin_api,node_ml_api,node_config toneMint
class node_features,node_predictor,node_explain,node_advice,node_knowledge toneRose
class node_eda,node_synthetic,node_training,node_person,node_llm,node_hospital_user toneIndigo
```

## Components

### User experience

- [Web app routes](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [Assessment wizard](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/Assessment.tsx): `src/app/pages/Assessment.tsx`
- [Results and chat](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/Result.tsx): `src/app/pages/Result.tsx`
- [Hospital booking](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/components/BookingDialog.tsx): `src/app/components/BookingDialog.tsx`
- [Admin dashboard](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/admin/AdminDashboard.tsx): `src/app/pages/admin/AdminDashboard.tsx`
- [Staff dashboard](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/staff/StaffDashboard.tsx): `src/app/pages/staff/StaffDashboard.tsx`
- [ML insights](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/pages/Insights.tsx): `src/app/pages/Insights.tsx`

### Client services

- [Offline inference](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/lib/offline.ts): `src/app/lib/offline.ts`
- [Client controllers](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/domain/controllers.ts): `src/app/domain/controllers.ts`
- [REST client](https://github.com/batdorj-s/system_design_eotoch/blob/main/src/app/domain/ApiController.ts): `src/app/domain/ApiController.ts`

### API services

- [FastAPI application](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Security and audit](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/security.py): `backend/app/security.py`
- [Application data](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/db.py): `backend/app/db.py`
- [Assessment API](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/assessments.py): `backend/app/routers/assessments.py`
- [Hospital services](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/hospitals.py): `backend/app/routers/hospitals.py`
- [Administration API](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/admin.py): `backend/app/routers/admin.py`
- [ML information API](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/routers/ml.py): `backend/app/routers/ml.py`
- [Runtime configuration](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/config.py): `backend/app/config.py`

### Risk and advice

- [Feature conversion](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/ml/features.py): `backend/app/ml/features.py`
- [Risk inference](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/ml/predictor.py): `backend/app/ml/predictor.py`
- [SHAP explanation](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/ml/explain.py): `backend/app/ml/explain.py`
- [Advice generation](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/services/advice.py): `backend/app/services/advice.py`
- [Knowledge retrieval](https://github.com/batdorj-s/system_design_eotoch/blob/main/backend/app/services/knowledge.py): `backend/app/services/knowledge.py`

### Model development

- [Dataset analysis](https://github.com/batdorj-s/system_design_eotoch/blob/main/ai-model/eda.py): `ai-model/eda.py`
- [Synthetic cohort](https://github.com/batdorj-s/system_design_eotoch/blob/main/ai-model/synthetic.py): `ai-model/synthetic.py`
- [Model training](https://github.com/batdorj-s/system_design_eotoch/blob/main/ai-model/train.py): `ai-model/train.py`

### Other components

- **Person**
- **Gemini or Ollama**
- **Hospital staff**

## Connections

- Person → Web app routes: uses
- Web app routes → Assessment wizard: routes to (evidence: `src/app/App.tsx`)
- Web app routes → Results and chat: routes to (evidence: `src/app/App.tsx`)
- Web app routes → Hospital booking: offers booking
- Web app routes → Admin dashboard: routes to (evidence: `src/app/App.tsx`)
- Web app routes → Staff dashboard: routes to (evidence: `src/app/App.tsx`)
- Web app routes → ML insights: routes to (evidence: `src/app/App.tsx`)
- Assessment wizard → Offline inference: runs offline (evidence: `src/app/pages/Assessment.tsx`)
- Assessment wizard → REST client: submits online
- Client controllers → REST client: sends requests (evidence: `src/app/domain/controllers.ts`)
- REST client → FastAPI application: calls REST API
- FastAPI application → Authentication: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Assessment API: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Hospital services: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Administration API: registers router (evidence: `backend/app/main.py`)
- FastAPI application → ML information API: registers router (evidence: `backend/app/main.py`)
- FastAPI application → Application data: seeds data (evidence: `backend/app/main.py`)
- FastAPI application → Risk inference: preloads models (evidence: `backend/app/main.py`)
- FastAPI application → Knowledge retrieval: seeds knowledge (evidence: `backend/app/main.py`)
- Authentication → Application data: reads and writes (evidence: `backend/app/routers/auth.py`)
- Authentication → Security and audit: uses tokens (evidence: `backend/app/routers/auth.py`)
- Assessment API → Risk inference: calculates risk (evidence: `backend/app/routers/assessments.py`)
- Assessment API → Advice generation: requests advice (evidence: `backend/app/routers/assessments.py`)
- Assessment API → Application data: stores assessments (evidence: `backend/app/routers/assessments.py`)
- Hospital services → Application data: reads and writes (evidence: `backend/app/routers/hospitals.py`)
- Administration API → Application data: manages records (evidence: `backend/app/routers/admin.py`)
- Administration API → Risk inference: manages models (evidence: `backend/app/routers/admin.py`)
- ML information API → Risk inference: serves model data (evidence: `backend/app/routers/ml.py`)
- Risk inference → Feature conversion: converts answers (evidence: `backend/app/ml/predictor.py`)
- Risk inference → SHAP explanation: builds explanations (evidence: `backend/app/ml/predictor.py`)
- Advice generation → Knowledge retrieval: retrieves knowledge (evidence: `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 (evidence: `backend/app/ml/features.py`)
- Model training → Synthetic cohort: uses fallback data (evidence: `ai-model/train.py`)
- Model training → SHAP explanation: uses explanations (evidence: `ai-model/train.py`)
- Dataset analysis → Synthetic cohort: uses fallback cohort (evidence: `ai-model/eda.py`)
- Runtime configuration → Application data: configures database (evidence: `backend/app/db.py`)
