Files
bot/README.md

2.2 KiB

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:
    cd bot
    
  3. Instal semua dependensi:
    pip install -r requirements.txt
    

⚙️ Konfigurasi (.env)

Buat file .env (salin dari .env.example) dan isi variabel berikut:

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.
  • 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:

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.