Update README.md

README.md

@@ -1,137 +1,114 @@
-# PINE-AI MVP - Hướng dẫn chạy
-
-## 1. Mục đích
-
-PINE-AI là một hệ thống AI hỗ trợ logic sales, có khả năng xử lý dữ liệu khách hàng và gói cước, đồng thời demo bằng giao diện web.  
-
-Hướng dẫn này giúp Ban giám khảo **chạy MVP PINE-AI trên Windows** bằng Docker mà không cần cài Python hay cấu hình môi trường phức tạp.
-
----
-
-## 2. Yêu cầu
-
-- Windows 10/11 với **PowerShell**  
-- **Docker Desktop** đã cài và đang chạy (bao gồm Docker Compose)  
-- Kết nối Internet để Docker pull image và build container  
-
----
-
-## 3. Cấu trúc thư mục
-
-PINE-AI-main/
-├─ backend/
-│ └─ ai/
-│ ├─ data/ # chứa CSV & JSON mẫu
-│ ├─ requirements.txt # các package Python
-│ └─ ... # code backend
-├─ frontend/ # code frontend
-├─ docker/
-│ ├─ Dockerfile
-│ ├─ docker-compose.yml
-│ ├─ start.ps1 # script PowerShell chạy MVP
-│ └─ .env # biến môi trường
-└─ README.md
-
-yaml
-Copy code
-
----
-
-## 4. Setup môi trường
-
-### 4.1 Tạo file `.env`
-
-Trong thư mục `docker`, tạo file `.env` với nội dung:
-
-```dotenv
-# Google API key
-GOOGLE_API_KEY=your_api_key_here
-
-# In real-time logs
-PYTHONUNBUFFERED=1
-
-4.2 Cài Docker Compose & Docker Desktop
-Docker Desktop mới đã bao gồm Docker Compose v2, nên không cần cài thêm.
-
-Đảm bảo Docker Desktop đang chạy trước khi build container.
-
-5. Cách chạy MVP
-5.1 Chạy bằng script PowerShell (recommended)
-Mở PowerShell, vào thư mục docker:
-
-powershell
-Copy code
-cd C:\Users\Admin\Downloads\PINE-AI-main\docker
-Nếu PowerShell báo Execution Policy:
-
-powershell
-Copy code
-Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-Chạy script:
-
-powershell
-Copy code
-.\start.ps1
-Script sẽ:
-
-Build image Docker
-
-Start container
-
-Chờ server startup
-
-Mở trình duyệt tới http://localhost:8000
-
-5.2 Chạy trực tiếp bằng Docker Compose (nếu muốn xem log chi tiết)
-powershell
-Copy code
-docker-compose up --build
-Output sẽ hiện toàn bộ quá trình build và start container.
-
-Nếu cần dừng container:
-
-powershell
-Copy code
-docker-compose down
-6. Kiểm tra container
-Xem container đang chạy:
-
-powershell
-Copy code
-docker ps
-Xem log realtime:
-
-powershell
-Copy code
-docker logs -f pine-ai
-7. Truy cập web app
-Mở trình duyệt và vào:
-
-arduino
-Copy code
-http://localhost:8000
-Giao diện web app sẽ hiển thị các chức năng của MVP.
-
-Hệ thống đã load CSV và JSON mẫu, sẵn sàng demo.
-
-8. Notes
-Nếu gặp lỗi thiếu package, đảm bảo backend/ai/requirements.txt có đầy đủ:
-
-text
-Copy code
-fastapi>=0.95.0
-uvicorn[standard]>=0.22.0
-python-multipart>=0.0.6
-python-dotenv>=1.0.0
-google-genai>=0.0.1
-websockets>=11.0
-requests>=2.31.0
-aiofiles>=23.1.0
-httpx>=0.24.0
-pandas>=2.0.0
-.env phải nằm trong thư mục docker, không nằm ngoài.
-
-9. Liên hệ
-Mọi vấn đề liên quan tới chạy MVP có thể trao đổi trực tiếp với nhóm phát triển.
-
-Chúc Ban giám khảo trải nghiệm MVP PINE-AI thành công!
+PINE-AI MVP – Hugging Face Space (Docker)
+1. Giới thiệu
+
+PINE-AI là hệ thống AI hỗ trợ logic sales, xử lý dữ liệu khách hàng & gói cước, demo thông qua giao diện web.
+
+Repository này được cấu hình để chạy trực tiếp trên Hugging Face Spaces (Docker)
+👉 Ban giám khảo không cần cài Python, không cần Docker, chỉ cần mở link Space.
+
+2. Công nghệ sử dụng
+
+Backend: Python, FastAPI
+
+Frontend: Web UI (serve trực tiếp từ backend)
+
+AI / LLM: Google GenAI + VNPT AI (qua API key)
+
+Deployment: Hugging Face Spaces – Docker runtime
+
+3. Cấu trúc thư mục
+.
+├── Dockerfile              # Dockerfile cho Hugging Face (bắt buộc ở ROOT)
+├── backend/
+│   └── ai/
+│       ├── data/           # CSV / JSON mẫu
+│       ├── requirements.txt
+│       └── main.py         # FastAPI entrypoint
+├── frontend/               # Frontend source
+└── README.md
+
+
+⚠️ Lưu ý:
+
+Hugging Face chỉ đọc Dockerfile ở ROOT
+
+Không sử dụng docker-compose, start.ps1, hoặc .env trong Space
+
+4. Environment Variables & Secrets
+
+Toàn bộ API key và biến môi trường KHÔNG được commit vào repo,
+mà được cấu hình trong Hugging Face:
+
+Settings → Variables and secrets
+
+4.1 Variables (không nhạy cảm)
+Name	Value
+PYTHONUNBUFFERED	1
+PRECOMPUTE_DATA_DIR	/app/backend/precomputation/data
+4.2 Secrets (API keys)
+Name	Mô tả
+GOOGLE_API_KEY	Google GenAI API key
+VNPT_AI_API_KEY	VNPT AI API key
+VNPT_AI_ENDPOINT	Endpoint VNPT AI (nếu có)
+
+⚠️ Secrets không hiển thị trong code và logs.
+
+5. Cách Space hoạt động
+
+Khi Space được build:
+
+Hugging Face đọc Dockerfile
+
+Build image
+
+Inject Variables & Secrets
+
+Chạy backend FastAPI
+
+Public web app qua URL Space
+
+Không cần thao tác thủ công.
+
+6. Truy cập demo
+
+Sau khi Space ở trạng thái Running, mở trực tiếp link Space:
+
+👉 Web UI sẽ hiển thị ngay
+
+Hệ thống đã:
+
+Load dữ liệu mẫu
+
+Sẵn sàng demo logic AI & sales flow
+
+7. Troubleshooting
+Space không chạy / Config error
+
+Kiểm tra:
+
+Dockerfile có nằm ở ROOT không
+
+backend/ai có tồn tại đúng đường dẫn không
+
+Không có log
+
+Đợi 1–2 phút sau khi Restart Space
+
+Nếu vẫn trống → thường là Dockerfile không được detect
+
+8. Ghi chú cho Ban giám khảo
+
+Đây là MVP demo
+
+Tập trung vào:
+
+Kiến trúc AI Agent
+
+Flow xử lý dữ liệu & tư vấn sales
+
+Khả năng mở rộng & tích hợp thực tế
+
+9. Liên hệ
+
+Mọi câu hỏi liên quan đến hệ thống PINE-AI
+vui lòng liên hệ trực tiếp nhóm phát triển.