# fullstacksjs/alita-bot architecture

> Architecture diagram of the GitHub repository fullstacksjs/alita-bot, 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/fullstacksjs/alita-bot
- Repository: https://github.com/fullstacksjs/alita-bot

## Overview

Alita is a Telegram group-management bot. Telegram updates enter through polling or the optional webhook, are dispatched to command and moderation modules, and produce moderation actions or group features such as filters, notes, greetings, warnings, and raid protection. Modules use shared permission, extraction, formatting, and media utilities and persist configuration and activity through SQLite repositories. The README establishes the major capabilities; sampled source confirms startup, dispatch setup, HTTP handling, and selected repository behavior, but not every module’s internal calls.

Main entry points: [`alita/modules/registry.go`](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/registry.go) (Module dispatcher), [`alita/db/db.go`](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/db.go) (SQLite database), [`main.go`](https://github.com/fullstacksjs/alita-bot/blob/main/main.go) (Process startup), [`alita/utils/httpserver/server.go`](https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/httpserver/server.go) (Webhook and health)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot runtime"]
  node_entry["Process startup<br/>[main.go]"]
  node_bot_init["Bot initialization<br/>[main.go]"]
  node_update_delivery["Update delivery<br/>[main.go]"]
  node_webhook["Webhook and health<br/>[server.go]"]
  node_dispatcher["Module dispatcher<br/>[registry.go]"]
end

subgraph group_features["Group features"]
  node_moderation["Moderation<br/>[moderation.go]"]
  node_bans["Bans and mutes<br/>[bans.go]"]
  node_antiflood["Flood protection<br/>[antiflood.go]"]
  node_antiraid["Raid protection<br/>[antiraid.go]"]
  node_filters["Message filters<br/>[filters.go]"]
  node_notes["Notes<br/>[notes.go]"]
  node_greetings["Greetings<br/>[greetings.go]"]
  node_warnings["Warnings<br/>[warns.go]"]
  node_approvals["Approvals<br/>[approvals.go]"]
  node_backup["Backup and restore<br/>[backup.go]"]
  node_connections["Chat connections<br/>[connections.go]"]
end

subgraph group_shared["Shared services"]
  node_permissions["Permission checks<br/>[chat_status.go]"]
  node_command_helpers["Command pipeline"]
  node_extraction["Message extraction<br/>[extraction.go]"]
  node_content["Content handling<br/>[content.go]"]
  node_media["Media sending<br/>[sender.go]"]
  node_i18n["Localization<br/>[manager.go]"]
  node_config["Configuration<br/>[config.go]"]
end

subgraph group_persistence["Persistence"]
  node_db[("SQLite database<br/>[db.go]")]
  node_chat_repo["Chat settings<br/>[repository.go]"]
  node_protection_repo["Protection data<br/>[repository.go]"]
  node_filters_repo["Filter records<br/>[repository.go]"]
  node_notes_repo["Note records<br/>[repository.go]"]
  node_greetings_repo["Greeting records<br/>[repository.go]"]
  node_warns_repo["Warning records<br/>[repository.go]"]
  node_backup_repo["Backup storage<br/>[backup.go]"]
end

node_telegram(("Telegram users"))
node_telegram_api["Telegram API"]

node_telegram -->|"sends updates"| node_telegram_api
node_entry -->|"initializes bot"| node_bot_init
node_entry -->|"starts delivery"| node_update_delivery
node_entry -->|"configures server"| node_webhook
node_telegram_api -->|"delivers updates"| node_update_delivery
node_update_delivery -.->|"dispatches updates"| node_dispatcher
node_webhook -->|"routes updates"| node_dispatcher
node_bot_init -->|"loads modules"| node_dispatcher
node_dispatcher -.->|"registers feature"| node_moderation
node_dispatcher -.->|"registers feature"| node_bans
node_dispatcher -.->|"registers feature"| node_antiflood
node_dispatcher -.->|"registers feature"| node_antiraid
node_dispatcher -.->|"registers feature"| node_filters
node_dispatcher -.->|"registers feature"| node_notes
node_dispatcher -.->|"registers feature"| node_greetings
node_dispatcher -.->|"registers feature"| node_warnings
node_dispatcher -.->|"registers feature"| node_approvals
node_dispatcher -.->|"registers feature"| node_backup
node_dispatcher -.->|"registers feature"| node_connections
node_command_helpers -->|"checks access"| node_permissions
node_antiraid -->|"reads and writes"| node_protection_repo
node_filters -.->|"uses records"| node_filters_repo
node_notes -.->|"uses records"| node_notes_repo
node_greetings -.->|"uses records"| node_greetings_repo
node_warnings -.->|"uses records"| node_warns_repo
node_backup -->|"uses storage"| node_backup_repo
node_protection_repo -->|"queries SQLite"| node_db
node_filters_repo -->|"queries SQLite"| node_db
node_notes_repo -->|"queries SQLite"| node_db
node_greetings_repo -->|"queries SQLite"| node_db
node_warns_repo -->|"queries SQLite"| node_db
node_chat_repo -->|"queries SQLite"| node_db
node_content -->|"uses translations"| node_i18n
node_extraction -->|"checks access"| node_permissions
node_media -->|"formats content"| node_content
node_entry -->|"loads settings"| node_config
node_entry -->|"initializes locales"| node_i18n
node_webhook -->|"checks health"| node_db
node_moderation -.->|"moderates members"| node_telegram_api
node_bans -.->|"restricts members"| node_telegram_api

click node_entry "https://github.com/fullstacksjs/alita-bot/blob/main/main.go"
click node_bot_init "https://github.com/fullstacksjs/alita-bot/blob/main/alita/main.go"
click node_update_delivery "https://github.com/fullstacksjs/alita-bot/blob/main/main.go"
click node_webhook "https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/httpserver/server.go"
click node_dispatcher "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/registry.go"
click node_moderation "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/moderation.go"
click node_bans "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/bans.go"
click node_antiflood "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/antiflood.go"
click node_antiraid "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/antiraid.go"
click node_filters "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/filters.go"
click node_notes "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/notes.go"
click node_greetings "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/greetings.go"
click node_warnings "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/warns.go"
click node_approvals "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/approvals.go"
click node_backup "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/backup.go"
click node_connections "https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/connections.go"
click node_permissions "https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/chat_status/chat_status.go"
click node_command_helpers "https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/helpers/command_pipeline.go"
click node_extraction "https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/extraction/extraction.go"
click node_content "https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/content/content.go"
click node_media "https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/media/sender.go"
click node_i18n "https://github.com/fullstacksjs/alita-bot/blob/main/alita/i18n/manager.go"
click node_config "https://github.com/fullstacksjs/alita-bot/blob/main/alita/config/config.go"
click node_db "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/db.go"
click node_chat_repo "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/chats/repository.go"
click node_protection_repo "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/antiraid/repository.go"
click node_filters_repo "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/filters/repository.go"
click node_notes_repo "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/notes/repository.go"
click node_greetings_repo "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/greetings/repository.go"
click node_warns_repo "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/warns/repository.go"
click node_backup_repo "https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/backup/backup.go"

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_entry,node_bot_init,node_update_delivery,node_webhook,node_dispatcher,node_telegram toneBlue
class node_moderation,node_bans,node_antiflood,node_antiraid,node_filters,node_notes,node_greetings,node_warnings,node_approvals,node_backup,node_connections toneAmber
class node_permissions,node_command_helpers,node_extraction,node_content,node_media,node_i18n,node_config,node_telegram_api toneMint
class node_db,node_chat_repo,node_protection_repo,node_filters_repo,node_notes_repo,node_greetings_repo,node_warns_repo,node_backup_repo toneRose
```

## Components

### Bot runtime

- [Process startup](https://github.com/fullstacksjs/alita-bot/blob/main/main.go): `main.go`
- [Bot initialization](https://github.com/fullstacksjs/alita-bot/blob/main/alita/main.go): `alita/main.go`
- [Update delivery](https://github.com/fullstacksjs/alita-bot/blob/main/main.go): `main.go`
- [Webhook and health](https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/httpserver/server.go): `alita/utils/httpserver/server.go`
- [Module dispatcher](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/registry.go): `alita/modules/registry.go`

### Group features

- [Moderation](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/moderation.go): `alita/modules/moderation.go`
- [Bans and mutes](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/bans.go): `alita/modules/bans.go`
- [Flood protection](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/antiflood.go): `alita/modules/antiflood.go`
- [Raid protection](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/antiraid.go): `alita/modules/antiraid.go`
- [Message filters](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/filters.go): `alita/modules/filters.go`
- [Notes](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/notes.go): `alita/modules/notes.go`
- [Greetings](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/greetings.go): `alita/modules/greetings.go`
- [Warnings](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/warns.go): `alita/modules/warns.go`
- [Approvals](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/approvals.go): `alita/modules/approvals.go`
- [Backup and restore](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/backup.go): `alita/modules/backup.go`
- [Chat connections](https://github.com/fullstacksjs/alita-bot/blob/main/alita/modules/connections.go): `alita/modules/connections.go`

### Shared services

- [Permission checks](https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/chat_status/chat_status.go): `alita/utils/chat_status/chat_status.go`
- [Command pipeline](https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/helpers/command_pipeline.go): `alita/utils/helpers/command_pipeline.go`
- [Message extraction](https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/extraction/extraction.go): `alita/utils/extraction/extraction.go`
- [Content handling](https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/content/content.go): `alita/utils/content/content.go`
- [Media sending](https://github.com/fullstacksjs/alita-bot/blob/main/alita/utils/media/sender.go): `alita/utils/media/sender.go`
- [Localization](https://github.com/fullstacksjs/alita-bot/blob/main/alita/i18n/manager.go): `alita/i18n/manager.go`
- [Configuration](https://github.com/fullstacksjs/alita-bot/blob/main/alita/config/config.go): `alita/config/config.go`

### Persistence

- [SQLite database](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/db.go): `alita/db/db.go`
- [Chat settings](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/chats/repository.go): `alita/db/chats/repository.go`
- [Protection data](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/antiraid/repository.go): `alita/db/antiraid/repository.go`
- [Filter records](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/filters/repository.go): `alita/db/filters/repository.go`
- [Note records](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/notes/repository.go): `alita/db/notes/repository.go`
- [Greeting records](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/greetings/repository.go): `alita/db/greetings/repository.go`
- [Warning records](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/warns/repository.go): `alita/db/warns/repository.go`
- [Backup storage](https://github.com/fullstacksjs/alita-bot/blob/main/alita/db/backup/backup.go): `alita/db/backup/backup.go`

### Other components

- **Telegram users**
- **Telegram API**

## Connections

- Telegram users → Telegram API: sends updates (evidence: `README.md`)
- Process startup → Bot initialization: initializes bot (evidence: `main.go`)
- Process startup → Update delivery: starts delivery (evidence: `main.go`)
- Process startup → Webhook and health: configures server (evidence: `main.go`)
- Telegram API → Update delivery: delivers updates (evidence: `main.go`)
- Update delivery → Module dispatcher: dispatches updates
- Webhook and health → Module dispatcher: routes updates (evidence: `alita/utils/httpserver/server.go`)
- Bot initialization → Module dispatcher: loads modules (evidence: `alita/main.go`)
- Module dispatcher → Moderation: registers feature
- Module dispatcher → Bans and mutes: registers feature
- Module dispatcher → Flood protection: registers feature
- Module dispatcher → Raid protection: registers feature
- Module dispatcher → Message filters: registers feature
- Module dispatcher → Notes: registers feature
- Module dispatcher → Greetings: registers feature
- Module dispatcher → Warnings: registers feature
- Module dispatcher → Approvals: registers feature
- Module dispatcher → Backup and restore: registers feature
- Module dispatcher → Chat connections: registers feature
- Command pipeline → Permission checks: checks access (evidence: `alita/utils/helpers/command_pipeline.go`)
- Raid protection → Protection data: reads and writes (evidence: `alita/modules/antiraid.go`)
- Message filters → Filter records: uses records
- Notes → Note records: uses records
- Greetings → Greeting records: uses records
- Warnings → Warning records: uses records
- Backup and restore → Backup storage: uses storage (evidence: `alita/modules/backup.go`)
- Protection data → SQLite database: queries SQLite (evidence: `alita/db/antiraid/repository.go`)
- Filter records → SQLite database: queries SQLite (evidence: `alita/db/filters/repository.go`)
- Note records → SQLite database: queries SQLite (evidence: `alita/db/notes/repository.go`)
- Greeting records → SQLite database: queries SQLite (evidence: `alita/db/greetings/repository.go`)
- Warning records → SQLite database: queries SQLite (evidence: `alita/db/warns/repository.go`)
- Chat settings → SQLite database: queries SQLite (evidence: `alita/db/chats/repository.go`)
- Content handling → Localization: uses translations (evidence: `alita/utils/content/content.go`)
- Message extraction → Permission checks: checks access (evidence: `alita/utils/extraction/extraction.go`)
- Media sending → Content handling: formats content (evidence: `alita/utils/media/sender.go`)
- Process startup → Configuration: loads settings (evidence: `main.go`)
- Process startup → Localization: initializes locales (evidence: `main.go`)
- Webhook and health → SQLite database: checks health (evidence: `alita/utils/httpserver/server.go`)
- Moderation → Telegram API: moderates members
- Bans and mutes → Telegram API: restricts members
