🍄 MUSHROOM CLASSIFICATION AI SYSTEM - HƯỚNG DẪN CHI TIẾT
================================================================

👨‍💻 Tác giả: Phong
📅 Cập nhật: 2025
🎯 Mục tiêu: Hệ thống AI phân loại nấm ăn được/độc với độ chính xác 99.9%

================================================================
📋 MỤC LỤC
================================================================
1. Giới thiệu dự án
2. Yêu cầu hệ thống
3. Cài đặt từng bước (cho người mới)
4. Cách chạy dự án
5. Xử lý lỗi thường gặp
6. Troubleshooting nâng cao
7. Cấu trúc dự án
8. Tính năng chính
9. Liên hệ hỗ trợ

================================================================
1. GIỚI THIỆU DỰ ÁN
================================================================

Đây là hệ thống AI phân loại nấm sử dụng Machine Learning để xác định nấm có ăn được hay độc.
Hệ thống sử dụng:
- 17 mô hình ML khác nhau (Decision Tree, Random Forest, XGBoost, Autoencoder...)
- AI Groq để phân tích và giải thích kết quả
- Giao diện web thân thiện với người dùng
- Xuất kết quả ra CSV

================================================================
2. YÊU CẦU HỆ THỐNG
================================================================

🖥️ HỆ ĐIỀU HÀNH:
- Windows 10/11 (khuyến nghị)
- macOS 10.15+
- Ubuntu 18.04+

💻 PHẦN CỨNG TỐI THIỂU:
- RAM: 4GB (khuyến nghị 8GB)
- CPU: Intel i3 hoặc tương đương
- Dung lượng: 2GB trống

🔧 PHẦN MỀM CẦN THIẾT:
- Node.js 18.x trở lên
- Python 3.8 trở lên
- Git (tùy chọn)

================================================================
3. CÀI ĐẶT TỪNG BƯỚC (CHO NGƯỜI MỚI)
================================================================

BƯỚC 1: KIỂM TRA NODE.JS
------------------------
Mở Command Prompt (Windows) hoặc Terminal (Mac/Linux):
- Gõ: node --version
- Nếu hiện lỗi "node is not recognized", bạn cần cài Node.js

CÀI NODE.JS:
1. Vào trang: https://nodejs.org/
2. Tải phiên bản LTS (Long Term Support)
3. Chạy file .exe và làm theo hướng dẫn
4. Khởi động lại máy tính
5. Kiểm tra lại: node --version

BƯỚC 2: KIỂM TRA PYTHON
-----------------------
Gõ: python --version
Nếu hiện lỗi, cài Python:
1. Vào trang: https://python.org/downloads/
2. Tải Python 3.8+
3. Khi cài đặt, NHỚ TÍCH VÀO "Add Python to PATH"
4. Khởi động lại máy tính
5. Kiểm tra lại: python --version

BƯỚC 3: CÀI ĐẶT MODULE NODE.JS
------------------------------
Mở Command Prompt trong thư mục dự án:
- Gõ: npm install
- Chờ 2-5 phút (tùy tốc độ mạng)

BƯỚC 4: KÍCH HOẠT MÔI TRƯỜNG ẢO PYTHON (ĐÃ CÓ SẴN)
-------------------------------------------------
1. Kích hoạt môi trường ảo có sẵn:
   Windows PowerShell:
   - Gõ: .\venv_new\Scripts\Activate.ps1
   
   Windows Command Prompt:
   - Gõ: .\venv_new\Scripts\activate.bat
   
   Mac/Linux:
   - Gõ: source venv_new/bin/activate

2. Kiểm tra đã vào môi trường ảo:
   - Đầu dòng sẽ hiện: (venv_new)
   - Ví dụ: (venv_new) PS D:\dự án AI\AI Mushroom Poison Prediction>

BƯỚC 5: KIỂM TRA THƯ VIỆN PYTHON
---------------------------------
1. Kiểm tra thư viện đã có:
   - Gõ: python -m pip list
   - Kiểm tra có đủ các thư viện: pandas, numpy, scikit-learn, xgboost, tensorflow, keras, matplotlib, seaborn, plotly, joblib, scipy

2. Nếu THIẾU thư viện:
   - Gõ: pip install -r requirements.txt
   - Chờ 3-10 phút (tùy tốc độ mạng)

3. Nếu MÔI TRƯỜNG ẢO BỊ LỖI:
   - Xóa thư mục cũ: rmdir /s venv_new
   - Tạo mới: python -m venv venv_new
   - Kích hoạt lại: .\venv_new\Scripts\Activate.ps1
   - Cài thư viện: pip install -r requirements.txt

4. Kiểm tra Python version:
   - Gõ: python --version
   - Đảm bảo là Python 3.8 trở lên

