tiennm99
0660960d35
- Portfolio, holdings, prices, symbols packages with Telegram command handlers
- Handlers: trade_topup (add credits), trade_buy, trade_sell, trade_convert (coming-soon), trade_stats
- Per-user keylock for concurrency safety
- KBS (VN) as price source; ticker validation regex ^[A-Z0-9]{1,16}$
- Scope-trimmed: no SQL history, no retention cron, no daily refresh, no leaderboard, no forex
(matches upstream miti99bot's current VN-stocks-only state)
- Full unit test coverage for format, portfolio, prices, symbols, handlers
miti99bot-go
Plug-n-play Telegram bot framework in Go. Default deploy: AWS Lambda + DynamoDB + EventBridge Scheduler (free tier). Cloud Run + Firestore retained as an alt path. Free-tier port of miti99bot.
Status
Mid-port. Code is on main; first AWS deploy still pending the user's manual AWS-account bootstrap.
| Track | What | Status |
|---|---|---|
| Modules | util, misc, wordle, loldle (+ ability/emoji/quote/splash variants), lolschedule, semantle, doantu, twentyq | done |
| Storage | KVStore interface; in-memory + Firestore + DynamoDB providers | done |
| AI | Gemini API client (internal/ai) |
done |
| AWS IaC | SAM template + Makefile + GH Actions OIDC deploy | done |
| AWS bootstrap | account, IAM OIDC, SSM SecureString params, first sam deploy |
manual user steps — see aws/README.md |
| Cron handlers | lolschedule daily push, trading daily refresh | pending |
| Trading module | VN-stocks paper trading | pending |
| Cutover | Telegram webhook flip + 7-day soak | deploy-gated |
Plans:
- Active:
plans/260510-0234-pre-deploy-wrapup/— cron handlers + trading + cosmetics - AWS port:
plans/260510-0114-aws-port/ - Original GCP plan (historical):
plans/260508-2222-go-port-cloud-run/— module work reused; deploy phases superseded by AWS port
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 / firestore / dynamodb providers
internal/ai/ Gemini client
template.yaml AWS SAM IaC (Lambda + Function URL + DynamoDB + Logs + Budget)
docs/deploy-aws.md AWS deploy operations
aws/README.md One-time AWS account bootstrap cheatsheet
Run locally
In-memory KV (default; no AWS / no GCP needed):
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
For Firestore emulator (legacy):
make firestore-emulator # in a second shell
make test-emulator
Test
make vet # go vet
make test # full unit suite (no emulator)
make test-dynamodb # storage tests against DynamoDB Local (requires Docker)
make test-emulator # storage tests against Firestore emulator
Deploy
AWS (canonical): see docs/deploy-aws.md. Push to main → GitHub Actions OIDC → SAM deploy. First-time bootstrap: aws/README.md.
Cloud Run (alternative, deferred): the multi-stage Dockerfile builds an image suitable for any container runtime (Cloud Run, Fly.io, ECS Fargate, K8s). Image is golang:1.25-alpine → gcr.io/distroless/static:nonroot, ~15 MiB.
docker build -t miti99bot-go .