# eraycancoban/tubitak architecture

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

- Interactive diagram: https://gitdiagram.com/eraycancoban/tubitak
- Repository: https://github.com/eraycancoban/tubitak

## Overview

This repository is a Turkish diary and emotional-wellbeing web app. Users can register or sign in, write diary entries with optional camera-based emotion capture, receive chatbot replies, and review diary history; administrators have user and analysis views. The frontend routes these experiences to an Express API, which uses MySQL and calls local ML endpoints for diary analysis and forecasts. The README provides no capability details, so the product map is based on the source tree and excerpts. The Python service’s implementation and its connection to those endpoints were not shown; that relationship is left unverified.

Main entry points: [`tubitak-proje-frontend/src/App.tsx`](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/App.tsx) (Route shell), [`api/index.js`](https://github.com/eraycancoban/tubitak/blob/main/api/index.js) (HTTP server), [`tubitak-proje-frontend/src/pages/Chatbot.tsx`](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/Chatbot.tsx) (Chat and camera), [`api/routes/users.js`](https://github.com/eraycancoban/tubitak/blob/main/api/routes/users.js) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Route shell<br/>[App.tsx]"]
  node_authui["Sign-in state<br/>[authContext.js]"]
  node_diaryui["Diary entry<br/>[DiaryPage.tsx]"]
  node_chatui["Chat and camera<br/>[Chatbot.tsx]"]
  node_historyui["Diary history<br/>[DiaryHistory.tsx]"]
  node_profileui["User profile<br/>[UserInfo.tsx]"]
  node_adminui["Admin analysis<br/>[AdminAnalysis.tsx]"]
  node_contentui["Public content<br/>[Home.tsx]"]
  node_blogdata["Blog content<br/>[blogs.ts]"]
end

subgraph group_api["Application API"]
  node_authapi["Authentication routes<br/>[auth.js]"]
  node_userapi["User routes<br/>[users.js]"]
  node_chatapi["Chat routes<br/>[chat.js]"]
  node_ragapi["RAG chat routes<br/>[chatt.js]"]
  node_authlogic["Auth operations<br/>[auth.js]"]
  node_userlogic["Diary and user logic<br/>[user.js]"]
  node_chatlogic["Chat operations<br/>[chat.js]"]
  node_raglogic["RAG chat operations<br/>[chatt.js]"]
  node_modelctl["Model controller<br/>[model.js]"]
  node_server["HTTP server<br/>[index.js]"]
end

subgraph group_analysis["Analysis services"]
  node_ml["Python analysis service<br/>[mode.py]"]
end

subgraph group_state["Persistence and identity"]
  node_db[("MySQL diary<br/>[db.js]")]
end

node_visitor(("Visitor"))
node_flask["Local ML endpoints"]
node_mail["Email service"]

node_visitor -->|"uses"| node_app
node_app -->|"reads session"| node_authui
node_app -->|"routes to"| node_diaryui
node_app -->|"routes to"| node_chatui
node_app -->|"routes to"| node_historyui
node_app -->|"routes to"| node_profileui
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_contentui
node_contentui -->|"renders content"| node_blogdata
node_authui -->|"posts login"| node_authapi
node_diaryui -->|"saves entry"| node_userapi
node_diaryui -->|"sends images"| node_flask
node_chatui -->|"requests reply"| node_chatapi
node_chatui -->|"fetches diary"| node_userapi
node_chatui -->|"sends images"| node_flask
node_server -->|"mounts routes"| node_authapi
node_server -->|"mounts routes"| node_userapi
node_server -->|"mounts routes"| node_chatapi
node_server -->|"mounts routes"| node_ragapi
node_authapi -->|"dispatches to"| node_authlogic
node_userapi -->|"dispatches to"| node_userlogic
node_chatapi -->|"dispatches to"| node_chatlogic
node_ragapi -->|"dispatches to"| node_raglogic
node_authlogic -->|"queries"| node_db
node_authlogic -->|"sends reset email"| node_mail
node_userlogic -->|"reads and writes"| node_db
node_userlogic -->|"requests analysis"| node_flask
node_chatlogic -->|"queries"| node_db
node_raglogic -->|"queries"| node_db
node_ml -.-> node_flask

click node_app "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/App.tsx"
click node_authui "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/context/authContext.js"
click node_diaryui "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/components/DiaryPage/DiaryPage.tsx"
click node_chatui "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/Chatbot.tsx"
click node_historyui "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/DiaryHistory.tsx"
click node_profileui "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/UserInfo.tsx"
click node_adminui "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/AdminAnalysis.tsx"
click node_contentui "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/Home.tsx"
click node_blogdata "https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/data/blogs.ts"
click node_authapi "https://github.com/eraycancoban/tubitak/blob/main/api/routes/auth.js"
click node_userapi "https://github.com/eraycancoban/tubitak/blob/main/api/routes/users.js"
click node_chatapi "https://github.com/eraycancoban/tubitak/blob/main/api/routes/chat.js"
click node_ragapi "https://github.com/eraycancoban/tubitak/blob/main/api/routes/chatt.js"
click node_authlogic "https://github.com/eraycancoban/tubitak/blob/main/api/controllers/auth.js"
click node_userlogic "https://github.com/eraycancoban/tubitak/blob/main/api/controllers/user.js"
click node_chatlogic "https://github.com/eraycancoban/tubitak/blob/main/api/controllers/chat.js"
click node_raglogic "https://github.com/eraycancoban/tubitak/blob/main/api/controllers/chatt.js"
click node_modelctl "https://github.com/eraycancoban/tubitak/blob/main/api/controllers/model.js"
click node_server "https://github.com/eraycancoban/tubitak/blob/main/api/index.js"
click node_db "https://github.com/eraycancoban/tubitak/blob/main/api/db.js"
click node_ml "https://github.com/eraycancoban/tubitak/blob/main/api/mode.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_authui,node_diaryui,node_chatui,node_historyui,node_profileui,node_adminui,node_contentui,node_blogdata toneBlue
class node_authapi,node_userapi,node_chatapi,node_ragapi,node_authlogic,node_userlogic,node_chatlogic,node_raglogic,node_modelctl,node_server toneAmber
class node_ml toneMint
class node_db toneRose
class node_visitor,node_flask,node_mail toneIndigo
```

## Components

### Web experience

- [Route shell](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/App.tsx): `tubitak-proje-frontend/src/App.tsx`
- [Sign-in state](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/context/authContext.js): `tubitak-proje-frontend/src/context/authContext.js`
- [Diary entry](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/components/DiaryPage/DiaryPage.tsx): `tubitak-proje-frontend/src/components/DiaryPage/DiaryPage.tsx`
- [Chat and camera](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/Chatbot.tsx): `tubitak-proje-frontend/src/pages/Chatbot.tsx`
- [Diary history](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/DiaryHistory.tsx): `tubitak-proje-frontend/src/pages/DiaryHistory.tsx`
- [User profile](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/UserInfo.tsx): `tubitak-proje-frontend/src/pages/UserInfo.tsx`
- [Admin analysis](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/AdminAnalysis.tsx): `tubitak-proje-frontend/src/pages/AdminAnalysis.tsx`
- [Public content](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/pages/Home.tsx): `tubitak-proje-frontend/src/pages/Home.tsx`
- [Blog content](https://github.com/eraycancoban/tubitak/blob/main/tubitak-proje-frontend/src/data/blogs.ts): `tubitak-proje-frontend/src/data/blogs.ts`

### Application API

- [Authentication routes](https://github.com/eraycancoban/tubitak/blob/main/api/routes/auth.js): `api/routes/auth.js`
- [User routes](https://github.com/eraycancoban/tubitak/blob/main/api/routes/users.js): `api/routes/users.js`
- [Chat routes](https://github.com/eraycancoban/tubitak/blob/main/api/routes/chat.js): `api/routes/chat.js`
- [RAG chat routes](https://github.com/eraycancoban/tubitak/blob/main/api/routes/chatt.js): `api/routes/chatt.js`
- [Auth operations](https://github.com/eraycancoban/tubitak/blob/main/api/controllers/auth.js): `api/controllers/auth.js`
- [Diary and user logic](https://github.com/eraycancoban/tubitak/blob/main/api/controllers/user.js): `api/controllers/user.js`
- [Chat operations](https://github.com/eraycancoban/tubitak/blob/main/api/controllers/chat.js): `api/controllers/chat.js`
- [RAG chat operations](https://github.com/eraycancoban/tubitak/blob/main/api/controllers/chatt.js): `api/controllers/chatt.js`
- [Model controller](https://github.com/eraycancoban/tubitak/blob/main/api/controllers/model.js): `api/controllers/model.js`
- [HTTP server](https://github.com/eraycancoban/tubitak/blob/main/api/index.js): `api/index.js`

### Analysis services

- [Python analysis service](https://github.com/eraycancoban/tubitak/blob/main/api/mode.py): `api/mode.py`

### Persistence and identity

- [MySQL diary](https://github.com/eraycancoban/tubitak/blob/main/api/db.js): `api/db.js`

### Other components

- **Visitor**
- **Local ML endpoints**
- **Email service**

## Connections

- Visitor → Route shell: uses (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Route shell → Sign-in state: reads session (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Route shell → Diary entry: routes to (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Route shell → Chat and camera: routes to (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Route shell → Diary history: routes to (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Route shell → User profile: routes to (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Route shell → Admin analysis: routes to (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Route shell → Public content: routes to (evidence: `tubitak-proje-frontend/src/App.tsx`)
- Public content → Blog content: renders content (evidence: `tubitak-proje-frontend/src/pages/Home.tsx`)
- Sign-in state → Authentication routes: posts login (evidence: `tubitak-proje-frontend/src/context/authContext.js`)
- Diary entry → User routes: saves entry (evidence: `tubitak-proje-frontend/src/components/DiaryPage/DiaryPage.tsx`)
- Diary entry → Local ML endpoints: sends images (evidence: `tubitak-proje-frontend/src/components/DiaryPage/DiaryPage.tsx`)
- Chat and camera → Chat routes: requests reply (evidence: `tubitak-proje-frontend/src/pages/Chatbot.tsx`)
- Chat and camera → User routes: fetches diary (evidence: `tubitak-proje-frontend/src/pages/Chatbot.tsx`)
- Chat and camera → Local ML endpoints: sends images (evidence: `tubitak-proje-frontend/src/pages/Chatbot.tsx`)
- HTTP server → Authentication routes: mounts routes (evidence: `api/index.js`)
- HTTP server → User routes: mounts routes (evidence: `api/index.js`)
- HTTP server → Chat routes: mounts routes (evidence: `api/index.js`)
- HTTP server → RAG chat routes: mounts routes (evidence: `api/index.js`)
- Authentication routes → Auth operations: dispatches to (evidence: `api/routes/auth.js`)
- User routes → Diary and user logic: dispatches to (evidence: `api/routes/users.js`)
- Chat routes → Chat operations: dispatches to (evidence: `api/routes/chat.js`)
- RAG chat routes → RAG chat operations: dispatches to (evidence: `api/routes/chatt.js`)
- Auth operations → MySQL diary: queries (evidence: `api/controllers/auth.js`)
- Auth operations → Email service: sends reset email (evidence: `api/controllers/auth.js`)
- Diary and user logic → MySQL diary: reads and writes (evidence: `api/controllers/user.js`)
- Diary and user logic → Local ML endpoints: requests analysis (evidence: `api/controllers/user.js`)
- Chat operations → MySQL diary: queries (evidence: `api/controllers/chat.js`)
- RAG chat operations → MySQL diary: queries (evidence: `api/controllers/chatt.js`)
- Python analysis service → Local ML endpoints
