# 完成アプリ

3つすべてが動くアプリで、コードの断片ではないよ：フォーム、サーバー、図、そして API のレスポンス。クローンして、キーを `.env` に入れて、起動してね。コードは MIT ライセンスだから、条件なしで自分のプロダクトに使っていいよ。

3つはすべて同じ構成だよ：フロントエンドは Vite、Node の小さなサーバーが1つあって、そこ経由で呼び出しが行われる。ブラウザは 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_*` を使ってね：クレジットは消費しないんだ。

## ヒューマンデザイン

入力は生年月日・時間・出生地、出力はボディグラフと解析だよ。`POST /v1/human-design` の呼び出し一つで、タイプ、戦略、権威、プロファイル、定義、インカーネーション・クロス、アクティブなゲートを持つ9つのセンター、すべての定義されたチャネル、そして2つのアクティベーションセットが返ってくる。アプリは SVG でボディグラフを描画し、アクティベーション表を表示する。1回のリーディングは 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` は、隠れたステムを持つ柱、陰陽と十二段階のフェーズ、日の支配者、エレメントのバランス、説明付きの力の判定、シンボリックな星、そしてすべての枝の組み合わせと衝突を返す。`POST /v1/bazi/luck-pillars` は大運（ダーユン）を返す：方向、開始年齢、そして10年ごとの10本の柱。両方の呼び出しは同時に行われ、1回のリーディングは 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 クレジットのレポートを各ユーザーに作成したら、無料プランの月間クレジットを2回のクリックで使い切っちゃうからね。君のコピーは全部の 16 件をレンダリングできるよ。
</Aside>

## デプロイ

Render ボタンはリポジトリの `render.yaml` を読み込むんだ：無料プランの Node ウェブサービスが1つで、package.json のスクリプトでビルド＆スタートする。Render を作成するときに API キーを求められるよ。Node 22 が動くホスティングならどこでも同じで、ビルドして起動し、キーを設定すれば OK だよ。
