MuhammadLutfiMuzakiiVY/SYSTEM-SERVICE-SPI: sPI Engine menggunakan arsitektur Modular Plugin-based Event

Arsitektur Bot WhatsApp Multi-Device Generasi Terbaru Berbasis Node.js (ESM), Sistem Plugin Modular, Integrasi Multi-AI, dan Ekosistem RPG/Store Digital.

⚡ Fitur Utama • 📐 Arsitektur • 🚀 Instalasi • ⚙️ Konfigurasi • 🧩 Developer Guide • 👤 Pengembang

📖 Ringkasan Proyek

SYSTEM SERVICE SPI (v2.4.0) adalah platform dan engine otomatisasi WhatsApp Multi-Device yang dibangun menggunakan Node.js (EcmaScript Module / ESM) dan pustaka WhatsApp socket teroptimasi. Didesain untuk keandalan tinggi, performa cepat, serta skalabilitas tinggi baik untuk penggunaan pribadi, komunitas grup, maupun kebutuhan bisnis komersial.

[!TIP] SPI Engine menggunakan arsitektur Modular Plugin-based Event Dispatcher, memudahkan penambahan fitur baru tanpa perlu mengubah struktur kode inti (core runtime).

📐 Diagram Arsitektur

Berikut adalah gambaran aliran eksekusi pesan dan pemrosesan event pada SYSTEM SERVICE SPI:

flowchart TD
    A["📱 WhatsApp Web / App"] <-->|"Baileys WebSocket Connection"| B["🔌 SPI Core Socket Gateway"]
    B --> C["🛡️ Middleware & Protection Layer"]
    C -->|"Cek Anti-Spam / Anti-Link / Banned"| D["🧩 Plugin Event Router"]

    D -->|"Match Prefix & Command"| E1["🧠 AI Processing Engine<br/>(OpenRouter & Smart AI)"]
    D -->|"Match Prefix & Command"| E2["🎮 RPG & Economy System<br/>(Coins, XP, Energy, Level)"]
    D -->|"Match Prefix & Command"| E3["🛒 E-Commerce & Store Engine<br/>(Order, Stok, Pakasir OTP)"]
    D -->|"Match Prefix & Command"| E4["🖼️ Media & Canvas Generator<br/>(FFmpeg / Skia-Canvas)"]

    E1 --> F[("💾 Local JSON Database / Storage")]
    E2 --> F
    E3 --> F
    E4 --> F

    F --> G["💬 Responsive Message Dispatcher"]
    G -->|"Send Text / Media / Buttons"| A

⚡ Fitur Utama & Kapabilitas Sistem

⚙️ Persyaratan Sistem

🚀 Panduan Instalasi

1. Cloning Repositori

Buka terminal pada komputer atau server Anda dan jalankan perintah berikut:

git clone https://github.com/MuhammadLutfiMuzakiiVY/SYSTEM-SERVICE-SPI.git
cd SYSTEM-SERVICE-SPI

2. Instalasi Dependensi Node.js

Pasang pustaka modul yang dibutuhkan:

npm install

3. Pengaturan Konfigurasi (config.js)

Edit file config.js untuk mengonfigurasi nomor WhatsApp Anda sebagai owner dan bot pairing:

    owner: {
        name: 'Muhammad Lutfi Muzaki',   // Nama Pemilik Bot
        number: ['6282362181059']        // Nomor Owner (Format 628xxx)
    },
    session: {
        pairingNumber: '6282362181059',  // Nomor WhatsApp Bot
        usePairingCode: true             // true = Gunakan Kode Pairing
    },
    bot: {
        name: '𝗦𝗜 𝗣𝗔𝗟𝗜𝗡𝗚 𝗜𝗡𝗙𝗢𝗥𝗠𝗔𝗦𝗜 (𝗦𝗣𝗜)',
        version: '2.4.0',
        developer: 'Muhammad Lutfi Muzaki'
    }

4. Menjalankan Server Engine SPI

Jalankan perintah berikut untuk mengaktifkan bot:

npm start

