Skip to content

samudradev/samudra-app

Repository files navigation

Samudra App

Samudra ialah aplikasi perkamusan dan pengurusan istilah untuk memudahkan pencatatan istilah serta pengongsiannya sesama rakan sekerja atau orang awam. Dengan memudahkan proses ini, kita dapat menambah jumlah rujukan bahasa Melayu dalam talian sekali gus mempercepatkan perkembangannya dari segi penggunaan, penyelidikan serta pembelajarannya.

Demo

samudra_demo.mp4

Reka Data

Data kamus direka supaya satu kata boleh mendukung banyak konsep serta satu perkataan boleh dipadankan ke banyak kata asing yang bergantung pada konsep dan konteks yang digunakan.

Inspirasi

Reka bentuk dan reka fungsi aplikasi ini diinspirasikan daripada beberapa kamus dalam talian:

  1. Akebi (Bahasa Jepun)
  2. Meriam-Webster (Bahasa Inggeris)
  3. KamusAstro (Bahasa Indonesia, khusus 'Astronomi')
  4. Gelintaran 'define' Google (Bahasa Inggeris)

Reka Fungsi

  • Mewujudkan pangkalan data sqlite dalam folder berbeza.
  • Tunjukkan jumlah item mengikut jenis.
  • Memasukkan lemma beserta konsep, golongan kata, cakupan, dan kata asing.
  • Dapatkan dan padam lemma.
  • Sunting lemma dan konsep.
  • Sunting bahagian-bahagian lemma lain.
  • Padam bahagian-bahagian lemma.
  • Import dari CSV (dalam pembaikan).
  • Kongsi data dalam bentuk gambar.

Pengaturcaraan

Prasyarat:

  1. Dapatkan npm atau yarn untuk Javascript.
  2. Dapatkan Rust.
  3. Dapatkan tauri.
  4. Dapatkan pakej-pakej Javascript melalui:
    npm install
    
    atau
    yarn install
    
  5. Dapatkan cargo-watch (cargo sudah tersedia melalui rust) untuk membolehkan pelaksanaan cargo watch untuk ujian kod melalui :
    cargo install cargo-watch
    
  6. Dapatkan sqlx-cli melalui:
    cargo install sqlx-cli
    
    kemudian sediakan database contoh untuk dapatkan membolehkan sqlx semak queri:
    sqlx database setup --database-url sqlite:src-tauri/.samudra-check.db --source src-tauri/database/migrations
    
    atau (dimudahkan melalui package.json)
    npm run setup-db
    
    atau
    yarn setup-db
    

Pembangunan

  1. Klon repositori ini.
  2. Gunakan cargo atau npm atau yarn untuk laksanakan skrip pembangunan:
    cargo tauri dev
    
    atau
    npm run tauri dev
    
    atau
    yarn tauri dev
    

Ujian

  1. Dari root, boleh pilih salah satu:
    cargo  watch -x \"test --workspace\" -C src-tauri/ -c
    
    atau (dimudahkan melalui package.json)
    npm run watch
    
    atau
    yarn watch
    

Bina Habis

  1. Untuk hasilkan produk akhir, dalam bentuk .exe atau yang sepadan, laksanakan:
    cargo tauri build
    
    atau
    npm run tauri build
    
    atau
    yarn tauri build