# luanlucino/bot-alcateia architecture

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

- Interactive diagram: https://gitdiagram.com/luanlucino/bot-alcateia
- Repository: https://github.com/luanlucino/bot-alcateia

## Overview

Bot Alcateia is a Discord community bot for recording farm, action, drug-deposit and package-sale activity, reporting balances and rankings, and scheduling announcements with periodic resets. Members or managers submit slash commands; the bot dispatches them to feature modules, which persist or query SQLite and reply in Discord. On startup, the bot also starts scheduled announcement modules. The README documents the broader command, hierarchy and reset capabilities; some command implementations were not excerpted, so their internal relationships are not inferred.

Main entry points: [`src/index.js`](https://github.com/luanlucino/bot-alcateia/blob/main/src/index.js) (Bot runtime and dispatch), [`src/database/db.js`](https://github.com/luanlucino/bot-alcateia/blob/main/src/database/db.js) (SQLite data store), [`src/commands/farm.js`](https://github.com/luanlucino/bot-alcateia/blob/main/src/commands/farm.js) (Farm submission), [`src/utils/rankingAnnouncements.js`](https://github.com/luanlucino/bot-alcateia/blob/main/src/utils/rankingAnnouncements.js) (Scheduled farm rankings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot runtime"]
  node_entry["Bot runtime and dispatch<br/>[index.js]"]
  node_db[("SQLite data store<br/>[db.js]")]
end

subgraph group_farm["Farm rankings"]
  node_farmcmd["Farm submission<br/>[farm.js]"]
  node_farmrank["Weekly ranking<br/>[ranking.js]"]
  node_monthlyrank["Monthly ranking<br/>[ranking_mensal.js]"]
  node_farmannounce["Scheduled farm rankings"]
end

subgraph group_actions["Actions and drugs"]
  node_actioncmd["Action recording<br/>[acao.js]"]
  node_actionsaldo["Action balance<br/>[saldo.js]"]
  node_actionannounce["Action announcements"]
  node_drugdeposit["Drug deposit<br/>[dinheirodrogas.js]"]
  node_drugbalance["Drug balance and ranking<br/>[saldodrogas.js]"]
  node_drugannounce["Drug announcements"]
  node_drugranking["Drug ranking command<br/>[drogasRanking.js]"]
end

subgraph group_sales["Package sales"]
  node_salecommand["Package sale recording<br/>[venda.js]"]
  node_salesaldo["Package sales balance<br/>[saldopacote.js]"]
  node_saleannounce["Monthly sales announcement"]
end

node_users(("Discord members"))
node_discord(("Discord API"))

node_users -->|"submit commands"| node_entry
node_entry -->|"dispatches to"| node_farmcmd
node_entry -->|"dispatches to"| node_farmrank
node_entry -->|"dispatches to"| node_monthlyrank
node_entry -->|"dispatches to"| node_actioncmd
node_entry -->|"dispatches to"| node_actionsaldo
node_entry -->|"dispatches to"| node_drugdeposit
node_entry -->|"dispatches to"| node_drugbalance
node_entry -->|"dispatches to"| node_drugranking
node_entry -->|"dispatches to"| node_salecommand
node_entry -->|"dispatches to"| node_salesaldo
node_entry -->|"starts scheduler"| node_farmannounce
node_entry -->|"starts scheduler"| node_actionannounce
node_entry -->|"starts scheduler"| node_drugannounce
node_entry -->|"starts scheduler"| node_saleannounce
node_farmcmd -->|"writes farm data"| node_db
node_farmrank -->|"queries rankings"| node_db
node_monthlyrank -->|"queries rankings"| node_db
node_farmannounce -->|"reads and resets"| node_db
node_actioncmd -->|"writes actions"| node_db
node_actionsaldo -->|"queries balance"| node_db
node_actionannounce -->|"reads and resets"| node_db
node_drugdeposit -->|"writes deposits"| node_db
node_drugbalance -->|"queries balance"| node_db
node_drugranking -->|"queries ranking"| node_db
node_drugannounce -->|"reads and resets"| node_db
node_salecommand -->|"writes sales"| node_db
node_salesaldo -->|"queries balance"| node_db
node_saleannounce -->|"reads and resets"| node_db
node_farmcmd -->|"replies with receipt"| node_discord
node_salecommand -->|"replies with receipt"| node_discord
node_drugannounce -->|"posts report"| node_discord
node_actionannounce -->|"posts report"| node_discord
node_saleannounce -->|"posts report"| node_discord
node_farmannounce -->|"posts rankings"| node_discord

click node_entry "https://github.com/luanlucino/bot-alcateia/blob/main/src/index.js"
click node_db "https://github.com/luanlucino/bot-alcateia/blob/main/src/database/db.js"
click node_farmcmd "https://github.com/luanlucino/bot-alcateia/blob/main/src/commands/farm.js"
click node_farmrank "https://github.com/luanlucino/bot-alcateia/blob/main/src/commands/ranking.js"
click node_monthlyrank "https://github.com/luanlucino/bot-alcateia/blob/main/src/commands/ranking_mensal.js"
click node_farmannounce "https://github.com/luanlucino/bot-alcateia/blob/main/src/utils/rankingAnnouncements.js"
click node_actioncmd "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_acao_saldo/acao.js"
click node_actionsaldo "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_acao_saldo/saldo.js"
click node_actionannounce "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_acao_saldo/acaoSaldoAnnouncements.js"
click node_drugdeposit "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/dinheirodrogas.js"
click node_drugbalance "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/saldodrogas.js"
click node_drugannounce "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/drogasAnnouncements.js"
click node_drugranking "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/drogasRanking.js"
click node_salecommand "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_vendas/venda.js"
click node_salesaldo "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_vendas/saldopacote.js"
click node_saleannounce "https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_vendas/vendasAnnouncements.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_entry,node_db toneBlue
class node_farmcmd,node_farmrank,node_monthlyrank,node_farmannounce toneAmber
class node_actioncmd,node_actionsaldo,node_actionannounce,node_drugdeposit,node_drugbalance,node_drugannounce,node_drugranking,node_discord toneMint
class node_salecommand,node_salesaldo,node_saleannounce toneRose
class node_users toneIndigo
```

## Components

### Bot runtime

- [Bot runtime and dispatch](https://github.com/luanlucino/bot-alcateia/blob/main/src/index.js): `src/index.js`
- [SQLite data store](https://github.com/luanlucino/bot-alcateia/blob/main/src/database/db.js): `src/database/db.js`

### Farm rankings

- [Farm submission](https://github.com/luanlucino/bot-alcateia/blob/main/src/commands/farm.js): `src/commands/farm.js`
- [Weekly ranking](https://github.com/luanlucino/bot-alcateia/blob/main/src/commands/ranking.js): `src/commands/ranking.js`
- [Monthly ranking](https://github.com/luanlucino/bot-alcateia/blob/main/src/commands/ranking_mensal.js): `src/commands/ranking_mensal.js`
- [Scheduled farm rankings](https://github.com/luanlucino/bot-alcateia/blob/main/src/utils/rankingAnnouncements.js): `src/utils/rankingAnnouncements.js`

### Actions and drugs

- [Action recording](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_acao_saldo/acao.js): `src/modulo_acao_saldo/acao.js`
- [Action balance](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_acao_saldo/saldo.js): `src/modulo_acao_saldo/saldo.js`
- [Action announcements](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_acao_saldo/acaoSaldoAnnouncements.js): `src/modulo_acao_saldo/acaoSaldoAnnouncements.js`
- [Drug deposit](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/dinheirodrogas.js): `src/modulo_drogas/dinheirodrogas.js`
- [Drug balance and ranking](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/saldodrogas.js): `src/modulo_drogas/saldodrogas.js`
- [Drug announcements](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/drogasAnnouncements.js): `src/modulo_drogas/drogasAnnouncements.js`
- [Drug ranking command](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_drogas/drogasRanking.js): `src/modulo_drogas/drogasRanking.js`

### Package sales

- [Package sale recording](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_vendas/venda.js): `src/modulo_vendas/venda.js`
- [Package sales balance](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_vendas/saldopacote.js): `src/modulo_vendas/saldopacote.js`
- [Monthly sales announcement](https://github.com/luanlucino/bot-alcateia/blob/main/src/modulo_vendas/vendasAnnouncements.js): `src/modulo_vendas/vendasAnnouncements.js`

### Other components

- **Discord members**
- **Discord API**

## Connections

- Discord members → Bot runtime and dispatch: submit commands (evidence: `src/index.js`)
- Bot runtime and dispatch → Farm submission: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Weekly ranking: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Monthly ranking: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Action recording: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Action balance: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Drug deposit: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Drug balance and ranking: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Drug ranking command: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Package sale recording: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Package sales balance: dispatches to (evidence: `src/index.js`)
- Bot runtime and dispatch → Scheduled farm rankings: starts scheduler (evidence: `src/index.js`)
- Bot runtime and dispatch → Action announcements: starts scheduler (evidence: `src/index.js`)
- Bot runtime and dispatch → Drug announcements: starts scheduler (evidence: `src/index.js`)
- Bot runtime and dispatch → Monthly sales announcement: starts scheduler (evidence: `src/index.js`)
- Farm submission → SQLite data store: writes farm data (evidence: `src/commands/farm.js`)
- Weekly ranking → SQLite data store: queries rankings (evidence: `src/commands/ranking.js`)
- Monthly ranking → SQLite data store: queries rankings (evidence: `src/commands/ranking_mensal.js`)
- Scheduled farm rankings → SQLite data store: reads and resets (evidence: `src/utils/rankingAnnouncements.js`)
- Action recording → SQLite data store: writes actions (evidence: `src/modulo_acao_saldo/acao.js`)
- Action balance → SQLite data store: queries balance (evidence: `src/modulo_acao_saldo/saldo.js`)
- Action announcements → SQLite data store: reads and resets (evidence: `src/modulo_acao_saldo/acaoSaldoAnnouncements.js`)
- Drug deposit → SQLite data store: writes deposits (evidence: `src/modulo_drogas/dinheirodrogas.js`)
- Drug balance and ranking → SQLite data store: queries balance (evidence: `src/modulo_drogas/saldodrogas.js`)
- Drug ranking command → SQLite data store: queries ranking (evidence: `src/modulo_drogas/drogasRanking.js`)
- Drug announcements → SQLite data store: reads and resets (evidence: `src/modulo_drogas/drogasAnnouncements.js`)
- Package sale recording → SQLite data store: writes sales (evidence: `src/modulo_vendas/venda.js`)
- Package sales balance → SQLite data store: queries balance (evidence: `src/modulo_vendas/saldopacote.js`)
- Monthly sales announcement → SQLite data store: reads and resets (evidence: `src/modulo_vendas/vendasAnnouncements.js`)
- Farm submission → Discord API: replies with receipt (evidence: `src/commands/farm.js`)
- Package sale recording → Discord API: replies with receipt (evidence: `src/modulo_vendas/venda.js`)
- Drug announcements → Discord API: posts report (evidence: `src/modulo_drogas/drogasAnnouncements.js`)
- Action announcements → Discord API: posts report (evidence: `src/modulo_acao_saldo/acaoSaldoAnnouncements.js`)
- Monthly sales announcement → Discord API: posts report (evidence: `src/modulo_vendas/vendasAnnouncements.js`)
- Scheduled farm rankings → Discord API: posts rankings (evidence: `src/utils/rankingAnnouncements.js`)
