andrew000/aiogram-template

🚀 Mẫu bot Telegram aiogram 3 đầy đủ tính năng

Một bộ khung bot Telegram hoàn chỉnh với aiogram 3, SQLAlchemy, PostgreSQL, Redis và Docker — chỉ cần clone và chạy.

Đây là template để xây dựng bot Telegram bằng thư viện aiogram phiên bản 3. Dự án tích hợp đầy đủ stack: cơ sở dữ liệu PostgreSQL, bộ nhớ đệm Redis, web server Caddy, đồng thời hỗ trợ đa ngôn ngữ (i18n) bằng Project Fluent và quản lý migration với Alembic. Mọi thứ đều được đóng gói trong Docker để dễ triển khai.

✨ Điểm nổi bật

• aiogram 3: Sử dụng bản cập nhật mới nhất của thư viện aiogram.
• SQLAlchemy + Alembic: Quản lý ORM và migration cơ sở dữ liệu chuyên nghiệp.
• PostgreSQL & Redis: Cơ sở dữ liệu chính và bộ nhớ đệm được tích hợp sẵn.
• Caddy Server: Web server tự động cấp SSL và hỗ trợ webhook.
• Docker Compose: Triển khai toàn bộ hệ thống chỉ bằng một lệnh just up.
• i18n (Project Fluent): Hỗ trợ đa ngôn ngữ với công cụ trích xuất khóa FTL tự động.
• uv: Quản lý môi trường ảo và dependency nhanh chóng.
• Pre-commit hooks: Kiểm tra chất lượng code tự động trước khi commit.

💡 Vì sao đáng chú ý

Template này không chỉ cung cấp cấu trúc dự án mẫu mà còn tích hợp đầy đủ công cụ DevOps như Docker, Caddy và Alembic, giúp nhà phát triển tập trung vào logic bot thay vì cấu hình môi trường. Việc sử dụng just để quản lý lệnh và uv để quản lý dependency giúp quy trình phát triển nhanh chóng và nhất quán.

Thích hợp cho các dự án bot Telegram cần hệ thống backend vữ chắc, hỗ trợ đa ngôn ngữ và dễ dàng mở rộng.

#aiogram #TelegramBot #Docker #OpenSource #TiniX