# Έτοιμες εφαρμογές

Κάθε ένα από τα τρία είναι μια λειτουργική εφαρμογή, όχι ένα απόσπασμα κώδικα: φόρμα, διακομιστής, σχέδιο και απάντηση API. Κλωνοποίησε, βάλε το κλειδί στο `.env`, εκκίνησε. Ο κώδικας είναι υπό MIT, οπότε μπορείς να τον χρησιμοποιήσεις στο προϊόν σου χωρίς όρους.

Και τα τρία είναι δομημένα με τον ίδιο τρόπο: Vite στο frontend και ένας μικρός διακομιστής σε 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

Ημερομηνία, ώρα και τόπος γέννησης στην είσοδο, bodygraph και ανάλυση στην έξοδο. Μία κλήση `POST /v1/human-design` επιστρέφει τον τύπο, τη στρατηγική, την αρχή, το προφίλ, τον ορισμό, τον σταυρό ενσάρκωσης, τα εννέα κέντρα με ενεργές πύλες, όλα τα καθορισμένα κανάλια και τα δύο σύνολα ενεργοποιήσεων. Η εφαρμογή σχεδιάζει το bodygraph σε SVG και έναν πίνακα ενεργοποιήσεων. 50 πιστώσεις ανά ανάγνωση, δηλαδή 200 αναγνώσεις στο δωρεάν πρόγραμμα.

<CardGrid>
  <LinkCard title="Ζωντανό demo" 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` επιστρέφει τους πυλώνες με κρυφά στελέχη, σε yin και τη φάση των δώδεκα σταδίων, τον κύριο της ημέρας, την ισορροπία των στοιχείων, την ετυμηγορία της δύναμης με επεξήγηση, τα συμβολικά αστέρια και όλους τους συνδυασμούς και τις συγκρούσεις των κλάδων. Το `POST /v1/bazi/luck-pillars` επιστρέφει το Da Yun: κατεύθυνση, ηλικία έναρξης και δέκα πυλώνες των δέκα ετών. Και οι δύο κλήσεις εκτελούνται παράλληλα, 30 πιστώσεις ανά ανάγνωση.

<CardGrid>
  <LinkCard title="Ζωντανό demo" 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 με το brand σου στην έξοδο. Δεκαέξι αναφορές υπό ένα πρόθεμα `POST /v1/reports/<type>`, κάθε μία δέχεται ένα μπλοκ `whitelabel`, οπότε το αρχείο που λαμβάνει ο πελάτης φέρει το όνομά σου, όχι το δικό μας. Δεκαπέντε αναφορές κοστίζουν 5000 πιστώσεις, το ταρώ 100.

<CardGrid>
  <LinkCard title="Ζωντανό demo" 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>
Τα demo περιορίζονται ανά διεύθυνση και χρησιμοποιούν τα δικά τους κλειδιά με πρόσβαση μόνο στα δικά τους endpoints. Το demo του γραφείου αναφορών αποδίδει μόνο ταρώ, γιατί μια σελίδα στο ανοιχτό διαδίκτυο που δημιουργεί μια αναφορά 5000 πιστώσεων για τον καθένα, θα εξαντλούσε το μηνιαίο δωρεάν πρόγραμμα σε δύο κλικ. Το δικό σου αντίγραφο αποδίδει και τις δεκαέξι.
</Aside>

## Ανάπτυξη

Το κουμπί Render διαβάζει το `render.yaml` στο αποθετήριο: μια υπηρεσία web σε Node σε δωρεάν πρόγραμμα, η οποία δημιουργείται και εκκινείται με scripts από το package.json. Κατά τη δημιουργία, το Render θα ζητήσει ένα κλειδί API. Οποιοδήποτε hosting όπου λειτουργεί το Node 22 είναι εξίσου κατάλληλο: δημιούργησε, εκκίνησε, όρισε το κλειδί.