README

Package Laravel untuk mengintegrasikan chatbot AI Minara, sistem Live Chat Handover ke admin, dan RAG Knowledge Base ke website Laravel mana saja secara plug-and-play.

Fitur

🤖 Minara AI Widget: Chatbot cerdas berbasis AI yang siap membantu pengunjung website 24/7.
👨‍💼 Human-in-the-Loop (Live Chat): Fitur oper alih percakapan dari AI ke Admin secara real-time menggunakan WebSocket.
📚 RAG Knowledge Base: Latih AI Minara dengan mengunggah dokumen (PDF, TXT, Excel, Docx) langsung dari dashboard.
🔍 Dataset Viewer: Pantau teks yang berhasil diekstraksi dan dipelajari oleh AI dari dokumen yang diunggah.
📝 Advanced Chat Logs: Rekaman riwayat obrolan yang terpisah antara interaksi AI dan Admin dengan filter rentang tanggal.
🔍 Dataset Viewer: Pantau konten teks yang berhasil diekstraksi dan dipelajari oleh AI.
📝 Advanced Chat Logs: Riwayat percakapan lengkap yang dipisahkan antara interaksi AI dan Admin.
🎨 UI Isolation: Menggunakan pre-compiled CSS sehingga tampilan chatbot tetap konsisten tanpa merusak desain website asli klien (tidak memerlukan Tailwind di aplikasi utama).---

Persyaratan

PHP ^8.1
Laravel ^10.0 | ^11.0 | ^12.0
Database MySQL / PostgreSQL / SQLite

Instalasi

1. Install via Composer

composer require aranus-tech/chatbot

2. Jalankan perintah install

Perintah ini menerbitkan file konfigurasi (config/chatbot.php) dan aset CSS/ikon ke folder public/vendor/chatbot:

php artisan chatbot:install

3. Jalankan migrasi

Package secara otomatis mendaftarkan 2 tabel yang dibutuhkan:

php artisan migrate

Konfigurasi

1. Environment variables (`.env`)

Tambahkan variabel berikut ke file .env project Anda:

# WebSocket AI dan Admin
CHATBOT_WS_URL="wss://aranus-aranus-chatbot-plugin.hf.space/ws/chat"
CHATBOT_ADMIN_WS_URL="wss://aranus-aranus-chatbot-plugin.hf.space/ws/admin"

# Endpoint upload dokumen ke AI server
CHATBOT_UPLOAD_URL="https://aranus-aranus-chatbot-plugin.hf.space/upload"

# Email yang menerima notifikasi saat pengunjung minta Live Chat
ADMIN_NOTIFICATION_EMAIL="admin@example.com"

2. Konfigurasi dashboard (`config/chatbot.php`)

Setelah chatbot:install, edit config/chatbot.php agar sesuai dengan struktur aplikasi Anda:

return [
    // Nama layout Blade utama aplikasi Anda
    // Halaman dashboard chatbot akan di-extend dari layout ini
    'layout' => 'layouts.app',

    // Prefix URL untuk semua halaman dashboard chatbot
    // Contoh: 'dashboard' -> /dashboard/chatlog, /dashboard/live-chat, dst.
    'prefix' => 'dashboard',

    // Middleware yang melindungi halaman dashboard chatbot
    'middleware' => ['web', 'auth'],
];

Penggunaan

Widget Chatbot (Frontend)

Tambahkan baris berikut ke layout utama website Anda (misalnya resources/views/layouts/app.blade.php):

<head>
    {{-- CSS widget chatbot --}}
    <link rel="stylesheet" href="{{ asset('vendor/chatbot/chatbot-ui.css') }}">
</head>

<body>
    {{-- Konten website Anda --}}

    {{-- Widget chatbot — letakkan sebelum </body> --}}
    @chatbot
</body>

Widget akan muncul sebagai tombol mengambang di pojok kanan bawah halaman.

Dashboard Admin

Package mendaftarkan rute dashboard secara otomatis berdasarkan prefix dan middleware di config/chatbot.php.

Tambahkan tautan berikut ke sidebar navigasi admin Anda:

<a href="{{ route('chatbot.index') }}">Chat Log</a>
<a href="{{ route('chatbot.livechat') }}">Live Chat</a>
<a href="{{ route('chatbot.kb') }}">Knowledge Base</a>
<a href="{{ route('chatbot.kb.dataset') }}">Dataset</a>

Daftar lengkap named routes:

