e-HUTECH Telegram Bot

Bot Telegram đa chức năng dành riêng cho sinh viên HUTECH Truy cập thông tin học tập nhanh chóng và thuận tiện ngay trên Telegram.

---

Giới thiệu

e-HUTECH Telegram Bot là công cụ hỗ trợ sinh viên Đại học Công nghệ TP.HCM (HUTECH) truy cập nhanh các thông tin học tập như thời khóa biểu, lịch thi, điểm số, điểm danh và nhiều tính năng khác — tất cả ngay trên nền tảng Telegram.

Tính năng

Lệnh	Chức năng	Mô tả
/dangnhap	Đăng nhập	Đăng nhập vào hệ thống HUTECH
/danhsach	Danh sách	Xem danh sách tài khoản đã đăng nhập
/vitri	Vị trí	Cài đặt vị trí điểm danh mặc định
/diemdanh	Điểm danh	Điểm danh cho tài khoản hiện tại
/diemdanhtatca	Điểm danh tất cả	Điểm danh tất cả tài khoản cùng lúc
/tkb	Thời khóa biểu	Xem TKB & xuất file iCalendar .ics
/lichthi	Lịch thi	Xem lịch thi các môn sắp tới
/diem	Điểm số	Xem điểm & xuất file Excel .xlsx
/hocphan	Học phần	Tra cứu học phần, danh sách lớp, lịch sử điểm danh
/trogiup	Trợ giúp	Hiển thị thông tin trợ giúp chi tiết
/chinhsach	Chính sách	Xem chấp nhận hoặc từ chối chính sách bảo mật
/dangxuat	Đăng xuất	Ngắt kết nối tài khoản

Cài đặt và Chạy

Yêu cầu tiên quyết

• Python 3.10+
• Git
• Docker (khuyến khích)

Bước 1: Clone repository

git clone https://github.com/Tylerx404/e-hutech.git
cd e-hutech

Bước 2: Cấu hình môi trường

cp .env.example .env

Mở file .env và điền các thông tin cần thiết:

TELEGRAM_BOT_TOKEN=your_bot_token_here
POSTGRES_URL=postgresql://user:password@postgres:5432/db_name
REDIS_URL=redis://redis:6379/cache_name
LOG_LEVEL=INFO
LOG_JSON=false
TELEGRAM_CONNECT_TIMEOUT=10
TELEGRAM_READ_TIMEOUT=20
TELEGRAM_WRITE_TIMEOUT=20
TELEGRAM_POOL_TIMEOUT=5
TELEGRAM_CONNECTION_POOL_SIZE=16
TELEGRAM_GET_UPDATES_CONNECT_TIMEOUT=10
TELEGRAM_GET_UPDATES_READ_TIMEOUT=35
TELEGRAM_GET_UPDATES_WRITE_TIMEOUT=20
TELEGRAM_GET_UPDATES_POOL_TIMEOUT=5
TELEGRAM_POLL_TIMEOUT=10
TELEGRAM_POLL_INTERVAL=0.5
TELEGRAM_BOOTSTRAP_RETRIES=-1

Mẹo: Lấy TELEGRAM_BOT_TOKEN từ @BotFather trên Telegram.

---

Lựa chọn A: Docker (Khuyến khích)

# Build và khởi động tất cả services
docker-compose up --build -d

# Kiểm tra trạng thái
docker-compose ps

# Xem logs
docker-compose logs -f hutech-bot

# Dừng services
docker-compose down

Docker Compose sẽ tự động khởi động PostgreSQL, Redis và Bot với health check đầy đủ.

Lựa chọn B: Chạy local

Lưu ý: Cần cài đặt và chạy PostgreSQL và Redis trên máy local trước.

# Tạo môi trường ảo
python3 -m venv venv
source venv/bin/activate   # macOS/Linux
# .\venv\Scripts\activate  # Windows

# Cài đặt dependencies
pip install -r requirements.txt

# Khởi chạy bot
python bot.py

Docker Services

Service	Image	Port	Chức năng
hutech-bot	Custom build	-	Telegram Bot chính
postgres	postgres:latest	5432	Cơ sở dữ liệu
redis	redis:latest	6379	Cache layer

Giấy phép

Dự án này được cấp phép theo GNU General Public License v3.0 — xem chi tiết tại file LICENSE.

---

Nếu dự án hữu ích, hãy cho một ⭐ trên GitHub!

Made with ❤️ for HUTECH students