bomzheg/Shvatka

🎮 Shvatka - Framework tạo trò chơi 'shvatka' trên Python

Một nền tảng mã nguồn mở để xây dựng, quản lý và trải nghiệm trò chơi shvatka, kết hợp Telegram Bot và API web.

Shvatka là một dự án Python mã nguồn mở nhằm hỗ trợ việc tạo lập và vận hành các trò chơi điện tử theo phong cách "shvatka" — một dạng trò chơi ẩn thân phổ biến ở Việt Nam. Dự án sử dụng aiogram3 để xây dựng bot Telegram quản lý trò chơi, đồng thời cung cấp API web thông qua FastAPI để người dùng tương tác trực tiếp.

✨ Điểm nổi bật

• Quản lý qua Telegram Bot: Người dùng có thể tạo nhóm, mời thành viên và tham gia trò chơi hoàn toàn qua giao diện Telegram.
• API web với FastAPI: Cung cấp giao diện REST API cho phép truy cập và điều khiển trò chơi từ bất kỳ nền tảng nào.
• Hệ thống cơ sở dữ liệu linh hoạt: Sử dụng SQLAlchemy kết hợp Alembic để quản lý schema và thực hiện migration một cách an toàn.
• Hỗ trợ đa dạng cấu hình trò chơi: Tùy chỉnh các thông số như thời gian chơi, số lượng gợi ý, điểm số, v.v.
• Kiến trúc modular với Dishka: Dự án sử dụp thư viện tiêm phụ thuộc Dishka giúp quản lý cấu trúc mã nguồn rõ ràng và dễ bảo trì.
• Xử lý bất đồng bộ toàn diện: Toàn bộ hệ thống được xây dựng trên nền tảng bất đồng bộ của Python, đảm bảo hiệu năng cao.

💡 Vì sao đáng chú ý

Shvatka không chỉ là một công cụ hỗ trợ tạo trò chơi mà còn là một nền tảng cho phép các cộng đồng người dùng dễ dàng tổ chức và tham gia các trò chơi ẩn thân một cách trực tuyến. Sự kết hợp giữa Telegram Bot và FastAPI giúp dự án tiếp cận được cả người dùng không chuyên kỹ thuật thông qua giao diện quen thuộc, đồng thời cung cấp đủ tính linh hoạt cho nhà phát triển qua API.

---

#Python #FastAPI #TelegramBot #OpenSource #GameFramework #TiniX