# freycikkk/invitron architecture

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

## Overview

Invitron is a Discord bot for tracking server invitations and administering invite-related settings. The main workflow is: Discord interactions or member-join events enter the bot, commands/components handle configuration and invite management, and database-backed state supports tracking, leaderboard and role features. The README also documents fraud detection and manual invite adjustments; those feature areas are represented, though their internal call paths were not sampled. Edges are limited to relationships visible in excerpts or explicitly documented; unsampled subsystem links are omitted.

Main entry points: [`src/database/Sqlite.ts`](https://github.com/freycikkk/invitron/blob/main/src/database/Sqlite.ts) (Database adapter), [`src/client.ts`](https://github.com/freycikkk/invitron/blob/main/src/client.ts) (Discord client), [`src/utils/loader.ts`](https://github.com/freycikkk/invitron/blob/main/src/utils/loader.ts) (Module loader), [`src/events/guild/member/GuildMemberAdd.ts`](https://github.com/freycikkk/invitron/blob/main/src/events/guild/member/GuildMemberAdd.ts) (Member-join tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot Runtime"]
  node_sharding["Shard manager<br/>[index.ts]"]
  node_client["Discord client<br/>[client.ts]"]
  node_loader["Module loader<br/>[loader.ts]"]
  node_interactions["Interaction router"]
end

subgraph group_tracking["Invite Tracking"]
  node_memberjoin["Member-join tracking<br/>[GuildMemberAdd.ts]"]
  node_inviteevents["Invite lifecycle events"]
  node_fraud["Fraud detection<br/>[GuildMemberAdd.ts]"]
end

subgraph group_features["Commands and Setup"]
  node_invitecommands["Invite management<br/>[Invites.ts]"]
  node_leaderboard["Invite leaderboard<br/>[Leaderboard.ts]"]
  node_admin["Guild administration"]
  node_setupcommand["Setup command<br/>[Setup.ts]"]
  node_setupui["Setup interface<br/>[Setup.ts]"]
  node_component["Component base<br/>[Component.ts]"]
  node_command["Command base<br/>[Command.ts]"]
end

subgraph group_state["Persistence and Utilities"]
  node_database["Database adapter<br/>[Sqlite.ts]"]
  node_mysql["MySQL adapter<br/>[MySql.ts]"]
  node_clientutils["Invite cache and roles<br/>[ClientUtils.ts]"]
  node_config["Bot configuration<br/>[config.ts]"]
end

node_discord(("Discord users and servers"))

node_discord -->|"starts bot"| node_sharding
node_sharding -->|"spawns shards"| node_client
node_client -->|"connects when SQLite"| node_database
node_client -->|"connects when MySQL"| node_mysql
node_client -->|"loads"| node_config
node_client -->|"loads modules"| node_loader
node_loader -->|"instantiates"| node_command
node_loader -->|"instantiates"| node_component
node_loader -.->|"registers listeners"| node_interactions
node_discord -->|"sends interactions"| node_interactions
node_interactions -->|"dispatches commands"| node_command
node_interactions -->|"dispatches components"| node_component
node_discord -->|"joins server"| node_memberjoin
node_memberjoin -->|"reads and writes"| node_database
node_memberjoin -->|"updates inviter role"| node_clientutils
node_memberjoin -.->|"checks join"| node_fraud
node_invitecommands -.->|"manages invite data"| node_database
node_leaderboard -.->|"reads rankings"| node_database
node_admin -.->|"changes settings"| node_database
node_setupcommand -.->|"opens setup flow"| node_setupui
node_setupui -.->|"saves configuration"| node_database
node_inviteevents -.->|"refreshes invite state"| node_clientutils

click node_sharding "https://github.com/freycikkk/invitron/blob/main/src/index.ts"
click node_client "https://github.com/freycikkk/invitron/blob/main/src/client.ts"
click node_loader "https://github.com/freycikkk/invitron/blob/main/src/utils/loader.ts"
click node_interactions "https://github.com/freycikkk/invitron/blob/main/src/events/interaction/InteractionCreate.ts"
click node_memberjoin "https://github.com/freycikkk/invitron/blob/main/src/events/guild/member/GuildMemberAdd.ts"
click node_inviteevents "https://github.com/freycikkk/invitron/tree/main/src/events/invite"
click node_invitecommands "https://github.com/freycikkk/invitron/blob/main/src/commands/commons/Invites.ts"
click node_leaderboard "https://github.com/freycikkk/invitron/blob/main/src/commands/commons/Leaderboard.ts"
click node_fraud "https://github.com/freycikkk/invitron/blob/main/src/events/guild/member/GuildMemberAdd.ts"
click node_admin "https://github.com/freycikkk/invitron/tree/main/src/commands/admins"
click node_setupcommand "https://github.com/freycikkk/invitron/blob/main/src/commands/utils/Setup.ts"
click node_setupui "https://github.com/freycikkk/invitron/blob/main/src/components/utils/Setup.ts"
click node_component "https://github.com/freycikkk/invitron/blob/main/src/components/Component.ts"
click node_command "https://github.com/freycikkk/invitron/blob/main/src/commands/Command.ts"
click node_database "https://github.com/freycikkk/invitron/blob/main/src/database/Sqlite.ts"
click node_mysql "https://github.com/freycikkk/invitron/blob/main/src/database/MySql.ts"
click node_clientutils "https://github.com/freycikkk/invitron/blob/main/src/utils/ClientUtils.ts"
click node_config "https://github.com/freycikkk/invitron/blob/main/src/config.ts"

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_sharding,node_client,node_loader,node_interactions,node_discord toneBlue
class node_memberjoin,node_inviteevents,node_fraud toneAmber
class node_invitecommands,node_leaderboard,node_admin,node_setupcommand,node_setupui,node_component,node_command toneMint
class node_database,node_mysql,node_clientutils,node_config toneRose
```

## Components

### Bot Runtime

- [Shard manager](https://github.com/freycikkk/invitron/blob/main/src/index.ts): `src/index.ts`
- [Discord client](https://github.com/freycikkk/invitron/blob/main/src/client.ts): `src/client.ts`
- [Module loader](https://github.com/freycikkk/invitron/blob/main/src/utils/loader.ts): `src/utils/loader.ts`
- [Interaction router](https://github.com/freycikkk/invitron/blob/main/src/events/interaction/InteractionCreate.ts): `src/events/interaction/InteractionCreate.ts`

### Invite Tracking

- [Member-join tracking](https://github.com/freycikkk/invitron/blob/main/src/events/guild/member/GuildMemberAdd.ts): `src/events/guild/member/GuildMemberAdd.ts`
- [Invite lifecycle events](https://github.com/freycikkk/invitron/tree/main/src/events/invite): `src/events/invite`
- [Fraud detection](https://github.com/freycikkk/invitron/blob/main/src/events/guild/member/GuildMemberAdd.ts): `src/events/guild/member/GuildMemberAdd.ts`

### Commands and Setup

- [Invite management](https://github.com/freycikkk/invitron/blob/main/src/commands/commons/Invites.ts): `src/commands/commons/Invites.ts`
- [Invite leaderboard](https://github.com/freycikkk/invitron/blob/main/src/commands/commons/Leaderboard.ts): `src/commands/commons/Leaderboard.ts`
- [Guild administration](https://github.com/freycikkk/invitron/tree/main/src/commands/admins): `src/commands/admins`
- [Setup command](https://github.com/freycikkk/invitron/blob/main/src/commands/utils/Setup.ts): `src/commands/utils/Setup.ts`
- [Setup interface](https://github.com/freycikkk/invitron/blob/main/src/components/utils/Setup.ts): `src/components/utils/Setup.ts`
- [Component base](https://github.com/freycikkk/invitron/blob/main/src/components/Component.ts): `src/components/Component.ts`
- [Command base](https://github.com/freycikkk/invitron/blob/main/src/commands/Command.ts): `src/commands/Command.ts`

### Persistence and Utilities

- [Database adapter](https://github.com/freycikkk/invitron/blob/main/src/database/Sqlite.ts): `src/database/Sqlite.ts`
- [MySQL adapter](https://github.com/freycikkk/invitron/blob/main/src/database/MySql.ts): `src/database/MySql.ts`
- [Invite cache and roles](https://github.com/freycikkk/invitron/blob/main/src/utils/ClientUtils.ts): `src/utils/ClientUtils.ts`
- [Bot configuration](https://github.com/freycikkk/invitron/blob/main/src/config.ts): `src/config.ts`

### Other components

- **Discord users and servers**

## Connections

- Discord users and servers → Shard manager: starts bot (evidence: `src/index.ts`)
- Shard manager → Discord client: spawns shards (evidence: `src/index.ts`)
- Discord client → Database adapter: connects when SQLite (evidence: `src/client.ts`)
- Discord client → MySQL adapter: connects when MySQL (evidence: `src/client.ts`)
- Discord client → Bot configuration: loads (evidence: `src/client.ts`)
- Discord client → Module loader: loads modules (evidence: `src/client.ts`)
- Module loader → Command base: instantiates (evidence: `src/utils/loader.ts`)
- Module loader → Component base: instantiates (evidence: `src/utils/loader.ts`)
- Module loader → Interaction router: registers listeners
- Discord users and servers → Interaction router: sends interactions (evidence: `src/events/interaction/InteractionCreate.ts`)
- Interaction router → Command base: dispatches commands (evidence: `src/events/interaction/InteractionCreate.ts`)
- Interaction router → Component base: dispatches components (evidence: `src/events/interaction/InteractionCreate.ts`)
- Discord users and servers → Member-join tracking: joins server (evidence: `src/events/guild/member/GuildMemberAdd.ts`)
- Member-join tracking → Database adapter: reads and writes (evidence: `src/events/guild/member/GuildMemberAdd.ts`)
- Member-join tracking → Invite cache and roles: updates inviter role (evidence: `src/events/guild/member/GuildMemberAdd.ts`)
- Member-join tracking → Fraud detection: checks join (evidence: `src/events/guild/member/GuildMemberAdd.ts`)
- Invite management → Database adapter: manages invite data
- Invite leaderboard → Database adapter: reads rankings
- Guild administration → Database adapter: changes settings
- Setup command → Setup interface: opens setup flow
- Setup interface → Database adapter: saves configuration
- Invite lifecycle events → Invite cache and roles: refreshes invite state
