# teagamer/alexsiteback architecture

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

- Interactive diagram: https://gitdiagram.com/teagamer/alexsiteback
- Repository: https://github.com/teagamer/alexsiteback

## Overview

Це Flask API для акаунтів і календаря, з JWT-автентифікацією та AI-чатом. Основний шлях: клієнт надсилає запит до API; бекенд автентифікує користувача, обробляє профільні чи календарні операції та повертає JSON. У чаті бекенд може передавати запит AI-сервісу; календарні видалення відновлювані протягом 12 годин. README описує також вкладення чату й підтвердження AI-видалення. Через часткові уривки не деталізую невидимі внутрішні виклики; зв’язки, підтверджені лише README, позначені ним як evidence.

Main entry points: [`Backend.py`](https://github.com/teagamer/alexsiteback/blob/main/Backend.py) (Flask API), [`cleanup_deleted_events.py`](https://github.com/teagamer/alexsiteback/blob/main/cleanup_deleted_events.py) (Очищення прострочених), [`init_db.py`](https://github.com/teagamer/alexsiteback/blob/main/init_db.py) (Ініціалізація БД), [`config.py`](https://github.com/teagamer/alexsiteback/blob/main/config.py) (Конфігурація середовищ)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_backend["Flask API<br/>[Backend.py]"]
  node_health["Health endpoint<br/>[Backend.py]"]
end

subgraph group_identity["Облікові записи"]
  node_auth["Реєстрація та вхід<br/>[Backend.py]"]
  node_profiles["Профілі користувачів<br/>[Backend.py]"]
  node_tokens["JWT-сесії<br/>[Backend.py]"]
end

subgraph group_calendar["Календар"]
  node_event_api["Події календаря<br/>[Backend.py]"]
  node_recovery["Відновлення подій<br/>[Backend.py]"]
  node_cleanup["Очищення прострочених"]
end

subgraph group_assistant["AI-чат"]
  node_chat_api["Чат і вкладення<br/>[Backend.py]"]
  node_event_intent["Команди подій AI<br/>[Backend.py]"]
end

subgraph group_persistence["Дані й налаштування"]
  node_models["Моделі User/Event/Chat<br/>[Backend.py]"]
  node_database[("SQLAlchemy база<br/>[Backend.py]")]
  node_config["Конфігурація середовищ<br/>[config.py]"]
  node_init_db["Ініціалізація БД<br/>[init_db.py]"]
  node_utils["Спільні утиліти<br/>[utils.py]"]
end

node_client(("Фронтенд-клієнт"))
node_ai_service["AI-сервіс"]

node_client -->|"надсилає запити"| node_backend
node_backend -->|"обробляє health"| node_health
node_backend -->|"маршрутизує auth"| node_auth
node_backend -->|"маршрутизує профілі"| node_profiles
node_backend -->|"маршрутизує події"| node_event_api
node_backend -->|"маршрутизує чат"| node_chat_api
node_auth -->|"видає токени"| node_tokens
node_event_api -->|"підтримує restore"| node_recovery
node_event_api -.->|"зберігає події"| node_database
node_recovery -.->|"відновлює записи"| node_database
node_cleanup -->|"викликає purge"| node_backend
node_chat_api -->|"надсилає контекст"| node_ai_service
node_event_intent -->|"аналізує намір"| node_ai_service
node_client -->|"підтверджує видалення"| node_event_intent
node_backend -->|"завантажує конфіг"| node_config
node_init_db -->|"імпортує моделі"| node_backend
node_models -.->|"описує таблиці"| node_database

click node_backend "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_health "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_auth "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_profiles "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_tokens "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_event_api "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_recovery "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_cleanup "https://github.com/teagamer/alexsiteback/blob/main/cleanup_deleted_events.py"
click node_chat_api "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_event_intent "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_models "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_database "https://github.com/teagamer/alexsiteback/blob/main/Backend.py"
click node_config "https://github.com/teagamer/alexsiteback/blob/main/config.py"
click node_init_db "https://github.com/teagamer/alexsiteback/blob/main/init_db.py"
click node_utils "https://github.com/teagamer/alexsiteback/blob/main/utils.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_backend,node_health toneBlue
class node_auth,node_profiles,node_tokens toneAmber
class node_event_api,node_recovery,node_cleanup toneMint
class node_chat_api,node_event_intent toneRose
class node_models,node_database,node_config,node_init_db,node_utils,node_client,node_ai_service toneIndigo
```

## Components

### HTTP API

- [Flask API](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [Health endpoint](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`

### Облікові записи

- [Реєстрація та вхід](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [Профілі користувачів](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [JWT-сесії](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`

### Календар

- [Події календаря](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [Відновлення подій](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [Очищення прострочених](https://github.com/teagamer/alexsiteback/blob/main/cleanup_deleted_events.py): `cleanup_deleted_events.py`

### AI-чат

- [Чат і вкладення](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [Команди подій AI](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`

### Дані й налаштування

- [Моделі User/Event/Chat](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [SQLAlchemy база](https://github.com/teagamer/alexsiteback/blob/main/Backend.py): `Backend.py`
- [Конфігурація середовищ](https://github.com/teagamer/alexsiteback/blob/main/config.py): `config.py`
- [Ініціалізація БД](https://github.com/teagamer/alexsiteback/blob/main/init_db.py): `init_db.py`
- [Спільні утиліти](https://github.com/teagamer/alexsiteback/blob/main/utils.py): `utils.py`

### Other components

- **Фронтенд-клієнт**
- **AI-сервіс**

## Connections

- Фронтенд-клієнт → Flask API: надсилає запити (evidence: `README.md`)
- Flask API → Health endpoint: обробляє health (evidence: `README.md`)
- Flask API → Реєстрація та вхід: маршрутизує auth (evidence: `README.md`)
- Flask API → Профілі користувачів: маршрутизує профілі (evidence: `README.md`)
- Flask API → Події календаря: маршрутизує події (evidence: `README.md`)
- Flask API → Чат і вкладення: маршрутизує чат (evidence: `README.md`)
- Реєстрація та вхід → JWT-сесії: видає токени (evidence: `Backend.py`)
- Події календаря → Відновлення подій: підтримує restore (evidence: `README.md`)
- Події календаря → SQLAlchemy база: зберігає події (evidence: `Backend.py`)
- Відновлення подій → SQLAlchemy база: відновлює записи (evidence: `Backend.py`)
- Очищення прострочених → Flask API: викликає purge (evidence: `cleanup_deleted_events.py`)
- Чат і вкладення → AI-сервіс: надсилає контекст (evidence: `Backend.py`)
- Команди подій AI → AI-сервіс: аналізує намір (evidence: `Backend.py`)
- Фронтенд-клієнт → Команди подій AI: підтверджує видалення (evidence: `README.md`)
- Flask API → Конфігурація середовищ: завантажує конфіг (evidence: `Backend.py`)
- Ініціалізація БД → Flask API: імпортує моделі (evidence: `init_db.py`)
- Моделі User/Event/Chat → SQLAlchemy база: описує таблиці (evidence: `Backend.py`)
