HƯỚNG DẪN CÀI ĐẶT VÀ CHẠY DỰ ÁN

Yêu cầu hệ thống

• Windows 10/11 (hoặc ubuntu 22 LTS nhưng cần điểu chỉnh lệnh cài phù hợp với linux)
• Python 3.11+
• Node.js 18+
• PostgreSQL 18
• Visual Studio 2022 (cần C++ support để build pgvector)
• Git

---

PHẦN 1: Cài đặt PostgreSQL + PGVector

Bước 1.1: Tạo database

Mở Command Prompt hoặc PowerShell, chạy:

"C:\Program Files\PostgreSQL\18\bin\psql.exe" -U postgres

Nhập password PostgreSQL, sau đó chạy:

CREATE DATABASE capstone_db;
\q

Bước 1.2: Cài đặt PGVector

1. Mở Start Menu, tìm "x64 Native Tools Command Prompt for VS 2022"
2. Click chuột phải, chọn "Run as administrator"
3. Trong cửa sổ command prompt, chạy:

cd D:\CapstoneProject\ai
install_pgvector.bat

Chờ script chạy xong (khoảng 1-2 phút).

Bước 1.3: Kích hoạt extension

Mở PowerShell hoặc Command Prompt thường (không cần admin), chạy:

cd D:\CapstoneProject\ai
enable_vector.bat

Lưu ý: Nếu password PostgreSQL của bạn khác "123456", mở file enable_vector.bat và sửa dòng set PGPASSWORD=123456 thành password của bạn.

---

PHẦN 2: Cài đặt và chạy Backend

Bước 2.1: Tạo môi trường ảo Python

Mở PowerShell trong thư mục project:

cd D:\CapstoneProject\backend
python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt

Bước 2.2: Tạo file cấu hình .env

Tạo file .env trong thư mục backend/ với nội dung:

# Database
DATABASE_URL=postgresql://postgres:123456@localhost:5432/capstone_db

# JWT Secret - thay đổi chuỗi này
SECRET_KEY=thay-doi-chuoi-nay-thanh-chuoi-bat-ky-dai-hon

# API Keys (điền key của bạn)
MISTRAL_API_KEY=
OPENAI_API_KEY=

# Google OAuth (tùy chọn)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

Thay 123456 bằng password PostgreSQL của bạn.

Bước 2.3: Chạy Backend

cd D:\CapstoneProject\backend
.\venv\Scripts\activate
python run.py

Backend sẽ chạy tại: http://localhost:8000

Để dừng server: nhấn Ctrl+C

---

PHẦN 3: Cài đặt và chạy Frontend

Bước 3.1: Cài đặt dependencies

Mở PowerShell mới (giữ terminal backend chạy):

cd D:\CapstoneProject\frontend
npm install

Bước 3.2: Chạy Frontend

npm run dev

Frontend sẽ chạy tại: http://localhost:3000