Route Name	Method	URL (default prefix: `dashboard`)	Deskripsi
`chatbot.index`	GET	`/dashboard/chatlog`	Riwayat percakapan AI & Admin
`chatbot.livechat`	GET	`/dashboard/live-chat`	Dashboard Live Chat admin
`chatbot.kb`	GET	`/dashboard/knowledge-base`	Upload & kelola dokumen AI
`chatbot.kb.upload`	POST	`/dashboard/knowledge-base/upload`	Upload dokumen
`chatbot.kb.sync`	POST	`/dashboard/knowledge-base/sync`	Sinkronisasi ulang ke AI server
`chatbot.kb.toggle`	POST	`/dashboard/knowledge-base/toggle/{id}`	Aktifkan/nonaktifkan dokumen
`chatbot.kb.destroy`	DELETE	`/dashboard/knowledge-base/{id}`	Hapus dokumen
`chatbot.kb.dataset`	GET	`/dashboard/knowledge-base/dataset`	Lihat teks hasil ekstraksi

Endpoint API publik (digunakan oleh widget secara internal):

Route Name	Method	URL	Deskripsi
`chatbot.store`	POST	`/aranus-chatbot/store-chat`	Simpan percakapan AI
`chatbot.store.admin`	POST	`/aranus-chatbot/store-admin-chat`	Simpan percakapan admin
`chatbot.notify.handover`	POST	`/aranus-chatbot/notify-admin-handover`	Kirim email notifikasi handover
`chatbot.popular`	GET	`/aranus-chatbot/popular-questions`	Ambil pertanyaan populer

Kustomisasi Tampilan

Jika ingin mengubah tampilan halaman dashboard, publish view-nya terlebih dahulu:

php artisan vendor:publish --tag=chatbot-views

File view akan disalin ke resources/views/vendor/chatbot/. Setelah itu Anda bisa mengedit bebas tanpa mempengaruhi package aslinya.

Struktur Tabel Database

`chat_records`

Kolom	Tipe	Keterangan
`id`	bigint	Primary key
`session_code`	string	Kode sesi unik pengunjung
`type`	enum('ai','admin')	Jenis percakapan
`client_message`	text	Pesan dari pengunjung
`ai_message`	text	Balasan dari AI (nullable)
`admin_message`	longtext	JSON array percakapan admin (nullable)
`waktu`	datetime	Waktu percakapan

`knowledge_documents`

Kolom	Tipe	Keterangan
`id`	bigint	Primary key
`title`	string	Judul dokumen
`original_name`	string	Nama file asli
`filename`	string	Nama file tersimpan
`file_path`	string	Path di storage
`file_size`	bigint	Ukuran file (bytes)
`file_type`	string	Ekstensi file
`content`	longtext	Teks hasil ekstraksi AI (nullable)
`status`	enum('active','inactive')	Status aktif/nonaktif
`sync_status`	enum('pending','synced','failed')	Status sinkronisasi ke AI server
`uploaded_by`	string	Nama admin yang upload

Publish Aset Secara Manual

Jika perlu menerbitkan aset secara terpisah:

# Konfigurasi
php artisan vendor:publish --tag=chatbot-config

# Aset CSS & ikon (wajib untuk widget)
php artisan vendor:publish --tag=chatbot-assets

# View (opsional, untuk kustomisasi tampilan)
php artisan vendor:publish --tag=chatbot-views

aranus-tech/chatbot

包简介

README 文档

README

Fitur

Persyaratan

Instalasi

1. Install via Composer

2. Jalankan perintah install

3. Jalankan migrasi

Konfigurasi

1. Environment variables (`.env`)

2. Konfigurasi dashboard (`config/chatbot.php`)

Penggunaan

Widget Chatbot (Frontend)

Dashboard Admin

Kustomisasi Tampilan

Struktur Tabel Database

`chat_records`

`knowledge_documents`

Publish Aset Secara Manual

统计信息

GitHub 信息

其他信息

承接程序开发

aranus-tech/chatbot

包简介

README 文档

README

Fitur

Persyaratan

Instalasi

1. Install via Composer

2. Jalankan perintah install

3. Jalankan migrasi

Konfigurasi

1. Environment variables (.env)

2. Konfigurasi dashboard (config/chatbot.php)

Penggunaan

Widget Chatbot (Frontend)

Dashboard Admin

Kustomisasi Tampilan

Struktur Tabel Database

chat_records

knowledge_documents

Publish Aset Secara Manual

统计信息

GitHub 信息

其他信息

承接程序开发

1. Environment variables (`.env`)

2. Konfigurasi dashboard (`config/chatbot.php`)

`chat_records`

`knowledge_documents`