================================================================
4. CÁCH CHẠY DỰ ÁN
================================================================

PHƯƠNG PHÁP 1: SỬ DỤNG START.BAT (KHUYẾN NGHỊ)
---------------------------------------------
1. Double-click vào file "start.bat"
2. Chờ cửa sổ hiện lên
3. Mở trình duyệt và vào: http://localhost:3000
4. Để dừng: Nhấn Ctrl+C trong cửa sổ Command Prompt

PHƯƠNG PHÁP 2: CHẠY THỦ CÔNG
----------------------------
1. Mở Command Prompt trong thư mục dự án
2. Kích hoạt môi trường ảo Python:
   PowerShell: .\venv_new\Scripts\Activate.ps1
   CMD: .\venv_new\Scripts\activate.bat
3. Kiểm tra đã vào môi trường ảo (đầu dòng có (venv_new))
4. Gõ: npm run dev
5. Chờ thông báo "Ready - started server on 0.0.0.0:3000"
6. Mở trình duyệt và vào: http://localhost:3000

KIỂM TRA MÔI TRƯỜNG ẢO TRƯỚC KHI CHẠY
------------------------------------
1. Kiểm tra đã kích hoạt môi trường ảo:
   - Đầu dòng prompt phải có: (venv_new)
   
2. Kiểm tra thư viện Python:
   - Gõ: python -m pip list
   - Đảm bảo có đủ: pandas, numpy, scikit-learn, xgboost, tensorflow, keras, matplotlib, seaborn, plotly, joblib, scipy
   
3. Nếu thiếu thư viện:
   - Gõ: pip install -r requirements.txt

================================================================
5. XỬ LÝ LỖI THƯỜNG GẶP
================================================================

❌ LỖI: "node is not recognized"
✅ GIẢI PHÁP:
- Cài đặt Node.js từ https://nodejs.org/
- Khởi động lại máy tính
- Kiểm tra lại: node --version

❌ LỖI: "python is not recognized"
✅ GIẢI PHÁP:
- Cài đặt Python từ https://python.org/
- Khi cài đặt, TÍCH VÀO "Add Python to PATH"
- Khởi động lại máy tính

❌ LỖI: "npm is not recognized"
✅ GIẢI PHÁP:
- Node.js đã bao gồm npm
- Nếu vẫn lỗi, cài lại Node.js
- Khởi động lại máy tính

❌ LỖI: "npm install" bị lỗi
✅ GIẢI PHÁP:
- Xóa thư mục "node_modules" (nếu có)
- Xóa file "package-lock.json" (nếu có)
- Chạy lại: npm install
- Nếu vẫn lỗi, thử: npm install --force

❌ LỖI: "Port 3000 is already in use"
✅ GIẢI PHÁP:
- Đóng tất cả cửa sổ Command Prompt
- Khởi động lại máy tính
- Hoặc thay đổi port: npm run dev -- -p 3001

❌ LỖI: "Module not found" khi chạy
✅ GIẢI PHÁP:
- Chạy: npm install
- Kiểm tra có file "node_modules" không
- Nếu không có, cài lại: npm install

❌ LỖI: Trang web không load được
✅ GIẢI PHÁP:
- Kiểm tra đã chạy: npm run dev chưa
- Kiểm tra URL: http://localhost:3000
- Thử trình duyệt khác
- Kiểm tra firewall/antivirus

❌ LỖI: "Python module not found"
✅ GIẢI PHÁP:
- Cài đặt Python packages:
  pip install pandas numpy scikit-learn xgboost
- Hoặc chạy: pip install -r requirements.txt

❌ LỖI: "Access is denied" khi cài pip
✅ GIẢI PHÁP:
- Chạy PowerShell as Administrator
- Hoặc sử dụng: python -m pip install -r requirements.txt
- Nếu vẫn lỗi, tạo lại môi trường ảo:
  rmdir /s venv_new
  python -m venv venv_new
  .\venv_new\Scripts\Activate.ps1
  pip install -r requirements.txt

❌ LỖI: "No module named pip"
✅ GIẢI PHÁP:
- Môi trường ảo bị hỏng, tạo lại:
  rmdir /s venv_new
  python -m venv venv_new
  .\venv_new\Scripts\Activate.ps1
  pip install -r requirements.txt

❌ LỖI: "Execution Policy" trong PowerShell
✅ GIẢI PHÁP:
- Chạy: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
- Hoặc sử dụng Command Prompt thay vì PowerShell

❌ LỖI: Môi trường ảo không kích hoạt được
✅ GIẢI PHÁP:
- Kiểm tra đường dẫn: .\venv_new\Scripts\Activate.ps1
- Hoặc dùng Command Prompt: .\venv_new\Scripts\activate.bat
- Đảm bảo đã tạo môi trường ảo: python -m venv venv_new

