MassonNN/masson-aiogram-template

🚀 Mẫu bot Telegram siêu nhẹ với aiogram 3.x — sẵn sàng production

Template chuẩn DevOps: Docker, Redis, Alembic, lint — chỉnh sửa và chạy.

masson-aiogram-template là scaffold cho bot Telegram dựa trên aiogram 3.x. Tích hợp Redis (có password), Alembic migration, Docker Compose, cùng bộ lint isort/blue/ruff. Hướng tới bot scalable, không từ bỏ tính năng.

✨ Điểm nổi bật

• Docker Compose sẵn: make project-start — chạy ngay không cần cài đặt môi trường.
• Redis có bảo mật: cấu hình requirepass và masterauth trong build/redis.conf, đồng bộ với .env.
• Migration Alembic: make generate NAME=<tên> và make migrate — quản lý schema DB chuẩn.
• Lint tự động: make lint chạy isort, blue, ruff trên src và tests.
• Cấu hình môi trường: .env.dist → .env, tùy chỉnh biến môi trường dễ dàng.
• Cấu trúc dự án chuẩn: pyproject.toml định danh project, dễ đóng góp.
• Make command đa dạng: make help liệt kê lệnh, phát triển nhanh.

💡 Vì sao đáng chú ý

Không phải template rỗng — trang bị đầy đủ công cụ: container, cache, migration, chất lượng code. Phù hợp nhóm phát triển muốn bắt đầu nhanh mà không bỏ qua best practice. Roadmap hướng tới CI/CD, phiên bản nhẹ và bản highload với NATS + Docker Swarm.

#aiogram #TelegramBot #OpenSource #Docker #TiniX