Skip to content
Emil-02Public

About

Platform Lost & Found bertenaga AI - pencocokan otomatis barang hilang/ditemukan, verifikasi kepemilikan, chat aman (Next.js + Supabase)

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

9 Commits

Folders and files

Repository files navigation

๐Ÿ” TEMUIN

Yang Hilang, Bisa Ditemuin.

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

Next.js TypeScript Tailwind CSS Supabase Ollama Gemini spruce


๐Ÿ’ก Masalah & Solusi

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:

  1. ๐Ÿค– AI Matching โ€” mencocokkan laporan kehilangan โ†” penemuan dari deskripsi, atribut, ciri khusus, lokasi, waktu, dan foto (bila ada).
  2. ๐Ÿ” Verifikasi Kepemilikan โ€” pengklaim menjawab pertanyaan privat yang hanya diketahui pemilik asli; AI menilai jawabannya.
  3. ๐Ÿ’ฌ Chat Aman โ€” jalur komunikasi terbuka hanya setelah klaim disetujui penemu.
  4. ๐Ÿ“Š Dampak Terukur โ€” setiap barang yang kembali tercatat di halaman Impact.

Informasi sensitif tidak pernah dipajang ke publik.

โœจ Fitur Utama

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

๐Ÿ—๏ธ Teknologi

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

Arsitektur AI (prinsip)

  • 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_KEY ada) โ†’ 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

๐Ÿš€ Setup (ยฑ 10 menit)

1. Buat project Supabase

  1. Buka supabase.com โ†’ New Project.
  2. Buka SQL Editor โ†’ paste seluruh isi supabase/schema.sql โ†’ Run. Ini membuat 12 tabel, trigger, RLS, dan bucket storage report-images.
  3. Jalankan juga supabase/migrations/0002_check_constraints.sql โ€” CHECK constraint integritas data (koordinat & rentang skor).
  4. Jalankan supabase/migrations/0003_ollama_provider.sql โ€” wajib untuk provider Ollama (kolom embedding_model + sumber AI ollama).

2. Konfigurasi environment

cp .env.example .env.local

Isi .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.

3. Jalankan

npm install
npm run dev        # development
# atau produksi:
npm run build && npm run start

Buka http://localhost:3000 ๐ŸŽ‰

4. (Opsional) Seed data demo

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.

๐ŸŽฌ Alur Demo Kompetisi

Budi (kehilangan) โ”€โ”€โ–บ Match ditemukan โ”€โ”€โ–บ Ajukan Klaim โ”€โ”€โ–บ Jawab verifikasi
                                                                โ”‚
Sari (penemu) โ—„โ”€โ”€ Tinjau Verification Score โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
      โ”‚
      โ”œโ”€โ”€โ–บ Setujui โ”€โ”€โ–บ ๐Ÿ’ฌ Chat aman โ”€โ”€โ–บ Atur serah terima
      โ””โ”€โ”€โ–บ Konfirmasi Diserahkan โ”€โ”€โ–บ โœ… RETURNED โ”€โ”€โ–บ ๐Ÿ“Š Impact
  1. Login budi.demo@temuin.app โ†’ laporan "Dompet Eiger Hitam" sudah punya match โ†’ buka Matches โ†’ lihat Explainable Match Score.
  2. Klik Ajukan Klaim โ†’ jawab 5 pertanyaan verifikasi (mis. "ada gantungan huruf A, jahitan pojok lepas, ada KTP atas nama Bโ€ฆ").
  3. Login sari.demo@temuin.app โ†’ Klaim โ†’ tinjau Verification Score โ†’ Setujui.
  4. Chat aman terbuka โ†’ atur serah terima.
  5. Sari klik Konfirmasi Barang Diserahkan โ†’ status RETURNED โ†’ cek Impact.

๐Ÿ“‚ Struktur Project

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

๐Ÿ”’ Keamanan & Privasi

  • โœ… Semua tabel RLS deny-all โ€” data hanya lewat backend (service role) dengan ownership check per-request.
  • โœ… private_verification_info tidak 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_KEY tidak 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".

About

Platform Lost & Found bertenaga AI - pencocokan otomatis barang hilang/ditemukan, verifikasi kepemilikan, chat aman (Next.js + Supabase)

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages