# 준비된 애플리케이션

세 가지 모두 완전한 애플리케이션이며 코드 조각이 아닙니다: 폼, 서버, 그림 및 API 응답입니다. 복제하여 `.env`에 키를 넣고 실행하세요. 코드는 MIT 라이선스이므로 조건 없이 자신의 제품에 사용할 수 있습니다.

세 가지 모두 동일한 방식으로 구성되어 있습니다: 프론트엔드에는 Vite를 사용하고, 호출은 Node의 작은 서버를 통해 이루어집니다. 브라우저는 API에 직접 접근할 수 없으므로 키는 서버에 존재하며 페이지에 노출되지 않습니다.

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

키는 [대시보드](https://api.astroway.info/dashboard/sign-up)에서 얻을 수 있습니다. 개발 중에는 샌드박스 `aw_test_*` 키를 사용하세요: 크레딧이 소모되지 않습니다.

## Human Design

입력으로 생년월일과 시간, 장소를 받아들이고, 출력으로 바디그래프와 분석을 제공합니다. `POST /v1/human-design` 한 번의 호출은 유형, 전략, 권위, 프로필, 정의, 현십자, 활성 게이트가 있는 9개 중심, 모든 정의된 채널, 두 세트 활성화를 반환합니다. 애플리케이션은 SVG로 바디그래프와 활성화 표를 그립니다. 읽기당 50 크레딧이므로 무료 플랜에서는 200번 읽을 수 있습니다.

<CardGrid>
  <LinkCard title="라이브 데모" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="GitHub 코드" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="Render에 배포" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## BaZi

네 개의 명주와 운의 주기. `POST /v1/bazi/chart`는 숨겨진 줄기, 음양, 12단계의 단계, 일주, 요소 균형, 설명이 포함된 힘 판단, 상징적인 별, 모든 결합 및 충돌 가지를 반환합니다. `POST /v1/bazi/luck-pillars`는 대운: 방향, 시작 나이, 10년 단위의 열 개 주기를 반환합니다. 두 호출은 병렬로 이루어지며, 읽기당 30 크레딧이 소요됩니다.

<CardGrid>
  <LinkCard title="라이브 데모" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="GitHub 코드" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="Render에 배포" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## 보고서 대시보드

연습용: 입력으로 고객 데이터를 받고, 출력으로 브랜드가 적용된 준비된 PDF를 제공합니다. `POST /v1/reports/<type>` 접두사 아래 16개 보고서가 있으며, 각각 `whitelabel` 블록을 받으므로 고객이 받는 파일은 우리 이름이 아닌 당신의 이름을 사용합니다. 15개 보고서는 5000 크레딧, 타로는 100 크레딧이 소요됩니다.

<CardGrid>
  <LinkCard title="라이브 데모" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="GitHub 코드" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="Render에 배포" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
데모는 주소로 제한되며 각자의 키를 사용하여 자신의 엔드포인트에만 접근할 수 있습니다. 보고서 대시보드 데모는 타로만 렌더링합니다. 왜냐하면 페이지가 공개 인터넷에 있어 5000 크레딟짜리 보고서를 생성하는 것은 두 번의 클릭으로 월간 무료 플랜을 소모하게 될 것이기 때문입니다. 당신의 복사본은 모든 16개를 렌더링합니다.
</Aside>

## 배포

Render 버튼은 리포지토리의 `render.yaml`을 읽습니다: 무료 플랜의 Node 웹 서비스 하나로 package.json의 스크립트로 빌드하고 시작합니다. Render를 생성할 때 API 키를 요구합니다. Node 22가 실행되는 모든 호스팅도 동일하게 적용됩니다: 빌드, 실행, 키 설정.