Platform Modern untuk Menemukan, Menganalisis, dan Menghubungi Bisnis Lokal Sebagai Objek Penelitian & Skripsi Berbasis AI
Research Prospect Finder adalah aplikasi Web UI yang dirancang khusus untuk membantu mahasiswa, akademisi, dan peneliti menemukan tempat studi kasus penelitian/skripsi yang potensial dari bisnis lokal di Indonesia.
Aplikasi ini mengintegrasikan data geospasial terbuka (OpenStreetMap), algoritma penilaian kelayakan riset, audit otomatis kehadiran digital (Website & Media Sosial), serta generator pesan komunikasi (outreach) bertenaga AI yang 100% berbahasa Indonesia.
- Cari ribuan bisnis lokal berdasarkan nama kota, kecamatan, atau alamat spesifik.
- Atur radius pencarian (1 – 25 km) dan filter kategori bisnis (Food & Dining, Retail, Technology, Health, Automotive, Services).
- Sistem Deduplikasi Cerdas untuk mencegah penyimpanan data ganda.
Algoritma komprehensif untuk menilai kesiapan bisnis menjadi subjek tugas akhir/skripsi:
- Ukuran Bisnis (25%): Usaha lokal independen mendapat bobot prioritas lebih tinggi dibanding franchise.
- Kompleksitas Operasional (30%): Menilai tingkat kompleksitas alur kerja (inventori, pesanan, layanan).
- Kesenjangan Digitalisasi (25%): Keberadaan website, formulir order, atau e-commerce.
- Ketersediaan Kontak (20%): Kemudahan menghubungi pemilik (WhatsApp/telepon dan email).
Didukung oleh LLM (Google Gemini / OmniRoute / OpenAI-compatible):
⚠️ Identifikasi Masalah Operasional: Analisis potensi bottleneck proses bisnis.- 💡 Peluang Solusi Sistem Informasi: Rekomendasi solusi digital (POS, ERP mini, CRM, booking web).
- 🎓 Relevansi Riset: Alasan akademis mengapa bisnis layak diteliti.
- 📌 5 Rekomendasi Judul Skripsi: Format judul formal sesuai standar perguruan tinggi di Indonesia.
- ❓ Daftar Pertanyaan Wawancara: Panduan validasi lapangan untuk pemilik usaha.
- Ekstraksi otomatis nomor WhatsApp, telepon, dan email dari situs resmi bisnis.
- Deteksi tautan profil Instagram, Facebook, LinkedIn, TikTok, dan WhatsApp.
- Menyusun draf pesan permohonan riset skripsi massal yang dibuat khusus secara dinamis per bisnis.
- Pilihan Channel:
- 💬 WhatsApp / DM Medsos: Format santun, ringkas, dan nyaman dibaca di smartphone.
- ✉️ Email Resmi: Format surat resmi proposal izin penelitian skripsi.
- Batasan Kustom (Custom Batch Limit): Atur jumlah pesan yang ingin di-generate (1 s.d. 25+ bisnis per batch).
- 💬 Chat WhatsApp (
wa.me): Langsung membuka chat WhatsApp pemilik bisnis dengan pesan pembuka otomatis. - 📍 Buka Google Maps: Membuka profil bisnis asli di Google Maps untuk melihat foto, jam buka, dan ulasan pengunjung.
- Paginasi Cepat: Navigasi lancar untuk ribuan data dengan pilihan 50, 100, 250, 500, hingga 1.000 data per halaman.
- Filter Tag Interaktif: Filter khusus bisnis yang memiliki WhatsApp, Website, Email, Media Sosial, atau yang sudah dianalisis AI.
- Sorting Header: Klik judul kolom untuk mengurutkan berdasarkan ID, Nama (A-Z), Kategori, Rating, atau Skor Riset.
- Antarmuka responsif dengan skema warna ramah mata dan tombol pengubah tema gelap/terang.
- Unduh data prospek riset ke format CSV (Excel / Google Sheets), Markdown (.md), atau JSON.
- Python 3.10 atau versi yang lebih baru.
- Virtual Environment (direkomendasikan).
git clone <repository_url>
cd research-finderpython3 -m venv .venv
source .venv/bin/activate # Linux / macOS
# .venv\Scripts\activate # Windowspip install -e .Salin template konfigurasi .env.example ke file .env:
cp .env.example .envBuka file .env dan sesuaikan parameter berikut:
# Database SQLite
RF_DATABASE_URL=sqlite+aiosqlite:///data/research_finder.db
# Konfigurasi AI (OmniRoute / Gemini / OpenAI)
RF_AI_ENABLED=true
RF_AI_API_KEY=your_api_key_here
RF_AI_BASE_URL=http://localhost:20128/v1 # atau https://generativelanguage.googleapis.com/v1beta/openai
RF_AI_MODEL=auto/gemini # atau antigravity/gemini-2.5-flash, gpt-4o-miniTip
Jika Anda menggunakan OmniRoute Lokal, pastikan Base URL mengarah ke endpoint /v1 (misal: http://localhost:20128/v1).
Cukup jalankan satu perintah berikut di terminal:
research-finderAplikasi Web server FastAPI akan menyala dan otomatis membuka browser ke:
http://127.0.0.1:8000
- Ganti port:
research-finder --port 8080 - Akses jaringan lokal:
research-finder --host 0.0.0.0 - Mode tanpa membuka browser:
research-finder --no-browser - Mode auto-reload (development):
research-finder --reload
research-finder/
├── data/ # Database SQLite lokal (dibuat otomatis)
├── src/
│ └── research_finder/
│ ├── application/ # Use cases, ranking service, dan AI orchestration
│ ├── cli/ # Entrypoint CLI dan runner aplikasi
│ ├── config/ # Pengaturan Pydantic Settings (.env)
│ ├── database/ # Model SQLAlchemy & repositori database
│ ├── domain/ # Domain entities & data models
│ ├── providers/ # Integrasi OpenStreetMap, AI, dan Website Analyzer
│ └── web/ # FastAPI backend & Static Frontend (HTML, CSS, JS)
│ ├── static/
│ │ ├── css/style.css
│ │ ├── js/app.js
│ │ └── index.html
│ ├── app.py
│ └── server.py
├── .env.example # Template konfigurasi environment
├── .gitignore # Aturan ignore file git
├── pyproject.toml # Konfigurasi package & dependencies
└── README.md # Dokumentasi proyek
Proyek ini dilisensikan di bawah lisensi MIT License.