| Dưới đây là **tóm tắt ngắn gọn và rõ ràng** để bạn chạy dự án **Windmill Streaming Integration**: | |
| --- | |
| ### ✅ **YÊU CẦU** | |
| * Đã cài Docker, Python ≥ 3.9 | |
| * Cổng trống: `8000`, `8001`, `8002`, `5432` | |
| --- | |
| ### 🚀 **CÁCH CHẠY DỰ ÁN** | |
| #### 🔧 **1. Khởi động dịch vụ** | |
| * **Windows / Linux / Mac:** | |
| ```bash | |
| docker-compose up -d --build | |
| ``` | |
| * **Hoặc dùng script cho Linux/Mac:** | |
| ```bash | |
| chmod +x start_services.sh | |
| ./start_services.sh | |
| ``` | |
| #### 📋 **2. Kiểm tra dịch vụ** | |
| ```bash | |
| docker-compose ps | |
| ``` | |
| * Windmill có thể mất 2–3 phút để sẵn sàng. | |
| --- | |
| ### 🔍 **3. Kiểm tra kết nối** | |
| ```bash | |
| curl http://localhost:8001 # ✅ Backend | |
| curl http://localhost:8000 # ✅ Windmill UI | |
| curl http://localhost:8001/ping-windmill # ✅ Kết nối Windmill | |
| ``` | |
| --- | |
| ### 🌐 **4. Truy cập ứng dụng** | |
| * Giao diện client: `http://localhost:8001/client` | |
| * Docs backend: `http://localhost:8001/docs` | |
| * Docs streaming: `http://localhost:8002/docs` | |
| * Windmill dashboard: `http://localhost:8000` | |
| * Đăng nhập mặc định: `admin@mail.windmill.com / changeme` | |
| --- | |
| ### 🧪 **5. Kiểm thử nhanh** | |
| ```bash | |
| pip install websockets requests asyncio | |
| python test_streaming.py | |
| ``` | |
| --- | |
| ### 🛑 **6. Dừng dịch vụ** | |
| ```bash | |
| docker-compose down # Dừng | |
| docker-compose down -v # Dừng + xóa dữ liệu | |
| ``` | |
| --- | |
| ### 🧾 **7. Xem logs** | |
| ```bash | |
| docker-compose logs -f # Tất cả | |
| docker-compose logs -f backend # Cụ thể | |
| ``` | |
| --- | |
| ### 🧰 **8. Gỡ lỗi thường gặp** | |
| * ⚠️ **Windmill chậm:** đợi thêm 2–3 phút | |
| * 🔌 **Client lỗi:** mở `client/index.html` trong trình duyệt | |
| * 🔁 **Không kết nối:** đổi `WINDMILL_BASE_URL=http://host.docker.internal:8000` (Windows) | |
| --- | |
| ### 🗂️ **Cấu trúc thư mục** | |
| * `backend/`: FastAPI API | |
| * `client/`: Giao diện người dùng | |
| * `windmill/`: Config + script | |
| * `docker-compose.yml`: Docker config | |
| * `start_services.sh`: Script khởi động | |
| * `test_streaming.py`: Kiểm thử | |
| --- | |
| ### 💡 **Hướng phát triển** | |
| * Xác thực OAuth2 | |
| * Streaming đa phương tiện | |
| * Dashboard giám sát | |
| * Kết nối LLM khác | |
| --- | |
| Nếu cần hỗ trợ: tạo issue trong repo GitHub. | |
| 🎉 **Chúc bạn triển khai thành công!** | |