# yusufcanesener/online-dietitian-platform architecture

> Architecture diagram of the GitHub repository yusufcanesener/online-dietitian-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yusufcanesener/online-dietitian-platform
- Repository: https://github.com/yusufcanesener/online-dietitian-platform

## Overview

Online Diyetisyen Platformu connects members, dietitians, and admins through web and mobile clients to a FastAPI service. The main workflow is role-based sign-in, member nutrition tracking and dietitian plan management, with AI analysis and reports as an additional workflow; messaging, subscriptions, news, and notifications are also documented capabilities. Agent scheduling and rule-based risk analysis form an internal layer. Several feature endpoints and screens are represented by their existing directories because their implementation was not sampled; links without direct source evidence are omitted.

Main entry points: [`backend/app/main.py`](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/main.py) (FastAPI application), [`frontend/src/App.tsx`](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/frontend/src/App.tsx) (Web portal), [`front-end-mobile/App.tsx`](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/App.tsx) (Mobile app), [`backend/app/api/api_v1/router.py`](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/api/api_v1/router.py) (REST route registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Web and mobile clients"]
  node_web["Web portal<br/>[App.tsx]"]
  node_web_admin["Admin panel<br/>[AdminPanel.tsx]"]
  node_mobile["Mobile app<br/>[App.tsx]"]
  node_mobile_auth["Mobile auth<br/>[AuthContext.tsx]"]
  node_mobile_auth_service["Mobile auth service<br/>[authService.ts]"]
  node_mobile_api["Mobile API client<br/>[api.ts]"]
  node_mobile_storage[("Mobile local storage<br/>[storage.ts]")]
end

subgraph group_api["API and identity"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_api_router["REST route registry<br/>[router.py]"]
  node_auth["Role-based identity<br/>[auth.py]"]
end

subgraph group_nutrition["Nutrition and care"]
  node_care_endpoints["Care endpoints"]
end

subgraph group_intelligence["AI and agents"]
  node_ai_endpoints["AI endpoints<br/>[ai_router.py]"]
  node_orchestrator["AI orchestrator<br/>[orchestrator.py]"]
  node_rule_engine["Risk rule engine<br/>[rule_engine.py]"]
  node_agent_scheduler["Agent scheduler<br/>[scheduler.py]"]
  node_agent_batch["Agent batch runner<br/>[batch_runner.py]"]
  node_agent_websocket["Agent live updates"]
end

subgraph group_platform["Persistence and integrations"]
  node_n8n["n8n automation"]
  node_db_init["Database initialization<br/>[database.py]"]
  node_mongo[("MongoDB")]
  node_user_model["User and member records<br/>[user.py]"]
  node_agent_log["Agent logs<br/>[agent_log.py]"]
end

node_member(("Member"))
node_dietitian(("Dietitian"))
node_admin(("Admin"))

node_member -->|"uses"| node_web
node_dietitian -->|"uses"| node_web
node_admin -->|"uses"| node_web
node_member -->|"uses"| node_mobile
node_dietitian -->|"uses"| node_mobile
node_admin -->|"uses"| node_mobile
node_web -->|"routes to"| node_web_admin
node_web -.->|"uses API"| node_api_app
node_mobile -->|"renders"| node_mobile_auth
node_mobile_auth -->|"uses"| node_mobile_auth_service
node_mobile_auth -->|"uses"| node_mobile_storage
node_mobile_auth_service -->|"sends requests"| node_mobile_api
node_mobile_auth_service -->|"stores credentials"| node_mobile_storage
node_mobile_api -->|"reads token"| node_mobile_storage
node_mobile -.->|"uses API"| node_api_app
node_api_app -->|"mounts routes"| node_api_router
node_api_app -->|"initializes"| node_db_init
node_api_app -->|"starts scheduler"| node_agent_scheduler
node_api_router -->|"registers"| node_auth
node_api_router -->|"registers feature routes"| node_care_endpoints
node_api_router -->|"registers"| node_ai_endpoints
node_ai_endpoints -->|"invokes"| node_orchestrator
node_ai_endpoints -->|"triggers workflows"| node_n8n
node_agent_scheduler -->|"runs batches"| node_agent_batch
node_agent_scheduler -->|"publishes updates"| node_agent_websocket
node_orchestrator -->|"uses rules"| node_rule_engine
node_orchestrator -->|"records analysis"| node_agent_log
node_rule_engine -.->|"analyzes member data"| node_user_model
node_db_init -->|"connects"| node_mongo
node_db_init -->|"registers models"| node_user_model
node_db_init -->|"registers models"| node_agent_log

click node_web "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/frontend/src/App.tsx"
click node_web_admin "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/frontend/src/pages/AdminPanel.tsx"
click node_mobile "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/App.tsx"
click node_mobile_auth "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/context/AuthContext.tsx"
click node_mobile_auth_service "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/services/authService.ts"
click node_mobile_api "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/services/api.ts"
click node_mobile_storage "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/utils/storage.ts"
click node_api_app "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/main.py"
click node_api_router "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/api/api_v1/router.py"
click node_auth "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/api/api_v1/endpoints/auth.py"
click node_care_endpoints "https://github.com/yusufcanesener/online-dietitian-platform/tree/main/backend/app/api/api_v1/endpoints"
click node_ai_endpoints "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/api/api_v1/endpoints/ai_router.py"
click node_orchestrator "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/orchestrator.py"
click node_rule_engine "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/rule_engine.py"
click node_agent_scheduler "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/scheduler.py"
click node_agent_batch "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/batch_runner.py"
click node_agent_websocket "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/websocket_manager.py"
click node_db_init "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/core/database.py"
click node_user_model "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/models/user.py"
click node_agent_log "https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/models/agent_log.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_web,node_web_admin,node_mobile,node_mobile_auth,node_mobile_auth_service,node_mobile_api,node_mobile_storage toneBlue
class node_api_app,node_api_router,node_auth toneAmber
class node_care_endpoints toneMint
class node_ai_endpoints,node_orchestrator,node_rule_engine,node_agent_scheduler,node_agent_batch,node_agent_websocket toneRose
class node_n8n,node_db_init,node_mongo,node_user_model,node_agent_log,node_member,node_dietitian,node_admin toneIndigo
```

## Components

### Web and mobile clients

- [Web portal](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Admin panel](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/frontend/src/pages/AdminPanel.tsx): `frontend/src/pages/AdminPanel.tsx`
- [Mobile app](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/App.tsx): `front-end-mobile/App.tsx`
- [Mobile auth](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/context/AuthContext.tsx): `front-end-mobile/src/context/AuthContext.tsx`
- [Mobile auth service](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/services/authService.ts): `front-end-mobile/src/services/authService.ts`
- [Mobile API client](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/services/api.ts): `front-end-mobile/src/services/api.ts`
- [Mobile local storage](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/front-end-mobile/src/utils/storage.ts): `front-end-mobile/src/utils/storage.ts`

### API and identity

- [FastAPI application](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/main.py): `backend/app/main.py`
- [REST route registry](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/api/api_v1/router.py): `backend/app/api/api_v1/router.py`
- [Role-based identity](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/api/api_v1/endpoints/auth.py): `backend/app/api/api_v1/endpoints/auth.py`

### Nutrition and care

- [Care endpoints](https://github.com/yusufcanesener/online-dietitian-platform/tree/main/backend/app/api/api_v1/endpoints): `backend/app/api/api_v1/endpoints`

### AI and agents

- [AI endpoints](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/api/api_v1/endpoints/ai_router.py): `backend/app/api/api_v1/endpoints/ai_router.py`
- [AI orchestrator](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/orchestrator.py): `backend/app/agent/orchestrator.py`
- [Risk rule engine](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/rule_engine.py): `backend/app/agent/rule_engine.py`
- [Agent scheduler](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/scheduler.py): `backend/app/agent/scheduler.py`
- [Agent batch runner](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/batch_runner.py): `backend/app/agent/batch_runner.py`
- [Agent live updates](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/agent/websocket_manager.py): `backend/app/agent/websocket_manager.py`

### Persistence and integrations

- **n8n automation**
- [Database initialization](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- **MongoDB**
- [User and member records](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Agent logs](https://github.com/yusufcanesener/online-dietitian-platform/blob/main/backend/app/models/agent_log.py): `backend/app/models/agent_log.py`

### Other components

- **Member**
- **Dietitian**
- **Admin**

## Connections

- Member → Web portal: uses (evidence: `README.md`)
- Dietitian → Web portal: uses (evidence: `README.md`)
- Admin → Web portal: uses (evidence: `README.md`)
- Member → Mobile app: uses (evidence: `README.md`)
- Dietitian → Mobile app: uses (evidence: `README.md`)
- Admin → Mobile app: uses (evidence: `README.md`)
- Web portal → Admin panel: routes to (evidence: `frontend/src/App.tsx`)
- Web portal → FastAPI application: uses API (evidence: `README.md`)
- Mobile app → Mobile auth: renders (evidence: `front-end-mobile/App.tsx`)
- Mobile auth → Mobile auth service: uses (evidence: `front-end-mobile/src/context/AuthContext.tsx`)
- Mobile auth → Mobile local storage: uses (evidence: `front-end-mobile/src/context/AuthContext.tsx`)
- Mobile auth service → Mobile API client: sends requests (evidence: `front-end-mobile/src/services/authService.ts`)
- Mobile auth service → Mobile local storage: stores credentials (evidence: `front-end-mobile/src/services/authService.ts`)
- Mobile API client → Mobile local storage: reads token (evidence: `front-end-mobile/src/services/api.ts`)
- Mobile app → FastAPI application: uses API (evidence: `README.md`)
- FastAPI application → REST route registry: mounts routes (evidence: `backend/app/main.py`)
- FastAPI application → Database initialization: initializes (evidence: `backend/app/main.py`)
- FastAPI application → Agent scheduler: starts scheduler (evidence: `backend/app/main.py`)
- REST route registry → Role-based identity: registers (evidence: `backend/app/api/api_v1/router.py`)
- REST route registry → Care endpoints: registers feature routes (evidence: `backend/app/api/api_v1/router.py`)
- REST route registry → AI endpoints: registers (evidence: `backend/app/api/api_v1/router.py`)
- AI endpoints → AI orchestrator: invokes (evidence: `backend/app/api/api_v1/endpoints/ai_router.py`)
- AI endpoints → n8n automation: triggers workflows (evidence: `backend/app/api/api_v1/endpoints/ai_router.py`)
- Agent scheduler → Agent batch runner: runs batches (evidence: `backend/app/agent/scheduler.py`)
- Agent scheduler → Agent live updates: publishes updates (evidence: `backend/app/agent/scheduler.py`)
- AI orchestrator → Risk rule engine: uses rules (evidence: `backend/app/agent/orchestrator.py`)
- AI orchestrator → Agent logs: records analysis (evidence: `backend/app/agent/orchestrator.py`)
- Risk rule engine → User and member records: analyzes member data
- Database initialization → MongoDB: connects (evidence: `backend/app/core/database.py`)
- Database initialization → User and member records: registers models (evidence: `backend/app/core/database.py`)
- Database initialization → Agent logs: registers models (evidence: `backend/app/core/database.py`)
