tiennm99
bd7a7fcedf
Move DeleteWebhook ahead of the deploynotify owner DM and polling so the webhook is cleared first thing once the bot is ready, instead of just before getUpdates. DropPendingUpdates=false keeps the lossless cutover.
miti99bot
Plug-n-play Telegram bot framework in Go. Self-hosted on Coolify + MongoDB Atlas via long polling and an in-process cron scheduler. (Previously ran on AWS Lambda + DynamoDB + EventBridge — now retired; see docs/deploy-aws.md for history.)
Modules
| Module | What it does |
|---|---|
util |
/help, /info, /stickerid |
misc |
/ping, /mstats, /trongtruonghop disclaimer |
wordle |
Daily Wordle game |
loldle |
League-of-Legends "guess the champion" |
lolschedule |
Pro-match schedule + daily push |
twentyq |
20-questions game (requires Gemini API key) |
stock |
VN-stocks paper trading |
gold |
Gold paper trading (opt-in; primary VNAppMob SJC buy/sell VND/luong, fallback spot XAU) |
coin |
Crypto paper trading in USD (Binance -> Coinbase -> CoinGecko price fallback) |
stats |
/stats (top commands), /stats users, /stats user <name>, /stats cmd <name> |
Disable any module by editing MODULES in template.yaml.
Layout
cmd/server/ entrypoint (long polling + in-process cron + HTTP health)
cmd/migrate-dynamo-to-mongo/ one-off DynamoDB → MongoDB Atlas data migrator
internal/server/ HTTP route (/ health only; cron has no HTTP route)
internal/telegram/ Telegram long-polling bot wrapper
internal/cron/ in-process cron scheduler (replaces EventBridge)
internal/modules/ Module framework, registry, dispatchers, modules
internal/storage/ typed DocStore[T] (Provider + Typed); mongodb runtime + memory (tests). Values persist as flattened native BSON root documents
internal/ai/ Gemini client (used by twentyq)
docker-compose.yml Coolify self-host stack (single bot service)
docs/deploy-coolify-selfhosted.md Self-host onboarding + cutover runbook
docs/aws-decommission-runbook.md AWS teardown (post-cutover)
template.yaml, aws/ Retired AWS SAM IaC + setup (kept for history)
Run locally
In-memory KV (no database required):
TELEGRAM_BOT_TOKEN=… \
MODULES= \
go run ./cmd/server
The bot uses long polling, so a local run talks to Telegram directly — no ngrok, no public URL. Ensure the bot's webhook is unset (the server clears it on startup) or getUpdates 409s. The dev bot is created manually; token injected via env vars only.
Persistent MongoDB locally (auto-selected when MONGO_URL is set):
make mongo-local
TELEGRAM_BOT_TOKEN=… \
MONGO_URL=mongodb://127.0.0.1:27017 \
MONGO_DATABASE=miti99bot_dev \
go run ./cmd/server
For integration tests (each skips when its emulator env var is unset):
make mongo-local # docker run mongo:7 on :27017
make test-mongo # internal/storage typed-store tests against local MongoDB
make test-dynamodb # DynamoDB→Mongo migrator e2e against DynamoDB Local + local Mongo
Test
make vet # go vet
make test # full unit suite (no emulator)
make test-mongo # typed-store integration tests against local Mongo (requires Docker)
make test-dynamodb # migrator e2e against DynamoDB Local + Mongo (requires Docker)
Deploy
Self-host (current): docs/deploy-coolify-selfhosted.md — Coolify + MongoDB Atlas (free M0), long polling (no public ingress), in-process cron. Storage auto-selects mongodb when MONGO_URL is set; the cron scheduler runs by default. Migrate existing data with cmd/migrate-dynamo-to-mongo, then tear down AWS via docs/aws-decommission-runbook.md.
AWS (retired): docs/deploy-aws.md — kept for history.