VEN (Value Exhibition Network) adalah ekosistem pameran seni dan galeri 3D digital interaktif yang menjembatani seniman, desainer, kurator, dan pengunjung dalam ruang pameran imersif. Memadukan aplikasi native Android (Jetpack Compose) dengan backend RESTful API berkinerja tinggi berbasis Laravel 13, arsitektur basis data Least Privilege, audit keamanan berlapis (backend & mobile), serta integrasi kecerdasan buatan Google Gemini.
- ๐ก Tentang VEN
- ๐๏ธ Arsitektur Sistem
- โจ Fitur Utama
- ๐ Struktur Repositori
- ๐ Panduan Memulai Cepat (Getting Started)
- ๐งช Pengujian Otomatis (Automated Testing)
- ๐ Status Proyek & Dokumentasi
- ๐ ๏ธ Standar Pengembangan & Git Workflow
- ๐ Lisensi & Hak Cipta
Platform VEN dirancang untuk mendemokratisasi akses karya seni, desain grafis, poster, dan model 3D melalui ruang galeri digital. Melalui platform ini:
| Peran | Kemampuan |
|---|---|
| ๐จ Kreator | Mempublikasikan karya poster 2D maupun merancang ruang pameran 3D (Value Exhibit) lengkap dengan penataan furnitur dan pencahayaan. |
| ๐ฅ Pengunjung | Menjelajahi galeri pameran secara virtual, melihat detail karya, mengajukan jadwal pertemuan (Request Meeting), dan berkonsultasi dengan asisten kurator AI cerdas. |
| ๐ก๏ธ Administrator & Kurator | Mengelola dasbor terpusat untuk memoderasi karya, memverifikasi kepatuhan konten pameran, mengaudit log aktivitas sistem, dan menjatuhkan sanksi akun secara real-time. |
Ekosistem VEN dibangun dengan memisahkan domain aplikasi secara bersih:
graph TD
subgraph "Client Layer"
MA["๐ฑ Android Mobile App<br/>(Kotlin + Jetpack Compose)"]
UA["๐ฎ Unity 3D Viewer<br/>(proses :unity ter-embed)"]
WA["๐ป Web Admin Panel<br/>(Blade + Vite + Tailwind v4)"]
end
subgraph "API Gateway & Application Layer"
LB["๐ RESTful API Server<br/>(Laravel 13, PHP 8.3)"]
Sanctum["๐ Sanctum Token & Session Auth"]
Scheduler["โฑ๏ธ Artisan Scheduler & Daemon Workers"]
end
subgraph "AI & External Services"
Gemini["โจ Google AI Studio<br/>(Gemini API)"]
Storage["๐ Storage Disk<br/>(Banners, 3D Models, Thumbnails)"]
end
subgraph "Security & Multi-Role Database Layer"
DB_User[("๐ค mysql_user<br/>(DML Terbatas / Publik)")]
DB_Admin[("๐ก๏ธ mysql_admin<br/>(Moderasi & Audit Log)")]
DB_DBA[("โ๏ธ mysql_dba<br/>(DDL, Migrasi, Backup & Recovery)")]
end
MA -->|"JSON HTTP / Bearer Token<br/>(HTTPS-only pada release)"| LB
MA -->|"RoomDto via UnityBridge"| UA
UA -->|"room-dto API"| LB
WA -->|"Session HTTP / CSRF"| LB
LB --> Sanctum
LB --> Scheduler
LB -->|"Chat Curate & Recs"| Gemini
LB -->|"Asset Management"| Storage
LB -->|"Query Pengguna"| DB_User
LB -->|"Moderasi & Log Sistem"| DB_Admin
Scheduler -->|"Midnight Backup & Verifikasi"| DB_DBA
Dibangun menggunakan Kotlin dan Jetpack Compose dengan pendekatan Unidirectional Data Flow (UDF) โ setiap fitur terpisah rapi menjadi Screen.kt (stateless), Route.kt (stateful), ViewModel.kt, dan UiState.kt:
- ๐ Smart Feed & Refresh System (Instagram Style):
- Pull-to-Refresh: Usap layar ke bawah dari bagian atas untuk memicu pembaruan data secara dinamis dengan animasi spinner Material 3.
- Double-Tap Tab Bar: Ketuk tab Beranda atau Explore dua kali untuk scroll instan ke paling atas dan menyaring karya yang sudah pernah dilihat (
seenMediaIds), memastikan selalu tersaji hal-hal baru dan segar. - State Hoisting: Posisi scroll daftar karya tersimpan aman antar perpindahan tab navigasi.
- ๐ผ๏ธ Feed Beranda Imersif:
- Carousel pameran Coming Soon dengan banner visual tajam.
- Kartu karya (PostCard) elegan dengan rasio media dinamis, tombol navigasi jadwal langsung, dan pemanggil 3D exhibit viewer.
- ๐ Explore & Unified Discovery:
- Grid eksplorasi 3 kolom dengan Memory LRU Cache (0ms) dan Disk Cache ter-downsample (360x480).
- Pencarian terpadu dengan debounce instan: tab For You, Accounts, Posts, dan Exhibits.
- Filter modal kategori dinamis berbasis Bottom Sheet.
- ๐๏ธ 3D Exhibition Editor & Viewer:
- Pembuatan ruang pameran virtual interaktif: checklist persiapan, penamaan, pemilihan template ruang, penempatan objek/furnitur, dan kontrol palet warna.
- Viewer pameran 3D berbasis Unity (proses
:unityter-embed) dengan penyambutan data ruangan real-time dari API (room-dto).
- ๐
Jadwal Pertemuan (Schedule & Request Meeting โ UC-17):
- Pengajuan, peninjauan, dan konfirmasi jadwal temu kurator/seniman dalam 4 tab: Approved, Waiting, Requests, dan History.
- Kalender pemilih tanggal dinamis + input jam/menit AM-PM, validasi jadwal lampau, dan catatan pertemuan.
- ๐ค Asisten Cerdas AI (Gemini Assistant):
- Panel drawer interaktif untuk tanya jawab seputar karya seni dan kurasi pameran, dengan riwayat chat persisten dan hapus percakapan per item.
- ๐ Theme Engine (Dark & Light Mode) & Multi-Bahasa (EN/ID):
- Palet desain kustom (
VexColors) dengan design token lengkap โ warna, spacing, radius, tipografi, dan motion โ dioptimalkan untuk Dark Mode elegan yang menonjolkan estetika karya seni. - Seluruh antarmuka tersedia dalam dua bahasa (English & Bahasa Indonesia) dengan pemilihan bahasa di pengaturan.
- Palet desain kustom (
Dibangun di atas fondasi Laravel 13 dengan performa tinggi dan struktur modular:
- High-Performance RESTful API: Endpoint JSON terstruktur rapi (
{data, message}) untuk seluruh alur bisnis aplikasi mobile โ autentikasi & OTP, profil, pameran, karya, undangan, pencarian, dan AI. - Web Admin Panel Terintegrasi: Dasbor moderasi karya, verifikasi pameran, manajemen pengguna, inspeksi riwayat aktivitas (LogAudit), dan penjatuhan sanksi akun berbasis Blade Views dan Tailwind CSS v4.
- Proteksi Mutasi Data: Validasi ketat Form Request, Policy-based authorization, dan pencegahan injeksi payload.
- Penanganan Galat Terpusat: Semua endpoint
/api/*selalu merespons JSON tanpa membocorkan detail internal; akses langsung dari browser dialihkan ke halaman 404 kustom. - Integrasi AI Gemini: Endpoint analitik kurasi dan rekomendasi konten otomatis dengan grounding konteks pameran & karya.
Backend VEN telah diaudit secara formal dan memenuhi 7 standar ketat arsitektur basis data:
| No | Standar Audit | Implementasi Teknis pada VEN |
|---|---|---|
| 1 | Pembatasan Akses dengan View | Filter data sensitif (kata_sandi, google_id, role) menggunakan view basis data v_pengguna_publik untuk konsumsi endpoint publik. |
| 2 | Hashing & Salting | Proteksi seluruh kata sandi menggunakan algoritma Bcrypt ($2y$) dengan salt unik dinamis. |
| 3 | Enkripsi AES-256-GCM & Blind Index | Enkripsi simetris data sensitif pihak ketiga (google_id) via AES-256-GCM dengan Blind Index (HMAC-SHA-256) untuk pencarian terenkripsi berkecepatan tinggi. |
| 4 | Database Transactions (ACID) | Eksekusi transaksi atomik (DB::transaction) yang menjamin sifat Commit pada alur sukses dan Rollback menyeluruh saat terjadi kendala. |
| 5 | Concurrent Access & Locking | Proteksi race condition saat moderasi sanksi akun dan klaim pameran dengan Pessimistic Row Locking (lockForUpdate). |
| 6 | Backup Otomatis & Terjadwal | Pencadangan basis data berkala setiap tengah malam (00:00) dengan retensi rotasi 30 hari serta perintah manual DBA ven:backup-db. |
| 7 | Disaster Recovery Sandbox Verification | Otomasi verifikasi pemulihan cadangan database ke sandbox terisolasi via perintah ven:restore-db. |
๐ Dokumentasi teknis lengkap masing-masing kepatuhan dapat ditinjau di direktori
backend-api/backend/docs/.
| Lapisan | Implementasi pada ven-mobile |
|---|---|
| Penyimpanan Sesi | Token & data pengguna terenkripsi AES-256-GCM via AndroidKeyStore (util/SecurePrefs) dengan migrasi transparan dari data lama โ kecil kemungkinan dibaca dari root/backup. |
| Transport | Build release HTTPS-only (networkSecurityConfig); cleartext hanya diizinkan untuk emulator/localhost pada build debug. |
| Backup | Preferensi sesi sensitif dikecualikan dari cloud backup & device transfer (backup_rules / data_extraction_rules). |
| Logging | Interceptor HTTP level BODY hanya aktif pada build debug โ kata sandi, OTP, dan JWT tidak pernah tercetak di logcat release. |
| Komponen | Activity Unity tidak exported (tidak dapat dipanggil aplikasi lain); proguard-rules.pro disiapkan untuk obfuskasi release. |
ven/
โโโ .agents/ # Panduan AI rules, best practices, dan workflow skills
โ โโโ rules/ # Aturan koding bersih, arsitektur, dan kebijakan git
โ โโโ skills/ # Standar spesialisasi Laravel, Android Compose, dan TDD
โโโ backend-api/
โ โโโ backend/ # Core Laravel Backend & Admin Web Panel
โ โโโ app/
โ โ โโโ Http/Controllers/ # Controller API dan Controller Web Admin
โ โ โโโ Models/ # Eloquent Models (Karya, Pameran, Pengguna, Objek, dsb.)
โ โ โโโ Services/ # Layer Logika Bisnis & Layanan Gemini AI
โ โ โโโ Observers/ # Observer Aktivitas & Audit Database
โ โโโ config/ # Konfigurasi database multi-role, backup, & AI
โ โโโ database/ # Migrasi skema database, Seeder data, & Views
โ โโโ docs/ # Dokumentasi formal 7 pilar audit keamanan database
โ โโโ resources/views/ # Template Blade untuk Admin Web Panel (Tailwind CSS v4)
โ โโโ tests/ # Automated PHPUnit Test Suites
โโโ ven-mobile/ # Aplikasi Klien Android Native
โ โโโ app/src/main/
โ โ โโโ java/com/ven/app/
โ โ โ โโโ core/ # Konfigurasi global (AppConfig) & lokalisasi (AppStrings)
โ โ โ โโโ data/ # API Service, SessionManager terenkripsi, & Data Models
โ โ โ โโโ ui/
โ โ โ โ โโโ components/ # Komponen UI bersama (VexButton, VexTextArea, PostCard, ...)
โ โ โ โ โโโ navigation/ # Routing AppNavigation & BottomNav Bar
โ โ โ โ โโโ screens/ # Feature Screens (Home, Explore, Schedule, AI, Create, ...)
โ โ โ โ โโโ theme/ # Token desain resmi VEN (Color, Space, Radius, Typography)
โ โ โ โโโ util/ # Utility (SecurePrefs, DateFormatter, GoogleAuth, ...)
โ โ โโโ res/ # Vector drawables, strings lokalisasi, & resource visual
โ โโโ unityLibrary/ # Modul Unity 3D Viewer (il2cpp)
โ โโโ docs/DESIGN.md # Spesifikasi desain visual & alur interaksi Figma
โโโ docs/ # STATUS-PROYEK-VEN.md โ status modul, verifikasi, & kendala
โโโ postman/ # Koleksi pengujian endpoint API & suite verifikasi audit
| Komponen | Kebutuhan |
|---|---|
| ๐ฅ๏ธ Backend | PHP >= 8.3, Composer >= 2.6, MySQL >= 8.0/8.4 (Laragon sangat disarankan di Windows), Node.js >= 18 |
| ๐ฑ Mobile | Android Studio (Ladybug / Meerkat / terbaru), JDK 17, Android SDK Platform 34/35 |
-
Masuk ke folder backend:
cd backend-api/backend -
Pasang dependensi PHP & Node.js:
composer install npm install
-
Konfigurasi Environment:
cp .env.example .env php artisan key:generate
Pastikan kredensial database pada
.envtelah disesuaikan dengan konfigurasi MySQL lokal Anda. -
Inisialisasi Database Multi-Role (Least Privilege):
php artisan ven:setup-db
-
Jalankan Migrasi Skema & Seeder:
php artisan migrate --database=mysql_dba php artisan db:seed
-
Jalankan Development Server:
# Menjalankan server API dan kompilasi asset frontend secara simultan npm run dev # Di terminal terpisah: php artisan serve
RESTful API server akan aktif di
http://127.0.0.1:8000dan Admin Web Panel dapat diakses dihttp://127.0.0.1:8000/admin.
- Konfigurasi endpoint API: salin/atur file
ven-mobile/.env:# Emulator Android memakai host loopback bawaan BASE_URL=http://10.0.2.2:8000/api/ # Google Web Client ID untuk Sign-In GOOGLE_SERVER_CLIENT_ID=<client-id-anda>
๐ก Untuk perangkat fisik, ganti
10.0.2.2dengan IP LAN komputer Anda. Build release wajib memakaihttps://โ aplikasi menolak base URL non-HTTPS pada mode release. - Buka folder
ven-mobile/di Android Studio. - Biarkan Gradle melakukan sinkronisasi dependensi proyek (Gradle Sync).
- Pastikan backend API berjalan.
- Pilih target perangkat (Emulator atau Perangkat Fisik via USB Debugging).
- Klik Run 'app' (
Shift + F10) atau jalankan perintah kompilasi:cd ven-mobile .\gradlew.bat installDebug
Integritas sistem VEN diuji secara berkala untuk memastikan reliabilitas tinggi โ hasil verifikasi terakhir: 19 November 2026.
cd backend-api/backend
php artisan testโ Status: 87 test โ 87 lulus, 406 assertion (100% lulus, 0 galat).
โ ๏ธ Pengujian wajib menggunakan databaseven_testing; dilarang mengarahkan test ke database aplikasiven.
cd ven-mobile
.\gradlew.bat testDebugUnitTestโ Status: 73 test โ 73 lulus (100% lulus, 0 galat) โ mencakup ViewModel, UiState, navigasi, & logika utilitas.
cd ven-mobile
.\gradlew.bat assembleDebugโ Status: BUILD SUCCESSFUL โ APK debug (~126 MB) tersedia di
app/build/outputs/apk/debug/.
Koleksi lengkap pengujian endpoint API dan verifikasi 7 pilar kepatuhan database tersedia di folder postman/ siap diimpor ke Postman.
| Dokumen | Isi |
|---|---|
๐ docs/STATUS-PROYEK-VEN.md |
Status modul per fitur (โ
/ |
๐จ ven-mobile/docs/DESIGN.md |
Spesifikasi design system Vex: palet warna, tipografi, spacing, komponen, dan pola interaksi. |
๐๏ธ backend-api/backend/docs/ |
Dokumentasi formal 7 pilar audit keamanan basis data. |
๐งช postman/ |
Koleksi Postman pengujian API & audit keamanan. |
- Clean Code & Architecture: Seluruh kontribusi wajib mengikuti kaidah Skinny Controller, Business Logic in Services, Unidirectional Data Flow (Compose), dan dokumentasi fungsi yang rapi โ lihat
.agents/rules/. - Status Proyek Selalu Sinkron: Setiap penambahan/perubahan/penghapusan fitur wajib memperbarui
docs/STATUS-PROYEK-VEN.mdpada commit yang sama. - Kebijakan Git Push:
- AI Agent dilarang menjalankan
git pushotomatis. - Seluruh eksekusi
git pushke remote repository adalah hak prerogatif eksklusif dari Developer (Pengguna) secara manual.
- AI Agent dilarang menjalankan
Hak Cipta ยฉ 2026 Tim Pengembang VEN (Value Exhibition Network).
Seluruh hak cipta dilindungi undang-undang.