# Android Native Skeleton - Kamus Bahasa

Kerangka proyek native Android untuk aplikasi Kamus Bahasa/KBBI, sesuai arsitektur modular dengan database SQLite per modul bahasa.

## Stack

- **Kotlin** + **Jetpack Compose**
- **Room / SQLite** untuk akses database
- **WorkManager/Coroutines** (direncanakan) untuk unduh/update modul
- **Google Mobile Ads SDK (AdMob)** untuk banner atas/bawah

## Struktur Utama

```text
android-native-skeleton/
  app/
    build.gradle.kts
    src/main/
      AndroidManifest.xml
      java/com/example/kbbidictionary/
        MainActivity.kt
        KbbiApp.kt
        data/
          local/
            AppDatabase.kt
            InstalledModuleDao.kt
            InstalledModuleEntity.kt
            FavoriteEntity.kt
            SearchHistoryEntity.kt
          module/
            ModuleManifest.kt
            ModuleRegistryRepository.kt
            ModuleInstaller.kt
          dictionary/
            DictionaryRepository.kt
            DictionaryEntry.kt
        ui/
          AppRoot.kt
          screens/
            SearchScreen.kt
            DetailScreen.kt
            ModulesScreen.kt
          components/
            AdBannerSlot.kt
        domain/
          SearchDictionaryUseCase.kt
          UpdateModuleUseCase.kt
  build.gradle.kts
  settings.gradle.kts
```

## Poin Arsitektur yang Ditunjukkan

1. **Native Android**: Kotlin + Compose.
2. **DB sesuai platform**: Room/SQLite untuk app DB; modul bahasa sebagai file SQLite terpisah.
3. **Modul terpisah per bahasa**: `ModuleManifest` + registry `InstalledModuleEntity`.
4. **Update online**: `ModuleInstaller` memiliki alur verifikasi checksum dan instal atomik (skeleton).
5. **Banner atas/bawah**: `AdBannerSlot` ditempatkan di `AppRoot`.

## Cara Menggunakan

Ini adalah skeleton/kerangka, bukan proyek Gradle lengkap siap-build. Untuk menjadikannya proyek runnable:

1. Buat proyek Android baru di Android Studio (Empty Compose Activity).
2. Salin paket `com.example.kbbidictionary` dan file Gradle yang relevan.
3. Tambahkan dependency Room, Coroutines, OkHttp/Retrofit, dan Google Mobile Ads.
4. Ganti placeholder AdMob App ID/unit ID dengan test ID saat development.
5. Implementasikan query SQLite ke file modul `.sqlite` yang diunduh.

## Catatan Penting

- Gunakan **test ad unit ID** selama development.
- Verifikasi `checksum_sha256`, `min_app_version`, dan `db_schema_version` sebelum instal modul.
- Simpan modul di storage internal aplikasi, bukan lokasi publik.