Hướng Dẫn Vận Hành & Triển Khai Portfolio

---

1. Chạy Thử Tại Máy Tính Cá Nhân (Local Development)

Portfolio sử dụng HTML, CSS và JavaScript thuần nên có thể chạy trực tiếp bằng bất kỳ máy chủ cục bộ nào:

# Cách 1: Sử dụng Python HTTP Server có sẵn
python -m http.server 8000

# Cách 2: Sử dụng công cụ npx serve
npx serve .

# Mở trình duyệt truy cập: http://localhost:8000

Để chạy thử trang tài liệu VitePress này:

# Di chuyển vào thư mục docs
cd docs

# Cài đặt thư viện VitePress
npm install

# Khởi chạy máy chủ tài liệu cục bộ
npm run docs:dev
# Mở trình duyệt truy cập: http://localhost:5173

---

2. Triển Khai Lên Cloudflare Pages

Bước 1: Kết nối Kho chứa GitHub

1. Truy cập Cloudflare Dashboard > chọn Workers & Pages.
2. Chọn Create application > Pages > Connect to Git.
3. Chọn kho chứa GitHub portfolio-stella.

Bước 2: Thiết lập Cấu hình Build

• Framework preset: None
• Build command: Để trống
• Build output directory: / (Thư mục gốc của repository)

Bước 3: Tạo & Gắn KV Namespace

1. Vào Workers & Pages > KV > Bấm Create a namespace.
2. Đặt tên namespace là: PORTFOLIO_KV.
3. Quay lại ứng dụng Pages vừa tạo > Chọn tab Settings > Functions.
4. Kéo xuống mục KV namespace bindings > Bấm Add binding:
   • Variable name: PORTFOLIO_KV
   • KV namespace: Chọn PORTFOLIO_KV vừa tạo.

Bước 4: Thiết lập Mã PIN Admin

1. Trong tab Settings của ứng dụng Pages > Chọn Environment variables.
2. Bấm Add variable:
   • Variable name: CF_ADMIN_PIN
   • Value: Điền mã PIN bí mật của bạn (Ví dụ: stella2026).
3. Bấm Save và thực hiện Retry deployment. Website đã sẵn sàng!