allow game noi_tu for multiple server/channel

2025-09-10 10:07:27 +07:00
parent aa62667d89
commit 670c124943
4 changed files with 204 additions and 16 deletions
@@ -0,0 +1,108 @@
+# Hướng dẫn sử dụng Bot với nhiều Channel
+
+## Tổng quan
+
+Bot đã được refactor để hỗ trợ chạy game nối từ trên nhiều channel đồng thời với cùng một bot token.
+
+## Cấu hình Environment Variables
+
+### Format đơn giản với dấu phẩy
+
+```bash
+# Nhiều channel, phân cách bằng dấu phẩy (không có khoảng trắng)
+CHANNEL_NOI_TU_ID=1383424686708363336,9876543210987654321,5555555555555555555
+```
+
+### Ví dụ thực tế
+
+```bash
+# 1 channel
+CHANNEL_NOI_TU_ID=1383424686708363336
+
+# 2 channel
+CHANNEL_NOI_TU_ID=1383424686708363336,9876543210987654321
+
+# 3 channel
+CHANNEL_NOI_TU_ID=1383424686708363336,9876543210987654321,5555555555555555555
+```
+
+### Lưu ý
+- Không có khoảng trắng xung quanh dấu phẩy
+- Mỗi ID phải là số nguyên hợp lệ
+- Bot sẽ tự động parse và hỗ trợ tất cả channel trong danh sách
+
+## Cách hoạt động
+
+### Game State riêng biệt
+- Mỗi channel có game state hoàn toàn độc lập
+- Channel A có thể đang chơi game với từ "âm cao" → "cao độ"
+- Channel B có thể đang chơi game khác với từ "mặt trời" → "trời mưa"
+- Không có xung đột giữa các game
+
+### Database chung
+- Tất cả channel sử dụng chung database PostgreSQL
+- Từ điển nối từ được chia sẻ giữa các channel
+- Admin có thể thêm/xóa từ từ bất kỳ channel nào
+
+## Lệnh hỗ trợ
+
+### Lệnh cơ bản
+- `!start` - Bắt đầu game nối từ
+- `!end` - Kết thúc game nối từ
+
+### Lệnh admin (chỉ admin server)
+- `!add <từ>` - Thêm từ mới vào database
+- `!remove <từ>` - Xóa từ khỏi database
+
+### Lệnh khác
+- `/help` - Hiển thị danh sách lệnh cho channel hiện tại
+
+## Ví dụ sử dụng
+
+### Server A (Channel #game-1)
+```
+User: !start
+Bot: 🎮 Trò chơi Nối Từ đã bắt đầu!
+     Từ đầu tiên: âm cao
+
+User: cao độ
+Bot: ✅
+
+User: độ cao
+Bot: ✅
+```
+
+### Server B (Channel #game-2) - Đồng thời
+```
+User: !start
+Bot: 🎮 Trò chơi Nối Từ đã bắt đầu!
+     Từ đầu tiên: mặt trời
+
+User: trời mưa
+Bot: ✅
+
+User: mưa gió
+Bot: ✅
+```
+
+## Lưu ý quan trọng
+
+1. **Bot Token**: Chỉ cần 1 bot token duy nhất
+2. **Database**: Tất cả channel dùng chung database
+3. **Game State**: Mỗi channel có game state riêng biệt
+4. **Admin**: Admin của server có thể quản lý từ điển
+5. **Timeout**: Mỗi game có timeout 30 giây độc lập
+
+## Troubleshooting
+
+### Bot không phản hồi trong channel
+- Kiểm tra channel ID có trong `CHANNEL_NOI_TU_IDS` không
+- Kiểm tra bot có quyền gửi tin nhắn trong channel không
+
+### Game không bắt đầu được
+- Kiểm tra xem đã có game đang chạy trong channel đó chưa
+- Kiểm tra database có từ nào không
+
+### Lỗi database
+- Kiểm tra kết nối PostgreSQL
+- Kiểm tra biến môi trường database