# ConnectPreneur Documentation

> Live demo: [https://connectpreneur.id](https://connectpreneur.id/)

## Tentang Project

**ConnectPreneur** adalah program Digital Ecosystem yang diinisiasi oleh BOEMKraf. Platform ini bertujuan untuk:

* Menampilkan katalog mitra bisnis dengan berbagai peluang kemitraan
* Menghubungkan pelaku UMKM dengan calon mitra (reseller, agen, dropshipper, franchise, dll)
* Memperluas jangkauan bisnis anggota melalui program Business Matching internal

## Masalah yang Diselesaikan

1. **Fragmentasi Informasi** - Menyatukan informasi peluang kemitraan dalam satu platform terpusat
2. **Akses Terbatas** - Membuka akses informasi kemitraan ke puluhan ribu anggota BOEMKraf
3. **Proses Manual** - Digitalisasi proses pendaftaran dan verifikasi mitra bisnis
4. **Keterhubungan** - Memfasilitasi koneksi langsung antara pemilik bisnis dan calon mitra

## Flow Sistem (Business Perspective)

### Overview

ConnectPreneur menghubungkan tiga aktor utama: **Pemilik Bisnis** (UMKM), **Pengunjung** (calon mitra), dan **Admin** (pengelola platform dari BOEMKraf). Berikut alur sistem dari sisi bisnis:

```
┌─────────────────────────────────────────────────────────────────────┐
│                        CONNECTPRENEUR FLOW                         │
│                                                                     │
│  ┌──────────┐    Daftar     ┌──────────┐   Verifikasi  ┌────────┐  │
│  │ Pemilik  │──────────────▶│ Platform │◀──────────────│ Admin  │  │
│  │ Bisnis   │               │  (Web)   │               │ Panel  │  │
│  └──────────┘               └────┬─────┘               └────────┘  │
│                                  │                                  │
│                            Tampil di                                │
│                             Katalog                                 │
│                                  │                                  │
│                                  ▼                                  │
│                           ┌──────────┐                              │
│                           │Pengunjung│                              │
│                           │(Calon    │                              │
│                           │ Mitra)   │                              │
│                           └────┬─────┘                              │
│                                │                                    │
│                         Hubungi via                                 │
│                          WhatsApp                                   │
│                                │                                    │
│                                ▼                                    │
│                        ┌──────────────┐                             │
│                        │  Koneksi     │                             │
│                        │  Langsung    │                             │
│                        │  (Offline)   │                             │
│                        └──────────────┘                             │
└─────────────────────────────────────────────────────────────────────┘
```

{% stepper %}
{% step %}

#### Pendaftaran Bisnis (Self-Registration)

```
Pemilik Bisnis → Buka /daftar-mitra → Isi Form Multi-Tab → Submit
                                          │
                                          ├─ Info Dasar (nama, deskripsi, kategori)
                                          ├─ Detail (alamat, lokasi, link kemitraan)
                                          ├─ Kontak (PIC, WhatsApp, sosial media)
                                          ├─ Legalitas (Akta Pendirian, Legalitas PDF)
                                          └─ Gambar (logo, foto produk max 5)
                                          │
                                          ▼
                              Status: PENDING (is_active=false)
                              Bisnis belum tampil di katalog
```

* Pemilik bisnis mendaftar mandiri tanpa perlu akun
* Data yang disubmit mencakup profil bisnis lengkap termasuk dokumen legal
* Gambar otomatis dikompresi (\~100KB) untuk efisiensi storage
* Setelah submit, bisnis masuk antrian verifikasi
  {% endstep %}

{% step %}

#### Verifikasi oleh Admin

```
Admin Login → Dashboard → Lihat Daftar Pending → Review Data Bisnis
                                                        │
                                                  ┌─────┴─────┐
                                                  │           │
                                              Approve      Reject
                                                  │           │
                                                  ▼           ▼
                                          is_active=true   Ditolak/
                                          Tampil di        Dihapus
                                          Katalog
```

* Admin melakukan verifikasi kelengkapan & keabsahan data bisnis
* Akses admin dibatasi berdasarkan wilayah (Location-Based Access Control):

| Level Admin     | Cakupan Akses                                           |
| --------------- | ------------------------------------------------------- |
| Superadmin      | Seluruh bisnis tanpa batasan                            |
| Admin Kab/Kota  | Bisnis di kota tersebut + seluruh kecamatan di dalamnya |
| Admin Kecamatan | Hanya bisnis di kecamatan tersebut                      |

* Setelah diverifikasi, bisnis langsung aktif dan tampil di katalog publik
  {% endstep %}

{% step %}

#### Katalog & Pencarian (Public)

```
Pengunjung → Homepage                → Lihat Featured Bisnis
           → Katalog (/katalog)      → Cari & Filter (nama, kategori, lokasi)
           → Detail Bisnis           → Lihat Profil, Galeri, ConnectScore
                                           │
                                           ▼
                                     Hubungi via WhatsApp
```

* Pengunjung melihat katalog bisnis yang sudah terverifikasi
* Tersedia fitur pencarian dan filter berdasarkan kategori
* Setiap bisnis memiliki **ConnectScore** (0-100) yang menunjukkan kelengkapan profil
* Kontak langsung melalui WhatsApp tanpa perantara platform
  {% endstep %}

{% step %}

#### ConnectScore — Indikator Kelengkapan Profil

```
Profil Bisnis → Evaluasi 17 Aspek → Skor 0-100
                    │
                    ├─ Deskripsi Bisnis (8 poin)
                    ├─ Logo (8 poin)
                    ├─ Akta Pendirian (10 poin)
                    ├─ Legalitas (7 poin)
                    ├─ Foto Produk (7-10 poin)
                    ├─ Sosial Media (Instagram 5, Facebook 3, TikTok 2)
                    ├─ Info Kemitraan, Lokasi, Kontak, dll
                    └─ Total: 100 poin
```

* Semakin lengkap profil, semakin tinggi skor → meningkatkan kredibilitas bisnis
* Skor di-cache di database untuk performa optimal
* Mendorong pemilik bisnis untuk melengkapi profilnya
  {% endstep %}

{% step %}

#### Alur Koneksi Bisnis (Business Matching)

```
┌───────────────┐         ┌───────────────┐         ┌──────────────┐
│   Pemilik     │  Daftar │               │  Browse │  Pengunjung  │
│   Bisnis      │────────▶│ ConnectPreneur │◀───────│  (Calon      │
│ (Franchisor,  │         │   Platform    │         │   Mitra)     │
│  Distributor) │         │               │         │              │
└───────────────┘         └───────┬───────┘         └──────┬───────┘
                                  │                        │
                                  │   Profil + WhatsApp    │
                                  └────────────────────────┘
                                             │
                                             ▼
                                  ┌──────────────────┐
                                  │  Negosiasi &     │
                                  │  Kerjasama       │
                                  │  (Di luar        │
                                  │   platform)      │
                                  └──────────────────┘
```

**Jenis peluang kemitraan yang tersedia:**

* Reseller
* Agen / Distributor
* Dropshipper
* Franchise / Kemitraan
* Dan lainnya

Platform berfungsi sebagai **katalog & jembatan awal** — proses negosiasi dan kerjasama berlangsung langsung antara kedua pihak melalui WhatsApp.
{% endstep %}

{% step %}

#### Ringkasan Alur End-to-End

```
                    PENDAFTARAN              VERIFIKASI            PUBLIKASI
                    ───────────              ──────────            ─────────
Pemilik Bisnis ──▶ Isi Form ──▶ Submit ──▶ Admin Review ──▶ Approve ──▶ Tampil di Katalog
                    (5 tab)      (pending)   (by region)     (active)    │
                                                                         │
                    DISCOVERY               KONEKSI                      │
                    ─────────               ───────                      │
Calon Mitra ◀──── Browse/Search ◀─────── Katalog Publik ◀──────────────┘
      │
      ▼
 Hubungi via WA ──▶ Negosiasi ──▶ Kerjasama (offline)
```

**Tidak ada:**

* Sistem pembayaran / transaksi di platform
* Sistem pesan internal
* Matching otomatis / algoritma rekomendasi
* Subscription / fitur premium

Platform ini sepenuhnya **gratis** sebagai layanan ekosistem digital BOEMKraf untuk mendukung pertumbuhan UMKM.
{% endstep %}
{% endstepper %}

## Tech Stack

| Layer            | Technology                                                              |
| ---------------- | ----------------------------------------------------------------------- |
| Framework        | [Next.js 16](https://nextjs.org/) (App Router)                          |
| Language         | TypeScript                                                              |
| Styling          | [Tailwind CSS 4](https://tailwindcss.com/)                              |
| UI Components    | [shadcn/ui](https://ui.shadcn.com/) + [Radix UI](https://radix-ui.com/) |
| Database         | [Neon PostgreSQL](https://neon.tech/) (Serverless)                      |
| Image Storage    | [Vercel Blob](https://vercel.com/docs/storage/vercel-blob)              |
| Image Processing | [Sharp](https://sharp.pixelplumbing.com/) (auto-compress)               |
| Authentication   | JWT (jose)                                                              |
| Deployment       | [Vercel](https://vercel.com/)                                           |

## Production URL

**Live:** [https://connectpreneur.id](https://connectpreneur.id/)

## Fitur Utama

### Public

* 📋 Katalog bisnis dengan filter kategori
* 🔍 Pencarian mitra bisnis
* 📱 Detail bisnis dengan carousel gambar
* 📝 Form pendaftaran mitra (self-registration)
* 📞 Integrasi WhatsApp untuk kontak langsung

### Admin Panel

* 🔐 Authentication dengan JWT
* 📊 Dashboard manajemen mitra
* ✅ Verifikasi pendaftaran mitra baru
* ✏️ CRUD bisnis dengan upload gambar
* 🖼️ Auto-compress gambar (max 1MB → \~100KB)
* ⭐ Featured business management

## License

Private project for BOEMKraf.

***

**BOEMKraf** - *Kreatif, Kolaboratif, Berdaya!*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.connectpreneur.id/connectpreneur-documentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
