# Ứng dụng sẵn có

Mỗi trong ba ứng dụng này là một ứng dụng hoàn chỉnh, không phải đoạn mã: form, server, bản vẽ và phản hồi API. Clone, đặt khóa vào `.env`, và chạy. Code được cấp phép theo MIT, vì vậy bạn có thể lấy nó vào sản phẩm của mình mà không có điều kiện.

Cả ba đều được thiết kế giống nhau: Vite ở phía frontend và một máy chủ nhỏ trên Node.js, nơi các cuộc gọi được thực hiện. Trình duyệt không thể truy cập API trực tiếp, vì vậy khóa được lưu trên máy chủ và không xuất hiện trên trang.

```bash
git clone https://github.com/astroway/starter-human-design
cd starter-human-design && npm install
cp .env.example .env     # ваш ключ сюди
npm run dev
```

Bạn sẽ nhận được khóa trong [dashboard](https://api.astroway.info/dashboard/sign-up). Trong khi xây dựng, hãy dùng sandbox `aw_test_*`: nó không tiêu thụ tín dụng.

## Human Design

Ngày, giờ và địa điểm sinh vào đầu vào, bodygraph và phân tích ở đầu ra. Một cuộc gọi `POST /v1/human-design` trả về loại, chiến lược, thẩm quyền, hồ sơ, định nghĩa, thập tự hiện thân, chín trung tâm với cổng hoạt động, tất cả các kênh được định nghĩa và cả hai bộ kích hoạt. Ứng dụng vẽ bodygraph trên SVG và bảng kích hoạt. 50 tín dụng cho mỗi lần đọc, tức là 200 lần đọc trên gói miễn phí.

<CardGrid>
  <LinkCard title="Demo trực tiếp" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="Mã trên GitHub" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="Triển khai trên Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## BaZi

Bốn trụ mệnh và chu kỳ may mắn. `POST /v1/bazi/chart` trả về các trụ với cẩn ẩn, Âm/Dương và giai đoạn mười hai, chủ nhật, cân bằng ngũ hành, phán xét sức mạnh với giải thích, sao tượng trưng và tất cả các kết hợp và xung đột nhánh. `POST /v1/bazi/luck-pillars` trả về Đại Vận: hướng, tuổi bắt đầu và mười trụ mỗi mười năm. Cả hai cuộc gọi được thực hiện song song, 30 tín dụng cho mỗi lần đọc.

<CardGrid>
  <LinkCard title="Demo trực tiếp" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="Mã trên GitHub" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="Triển khai trên Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## Báo cáo

Dành cho thực hành: dữ liệu khách hàng vào đầu vào, PDF hoàn chỉnh với thương hiệu của bạn ở đầu ra. Mười sáu báo cáo dưới một tiền tố `POST /v1/reports/<type>`, mỗi báo cáo chấp nhận khối `whitelabel`, vì vậy tệp mà khách hàng nhận được mang tên của bạn, không phải của chúng tôi. Mười lăm báo cáo giá 5000 tín dụng, tarot 100.

<CardGrid>
  <LinkCard title="Demo trực tiếp" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="Mã trên GitHub" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="Triển khai trên Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
Các demo bị giới hạn theo địa chỉ và sử dụng khóa riêng với quyền truy cập chỉ vào các endpoint của chúng. Demo báo cáo chỉ hiển thị tarot, vì trang này trên internet công khai, việc tạo báo cáo giá 5000 tín dụng cho mỗi người sẽ tiêu tốn gói miễn phí hàng tháng chỉ sau hai cú nhấp chuột. Bản sao của bạn sẽ hiển thị tất cả mười sáu.
</Aside>

## Triển khai

Nút Render đọc `render.yaml` trong kho: một dịch vụ web Node trên gói miễn phí, được biên dịch và khởi chạy bằng các script từ package.json. Khi tạo Render, hệ thống sẽ yêu cầu khóa API. Bất kỳ hosting nào chạy Node 22 cũng phù hợp tương tự: biên dịch, chạy, đặt khóa.