Platform Lost & Found Bertenaga AI โ mempertemukan barang hilang dengan penemunya secara otomatis, aman, dan explainable.
Dibangun untuk CREATHON 2026 ยท Tema: AI dan Data yang Berdampak Sosial
๐ Live demo: temuin-kohl.vercel.app
Setiap hari ribuan barang hilang โ dompet, ponsel, kunci, dokumen penting. Grup media sosial "info kehilangan" tidak efisien: laporan tenggelam, informasi sensitif terpampang publik, dan rawan klaim palsu.
Temuin menyelesaikannya end-to-end:
- ๐ค AI Matching โ mencocokkan laporan kehilangan โ penemuan dari deskripsi, atribut, ciri khusus, lokasi, waktu, dan foto (bila ada).
- ๐ Verifikasi Kepemilikan โ pengklaim menjawab pertanyaan privat yang hanya diketahui pemilik asli; AI menilai jawabannya.
- ๐ฌ Chat Aman โ jalur komunikasi terbuka hanya setelah klaim disetujui penemu.
- ๐ Dampak Terukur โ setiap barang yang kembali tercatat di halaman Impact.
Informasi sensitif tidak pernah dipajang ke publik.
| Fitur | Deskripsi |
|---|---|
| ๐ Laporan Kehilangan & Penemuan | Form terstruktur + upload foto (bucket privat, signed URL) |
| ๐ธ Isi Otomatis dari Foto | Cukup foto barang โ AI mengisi nama, kategori, warna, merek, material, deskripsi & ciri khusus; user tinggal cek & koreksi. Foto wajib untuk laporan penemuan, dikompres di browser sebelum upload |
| ๐ง Explainable Match Score | Skor per-komponen (deskripsi, atribut, lokasi, waktu, fotoโฆ) โ bukan black box |
| ๐ก๏ธ Verifikasi Klaim | 5 pertanyaan privat + Verification Score dari AI, keputusan akhir di tangan penemu |
| ๐ฌ Pesan Real-time | Chat antar pihak setelah klaim disetujui |
| ๐ Notifikasi | Match baru, klaim masuk, status berubah |
| ๐งญ Timeline Status | ACTIVE โ MATCH_FOUND โ CLAIMED โ VERIFICATION โ HANDOVER โ RETURNED |
| ๐ฎ Panel Admin | Statistik & moderasi laporan (cara setup admin) |
| โก Submit Non-Blocking | Laporan langsung tersimpan; analisis AI & matching berjalan di background (after()) |
| ๐ฑ Graceful Fallback | Tanpa API key AI, heuristik lokal (termasuk kamus IDโEN) tetap bekerja |
| Lapisan | Teknologi |
|---|---|
| Frontend + Backend | Next.js 16 (App Router, Server Actions), TypeScript, Tailwind CSS v4 |
| Database + Auth + Storage | Supabase (PostgreSQL, RLS deny-all, bucket privat) |
| AI utama | Ollama server AI kampus (ollama.if.unismuh.ac.id): Gemma 4 (teks + vision) & bge-m3 (embedding multibahasa) โ server-side only |
| AI cadangan | Gemini API (GEMINI_MODEL + gemini-embedding-001), otomatis dipakai bila server kampus gagal/timeout |
| Matching | Temuin Matching Engine โ skor deterministik & explainable di backend |
- AI hanya menyuplai sinyal: isi otomatis form dari foto, ekstraksi atribut terstruktur, embedding semantik, analisis foto, dan penilaian jawaban verifikasi.
- Urutan provider: Ollama kampus โ Gemini (bila
GEMINI_API_KEYada) โ heuristik lokal. Bila server kampus gagal, Temuin melewatinya selama 60 detik (circuit breaker) agar user tidak menunggu. - Cold start: server kampus dipakai bersama, memuat model bisa ~1โ2 menit. Temuin meminta model tetap di memori (
OLLAMA_KEEP_ALIVE) dan memanaskan model saat form laporan dibuka. - Embedding hanya dibandingkan antar model yang sama (kolom
embedding_model), dengan kalibrasi skor per model. - Skor akhir dihitung deterministik oleh Temuin Matching Engine dengan bobot: deskripsi 30 ยท atribut 20 ยท ciri khusus 10 ยท lokasi 20 ยท waktu 15 ยท kategori 5 (+ foto 15). Bobot dinormalisasi ulang bila komponen tidak tersedia, sehingga pengguna tanpa foto tidak dirugikan.
- AI tidak pernah "memastikan kepemilikan" โ hanya Potential Match; keputusan akhir lewat verifikasi + persetujuan penemu.
๐ Diagram arsitektur lengkap, skema database, dan flow sistem: docs/ARCHITECTURE.md
- Buka supabase.com โ New Project.
- Buka SQL Editor โ paste seluruh isi
supabase/schema.sqlโ Run. Ini membuat 12 tabel, trigger, RLS, dan bucket storagereport-images. - Jalankan juga
supabase/migrations/0002_check_constraints.sqlโ CHECK constraint integritas data (koordinat & rentang skor). - Jalankan
supabase/migrations/0003_ollama_provider.sqlโ wajib untuk provider Ollama (kolomembedding_model+ sumber AIollama).
cp .env.example .env.localIsi .env.local:
| Variabel | Sumber | Catatan |
|---|---|---|
NEXT_PUBLIC_SUPABASE_URL |
Project Settings โ API | |
NEXT_PUBLIC_SUPABASE_ANON_KEY |
Project Settings โ API | |
SUPABASE_SERVICE_ROLE_KEY |
Project Settings โ API | ๐ tidak di-commit |
OLLAMA_BASE_URL |
server AI kampus | mis. https://ollama.if.unismuh.ac.id; kosongkan untuk menonaktifkan |
OLLAMA_MODEL |
opsional | default gemma4:latest (harus mendukung vision) |
OLLAMA_EMBED_MODEL |
opsional | default bge-m3:latest |
OLLAMA_KEEP_ALIVE |
opsional | default 30m โ lama model ditahan di memori server |
OLLAMA_API_KEY |
opsional | ๐ bila server Ollama memakai autentikasi Bearer |
GEMINI_API_KEY |
aistudio.google.com/apikey | ๐ opsional, AI cadangan |
GEMINI_MODEL |
opsional | default gemini-flash-latest |
SEED_SECRET |
string bebas | mengunci endpoint seed |
๐ก Tanpa AI sama sekali (Ollama tidak terjangkau & tanpa
GEMINI_API_KEY) aplikasi tetap berjalan memakai fallback heuristik, tetapi isi otomatis dari foto tidak tersedia dan akurasi matching menurun.๐ Laporan lama yang dianalisis dengan Gemini memakai embedding berbeda โ tekan Analisis ulang AI di halaman detail laporan agar embedding-nya ikut model baru.
npm install
npm run dev # development
# atau produksi:
npm run build && npm run startBuka http://localhost:3000 ๐
http://localhost:3000/api/dev/seed?secret=<SEED_SECRET>
Seed membuat 3 akun demo + 5 laporan yang diproses lewat pipeline AI & matching engine asli (bukan skor hard-code):
| Akun | Password | Peran |
|---|---|---|
budi.demo@temuin.app |
Temuin!234 |
Kehilangan dompet Eiger (skenario utama) |
sari.demo@temuin.app |
Temuin!234 |
Menemukan dompet tersebut |
andi.demo@temuin.app |
Temuin!234 |
Laporan negatif (pembanding) |
Skenario utama ditargetkan menghasilkan HIGH MATCH (ยฑ90%); laporan negatif membuktikan sistem tidak selalu memberi skor tinggi.
Budi (kehilangan) โโโบ Match ditemukan โโโบ Ajukan Klaim โโโบ Jawab verifikasi
โ
Sari (penemu) โโโ Tinjau Verification Score โโโโโโโโโโโโโโโโโโโโ
โ
โโโโบ Setujui โโโบ ๐ฌ Chat aman โโโบ Atur serah terima
โโโโบ Konfirmasi Diserahkan โโโบ โ
RETURNED โโโบ ๐ Impact
- Login
budi.demo@temuin.appโ laporan "Dompet Eiger Hitam" sudah punya match โ buka Matches โ lihat Explainable Match Score. - Klik Ajukan Klaim โ jawab 5 pertanyaan verifikasi (mis. "ada gantungan huruf A, jahitan pojok lepas, ada KTP atas nama Bโฆ").
- Login
sari.demo@temuin.appโ Klaim โ tinjau Verification Score โ Setujui. - Chat aman terbuka โ atur serah terima.
- Sari klik Konfirmasi Barang Diserahkan โ status RETURNED โ cek Impact.
src/
โโโ app/
โ โโโ (app)/ # Halaman terautentikasi (dashboard, reports, matches, claims, โฆ)
โ โโโ api/ # Route handlers (images, messages, seed)
โ โโโ login/ register/ # Autentikasi
โ โโโ page.tsx # Landing page
โโโ components/ # UI components (app-shell, report-form, chat-panel, โฆ)
โโโ lib/
โโโ ai/ # Layanan AI: Ollama (utama) + Gemini (cadangan) + fallback heuristik
โโโ matching/ # Temuin Matching Engine (deterministik, explainable)
โโโ actions/ # Server Actions (auth, reports, claims, profile)
โโโ supabase/ # Client server-side & admin (service role)
supabase/
โโโ schema.sql # 12 tabel, trigger, RLS deny-all, storage bucket
โโโ migrations/ # Migration tambahan (CHECK constraints)
docs/
โโโ ARCHITECTURE.md # Arsitektur & flow sistem (diagram lengkap)
โโโ ADMIN_SETUP.md # Cara mengelola role admin
- โ Semua tabel RLS deny-all โ data hanya lewat backend (service role) dengan ownership check per-request.
- โ
private_verification_infotidak pernah dikirim ke pengklaim; foto disajikan lewat signed URL berautentikasi. - โ
Semua panggilan AI (Ollama & Gemini) dilakukan dari server;
GEMINI_API_KEY,OLLAMA_API_KEY&SUPABASE_SERVICE_ROLE_KEYtidak pernah menyentuh browser. - โ Rate limiting pada login/register, pembuatan laporan, klaim, verifikasi, dan chat.
- โ Validasi input server-side pada semua Server Action (termasuk rentang latitude/longitude) + CHECK constraint di database.
- โ Transisi status klaim memakai conditional guard di database โ aman dari race condition / double-submit.
Temuin โ dibuat dengan โค๏ธ untuk CREATHON 2026
Karena setiap barang hilang punya cerita, dan setiap cerita layak berakhir dengan "ketemu".