# Gotowe aplikacje

Każdy z trzech to działająca aplikacja, a nie fragment kodu: formularz, serwer, rysunek i odpowiedź API. Sklonuj, umieść klucz w `.env`, uruchom. Kod na licencji MIT, więc możesz go wziąć do swojego produktu bez warunków.

Wszystkie trzy są zbudowane w ten sam sposób: Vite na frontendzie i mały serwer na Node.js, przez który przechodzą wywołania. Przeglądarka nie może bezpośrednio uzyskać dostępu do API, więc klucz przechowywany jest na serwerze i nie trafia na stronę.

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

Klucz otrzymasz w [dashboardzie](https://api.astroway.info/dashboard/sign-up). Podczas budowania używaj piaskowego `aw_test_*`: nie zużywa kredytów.

## Human Design

Data, czas i miejsce urodzenia na wejściu, bodygraph i analiza na wyjściu. Jeden wywołanie `POST /v1/human-design` zwraca typ, strategię, autorytet, profil, definicję, krzyż wcielenia, dziewięć centrów z aktywnymi bramami, wszystkie zdefiniowane kanały i oba zestawy aktywacji. Aplikacja rysuje bodygraph w formacie SVG i tabelę aktywacji. 50 kredytów za odczyt, czyli 200 odczytów na darmowym planie.

<CardGrid>
  <LinkCard title="Żywe demo" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="Kod na GitHub" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="Wdróż na Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## BaZi

Cztery słupy losu i cykl szczęścia. `POST /v1/bazi/chart` zwraca słupy z ukrytymi łodygami, na yin i fazę dwunastu etapów, pana dnia, równowagę żywiołów, werdykt siły z wyjaśnieniem, gwiazdy symboliczne i wszystkie połączenia oraz kolizje gałęzi. `POST /v1/bazi/luck-pillars` zwraca Da Yun: kierunek, wiek rozpoczęcia i dziesięć słupów po dziesięć lat. Oba wywołania są wykonywane równolegle, 30 kredytów za odczyt.

<CardGrid>
  <LinkCard title="Żywe demo" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="Kod na GitHub" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="Wdróż na Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## Kabinet raportów

Dla praktyki: dane klienta na wejściu, gotowy PDF z Twoją marką na wyjściu. Szesnaście raportów pod jednym prefiksem `POST /v1/reports/<type>`, każdy przyjmuje blok `whitelabel`, więc plik, który otrzymuje klient, nosi Twoje imię, a nie nasze. Piętnaście raportów kosztuje 5000 kredytów, tarot 100.

<CardGrid>
  <LinkCard title="Żywe demo" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="Kod na GitHub" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="Wdróż na Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
Demo są ograniczone adresowo i działają na własnych kluczach z dostępem tylko do swoich endpointów. Demo kabinetu raportów renderuje tylko tarot, ponieważ strona w otwartym internecie, co sprawiłoby, że raport za 5000 kredytów dla każdego wyczerpałby miesięczny darmowy plan po dwóch kliknięciach. Twoja kopia renderuje wszystkie szesnaście.
</Aside>

## Wdrożenie

Przycisk Render odczytuje `render.yaml` w repozytorium: jeden serwis webowy na Node.js na darmowym planie, który jest budowany i uruchamiany skryptami z package.json. Podczas tworzenia Render poprosi o klucz API. Każdy hosting, na którym działa Node 22, nadaje się tak samo: zbudować, uruchomić, ustawić klucz.