# WhyPik

> Public product documentation for WhyPik storefronts and Cloud Platform.

Documentation version: 2026-10-14.10. Language: Vietnamese (vi).
Use the linked article for its current scope, requirements and limitations.
This index contains only public product documentation; no runbooks or customer data.

- [Documentation](https://whypik.com/docs)
- [Machine-readable article index](https://whypik.com/docs/index.json)

## Bắt đầu

- [Bắt đầu với WhyPik](https://whypik.com/docs/first-start.md): Tạo một dự án chung, xem tổng quan rồi chọn cửa hàng theo mẫu hoặc bật các dịch vụ cần dùng.
- [Tạo, chọn, chỉnh sửa và xóa dự án](https://whypik.com/docs/project-management.md): Một tổng quan chung cho cửa hàng theo mẫu, Authentication, Database, Hosting và Storage; hiểu rõ liên kết và phạm vi xóa.
- [Bật xác thực hai bước cho tài khoản WhyPik](https://whypik.com/docs/account-mfa.md): Bảo vệ tài khoản quản lý bằng ứng dụng xác thực, lưu mã khôi phục và đăng nhập khi đã bật MFA.
- [Quota và nâng cấp](https://whypik.com/docs/plans.md): Phân biệt quota theo gói với giới hạn thử nghiệm của Auth.
- [Thử mua và gia hạn gói trả trước](https://whypik.com/docs/prepaid-sandbox.md): Dành cho đợt thử Sandbox được WhyPik hướng dẫn; chưa mở thu tiền thật.
- [Bắt đầu Database](https://whypik.com/docs/database-start.md): Tạo bảng, đưa dữ liệu vào rồi cấp đúng quyền cho ứng dụng.
- [First Start: tích hợp Angular](https://whypik.com/docs/angular-first-start.md): Làm từng bước với một ứng dụng Angular chạy phía trình duyệt. Đường nhanh dùng memory session; bản chạy trên WhyPik Hosting có thể dùng cookie cùng origin.
- [Tìm và đọc tài liệu WhyPik](https://whypik.com/docs/using-docs.md): Chọn đúng nhóm hướng dẫn, tìm theo việc muốn làm và chia sẻ nội dung công khai với công cụ hỗ trợ.

## Người dùng

- [Đăng nhập, mật khẩu và email](https://whypik.com/docs/customer-account.md): Dành cho người mua hoặc người sử dụng cửa hàng. Không cần hiểu API hay code.
- [Đơn hàng, quyền sử dụng và tải phần mềm](https://whypik.com/docs/customer-orders.md): Tìm lại phần mềm đã mua, xem thời hạn và xử lý khi chưa có quyền sử dụng.

## Chủ cửa hàng

- [Mở cửa hàng theo mẫu](https://whypik.com/docs/shop-first-start.md): Chọn một trong 10 mẫu, chỉnh nội dung khởi đầu và chuẩn bị danh mục phù hợp với cửa hàng.
- [Mở cửa hàng Spa](https://whypik.com/docs/shop-spa.md): Chọn mẫu Spa & chăm sóc, thêm nhóm, liệu trình, sản phẩm và kênh liên hệ.
- [Thiết kế, nội dung và bản phát hành](https://whypik.com/docs/shop-content.md): Chỉnh đúng khu vực đang hiển thị cho khách; giữ trang gọn và dễ đọc.
- [Quản lý bán hàng và hỗ trợ](https://whypik.com/docs/shop-operations.md): Dùng tổng quan để biết việc cần làm, rồi mở đúng mục để xử lý.
- [Đưa website lên Static Hosting](https://whypik.com/docs/hosting.md): Dành cho website đã build sẵn. Hosting không chạy backend tùy ý.
- [Dùng tên miền riêng và HTTPS](https://whypik.com/docs/hosting-domains.md): Thêm tên miền, xác minh quyền sở hữu rồi chờ hệ thống tự bật HTTPS.
- [Storage cửa hàng và Object Storage](https://whypik.com/docs/storage.md): Chọn đúng kho file, hiểu quyền tải và cách hai mục dùng chung dung lượng tài khoản.
- [Chọn mẫu theo ngành](https://whypik.com/docs/shop-templates.md): Tạo một cửa hàng có nội dung sẵn, sửa dịch vụ, ảnh và từng khu vực theo thương hiệu.
- [Tên miền, tạm ngừng bán và xóa cửa hàng](https://whypik.com/docs/shop-settings.md): Quản lý địa chỉ trong Cài đặt cửa hàng. Tạm ngừng nhận đơn mà vẫn phục vụ khách đã mua, hoặc xóa cửa hàng chưa có giao dịch.

## Lập trình viên

- [Đọc tình trạng dịch vụ trong Project](https://whypik.com/docs/service-status.md): Xem lỗi gần đây, độ trễ Data API, hàng chờ và dung lượng; phân biệt số liệu Project với hạn mức tài khoản.
- [Nhập JSON, SQL và dữ liệu có sẵn](https://whypik.com/docs/database-import.md): Luồng tự phục vụ: xuất từ nền tảng cũ → xem trước cấu trúc → tạo bảng → nhập dữ liệu → cấu hình quyền.
- [Tham chiếu cấu trúc bảng](https://whypik.com/docs/schema-reference.md): Schema JSON là hợp đồng giới hạn rõ ràng, không phải SQL tùy ý.
- [Quản trị viên và quyền dữ liệu dùng chung](https://whypik.com/docs/database-permissions.md): Bảng mới chỉ Admin truy cập. Cấp quyền cho người dùng bằng bộ quy tắc liên kết nhiều bảng, chọn riêng dòng và cột.
- [Cài SDK và chọn đúng loại](https://whypik.com/docs/sdk-install.md): SDK JavaScript/TypeScript cho Auth + Data; Python cho licensing và cập nhật phần mềm.
- [Auth SDK: đăng ký, phiên và khôi phục](https://whypik.com/docs/auth-reference.md): Danh tính nằm riêng trong từng Project; tài khoản WhyPik dashboard không phải tài khoản của ứng dụng.
- [Đăng nhập từ hệ thống có sẵn](https://whypik.com/docs/auth-custom-token.md): Đổi danh tính đã xác minh ở backend của bạn sang phiên WhyPik; không yêu cầu nhập lại mật khẩu vào WhyPik.
- [Data API: chọn cột, lọc và phân trang](https://whypik.com/docs/data-queries.md): Truy vấn có giới hạn và quyền theo từng bảng/cột/dòng. Cú pháp gần Django nhưng dùng object JavaScript.
- [Quan hệ: include và lọc qua bảng liên kết](https://whypik.com/docs/data-relations.md): Join theo foreign key đã khai báo. Không nhận raw JOIN SQL hoặc nối bảng tùy ý.
- [Thêm, sửa, xóa bằng SDK](https://whypik.com/docs/data-writes.md): Một request ghi được giới hạn và có transaction; không tự retry khi chưa biết kết quả.
- [REST Data API](https://whypik.com/docs/data-rest.md): Dùng cho ngôn ngữ chưa có SDK. Endpoint public vẫn kiểm tra key, user token và policy.
- [Node, SSR và BFF](https://whypik.com/docs/node-sdk.md): Tách secret backend và phiên từng người dùng. Node 24+ cho entry server.
- [Lỗi, timeout và chẩn đoán SDK](https://whypik.com/docs/sdk-errors.md): Dựa vào mã lỗi và request_id; không đưa password, token hoặc payload riêng tư vào log.
- [REST quản lý Database và import](https://whypik.com/docs/management-api.md): Dành cho backend/CLI của chủ Project, tách khỏi runtime Data API của người dùng ứng dụng.
- [API mẫu cửa hàng và danh mục dịch vụ, sản phẩm](https://whypik.com/docs/store-template-api.md): Phiên chủ cửa hàng, snapshot có phiên bản và ảnh; phân biệt với Project Auth và Data SDK.
- [API Hosting, Storage và Project](https://whypik.com/docs/cloud-api.md): API quản lý dùng key tài khoản wpc_, chỉ đặt ở backend hoặc công cụ riêng của bạn.
- [CI/CD với GitHub, GitLab và Bitbucket](https://whypik.com/docs/cicd.md): Sinh pipeline từ whypik.toml để build Hosting hoặc triển khai Mini Server bằng khóa riêng của tài nguyên.
- [Python SDK: license và cập nhật phần mềm](https://whypik.com/docs/python-sdk.md): SDK Python hiện phục vụ licensing v2 và cập nhật có chữ ký; chưa có Python Auth/Data SDK.
- [Backup, khôi phục và lịch sử Database](https://whypik.com/docs/database-recovery.md): Kiểm tra trạng thái bản sao trước khi thực hiện thay đổi có thể mất dữ liệu.
- [Bắt đầu với Mini Server](https://whypik.com/docs/mini-server.md): Viết API Python, chạy thử trên máy và triển khai tại /api của dự án.
- [Variables và môi trường local](https://whypik.com/docs/mini-server-variables.md): Cấu hình theo backend, bí mật mã hóa và cách dùng cùng os.environ trên máy riêng.
- [Thư viện Python có sẵn](https://whypik.com/docs/mini-server-libraries.md): Phiên bản runtime, bộ thư viện được cài sẵn và cài cùng phiên bản trên máy local.
- [Mini Server: API và SDK Python](https://whypik.com/docs/mini-server-sdk.md): Handler, danh tính request.user, Admin Database theo Project, truy vấn và kết quả chưa xác định.
- [Gọi HTTPS và dịch vụ bên ngoài](https://whypik.com/docs/mini-server-https.md): Gọi API AI, gửi email qua API và tải dữ liệu bằng HTTPS trong Mini Server.
- [Admin SDK: Database của Project](https://whypik.com/docs/data-admin.md): Python và Node có toàn quyền dữ liệu, cấu trúc Database trong Project; client SDK tiếp tục áp dụng policy người dùng.
- [Bắt đầu với Database Migration](https://whypik.com/docs/data-migrations.md): Khai báo cấu trúc trong Git, thử với Database local, xem kế hoạch rồi áp dụng vào đúng Project hosted.
- [Migration: hợp đồng, baseline và phục hồi](https://whypik.com/docs/data-migrations-reference.md): Tra cứu file, lệnh, quyền, rủi ro, nhánh Git, SDK, CI và cách xử lý kết quả chưa xác định.
- [API Storage cửa hàng: tải tiếp theo phần](https://whypik.com/docs/store-storage-api.md): Tải file độc lập vào cửa hàng, tiếp tục sau mất mạng và kiểm tra trạng thái quét.

## Quản trị

- [First Start: quản trị WhyPik](https://whypik.com/docs/admin-first-start.md): Đăng nhập an toàn, tìm đúng tài khoản và xử lý công việc đang chờ.
- [Hàng đợi, lỗi và lịch sử thao tác](https://whypik.com/docs/admin-queues.md): Biết ai làm gì, việc nào đang kẹt và bước tiếp theo.
- [Tài khoản, gói và dịch vụ của khách](https://whypik.com/docs/admin-accounts.md): Kiểm tra đúng account, quota và trạng thái dịch vụ trước khi hỗ trợ.
- [Quyền quản trị và thông tin nhạy cảm](https://whypik.com/docs/admin-security.md): Chỉ truy cập và thay đổi những gì công việc hỗ trợ yêu cầu.
- [Quản lý Mini Server](https://whypik.com/docs/mini-server-admin.md): Xem phiên bản, tác vụ lỗi, mức dùng và runtime chưa dọn xong.