# faramat/autopay_bot architecture

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

- Interactive diagram: https://gitdiagram.com/faramat/autopay_bot
- Repository: https://github.com/faramat/autopay_bot

## Overview

This is an aiogram Telegram bot for paid-channel subscriptions. Users start the bot, join a free channel, choose a subscription term, pay through RuKassa, and receive access to the private channel; scheduled checks handle subscription expiry. Admins can change prices, broadcast messages, and request database backups. The graph follows shown router registration and calls; database internals and several modules were not excerpted, so their links are limited to relationships visible in the supplied sources.

Main entry points: [`main.py`](https://github.com/faramat/autopay_bot/blob/master/main.py) (Bot runtime), [`handlers/user_commands.py`](https://github.com/faramat/autopay_bot/blob/master/handlers/user_commands.py) (User commands), [`callbacks/payments.py`](https://github.com/faramat/autopay_bot/blob/master/callbacks/payments.py) (Payment callbacks), [`handlers/admin.py`](https://github.com/faramat/autopay_bot/blob/master/handlers/admin.py) (Admin controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Bot entry"]
  node_bot_runtime["Bot runtime<br/>[main.py]"]
  node_user_commands["User commands<br/>[user_commands.py]"]
  node_channel_keyboards["Channel keyboards<br/>[inline.py]"]
  node_reply_keyboards["Navigation keyboards<br/>[reply.py]"]
  node_configuration["Bot configuration<br/>[config.py]"]
  node_request_session["HTTP session<br/>[api_session.py]"]
end

subgraph group_subscription["Subscription flow"]
  node_subscription_callbacks["Channel callbacks<br/>[sub_channels.py]"]
  node_payment_callbacks["Payment callbacks<br/>[payments.py]"]
  node_payment_keyboards["Payment links<br/>[builders.py]"]
end

subgraph group_storage["Persistence"]
  node_user_records[("User records")]
  node_subscription_records[("Subscription records<br/>[db_user_sub.py]")]
  node_payment_records[("Payment records<br/>[db_user_payment.py]")]
  node_admin_records[("Admin records<br/>[db_admin.py]")]
  node_sqlite_file[("SQLite database<br/>[autopay.db]")]
end

subgraph group_operations["Admin operations"]
  node_admin_handlers["Admin controls<br/>[admin.py]"]
  node_maintenance["Subscription maintenance<br/>[database.py]"]
end

node_telegram_user(("Telegram user"))
node_rukassa["RuKassa"]
node_telegram_api["Telegram API"]

node_telegram_user -->|"sends updates"| node_bot_runtime
node_bot_runtime -->|"registers router"| node_user_commands
node_bot_runtime -->|"registers router"| node_subscription_callbacks
node_bot_runtime -->|"registers router"| node_payment_callbacks
node_bot_runtime -->|"registers router"| node_admin_handlers
node_bot_runtime -->|"runs checks"| node_maintenance
node_user_commands -->|"registers users"| node_user_records
node_user_commands -->|"checks access"| node_subscription_records
node_user_commands -->|"builds plan menu"| node_payment_keyboards
node_user_commands -->|"shows channel links"| node_channel_keyboards
node_user_commands -->|"shows navigation"| node_reply_keyboards
node_user_commands -->|"checks membership"| node_telegram_api
node_subscription_callbacks -->|"rechecks subscription"| node_user_commands
node_subscription_callbacks -->|"shows subscription link"| node_channel_keyboards
node_payment_callbacks -->|"creates payment link"| node_payment_keyboards
node_payment_callbacks -->|"reads plan prices"| node_admin_records
node_payment_callbacks -->|"activates subscription"| node_payment_records
node_payment_callbacks -->|"checks payment"| node_rukassa
node_payment_callbacks -->|"offers channel access"| node_channel_keyboards
node_payment_keyboards -->|"reads plan prices"| node_admin_records
node_payment_keyboards -->|"creates payment"| node_rukassa
node_admin_handlers -->|"updates prices"| node_admin_records
node_admin_handlers -->|"loads recipients"| node_user_records
node_admin_handlers -->|"sends broadcasts"| node_telegram_api
node_admin_handlers -->|"requests backup"| node_maintenance
node_maintenance -->|"checks expiry"| node_subscription_records
node_maintenance -->|"sends backup"| node_telegram_api
node_bot_runtime -->|"loads settings"| node_configuration
node_bot_runtime -->|"creates session"| node_request_session
node_user_records -.->|"stores records"| node_sqlite_file
node_subscription_records -.->|"stores subscriptions"| node_sqlite_file
node_payment_records -.->|"stores payments"| node_sqlite_file
node_admin_records -.->|"stores admin data"| node_sqlite_file

click node_bot_runtime "https://github.com/faramat/autopay_bot/blob/master/main.py"
click node_user_commands "https://github.com/faramat/autopay_bot/blob/master/handlers/user_commands.py"
click node_subscription_callbacks "https://github.com/faramat/autopay_bot/blob/master/callbacks/sub_channels.py"
click node_payment_callbacks "https://github.com/faramat/autopay_bot/blob/master/callbacks/payments.py"
click node_payment_keyboards "https://github.com/faramat/autopay_bot/blob/master/keyboards/builders.py"
click node_channel_keyboards "https://github.com/faramat/autopay_bot/blob/master/keyboards/inline.py"
click node_reply_keyboards "https://github.com/faramat/autopay_bot/blob/master/keyboards/reply.py"
click node_admin_handlers "https://github.com/faramat/autopay_bot/blob/master/handlers/admin.py"
click node_maintenance "https://github.com/faramat/autopay_bot/blob/master/misc/database.py"
click node_configuration "https://github.com/faramat/autopay_bot/blob/master/config.py"
click node_request_session "https://github.com/faramat/autopay_bot/blob/master/services/api_session.py"
click node_user_records "https://github.com/faramat/autopay_bot/blob/master/data/db_user_start_bot.py"
click node_subscription_records "https://github.com/faramat/autopay_bot/blob/master/data/db_user_sub.py"
click node_payment_records "https://github.com/faramat/autopay_bot/blob/master/data/db_user_payment.py"
click node_admin_records "https://github.com/faramat/autopay_bot/blob/master/data/db_admin.py"
click node_sqlite_file "https://github.com/faramat/autopay_bot/blob/master/autopay.db"

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_bot_runtime,node_user_commands,node_channel_keyboards,node_reply_keyboards,node_configuration,node_request_session,node_telegram_user toneBlue
class node_subscription_callbacks,node_payment_callbacks,node_payment_keyboards toneAmber
class node_user_records,node_subscription_records,node_payment_records,node_admin_records,node_sqlite_file,node_telegram_api toneMint
class node_admin_handlers,node_maintenance toneRose
class node_rukassa toneIndigo
```

## Components

### Bot entry

- [Bot runtime](https://github.com/faramat/autopay_bot/blob/master/main.py): `main.py`
- [User commands](https://github.com/faramat/autopay_bot/blob/master/handlers/user_commands.py): `handlers/user_commands.py`
- [Channel keyboards](https://github.com/faramat/autopay_bot/blob/master/keyboards/inline.py): `keyboards/inline.py`
- [Navigation keyboards](https://github.com/faramat/autopay_bot/blob/master/keyboards/reply.py): `keyboards/reply.py`
- [Bot configuration](https://github.com/faramat/autopay_bot/blob/master/config.py): `config.py`
- [HTTP session](https://github.com/faramat/autopay_bot/blob/master/services/api_session.py): `services/api_session.py`

### Subscription flow

- [Channel callbacks](https://github.com/faramat/autopay_bot/blob/master/callbacks/sub_channels.py): `callbacks/sub_channels.py`
- [Payment callbacks](https://github.com/faramat/autopay_bot/blob/master/callbacks/payments.py): `callbacks/payments.py`
- [Payment links](https://github.com/faramat/autopay_bot/blob/master/keyboards/builders.py): `keyboards/builders.py`

### Persistence

- [User records](https://github.com/faramat/autopay_bot/blob/master/data/db_user_start_bot.py): `data/db_user_start_bot.py`
- [Subscription records](https://github.com/faramat/autopay_bot/blob/master/data/db_user_sub.py): `data/db_user_sub.py`
- [Payment records](https://github.com/faramat/autopay_bot/blob/master/data/db_user_payment.py): `data/db_user_payment.py`
- [Admin records](https://github.com/faramat/autopay_bot/blob/master/data/db_admin.py): `data/db_admin.py`
- [SQLite database](https://github.com/faramat/autopay_bot/blob/master/autopay.db): `autopay.db`

### Admin operations

- [Admin controls](https://github.com/faramat/autopay_bot/blob/master/handlers/admin.py): `handlers/admin.py`
- [Subscription maintenance](https://github.com/faramat/autopay_bot/blob/master/misc/database.py): `misc/database.py`

### Other components

- **Telegram user**
- **RuKassa**
- **Telegram API**

## Connections

- Telegram user → Bot runtime: sends updates (evidence: `main.py`)
- Bot runtime → User commands: registers router (evidence: `main.py`)
- Bot runtime → Channel callbacks: registers router (evidence: `main.py`)
- Bot runtime → Payment callbacks: registers router (evidence: `main.py`)
- Bot runtime → Admin controls: registers router (evidence: `main.py`)
- Bot runtime → Subscription maintenance: runs checks (evidence: `main.py`)
- User commands → User records: registers users (evidence: `handlers/user_commands.py`)
- User commands → Subscription records: checks access (evidence: `handlers/user_commands.py`)
- User commands → Payment links: builds plan menu (evidence: `handlers/user_commands.py`)
- User commands → Channel keyboards: shows channel links (evidence: `handlers/user_commands.py`)
- User commands → Navigation keyboards: shows navigation (evidence: `handlers/user_commands.py`)
- User commands → Telegram API: checks membership (evidence: `handlers/user_commands.py`)
- Channel callbacks → User commands: rechecks subscription (evidence: `callbacks/sub_channels.py`)
- Channel callbacks → Channel keyboards: shows subscription link (evidence: `callbacks/sub_channels.py`)
- Payment callbacks → Payment links: creates payment link (evidence: `callbacks/payments.py`)
- Payment callbacks → Admin records: reads plan prices (evidence: `callbacks/payments.py`)
- Payment callbacks → Payment records: activates subscription (evidence: `callbacks/payments.py`)
- Payment callbacks → RuKassa: checks payment (evidence: `callbacks/payments.py`)
- Payment callbacks → Channel keyboards: offers channel access (evidence: `callbacks/payments.py`)
- Payment links → Admin records: reads plan prices (evidence: `keyboards/builders.py`)
- Payment links → RuKassa: creates payment (evidence: `keyboards/builders.py`)
- Admin controls → Admin records: updates prices (evidence: `handlers/admin.py`)
- Admin controls → User records: loads recipients (evidence: `handlers/admin.py`)
- Admin controls → Telegram API: sends broadcasts (evidence: `handlers/admin.py`)
- Admin controls → Subscription maintenance: requests backup (evidence: `handlers/admin.py`)
- Subscription maintenance → Subscription records: checks expiry (evidence: `misc/database.py`)
- Subscription maintenance → Telegram API: sends backup (evidence: `misc/database.py`)
- Bot runtime → Bot configuration: loads settings (evidence: `main.py`)
- Bot runtime → HTTP session: creates session (evidence: `main.py`)
- User records → SQLite database: stores records
- Subscription records → SQLite database: stores subscriptions
- Payment records → SQLite database: stores payments
- Admin records → SQLite database: stores admin data
