interlumpen/Telegram-shop

🛍️ Telegram Shop Bot — Template shop số đầy đủ tính năng trên Telegram

Một bot Telegram hỗ trợ bán hàng kỹ thuật số với giỏ hàng, khuyến mãi, đa phương thức thanh toán và bảo mật nâng cao.

Telegram Shop Bot là một template shop số (tài khoản, key, bản quyền, v.v.) được xây dựng bằng aiogram 3, SQLAlchemy và PostgreSQL. Dự án hỗ trợ người dùng nạp tiền, mua hàng, dùng giỏ hàng, áp dụng mã khuyến mãi, đánh giá sản phẩm và tham gia chương trình giới thiệu. Được thiết kế để triển khai nhanh với Docker, đồng thời cung cấp đầy đủ công cụ quản trị và giám sát.

✨ Điểm nổi bật

• Quản lý sản phẩm: Danh mục, sản phẩm có theo dõi tồn kho
• Mua hàng giao dịch: Quy trình mua hàng tuân thủ ACID
• Đa phương thức thanh toán: CryptoPay (TON, USDT, BTC, ETH), Telegram Stars, Telegram Payments (fiat)
• Giỏ hàng: Thêm nhiều sản phẩm, áp dụng mã khuyến mãi, thanh toán hàng loạt
• Mã khuyến mãi: Giảm theo phần trăm, cố định hoặc số dư, giới hạn sử dụng và thời hạn
• Đánh giá sản phẩm: Đánh giá 1–5 sao kèm bình luận, mỗi người một lần
• Hệ thống giới thiệu: Tỷ lệ hoa hồng có thể cấu hình
• Đa ngôn ngữ: Hỗ trợ tiếng Việt và tiếng Anh
• Phân quyền RBAC: Vai trò USER, ADMIN, OWNER với 10 quyền chi tiết
• Quản trị viên: Thống kê thời gian thực, quản lý người dùng, sản phẩm, phát sóng, xuất CSV
• Giám sát & Metrics: Theo dõi sự kiện, hiệu năng, lỗi, funnel
• Redis tùy chọn: Cache người dùng, danh mục, thống kê với TTL riêng
• Async toàn bộ: PostgreSQL bằng asyncpg + async SQLAlchemy, không thread pool

💡 Vì sao đáng chú ý

Dự án không chỉ là một bot mua bán đơn giản mà còn tích hợp toàn bộ hệ sinh thái: từ giao diện người dùng, giỏ hàng, khuyến mãi cho đến hệ thống phân quyền quản trị viên phức tạp với 10 bit quyền. Kiến trúc async hoàn toàn giúp bot xử lý tải cao mà không cần thread pool, đồng thời hệ thống cache Redis tùy chọn giảm đến 60% truy vấn cơ sở dữ liệu. Phù hợp cho người muốn triển khai nhanh một cửa hàng số trên Telegram với đầy đủ tính năng bảo mật và giám sát.

#TelegramBot #ShopBot #Aiogram #Python #OpenSource #TiniX