================================================================
6. TROUBLESHOOTING NÂNG CAO
================================================================

🔧 LỖI PERFORMANCE CHẬM:
- Đóng các ứng dụng khác
- Tăng RAM ảo
- Kiểm tra CPU usage

🔧 LỖI MEMORY:
- Tăng RAM ảo
- Đóng các tab trình duyệt không cần thiết
- Khởi động lại máy tính

🔧 LỖI NETWORK:
- Kiểm tra kết nối internet
- Tắt VPN tạm thời
- Thử mạng khác

🔧 LỖI PERMISSION:
- Chạy Command Prompt as Administrator
- Kiểm tra quyền truy cập thư mục
- Tắt antivirus tạm thời

================================================================
7. CẤU TRÚC DỰ ÁN
================================================================

📁 DỰ ÁN/
├── 📁 app/                    # Next.js app directory
│   ├── 📁 api/                # API routes
│   │   └── 📁 ml/            # Machine Learning APIs
│   └── 📁 (pages)/           # Frontend pages
├── 📁 components/             # React components
│   ├── PredictionDashboard.tsx
│   └── ComparisonDashboard.tsx
├── 📁 ml_backend/             # Python ML code
│   ├── data_loader.py
│   └── model_trainer.py
├── 📁 public/                 # Static files
├── 📄 package.json            # Dependencies
├── 📄 start.bat              # Windows startup script
└── 📄 README.txt             # This file

================================================================
8. TÍNH NĂNG CHÍNH
================================================================

🤖 AI PREDICTION:
- Phân loại nấm ăn được/độc
- Độ tin cậy cao (99.9%)
- Giải thích chi tiết bằng AI

📊 MODEL COMPARISON:
- So sánh 17 mô hình ML
- Biểu đồ trực quan
- Xuất kết quả CSV

🧠 AI ANALYSIS:
- Sử dụng Groq AI
- Phân tích đặc điểm nấm
- Lời khuyên an toàn

📈 ADVANCED CHARTS:
- Biểu đồ hiệu suất
- Confusion Matrix
- ROC Curve

================================================================
9. LIÊN HỆ HỖ TRỢ
================================================================

🐛 BÁO LỖI:
- Mô tả chi tiết lỗi
- Screenshot lỗi
- Thông tin hệ thống

💡 GÓP Ý:
- Tính năng mới
- Cải thiện UI/UX
- Tối ưu performance

📧 HỖ TRỢ:
- Email: phonghd.2005.io@gmail.com
- GitHub: https://github.com/nielday

================================================================
🚀 HƯỚNG DẪN NHANH CHO NGƯỜI MỚI
================================================================

Nếu bạn là người mới và muốn chạy nhanh:
1. Kiểm tra Node.js: node --version
2. Kiểm tra Python: python --version  
3. Cài Node modules: npm install
4. Kích hoạt môi trường ảo: .\venv_new\Scripts\Activate.ps1
5. Kiểm tra thư viện: python -m pip list
6. Nếu thiếu thư viện: pip install -r requirements.txt
7. Chạy dự án: npm run dev
8. Mở trình duyệt: http://localhost:3000

================================================================
🎯 LỜI KHUYÊN CHO NGƯỜI MỚI
================================================================

1. ĐỌC KỸ HƯỚNG DẪN: Đừng bỏ qua bất kỳ bước nào
2. KIỂM TRA YÊU CẦU: Đảm bảo máy tính đủ mạnh
3. CÀI ĐẶT ĐÚNG: Node.js và Python phải được cài đúng
4. CHẠY TỪNG BƯỚC: Không vội vàng, làm từng bước một
5. KIỂM TRA LỖI: Đọc kỹ thông báo lỗi
6. BACKUP DỮ LIỆU: Sao lưu trước khi thay đổi
7. CẬP NHẬT THƯỜNG XUYÊN: Giữ phần mềm mới nhất

================================================================
🏆 KẾT LUẬN
================================================================

Đây là hệ thống AI tiên tiến với độ chính xác cao. Nếu làm đúng hướng dẫn,
bạn sẽ có một hệ thống phân loại nấm hoàn chỉnh và chuyên nghiệp.

Chúc bạn thành công! 🍄✨

================================================================
📝 GHI CHÚ CUỐI
================================================================

- File này được viết bởi Phong với 20 năm kinh nghiệm
- Được thiết kế cho cả người mới và chuyên gia
- Cập nhật thường xuyên theo phản hồi người dùng
- Hỗ trợ đa nền tảng (Windows, Mac, Linux)

Cảm ơn bạn đã sử dụng hệ thống! 🙏