58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# 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.
|