Skip to content
sambaskuPublic

About

Kamus Sambas-Indonesia dengan kontribusi warga, eksplorasi budaya, dan diskusi

Topics

Resources

Stars

6 stars

Watchers

1 watching

Forks

Latest commit

 

History

371 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SambasKu

SambasKu Mobile

Aplikasi Flutter Kamus Digital Sambas-Indonesia. Target utama produk: cari kata, dengar pelafalan, lihat gambar, bookmark, komentar/vote, dan kirim kontribusi dari ponsel.

Dikerjakan dengan AI

Kode dan dokumentasi di repo ini ditulis bersama agen AI. Manusia tetap yang memutuskan arah produk, meninjau setiap perubahan, dan menjalankan verifikasi sebelum rilis. Tidak ada agen yang punya akses commit, merge, atau deploy otomatis. Semua keputusan akhir ada di tangan pengelola.

Stack

Layer Pilihan
Framework Flutter (SDK ^3.10)
State Riverpod + hooks_riverpod
Navigasi go_router
HTTP Dio + Retrofit
UI Forui, skeletonizer
Auth sensitif flutter_secure_storage
Push Firebase Messaging
Env compile-time envied (baca .env)

Flavor

Flavor Logo aset Host API
staging assets/icons/logo.staging.png SAMBASKU_API_HOST_STAGING → https://sambasku-staging.iamutaki.com
production assets/icons/logo.png SAMBASKU_API_HOST_PRODUCTION → https://api.sambasku.com

Host dipilih di lib/core/constants/env.dart lewat F.appFlavor. Jangan hardcode host di datasource.

Setup

cp .env.example .env
# isi host + GOOGLE_WEB_CLIENT_ID_* / FACEBOOK_APP_ID_* bila OAuth dipakai
# lalu: dart run build_runner build

flutter pub get
flutter run --flavor staging
# atau
flutter run --flavor production

.env di-gitignore. envied membacanya saat compile; env.g.dart yang ter-commit dipakai CI.

Fitur (modul lib/features/)

Modul Peran
dictionary Cari / detail kata, WOTD
auth Login, OTP email, Google, Facebook, lupa password
contribution / suggest_edit Kirim kata / usulan edit
bookmark / vote / comment Interaksi pengguna login
profile / user_profile Profil saya + profil publik
notification Inbox push + in-app
share Share card
report_bug / word_report Laporan
verifier_application Pengajuan jadi verifikator
onboarding Layar pertama kali

Aset media

Jenis Alur
Gambar kata POST /api/v1/images?purpose=word → sambasku/images
Avatar POST /api/v1/users/me/avatar → repo yang sama
Audio pelafalan Multipart ke API → sambasku/audios
Bukti / lampiran bug ImageKit (privat) lewat upload-token

URL kanonik gambar = jsDelivr. Tampilan di-resize lewat wsrv (displayImageUrl). Lampiran UI wajib lewat AttachmentImagesField / showImageSheetDrawer (lihat base stack).

Struktur singkat

lib/
├── core/                # env, utils, widgets, network
├── features/<fitur>/    # data → domain → presentation (clean)
├── shared/              # widget lintas fitur
└── flavors.dart         # Flavor.staging | production

Deploy

CI staging: .github/workflows/deploy-staging.yml (push branch staging) menjalankan analyze dan test. Tidak membangun APK dan tidak mengunggah ke Play.

CI production: .github/workflows/deploy-production.yml (push tag v1.1.1, pola vMAJOR.MINOR.PATCH) → AAB flavor production (API https://api.sambasku.com) + draft upload ke Play Console track production (package com.iamutaki.sambasku). GitHub Release pada tag itu melampirkan APK split per ABI (bukan AAB). versionName dari tag, versionCode dari Play (max + 1). Tidak auto-publish.

Setup Play API: secret GitHub PLAY_STORE_SERVICE_ACCOUNT_JSON (+ KEYSTORE_*).

About

Kamus Sambas-Indonesia dengan kontribusi warga, eksplorasi budaya, dan diskusi

Topics

Resources

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages