mirror of
https://github.com/tiennm99/miti99bot.git
synced 2026-09-15 14:19:55 +00:00
tiennm99
35ad4cb997
Implements Phases 02 (partial) and 03 of the go-port-cloud-run plan. Introduces module framework with per-module KV prefix isolation, health check endpoint, request timeout protection, and comprehensive test coverage. Cloud Run deployment deferred to Phase 01. Security hardening: constant-time secret comparison, cron auth bridge, and secrets stripped from dependency environment exports. Includes Dockerfile, GitHub CI workflow (vet + race + build), and integration tests for module lifecycle.
56 lines
1.5 KiB
Markdown
56 lines
1.5 KiB
Markdown
# miti99bot-go
|
|
|
|
Plug-n-play Telegram bot framework in Go, deployed on Google Cloud Run with Firestore + Gemini. Free-tier port of [miti99bot](https://github.com/tiennm99/miti99bot).
|
|
|
|
## Status
|
|
|
|
Early scaffolding. See [`plans/260508-2222-go-port-cloud-run/plan.md`](plans/260508-2222-go-port-cloud-run/plan.md) for the full roadmap.
|
|
|
|
| Phase | What | Status |
|
|
|-------|------|--------|
|
|
| 01 | GCP setup, Cloud Run baseline | pending |
|
|
| 02 | Repo bootstrap + webhook skeleton | **partial** (local pieces done; Cloud Run deploy deferred to Phase 01) |
|
|
| 03 | Module framework + KVStore | **done** |
|
|
| 04+ | Firestore, modules, cron, CI/CD, cutover | pending |
|
|
|
|
## Layout
|
|
|
|
```
|
|
cmd/server/ entrypoint
|
|
internal/server/ HTTP routes (/, /webhook, /cron/{name})
|
|
internal/telegram/ Telegram webhook + bot wrapper
|
|
internal/modules/ Module framework, registry, dispatchers
|
|
internal/storage/ KVStore interface, in-memory impl, prefix wrapper
|
|
```
|
|
|
|
## Run locally
|
|
|
|
```sh
|
|
TELEGRAM_BOT_TOKEN=… \
|
|
TELEGRAM_WEBHOOK_SECRET=local \
|
|
PORT=8080 \
|
|
MODULES= \
|
|
go run ./cmd/server
|
|
```
|
|
|
|
End-to-end smoke test against a Telegram dev bot requires `ngrok` (local) or a Cloud Run deployment. The dev bot is created manually; token is injected via env vars only.
|
|
|
|
## Test
|
|
|
|
```sh
|
|
go vet ./...
|
|
go test ./...
|
|
```
|
|
|
|
## Build
|
|
|
|
```sh
|
|
docker build -t miti99bot-go .
|
|
```
|
|
|
|
The image is multi-stage (`golang:1.23-alpine` → `gcr.io/distroless/static:nonroot`); resulting image is ~15 MiB.
|
|
|
|
## License
|
|
|
|
[Apache-2.0](LICENSE).
|