feat: initial bot orchestrator with AI integration

README.md

@@ -0,0 +1,57 @@
+# Juaskill Bot - Platform Simulation Orchestrator
+
+Bot ini dirancang untuk mensimulasikan aktivitas nyata di platform Microjob (membuat akun, membuat layanan, dan melakukan transaksi) menggunakan data cerdas yang dihasilkan oleh AI (OpenRouter).
+
+## 🚀 Fitur Utama
+
+- **AI-Driven Data**: Menggunakan OpenRouter (Llama-3) untuk menghasilkan nama orang Indonesia, nama bisnis profesional, deskripsi, hingga ulasan yang realistis.
+- **Dynamic Location**: Menghasilkan koordinat (Lat/Lng) dan alamat acak di berbagai kota besar di Indonesia.
+- **Smart Simulation**: Meniru perilaku manusia dengan jeda waktu (*delay*) antar tindakan.
+- **Automated Transactions**: Melewati gerbang pembayaran (*skip payment*) untuk memudahkan simulasi internal.
+
+## 🛠️ Instalasi
+
+1. Pastikan Anda memiliki Python 3.8+ terinstal.
+2. Masuk ke direktori bot:
+   ```bash
+   cd bot
+   ```
+3. Instal semua dependensi:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+## ⚙️ Konfigurasi (.env)
+
+Buat file `.env` (salin dari `.env.example`) dan isi variabel berikut:
+
+```env
+OPENROUTER_API_KEY=your_key_here
+BOT_API_SECRET=your_backend_bot_secret
+BACKEND_URL=http://localhost:3001/api
+```
+
+- `OPENROUTER_API_KEY`: Kunci API Anda dari [OpenRouter](https://openrouter.ai/).
+- `BOT_API_SECRET`: Kunci rahasia yang harus sama dengan yang ada di `.env` backend Anda (untuk otentikasi API Bot).
+- `BACKEND_URL`: URL API backend Microjob Anda.
+
+## 🏁 Cara Menjalankan
+
+### Jalankan Simulasi Sekali (On-Demand)
+Untuk menjalankan satu siklus simulasi (Buat Akun -> Buat Jasa -> Order -> Selesai) secara instan:
+```bash
+python main.py
+```
+
+### Jalankan Sebagai Scheduler (Harian)
+Bot ini mendukung penjadwalan otomatis. Anda bisa mengaktifkan bagian `schedule` di dalam `main.py` agar bot berjalan otomatis setiap hari pada jam tertentu.
+
+## 📂 Struktur Folder
+
+- `main.py`: Orkestrator utama alur bisnis bot.
+- `ai_generator.py`: Modul untuk berinteraksi dengan OpenRouter AI.
+- `requirements.txt`: Daftar pustaka Python yang dibutuhkan.
+- `.env.example`: Contoh file konfigurasi lingkungan.
+
+## ⚠️ Catatan Keamanan
+Pastikan endpoint `/api/bot/*` di backend hanya dapat diakses menggunakan `BOT_API_SECRET` yang kuat untuk mencegah penyalahgunaan oleh pihak luar.