# Fertige Anwendungen

Jede der drei ist eine funktionierende Anwendung, kein Code-Fragment: Formular, Server, Grafik und API-Antwort. Klone sie, lege den Schlüssel in die `.env` und starte sie. Der Code steht unter MIT, du kannst ihn also bedingungslos in dein Produkt übernehmen.

Alle drei sind gleich aufgebaut: Vite im Frontend und ein kleiner Node-Server, über den die Aufrufe laufen. Der Browser kann die API nicht direkt aufrufen, daher befindet sich der Schlüssel auf dem Server und gelangt nicht auf die Seite.

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

Den Schlüssel erhältst du im [Dashboard](https://api.astroway.info/dashboard/sign-up). Während du entwickelst, verwende den Sandbox-Schlüssel `aw_test_*`: Er verbraucht keine Credits.

## Human Design

Geburtsdatum, -zeit und -ort als Eingabe, Bodygraph und Analyse als Ausgabe. Ein einziger `POST /v1/human-design`-Aufruf liefert Typ, Strategie, Autorität, Profil, Definition, Inkarnationskreuz, neun Zentren mit aktiven Toren, alle definierten Kanäle und beide Aktivierungssätze. Die Anwendung zeichnet den Bodygraph als SVG und die Aktivierungstabelle. 50 Credits pro Lesung, d.h. 200 Lesungen im kostenlosen Tarif.

<CardGrid>
  <LinkCard title="Live-Demo" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="Code auf GitHub" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="Auf Render bereitstellen" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## BaZi

Die vier Säulen des Schicksals und der Glückszyklus. `POST /v1/bazi/chart` liefert die Säulen mit verborgenen Himmelsstämmen, Yin und die Phase der zwölf Stufen, den Tagesmeister, das Elementegleichgewicht, das Stärkeverdikt mit Erklärung, symbolische Sterne und alle Kombinationen und Kollisionen der Erdzweige. `POST /v1/bazi/luck-pillars` liefert Da Yun: Richtung, Startalter und zehn Säulen zu je zehn Jahren. Beide Aufrufe erfolgen parallel, 30 Credits pro Lesung.

<CardGrid>
  <LinkCard title="Live-Demo" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="Code auf GitHub" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="Auf Render bereitstellen" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## Berichts-Dashboard

Für Praktiker: Kundendaten als Eingabe, fertiges PDF mit deinem Branding als Ausgabe. Sechzehn Berichte unter einem Präfix `POST /v1/reports/<type>`, jeder akzeptiert einen `whitelabel`-Block, sodass die Datei, die der Kunde erhält, deinen Namen trägt und nicht unseren. Fünfzehn Berichte kosten 5000 Credits, Tarot 100.

<CardGrid>
  <LinkCard title="Live-Demo" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="Code auf GitHub" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="Auf Render bereitstellen" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
Die Demos sind adressbeschränkt und verwenden eigene Schlüssel mit Zugriff nur auf ihre jeweiligen Endpunkte. Die Demo des Berichts-Dashboards rendert nur Tarot, da eine öffentlich zugängliche Seite, die jedem einen Bericht für 5000 Credits erstellt, den monatlichen kostenlosen Tarif mit zwei Klicks aufbrauchen würde. Deine Kopie rendert alle sechzehn.
</Aside>

## Bereitstellung

Der Render-Button liest die `render.yaml` im Repository: ein Node-Webservice im kostenlosen Plan, der mit Skripten aus der `package.json` gebaut und gestartet wird. Bei der Erstellung fragt Render nach dem API-Schlüssel. Jeder Hosting-Anbieter, auf dem Node 22 läuft, ist gleichermaßen geeignet: bauen, starten, Schlüssel festlegen.