# Applications prêtes

Chacun des trois est une application fonctionnelle et non un fragment de code : un formulaire, un serveur, un dessin et une réponse API. Clonez, placez la clé dans `.env`, lancez. Le code est sous licence MIT, donc vous pouvez l'intégrer dans votre produit sans conditions.

Les trois sont structurés de la même manière : Vite pour le frontend et un petit serveur Node.js par lequel passent les appels. Le navigateur ne peut pas accéder directement à l'API, donc la clé reste sur le serveur et n'apparaît pas sur la page.

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

Vous obtiendrez la clé dans le [tableau de bord](https://api.astroway.info/dashboard/sign-up). Pendant le développement, utilisez la clé de test `aw_test_*` : elle ne consomme pas de crédits.

## Human Design

Date, heure et lieu de naissance en entrée, corps graphique et analyse en sortie. Un appel `POST /v1/human-design` renvoie le type, la stratégie, l'autorité, le profil, la définition, la croix d'incarnation, les neuf centres avec portes actives, tous les canaux définis et les deux ensembles d'activations. L'application dessine le corps graphique en SVG et un tableau d'activations. 50 crédits par lecture, soit 200 lectures sur le tarif gratuit.

<CardGrid>
  <LinkCard title="Démo en direct" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="Code sur GitHub" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="Déployer sur Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## BaZi

Quatre piliers du destin et cycle de chance. `POST /v1/bazi/chart` renvoie les piliers avec tiges cachées, yin et phase des douze étapes, maître du jour, équilibre des éléments, verdict de force avec explication, étoiles symboliques et toutes les combinaisons et collisions de branches. `POST /v1/bazi/luck-pillars` renvoie Da Yun : direction, âge de début et dix piliers de dix ans. Les deux appels s'exécutent en parallèle, 30 crédits par lecture.

<CardGrid>
  <LinkCard title="Démo en direct" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="Code sur GitHub" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="Déployer sur Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## Cabinet des rapports

Pour la pratique : données client en entrée, PDF prêt avec votre marque en sortie. Seize rapports sous un même préfixe `POST /v1/reports/<type>`, chacun accepte un bloc `whitelabel`, donc le fichier que reçoit le client porte votre nom et non le nôtre. Quinze rapports coûtent 5000 crédits, le tarot 100.

<CardGrid>
  <LinkCard title="Démo en direct" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="Code sur GitHub" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="Déployer sur Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
Les démos sont limitées par adresse et utilisent leurs propres clés avec accès uniquement à leurs endpoints. La démo du rapport ne génère que le tarot, car la page est sur internet public, ce qui épuiserait le tarif mensuel gratuit en deux clics pour un rapport à 5000 crédits. Votre propre copie génère les seize rapports.
</Aside>

## Déploiement

Le bouton Render lit `render.yaml` dans le dépôt : un service web Node sur le plan gratuit, qui se construit et démarre avec les scripts de package.json. Lors de la création, Render demandera la clé API. Tout hébergement où Node 22 fonctionne de la même manière : construire, lancer, définir la clé.