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

# Để trống POSTGRES_URL → tự động dùng SQLite
POSTGRES_URL=

# Để trống REDIS_URL → tự động dùng in-memory (mất khi restart)
REDIS_URL=

LOG_LEVEL=INFO
LOG_JSON=false

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

---

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

# Khởi động đầy đủ (Postgres + Redis + Bot)
# Auto-detect backend bên trong bot dựa trên POSTGRES_URL / REDIS_URL
docker compose up -d --build

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

# Xem logs
docker compose logs -f hutech-bot

# Dừng services
docker compose down

• Nếu để trống POSTGRES_URL và REDIS_URL → bot tự dùng SQLite + in-memory cache (các service postgres/redis vẫn khởi động nhưng không được dùng).
• Để dùng Postgres/Redis: set URL trong .env (xem phần bên dưới).
• Muốn chạy nhẹ (không cần postgres/redis): dùng cách chạy local python bot.py.

Lựa chọn B: Chạy local (không cần Docker)

Nếu để trống POSTGRES_URL và REDIS_URL trong .env, bot tự chạy với SQLite + in-memory:

# 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 (auto-detect: sqlite + memory)
python bot.py

Nếu muốn dùng Postgres + Redis local, chỉ cần set URL trong .env:

POSTGRES_URL=postgresql://user:pass@localhost:5432/e-hutech
REDIS_URL=redis://localhost:6379/0

Docker Services

Service	Image	Port	Chức năng
hutech-bot	ghcr.io/tylerx404/e-hutech	-	Telegram Bot chính (tự động chọn backend)
postgres	postgres	5432	Cơ sở dữ liệu (dùng khi có POSTGRES_URL)
redis	redis	6379	Cache layer (dùng khi có REDIS_URL)

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