Skip to content
fajprasPublic

About

This Project Based Learning 310 with tittle VEN (Value Exchange Network) aplication for exhibition of kreator project.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

194 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›๏ธ VEN โ€” Value Exhibition Network

The Next-Generation Digital Art & 3D Value Gallery Ecosystem

Android Backend Database AI Integration 3D Viewer UI Design Backend Tests Android Tests

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.


๐Ÿ“‘ Daftar Isi


๐Ÿ’ก Tentang VEN

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.

๐Ÿ›๏ธ Arsitektur Sistem

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
Loading

โœจ Fitur Utama

1. Mobile Client (Android Native)

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 :unity ter-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.

2. Backend API & Admin Web Panel

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.

3. Keamanan Berlapis: 7 Pilar Audit DB & Hardening Mobile

๐Ÿ—„๏ธ Backend โ€” 7 Pilar Kepatuhan Audit Keamanan Basis Data

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

๐Ÿ“ฑ Mobile Client โ€” Hardening Keamanan Aplikasi

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.

๐Ÿ“ Struktur Repositori

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

๐Ÿš€ Panduan Memulai Cepat (Getting Started)

Prasyarat Sistem

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

Langkah Setup Backend & Database

  1. Masuk ke folder backend:

    cd backend-api/backend
  2. Pasang dependensi PHP & Node.js:

    composer install
    npm install
  3. Konfigurasi Environment:

    cp .env.example .env
    php artisan key:generate

    Pastikan kredensial database pada .env telah disesuaikan dengan konfigurasi MySQL lokal Anda.

  4. Inisialisasi Database Multi-Role (Least Privilege):

    php artisan ven:setup-db
  5. Jalankan Migrasi Skema & Seeder:

    php artisan migrate --database=mysql_dba
    php artisan db:seed
  6. 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:8000 dan Admin Web Panel dapat diakses di http://127.0.0.1:8000/admin.


Langkah Menjalankan Mobile App

  1. 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.2 dengan IP LAN komputer Anda. Build release wajib memakai https:// โ€” aplikasi menolak base URL non-HTTPS pada mode release.

  2. Buka folder ven-mobile/ di Android Studio.
  3. Biarkan Gradle melakukan sinkronisasi dependensi proyek (Gradle Sync).
  4. Pastikan backend API berjalan.
  5. Pilih target perangkat (Emulator atau Perangkat Fisik via USB Debugging).
  6. Klik Run 'app' (Shift + F10) atau jalankan perintah kompilasi:
    cd ven-mobile
    .\gradlew.bat installDebug

๐Ÿงช Pengujian Otomatis (Automated Testing)

Integritas sistem VEN diuji secara berkala untuk memastikan reliabilitas tinggi โ€” hasil verifikasi terakhir: 19 November 2026.

1. Backend API & Keamanan Database (PHPUnit)

cd backend-api/backend
php artisan test

โœ… Status: 87 test โ€” 87 lulus, 406 assertion (100% lulus, 0 galat).

โš ๏ธ Pengujian wajib menggunakan database ven_testing; dilarang mengarahkan test ke database aplikasi ven.

2. Android Mobile Client (Gradle Unit Test)

cd ven-mobile
.\gradlew.bat testDebugUnitTest

โœ… Status: 73 test โ€” 73 lulus (100% lulus, 0 galat) โ€” mencakup ViewModel, UiState, navigasi, & logika utilitas.

3. Build & Smoke Test

cd ven-mobile
.\gradlew.bat assembleDebug

โœ… Status: BUILD SUCCESSFUL โ€” APK debug (~126 MB) tersedia di app/build/outputs/apk/debug/.

4. Postman API Suite

Koleksi lengkap pengujian endpoint API dan verifikasi 7 pilar kepatuhan database tersedia di folder postman/ siap diimpor ke Postman.


๐Ÿ“Š Status Proyek & Dokumentasi

Dokumen Isi
๐Ÿ“‹ docs/STATUS-PROYEK-VEN.md Status modul per fitur (โœ…/โš ๏ธ/โŒ), hasil verifikasi terkini (test, build, tanggal, commit), daftar bagian mock, dan kendala aktif beserta rekomendasinya.
๐ŸŽจ 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.

๐Ÿ› ๏ธ Standar Pengembangan & Git Workflow

  1. 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/.
  2. Status Proyek Selalu Sinkron: Setiap penambahan/perubahan/penghapusan fitur wajib memperbarui docs/STATUS-PROYEK-VEN.md pada commit yang sama.
  3. Kebijakan Git Push:
    • AI Agent dilarang menjalankan git push otomatis.
    • Seluruh eksekusi git push ke remote repository adalah hak prerogatif eksklusif dari Developer (Pengguna) secara manual.

๐Ÿ“„ Lisensi & Hak Cipta

Hak Cipta ยฉ 2026 Tim Pengembang VEN (Value Exhibition Network).
Seluruh hak cipta dilindungi undang-undang.

Dibangun dengan ๐Ÿ’œ oleh Tim VEN

About

This Project Based Learning 310 with tittle VEN (Value Exchange Network) aplication for exhibition of kreator project.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages