Hỗ trợ cài đặt và xử lý các lỗi liên quan đến source trong phạm vi chức năng gốc.

Thời gian phản hồi dự kiến: 24–48 giờ trong ngày làm việc.

Hỗ trợ qua email hoặc kênh liên hệ được cung cấp tại gian hàng.

Không bao gồm phát triển tính năng mới, chỉnh sửa giao diện hoặc tùy chỉnh riêng theo yêu cầu. Các yêu cầu phát triển thêm sẽ được báo giá riêng.

HƯỚNG DẪN CÀI ĐẶT HANZIFLOW

1. YÊU CẦU

- Node.js 20+ khuyến nghị
- npm
- Tài khoản Supabase
- Tài khoản Google AI Studio nếu sử dụng tính năng AI
- Tài khoản Resend nếu sử dụng chức năng gửi email
- Tài khoản Vercel nếu muốn deploy online

2. CÀI ĐẶT SOURCE

- Giải nén file HanziFlow-v1.0.0.zip.
- Mở Terminal tại thư mục HanziFlow.
- Cài đặt các package:

npm install

3. CẤU HÌNH ENVIRONMENT

- Sao chép file .env.example thành .env.local.
- Mở .env.local và điền các thông tin cấu hình cần thiết:

DATABASE_URL=
DIRECT_URL=
JWT_SECRET=
RESEND_API_KEY=
EMAIL_FROM=
GEMINI_API_KEY=
NEXT_PUBLIC_APP_URL=

Không sử dụng API key hoặc thông tin tài khoản của người khác.

4. CẤU HÌNH DATABASE

- Tạo một project PostgreSQL trên Supabase.
- Lấy DATABASE_URL và DIRECT_URL từ Supabase.
- Điền vào file .env.local.

Sau đó chạy:

npx prisma db push

Tiếp theo chạy dữ liệu mẫu:

npx prisma db seed

Sau khi seed hoàn tất, terminal sẽ hiển thị thông tin tài khoản demo và mật khẩu được tạo.

5. CHẠY WEBSITE LOCAL

Chạy:

npm run dev

Sau đó mở địa chỉ được hiển thị trong Terminal để kiểm tra website.

6. TÀI KHOẢN DEMO

Sau khi chạy:

npx prisma db seed

Hệ thống sẽ tạo tài khoản học viên và tài khoản quản trị mẫu.

Thông tin mật khẩu demo được sinh tự động và hiển thị trực tiếp trong Terminal.

7. CẤU HÌNH AI VÀ EMAIL

Để sử dụng đầy đủ các chức năng AI, nhập GEMINI_API_KEY vào .env.local.

Để sử dụng chức năng xác thực email, nhập RESEND_API_KEY và EMAIL_FROM.

Các dịch vụ bên thứ ba có thể yêu cầu người mua tự tạo tài khoản và API key riêng.

8. CẤU HÌNH THANH TOÁN

Nếu sử dụng chức năng nâng cấp gói Pro, mở:

src/app/upgrade/page.tsx

và thay các giá trị placeholder:

YOUR_RECEIVER_NAME
YOUR_BANK_ACCOUNT
YOUR_PHONE

Đồng thời thay ảnh QR mặc định bằng QR của người mua nếu cần.

9. DEPLOY LÊN VERCEL

- Đưa source lên GitHub Private Repository.
- Kết nối repository với Vercel.
- Thêm toàn bộ Environment Variables vào Vercel.
- Deploy project.
- Sau khi deploy thành công, cập nhật NEXT_PUBLIC_APP_URL bằng domain thực tế.

10. LƯU Ý

- Không upload file .env hoặc .env.local lên GitHub.
- Không chia sẻ API key, password hoặc secret.
- Người mua cần tự tạo tài khoản Supabase, Google AI Studio, Resend và Vercel của mình.
- Source được cung cấp theo điều khoản License đi kèm sản phẩm.