# zeeoneofficial/alphabot-md architecture

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

- Interactive diagram: https://gitdiagram.com/zeeoneofficial/alphabot-md
- Repository: https://github.com/zeeoneofficial/alphabot-md

## Overview

Alphabot-Md is a Baileys-based WhatsApp multi-device bot. The principal flow is a WhatsApp interaction handled by the bot’s runtime, then answered with bot features and localized messages. Its documented menus span games, RPG, media, group and owner tools; the large command implementation is in index.js, but that file was not sampled, so its internal routing and feature-to-helper relationships are not asserted. Edges reflect the sampled imports and explicit README statements; several substantial subsystems are represented without unverified call links.

Main entry points: [`alpha.js`](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/alpha.js) (Connection runtime), [`language/index.js`](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/index.js) (Language selector), [`settings.js`](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/settings.js) (Bot settings), [`index.js`](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/index.js) (Command features)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot runtime"]
  node_alpha["Connection runtime<br/>[alpha.js]"]
  node_settings["Bot settings<br/>[settings.js]"]
end

subgraph group_features["Bot features"]
  node_commands["Command features<br/>[index.js]"]
  node_welcome["Welcome and group events<br/>[welcome.js]"]
  node_setwelcome["Welcome settings<br/>[setwelcome.js]"]
  node_setleft["Goodbye settings<br/>[setleft.js]"]
  node_setproses["Process notices<br/>[setproses.js]"]
end

subgraph group_language["Languages"]
  node_indonesian["Indonesian messages<br/>[indonesia.js]"]
  node_english["English messages<br/>[english.js]"]
  node_spanish["Spanish messages<br/>[spanyol.js]"]
  node_languageindex["Language selector<br/>[index.js]"]
end

subgraph group_data["Data and utilities"]
  node_mongo[("MongoDB adapter<br/>[mongoDB.js]")]
  node_cloud[("Cloud DB adapter<br/>[cloudDBAdapter.js]")]
  node_converter["Media converter<br/>[converter.js]"]
  node_exif["Sticker metadata<br/>[exif.js]"]
  node_myfunc["Bot utilities<br/>[myfunc.js]"]
  node_uploader["Media uploader<br/>[uploader.js]"]
end

node_user(("WhatsApp user"))
node_baileys["Baileys service"]

node_user -.->|"sends interaction"| node_alpha
node_alpha -.->|"connects via"| node_baileys
node_alpha -->|"loads settings"| node_settings
node_alpha -->|"loads commands"| node_commands
node_alpha -->|"references adapter"| node_mongo
node_alpha -->|"references adapter"| node_cloud
node_alpha -->|"uses converter"| node_converter
node_alpha -->|"uses metadata"| node_exif
node_alpha -->|"uses uploader"| node_uploader
node_alpha -->|"uses utilities"| node_myfunc
node_alpha -->|"loads module"| node_welcome
node_alpha -->|"loads module"| node_setwelcome
node_alpha -->|"loads module"| node_setleft
node_alpha -->|"loads module"| node_setproses
node_languageindex -->|"imports language"| node_indonesian
node_languageindex -->|"imports language"| node_english
node_languageindex -->|"imports language"| node_spanish

click node_alpha "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/alpha.js"
click node_commands "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/index.js"
click node_settings "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/settings.js"
click node_welcome "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/welcome.js"
click node_setwelcome "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/setwelcome.js"
click node_setleft "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/setleft.js"
click node_setproses "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/setproses.js"
click node_indonesian "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/indonesia.js"
click node_english "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/english.js"
click node_spanish "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/spanyol.js"
click node_languageindex "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/index.js"
click node_mongo "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/mongoDB.js"
click node_cloud "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/cloudDBAdapter.js"
click node_converter "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/converter.js"
click node_exif "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/exif.js"
click node_myfunc "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/myfunc.js"
click node_uploader "https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/uploader.js"

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_alpha,node_settings,node_user toneBlue
class node_commands,node_welcome,node_setwelcome,node_setleft,node_setproses toneAmber
class node_indonesian,node_english,node_spanish,node_languageindex toneMint
class node_mongo,node_cloud,node_converter,node_exif,node_myfunc,node_uploader toneRose
class node_baileys toneIndigo
```

## Components

### Bot runtime

- [Connection runtime](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/alpha.js): `alpha.js`
- [Bot settings](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/settings.js): `settings.js`

### Bot features

- [Command features](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/index.js): `index.js`
- [Welcome and group events](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/welcome.js): `lib/welcome.js`
- [Welcome settings](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/setwelcome.js): `lib/setwelcome.js`
- [Goodbye settings](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/setleft.js): `lib/setleft.js`
- [Process notices](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/setproses.js): `lib/setproses.js`

### Languages

- [Indonesian messages](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/indonesia.js): `language/indonesia.js`
- [English messages](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/english.js): `language/english.js`
- [Spanish messages](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/spanyol.js): `language/spanyol.js`
- [Language selector](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/language/index.js): `language/index.js`

### Data and utilities

- [MongoDB adapter](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/mongoDB.js): `lib/mongoDB.js`
- [Cloud DB adapter](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/cloudDBAdapter.js): `lib/cloudDBAdapter.js`
- [Media converter](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/converter.js): `lib/converter.js`
- [Sticker metadata](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/exif.js): `lib/exif.js`
- [Bot utilities](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/myfunc.js): `lib/myfunc.js`
- [Media uploader](https://github.com/zeeoneofficial/alphabot-md/blob/v17.9/lib/uploader.js): `lib/uploader.js`

### Other components

- **WhatsApp user**
- **Baileys service**

## Connections

- WhatsApp user → Connection runtime: sends interaction
- Connection runtime → Baileys service: connects via
- Connection runtime → Bot settings: loads settings (evidence: `alpha.js`)
- Connection runtime → Command features: loads commands (evidence: `alpha.js`)
- Connection runtime → MongoDB adapter: references adapter (evidence: `alpha.js`)
- Connection runtime → Cloud DB adapter: references adapter (evidence: `alpha.js`)
- Connection runtime → Media converter: uses converter (evidence: `alpha.js`)
- Connection runtime → Sticker metadata: uses metadata (evidence: `alpha.js`)
- Connection runtime → Media uploader: uses uploader (evidence: `alpha.js`)
- Connection runtime → Bot utilities: uses utilities (evidence: `alpha.js`)
- Connection runtime → Welcome and group events: loads module (evidence: `alpha.js`)
- Connection runtime → Welcome settings: loads module (evidence: `alpha.js`)
- Connection runtime → Goodbye settings: loads module (evidence: `alpha.js`)
- Connection runtime → Process notices: loads module (evidence: `alpha.js`)
- Language selector → Indonesian messages: imports language (evidence: `language/index.js`)
- Language selector → English messages: imports language (evidence: `language/index.js`)
- Language selector → Spanish messages: imports language (evidence: `language/index.js`)