# mahmoudmtalatm-cyber/blaidd-drwg-form-filler architecture

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

- Interactive diagram: https://gitdiagram.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler
- Repository: https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler

## Overview

Blaidd Drwg is a Telegram-controlled bot that signs into users’ Google accounts and fills Google Forms from reusable per-account rules. Users add accounts, define or copy rules, send a form link, select accounts, and start filling; the bot reports a result per account. The runtime is concentrated in bot.py, so multiple nodes point to that file. README-described capabilities such as allow-listing and multi-page form handling are included, but their unsampled implementation details are not inferred.

Main entry points: [`bot.py`](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py) (Bot handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_telegram["Telegram interaction"]
  node_bot["Bot handlers<br/>[bot.py]"]
  node_access["Access control<br/>[bot.py]"]
end

subgraph group_accounts["Accounts and rules"]
  node_account_ui["Account management<br/>[bot.py]"]
  node_login["Google login<br/>[bot.py]"]
  node_session[("Saved sessions<br/>[bot.py]")]
  node_rule_ui["Rule management<br/>[bot.py]"]
  node_rule_store[("Account and rule data<br/>[bot.py]")]
end

subgraph group_filling["Form filling"]
  node_form_input["Form link and selection<br/>[bot.py]"]
  node_fill["Form automation<br/>[bot.py]"]
  node_question_handling["Question handling<br/>[bot.py]"]
  node_page_handling["Page navigation<br/>[bot.py]"]
  node_status_detection["Form status detection<br/>[bot.py]"]
end

node_user(("Telegram user"))
node_google["Google services"]

node_user -->|"uses buttons"| node_bot
node_bot -->|"checks access"| node_access
node_bot -->|"manages accounts"| node_account_ui
node_account_ui -->|"starts sign-in"| node_login
node_login -->|"opens sign-in"| node_google
node_login -->|"saves session"| node_session
node_bot -->|"manages rules"| node_rule_ui
node_rule_ui -->|"saves rules"| node_rule_store
node_user -->|"sends link"| node_form_input
node_form_input -->|"starts filling"| node_bot
node_bot -->|"loads account rules"| node_rule_store
node_bot -->|"calls per account"| node_fill
node_fill -->|"automates form"| node_google
node_fill -->|"applies answers"| node_question_handling
node_fill -->|"handles pages"| node_page_handling
node_fill -->|"detects status"| node_status_detection
node_bot -->|"reports results"| node_user

click node_bot "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_access "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_account_ui "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_login "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_session "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_rule_ui "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_rule_store "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_form_input "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_fill "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_question_handling "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_page_handling "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py"
click node_status_detection "https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.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_bot,node_access,node_user toneBlue
class node_account_ui,node_login,node_session,node_rule_ui,node_rule_store toneAmber
class node_form_input,node_fill,node_question_handling,node_page_handling,node_status_detection toneMint
class node_google toneIndigo
```

## Components

### Telegram interaction

- [Bot handlers](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Access control](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`

### Accounts and rules

- [Account management](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Google login](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Saved sessions](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Rule management](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Account and rule data](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`

### Form filling

- [Form link and selection](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Form automation](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Question handling](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Page navigation](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`
- [Form status detection](https://github.com/mahmoudmtalatm-cyber/blaidd-drwg-form-filler/blob/main/bot.py): `bot.py`

### Other components

- **Telegram user**
- **Google services**

## Connections

- Telegram user → Bot handlers: uses buttons (evidence: `README.md`)
- Bot handlers → Access control: checks access (evidence: `README.md`)
- Bot handlers → Account management: manages accounts (evidence: `README.md`)
- Account management → Google login: starts sign-in (evidence: `README.md`)
- Google login → Google services: opens sign-in (evidence: `bot.py`)
- Google login → Saved sessions: saves session (evidence: `README.md`)
- Bot handlers → Rule management: manages rules (evidence: `README.md`)
- Rule management → Account and rule data: saves rules (evidence: `bot.py`)
- Telegram user → Form link and selection: sends link (evidence: `README.md`)
- Form link and selection → Bot handlers: starts filling (evidence: `README.md`)
- Bot handlers → Account and rule data: loads account rules (evidence: `bot.py`)
- Bot handlers → Form automation: calls per account (evidence: `bot.py`)
- Form automation → Google services: automates form (evidence: `README.md`)
- Form automation → Question handling: applies answers (evidence: `README.md`)
- Form automation → Page navigation: handles pages (evidence: `README.md`)
- Form automation → Form status detection: detects status (evidence: `README.md`)
- Bot handlers → Telegram user: reports results (evidence: `README.md`)
