# Ετοιμες Ενταξεις — Γκαλερί

## Δέκα έτοιμα έργα για τυπικά σενάρια. Κάθε συνταγή είναι ένα αρχείο, χωρίς βήμα build. Βάλε το δικό σου κλειδί API → εκτέλεσε `npx tsx` ή `python` → λειτουργεί.

Όλες οι παρακάτω συνταγές είναι copy-paste-έτοιμες: κλειδί μέσω `X-Api-Key` header, αιτήματα μέσω standard `fetch` ή `requests`. Το SDK για TypeScript / Python σχεδιάζεται — προς το παρόν αυτό αρκεί.

## Τι υπάρχει στη γκαλερί

| # | Συνταγή | Στρωματοποίηση | Περίπτωση χρήσης |
|---|---|---|---|
| 1 | Ημερήσιο горόσκοπο μέσω SMS | Twilio + Node.js | Cron που στέλνει τον ημερήσιο горόσκοπο στους χρήστες μέσω SMS |
| 2 | Bot του Discord `/chart` | discord.js | Η εντολή slash — οποιοσδήποτε στο chat δημιουργεί ένα natal chart |
| 3 | OpenAI function-calling | openai + Node.js | Το GPT κάνει μόνος του αιτήματα για charts μέσω κλήσης εργαλείου |
| 4 | Bot του Slack `/synastry` | @slack/bolt | Η εντολή γραφείου ελέγχει τη συμβατότητα με μία γραμμή |
| 5 | Εμπλουτισμός Notion | @notionhq/client | Ημερομηνία γέννησης στη βάση δεδομένων → πλήρες natal αυτόματα |
| 6 | Cache του Cloudflare Worker | CF Workers KV | Edge-cache ταυτόσημων αιτημάτων για 30 ημέρες |
| 7 | Εργαλεία MCP του Claude | @astroway/mcp | Το Claude Desktop / Code καλεί το API σαν native εργαλείο |
| 8 | Εξαγωγή прогнόζου σε CSV | Python + pandas | Πρόβλεψη 12 μηνών → CSV για BI / Tableau |
| 9 | UI διόρθωσης χρόνου στη Streamlit | Python + Streamlit | Διαδραστικό UI για διόρθωση του χρόνου γέννησης |
| 10 | Υπηρεσία συμβατότητας στο FastAPI | Python + FastAPI | HTTP υπηρεσία για dating apps: 2 charts → score |

## Πώς να το χρησιμοποιήσεις

1. Αντέγραψε το ανάλογο αρχείο στον δικό σου κώδικα.
2. Εγκατέστησε τις εξαρτήσεις από την επικεφαλίδα του αρχείου (`npm install ...` ή `pip install ...`).
3. Ρύθμισε τις μεταβλητές περιβάλλοντος (τουλάχιστον `ASTROWAY_API_KEY`).
4. Εκτέλεσε.

## Πρότυπα στη γκαλερί

- **Μονόκλιτη script** (1, 5, 8) — batch επεξεργασία σε στυλ cron.
- **Long-lived bot** (2, 4) — μόνιμη σύνδεση, ακούει τις εντολές slash.
- **HTTP υπηρεσία** (10) — drop-in REST σύμφωνα με την δικιά σου εξουσιοδότηση.
- **Edge function** (6) — layer cache μεταξύ πελάτη και API.
- **Ενσωμάτωση εργαλείων LLM** (3, 7) — έκθεση των endpoints σαν λειτουργίες για AI.
- **UI** (9) — διαδραστικά front-end.

## Δεν καλύφθηκε ακόμα

Αν το σενάριο σου δεν υπάρχει στη λίστα (π.χ.: Telegram bot, n8n workflow, Zapier action, ενσωματωμένο widget στον ιστότοπο) — **στείλε ένα μήνυμα στο [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** με την περιγραφή σου. Προσθέτουμε συνταγές βάσει πραγματικών αιτημάτων, δεν μαντεύουμε.