Update README.md

README.md

@@ -10,113 +10,122 @@ pinned: false
 # 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.  
+Phiên bản hiện tại có **3 tab chính**:  
 
-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.
+1. **Desktop Call** – giao diện voicebot trên desktop.  
+2. **Mobile Call** – giao diện voicebot trên điện thoại (logic backend giống desktop, chỉ khác UI).  
+3. **Dashboard** – giao diện quản lý, theo dõi hiệu quả AI Agent, xem CSAT metrics & feedback khách hàng.
 
-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.
+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 hay 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  
+- **Backend:** Python, FastAPI  
+- **Frontend:** HTML/JS 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
 ├── backend/
-│ └── ai/
-│ ├── data/
-│ ├── requirements.txt
-│ └── main.py
+│ ├── ai/
+│ │ ├── core/
+│ │ │ ├── init.py
+│ │ │ ├── analyze.py
+│ │ │ └── logic_flow.py
+│ │ ├── data/
+│ │ │ ├── data_engine.py
+│ │ │ ├── final_voice.scripts.json
+│ │ │ ├── product_collection.json
+│ │ │ └── test_customer.csv
+│ │ ├── strategy/
+│ │ │ ├── init.py
+│ │ │ ├── strategy_competitor.py
+│ │ │ ├── strategy_low_data.py
+│ │ │ └── strategy_network.py
+│ │ ├── main.py
+│ │ ├── services.py
+│ │ └── database.py
+│ └── requirements.txt
 ├── frontend/
-└── README.md
+│ ├── call_desktop.html
+│ ├── call_mobile.html
+│ └── dashboard.html
+├── README.md
+└── .gitignore
 
 ---
 
 ## 4. Environment Variables & Secrets
+Toàn bộ **API key không commit vào repo**, được cấu hình trong:  
 
-Toàn bộ API key **KHÔNG commit vào repo**, mà được cấu hình trong:
-
-**Settings → Variables and secrets**
+**Settings → Variables and secrets**  
 
 ### 4.1 Variables (không nhạy cảm)
-
 | Name | Value |
-|----|----|
+|------|-------|
 | GEMINI_MODEL_ID | gemini-3-flash-preview |
 | VNPT_BASE_URL | https://api.idg.vnpt.vn |
 | SMARTBOT_URL | https://assistant-stream.vnpt.vn/v1/conversation |
 
 ### 4.2 Secrets (API keys)
-
 | Name | Mô tả |
-|----|----|
+|------|-------|
 | GOOGLE_API_KEY | Google GenAI API key |
 | VNPT_AI_API_KEY | VNPT AI API key |
 | SMARTBOT_KEY | SMARTBOT_KEY |
 
-Secrets **không hiển thị trong code và logs**.
+> Secrets không hiển thị trong code hoặc logs.
 
 ---
 
 ## 5. Cách Space hoạt động
+Khi Space được build:  
 
-Khi Space được build:
+1. Hugging Face đọc `Dockerfile`  
+2. Build Docker image  
+3. Inject Variables & Secrets  
+4. Chạy **FastAPI backend**  
+5. Public web app qua URL Space  
 
-1. Hugging Face đọc `Dockerfile`
-2. Build Docker image
-3. Inject Variables & Secrets
-4. Chạy FastAPI backend
-5. Public web app qua URL Space
+Không cần thao tác thủ công.  
 
-Không cần thao tác thủ công.
+### 5.1 Truy cập các tab
+- `/desktop` → Desktop Call UI  
+- `/mobile` → Mobile Call UI  
+- `/dashboard` → Dashboard quản lý  
+
+Cả desktop & mobile **dùng chung backend**, chỉ khác giao diện frontend.
 
 ---
 
 ## 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
+- Sau khi Space ở trạng thái Running, mở trực tiếp link Space.  
+- Hệ thống sẽ load dữ liệu mẫu và sẵn sàng demo logic AI & sales flow.  
+- Dashboard đọc dữ liệu từ `database.py` và (tuỳ deploy) từ `feedback_data.csv` để hiển thị CSAT metrics.
 
 ---
 
 ## 7. Troubleshooting
-
-### Space báo Configuration error
-
-Kiểm tra:
-- README có **YAML header** không
-- `sdk: docker`
-- `app_file: Dockerfile`
-- Dockerfile nằm ở **ROOT**
-
-### Không có log
-
-- Đợi 1–2 phút sau khi Restart Space
-- Tránh restart liên tục
+Nếu Space báo **Configuration error**:  
+- Kiểm tra YAML header có đúng chưa (`sdk: docker`, `app_file: Dockerfile`)  
+- Dockerfile có nằm ở ROOT không  
+- Đợi 1–2 phút sau khi Restart Space  
+- Tránh restart liên tục  
 
 ---
 
 ## 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ế
+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.
+Mọi câu hỏi liên quan tới hệ thống **PINE-AI**, vui lòng liên hệ trực tiếp nhóm phát triển.