📬 Příjem a zpracování rezervací přes SuperSaaS API

---

📝 Popis projektu

Tento projekt slouží k příjmu rezervací z webového formuláře a jejich automatickému vytvoření v rozvrhu SuperSaaS.
Zároveň odesílá e-mail s přehledem rezervace vybraným příjemcům.

Skript je připraven pro nasazení na Google Cloud Functions. Při běžném provozu nevypisuje nic, ale při chybě nebo při ladění zobrazí užitečné zprávy. Využívá environmentální proměnné pro zabezpečení přístupu.

---

💻 Funkce

1. Zpracování POST požadavku – Načtení a validace dat o rezervaci.
2. Vytvoření rezervace v SuperSaaS – Pomocí API, včetně pole pro název a místo akce.
3. Odeslání e-mailu s podrobnostmi – Na základě dat z rezervace.
4. Bezpečné ladění – Pomocí log() funkce, která vypisuje jen při chybě nebo DEBUG=true.

---

🚀 Jak použít

1. Nahraj funkci do Google Cloud Functions jako handle_booking_request.py.

2. V prostředí nastav následující proměnné:

   API_KEY=...
   FTP_USER=...
   SMTP_SERVER=...
   SMTP_PORT=465
   SMTP_USER=...
   SMTP_PASSWORD=...
   EMAIL_RECIPIENTS=prvni@email.cz,druhy@email.cz
   

3. Funkce očekává POST požadavek ve formátu JSON s těmito poli:

   {
     "start": "2025-04-01T18:00",
     "finish": "2025-04-01T20:00",
     "full_name": "Jan Novák",
     "email": "jan@email.cz",
     "mobile": "123456789",
     "field_1": "Zlín",
     "field_2": "Fire show",
     "field_1_r": "venku",
     "field_2_r": "light"
   }

4. Po úspěšném vytvoření rezervace vrací JSON odpověď a odešle e-mail.

---

🛠️ Použité technologie

• Python 3
• Google Cloud Functions
• SuperSaaS API
• Requests
• SMTP (smtplib)

---

📂 Struktura projektu

.
├── handle_booking_request.py  # Hlavní skript s funkcí
├── requirements.txt           # Požadované balíčky
└── README.md                  # Tato dokumentace

---

💡 Vylepšení do budoucna

• Zpětný e-mail i pro klienta.
• Přidání validace e-mailu a mobilu.
• Ukládání rezervací do Google Sheets nebo Firestore.

---

📜 Licence

Projekt je pod licencí MIT.

---

🤝 Spolupráce

Uvítám nápady na rozšíření nebo upozornění na chyby. Skript je součástí širšího systému pro plánování a rezervace vystoupení.

📬 Bezpečně, automaticky a jednoduše – tak má vypadat online rezervace.