# Modus Pengembangan (Auto-Restart via Nodemon)
npm run dev

Saat pertama kali berjalan, sistem akan memberikan Kode Pairing 8 Digit di terminal. Masukkan kode tersebut pada aplikasi WhatsApp Anda:

WhatsApp -> Perangkat Tertaut -> Tautkan dengan Nomor Telepon

🐳 Deploy Menggunakan Docker (Opsional)

Untuk kemudahan deployment di VPS server tanpa menginstall Node.js secara manual:

# Build Docker Image
docker build -t system-service-spi .

# Jalankan Container
docker run -d --name spi-bot-instance --restart always system-service-spi

🐧 Deploy di Android Termux (Opsional)

Untuk pengguna Android yang menjalankan bot lewat Termux:

pkg update && pkg upgrade -y
pkg install git nodejs-lts ffmpeg -y
git clone https://github.com/MuhammadLutfiMuzakiiVY/SYSTEM-SERVICE-SPI.git
cd SYSTEM-SERVICE-SPI
bash install.sh
npm start

🧩 Panduan Pengembangan Plugin (Developer Guide)

Setiap fitur pada SYSTEM SERVICE SPI menggunakan arsitektur Plugin ESM. Anda dapat membuat file baru di dalam folder plugins/ dengan struktur seperti berikut:

// Contoh: plugins/example/halo.js

const pluginConfig = {
    name: 'halo',
    alias: ['hi', 'hello'],
    category: 'general',
    description: 'Menyapa pengguna secara ramah',
    usage: '.halo',
    example: '.halo',
    isOwner: false,
    isGroup: false,
    cooldown: 5,
    energi: 1
}

async function handler(m, { sock }) {
    await m.reply(`Halo *${m.pushName}*! 👋 Selamat datang di SYSTEM SERVICE SPI.`)
}

export { handler, pluginConfig }

📂 Struktur Direktori Proyek

SYSTEM-SERVICE-SPI/
├── assets/                  # Aset gambar, video, dan media bot
│   ├── images/              # Gambar banner, profile, dan thumbnail (spi.jpg, spi2.jpg)
│   └── video/               # Media video pendukung (spi.mp4)
├── database/                # Penyimpanan JSON lokal & statistik
├── plugins/                 # Folder Plugin Modular
│   ├── ai/                  # Plugin Integrasi AI (Gemini, Groq, OpenRouter)
│   ├── download/            # Plugin Downloader (TikTok, YouTube, IG, Spotify)
│   ├── fun/                 # Plugin Hiburan & Game
│   ├── group/               # Plugin Moderasi & Keamanan Grup
│   ├── main/                # Plugin Utama (Menu, Help, Info)
│   ├── owner/               # Plugin Khusus Owner Bot
│   ├── store/               # Plugin E-Commerce & Otomatisasi Produk
│   └── tools/               # Plugin Utility & Converter
├── src/                     # Core Library Engine SPI
│   ├── lib/                 # Core Helper System (spi-socket.js, spi-database.js, dll)
│   ├── scraper/             # Web Scrapers & API Integrations
│   ├── connection.js        # Konfigurasi Koneksi WebSocket
│   └── handler.js           # Event Handler & Dispatcher Utama
├── config.js                # File Konfigurasi Utama Bot
├── Dockerfile               # Konfigurasi Container Docker
├── index.js                 # Entry Point Aplikasi
├── package.json             # Manifest Dependensi & Scripts
└── README.md                # Dokumentasi Resmi Proyek

🤝 Kontribusi & Lisensi

Proyek ini bersifat Open Source di bawah lisensi MIT License.

Jika Anda ingin berpatisipasi mengembangkan fitur atau memperbaiki kendala (bug):

1. Fork repositori ini.
2. Buat branch fitur baru (git checkout -b fitur-baru).
3. Lakukan Commit perubahan Anda (git commit -m "Tambah fitur X").
4. Kirim Pull Request (PR).

👨‍💻 Developed & Maintained by

Muhammad Lutfi Muzaki

⭐ Jangan lupa memberikan Star pada repositori ini jika bermanfaat!