mirror of https://github.com/tiennm99/miti99bot.git synced 2026-09-14 08:18:41 +00:00

Files

T

tiennm99 1c50023261 feat(stats): add per-user analytics with /stats subcommands

Extend the stats module to track per-user counts in addition to the
existing per-command totals. CommandHook now receives the originating
*models.Update so the hook can attribute invocations to a user; only
the stats module consumes this hook today.

Schema (sort keys under pk="stats"):
  count:<cmd>            existing, per-command total
  user:<id>              new, per-user total with cached username
  pair:<cmd>:<id>        new, per (command, user) pair

Subcommands (all public):
  /stats                 top commands (unchanged)
  /stats users           top users overall
  /stats user <name>     top commands for that user
  /stats cmd <name>      top users of that command

When the sender has no Telegram username the per-user/pair writes are
skipped — the global per-command counter still increments. View helpers
fan out KV reads in parallel to stay inside the webhook deadline. The
existing read-modify-write race is unchanged; closing it would need
atomic UpdateItem ADD on the KV interface.

2026-05-22 18:01:12 +07:00

2.3 KiB

Raw Blame History

miti99bot

Plug-n-play Telegram bot framework in Go. Runs on AWS Lambda + DynamoDB + EventBridge Scheduler. Strictly free-tier.

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)
`trading`	VN-stocks paper trading
`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
internal/server/        HTTP routes (/, /webhook, /cron/{name})
internal/telegram/      Telegram webhook + bot wrapper
internal/modules/       Module framework, registry, dispatchers, modules
internal/storage/       KVStore interface; memory + dynamodb providers
internal/ai/            Gemini client (used by twentyq)
template.yaml           AWS SAM IaC (Lambda + Function URL + DynamoDB + Logs + Budget)
docs/deploy-aws-free-tier-guide.md   Full onboarding guide
docs/deploy-aws.md                   Steady-state operations
aws/README.md                        One-time AWS account setup

Run locally

In-memory KV (no AWS required):

TELEGRAM_BOT_TOKEN=… \
TELEGRAM_WEBHOOK_SECRET=local \
PORT=8080 \
MODULES= \
go run ./cmd/server

End-to-end smoke test against a Telegram dev bot needs ngrok (local) or a deployed Function URL. The dev bot is created manually; token injected via env vars only.

For DynamoDB integration tests:

make dynamodb-local      # docker run amazon/dynamodb-local on :8001
make test-dynamodb       # runs internal/storage tests against DDB Local

Test

make vet              # go vet
make test             # full unit suite (no emulator)
make test-dynamodb    # storage tests against DynamoDB Local (requires Docker)

Deploy

First-time onboarding: see docs/deploy-aws-free-tier-guide.md.

Steady-state operations: docs/deploy-aws.md.

After the initial setup, every push to main triggers .github/workflows/deploy.yml (GitHub Actions OIDC → SAM deploy). No long-lived AWS keys.

License

Apache-2.0.

2.3 KiB Raw Blame History