Upload 6 files

.gitignore

@@ -0,0 +1,48 @@
+# =========================
+# Python
+# =========================
+*.pyc
+__pycache__/
+*.pyo
+*.pyd
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# =========================
+# Virtual Environment
+# =========================
+.venv/
+venv/
+ENV/
+env/
+
+# =========================
+# Environment variables
+# =========================
+.env
+.env.*
+
+# =========================
+# Docker
+# =========================
+*.log
+docker-compose.override.yml
+*.pid
+*.sock
+
+# =========================
+# VSCode / IDE
+# =========================
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
+
+# =========================
+# Misc
+# =========================
+.DS_Store
+Thumbs.db

README.md

@@ -1,13 +1,137 @@
----
-title: PINE AI Amdocs
-emoji: 🐨
-colorFrom: red
-colorTo: purple
-sdk: docker
-pinned: false
-short_description: VNPT AIHackathon 2025
----
-<!-- force rebuild -->
-
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 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!

create_init.py

@@ -0,0 +1,26 @@
+import os
+
+# Danh sách folder cần tạo __init__.py
+folders_to_init = [
+    "backend",
+    "backend/ai",
+    "backend/ai/core",
+    "backend/ai/strategy",
+    "backend/ai/data",
+    "backend/config",
+    "backend/precomputation",
+    "backend/precomputation/logic",
+    "backend/precomputation/voice",
+    "backend/precomputation/data",
+]
+
+for folder in folders_to_init:
+    init_file = os.path.join(folder, "__init__.py")
+    if not os.path.exists(init_file):
+        with open(init_file, "w", encoding="utf-8") as f:
+            pass  # tạo file trống
+        print(f"Đã tạo: {init_file}")
+    else:
+        print(f"Đã tồn tại: {init_file}")
+
+print("\nHoàn tất tạo các file __init__.py")

docker-compose.yml

@@ -0,0 +1,15 @@
+services:
+  pine-ai:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+    container_name: pine-ai
+    ports:
+      - "8000:8000"   # map port host -> container
+    volumes:
+      - ../backend/ai/data:/app/backend/ai/data   # persist dữ liệu và output
+    env_file:
+      - .env   # load GOOGLE_API_KEY và các biến môi trường khác
+    environment:
+      PYTHONUNBUFFERED: "1"  # in real-time logs
+    restart: unless-stopped   # tự restart nếu container crash

start.ps1

@@ -0,0 +1,35 @@
+# start.ps1 - Script chạy Docker project và mở trình duyệt trên Windows
+
+# Chuyển tới thư mục hiện tại của script
+Set-Location -Path $PSScriptRoot
+
+# Kiểm tra Docker Desktop
+try {
+    docker info > $null 2>&1
+} catch {
+    Write-Error "Docker không chạy hoặc không kết nối được. Vui lòng mở Docker Desktop trước."
+    exit 1
+}
+
+# Build và chạy container
+Write-Host "Đang build và chạy container..."
+docker-compose up -d --build
+if ($LASTEXITCODE -ne 0) {
+    Write-Error "Docker Compose chạy thất bại. Kiểm tra log trên console."
+    exit 1
+}
+
+# Chờ server khởi động
+Write-Host "Đợi container khởi động..."
+Start-Sleep -Seconds 10
+
+# Kiểm tra logs xem server đã sẵn sàng chưa
+Write-Host "Hiển thị 5 dòng log cuối container:"
+docker logs --tail 5 pine-ai
+
+# Mở trình duyệt tới localhost:8000
+$url = "http://localhost:8000/"
+Write-Host "Mở trình duyệt tại $url"
+Start-Process $url
+
+Write-Host "Hoàn tất! Container đang chạy."