# abdullayevtemurmalik/shaxsiytelegramaifront architecture

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

- Interactive diagram: https://gitdiagram.com/abdullayevtemurmalik/shaxsiytelegramaifront
- Repository: https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront

## Overview

Telegram AI (JARVIS) is a web dashboard for connecting a Telegram account and managing its AI assistant. The main workflow is: the app loads status and dashboard data, presents authentication, settings, key, chat, and log views, and sends user actions through a shared API client to the configured backend. The README also describes model, multimodal, and assistant capabilities surfaced in the settings and logs UI. Edges between the app and its rendered views are visible in the App excerpt; some tab-to-API links are based on the source index and are marked unverified.

Main entry points: [`src/App.tsx`](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/App.tsx) (App coordinator), [`src/api/client.ts`](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/api/client.ts) (API client), [`src/components/SettingsTab.tsx`](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/SettingsTab.tsx) (Assistant settings), [`src/components/GeminiKeysTab.tsx`](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/GeminiKeysTab.tsx) (Gemini keys)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Dashboard"]
  node_app["App coordinator<br/>[App.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_status["Status overview<br/>[StatusCard.tsx]"]
end

subgraph group_auth["Telegram access"]
  node_login["Telegram login"]
  node_phone["Phone input"]
end

subgraph group_controls["Assistant controls"]
  node_settings["Assistant settings<br/>[SettingsTab.tsx]"]
  node_keys["Gemini keys<br/>[GeminiKeysTab.tsx]"]
  node_chats["Chat controls<br/>[ChatsTab.tsx]"]
end

subgraph group_monitoring["Activity monitoring"]
  node_logs["Activity logs<br/>[LogsTab.tsx]"]
end

subgraph group_shared["API and UI components"]
  node_api["API client<br/>[client.ts]"]
  node_confirm["Confirmation modal<br/>[ConfirmModal.tsx]"]
  node_datepicker["Date picker"]
  node_select["Select control<br/>[CustomSelect.tsx]"]
  node_toggle["Toggle control<br/>[CustomToggle.tsx]"]
  node_icon["JARVIS icon<br/>[JarvisAiIcon.tsx]"]
end

node_user(("Dashboard user"))
node_backend["Backend API"]

node_user -->|"uses"| node_app
node_app -->|"loads data"| node_api
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_status
node_app -->|"renders"| node_login
node_app -->|"renders"| node_settings
node_app -->|"renders"| node_keys
node_app -->|"renders"| node_chats
node_app -->|"renders"| node_logs
node_login -->|"uses"| node_phone
node_settings -.->|"uses"| node_api
node_keys -.->|"uses"| node_api
node_chats -.->|"uses"| node_api
node_logs -.->|"uses"| node_api
node_status -.->|"uses"| node_api
node_api -.->|"requests"| node_backend
node_settings -->|"uses"| node_select
node_settings -->|"uses"| node_toggle
node_settings -->|"uses"| node_confirm
node_keys -->|"uses"| node_toggle
node_keys -->|"uses"| node_confirm
node_chats -->|"uses"| node_toggle
node_logs -->|"uses"| node_datepicker
node_navbar -->|"uses"| node_icon

click node_app "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/App.tsx"
click node_navbar "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/Navbar.tsx"
click node_status "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/StatusCard.tsx"
click node_login "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/TelegramLoginModal.tsx"
click node_phone "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/PhoneInputWithCountry.tsx"
click node_settings "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/SettingsTab.tsx"
click node_keys "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/GeminiKeysTab.tsx"
click node_chats "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/ChatsTab.tsx"
click node_logs "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/LogsTab.tsx"
click node_api "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/api/client.ts"
click node_confirm "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/ConfirmModal.tsx"
click node_datepicker "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/CustomDatePicker.tsx"
click node_select "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/CustomSelect.tsx"
click node_toggle "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/CustomToggle.tsx"
click node_icon "https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/JarvisAiIcon.tsx"

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_navbar,node_status,node_user toneBlue
class node_login,node_phone toneAmber
class node_settings,node_keys,node_chats,node_backend toneMint
class node_logs toneRose
class node_api,node_confirm,node_datepicker,node_select,node_toggle,node_icon toneIndigo
```

## Components

### Dashboard

- [App coordinator](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Status overview](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/StatusCard.tsx): `src/components/StatusCard.tsx`

### Telegram access

- [Telegram login](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/TelegramLoginModal.tsx): `src/components/TelegramLoginModal.tsx`
- [Phone input](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/PhoneInputWithCountry.tsx): `src/components/PhoneInputWithCountry.tsx`

### Assistant controls

- [Assistant settings](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/SettingsTab.tsx): `src/components/SettingsTab.tsx`
- [Gemini keys](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/GeminiKeysTab.tsx): `src/components/GeminiKeysTab.tsx`
- [Chat controls](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/ChatsTab.tsx): `src/components/ChatsTab.tsx`

### Activity monitoring

- [Activity logs](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/LogsTab.tsx): `src/components/LogsTab.tsx`

### API and UI components

- [API client](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/api/client.ts): `src/api/client.ts`
- [Confirmation modal](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/ConfirmModal.tsx): `src/components/common/ConfirmModal.tsx`
- [Date picker](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/CustomDatePicker.tsx): `src/components/common/CustomDatePicker.tsx`
- [Select control](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/CustomSelect.tsx): `src/components/common/CustomSelect.tsx`
- [Toggle control](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/CustomToggle.tsx): `src/components/common/CustomToggle.tsx`
- [JARVIS icon](https://github.com/abdullayevtemurmalik/shaxsiytelegramaifront/blob/main/src/components/common/JarvisAiIcon.tsx): `src/components/common/JarvisAiIcon.tsx`

### Other components

- **Dashboard user**
- **Backend API**

## Connections

- Dashboard user → App coordinator: uses (evidence: `README.md`)
- App coordinator → API client: loads data (evidence: `src/App.tsx`)
- App coordinator → Navigation: renders (evidence: `src/App.tsx`)
- App coordinator → Status overview: renders (evidence: `src/App.tsx`)
- App coordinator → Telegram login: renders (evidence: `src/App.tsx`)
- App coordinator → Assistant settings: renders (evidence: `src/App.tsx`)
- App coordinator → Gemini keys: renders (evidence: `src/App.tsx`)
- App coordinator → Chat controls: renders (evidence: `src/App.tsx`)
- App coordinator → Activity logs: renders (evidence: `src/App.tsx`)
- Telegram login → Phone input: uses (evidence: `src/components/TelegramLoginModal.tsx`)
- Assistant settings → API client: uses (evidence: `src/components/SettingsTab.tsx`)
- Gemini keys → API client: uses (evidence: `src/components/GeminiKeysTab.tsx`)
- Chat controls → API client: uses (evidence: `src/components/ChatsTab.tsx`)
- Activity logs → API client: uses (evidence: `src/components/LogsTab.tsx`)
- Status overview → API client: uses (evidence: `src/components/StatusCard.tsx`)
- API client → Backend API: requests (evidence: `README.md`)
- Assistant settings → Select control: uses (evidence: `src/components/SettingsTab.tsx`)
- Assistant settings → Toggle control: uses (evidence: `src/components/SettingsTab.tsx`)
- Assistant settings → Confirmation modal: uses (evidence: `src/App.tsx`)
- Gemini keys → Toggle control: uses (evidence: `src/components/GeminiKeysTab.tsx`)
- Gemini keys → Confirmation modal: uses (evidence: `src/components/GeminiKeysTab.tsx`)
- Chat controls → Toggle control: uses (evidence: `src/components/ChatsTab.tsx`)
- Activity logs → Date picker: uses (evidence: `src/components/LogsTab.tsx`)
- Navigation → JARVIS icon: uses (evidence: `src/components/Navbar.tsx`)
