Source

kargu / README.mkd

Full commit

Kargu

Dokumentasi Kargu (lang=id-ID)

Edisi aplikasi Android

Logo Kargu Status Buat

Nama        = Kargu
Subnama     = Kalkulator Perkiraan Penggunaan
Nama Edisi  = Energi Listrik
Judul       = Kargu, kalkulator untuk memperkiraan penggunaan energi listrik serta mencanangkan budaya hemat energi
Judul Alt.  = Kargu, mencanangkan budaya hemat energi dengan memperkiraan penggunaan energi listrik
Deskripsi Pendek  = Kargu adalah aplikasi kalkulator untuk memperkiraan penggunaan energi listrik yang bisa untuk variasi pelanggan prabayar atau pascabayar serta mencanangkan budaya hemat energi dengan aturan biaya oleh PLN.
Deskripsi Panjang = Terdapat di [deskripsi](/#deskripsi)
Tanggal     = 2013-03-XX XX:XX:XX
Foto Produk = ./screen/kargu_x.x_screen-hr.png
Berkas APK  = ./bin/Kargu_x.x.apk
Kategori    = Energi, Edukasi, Budaya, Referensi, Perkakas

Deskripsi

Kar·gu /kargu/ n

Kargu, disingkat dari [Ka]lkulator Perki[r]aan Peng[gu]naan, adalah aplikasi kalkulator sederhana dengan penyesuaian pendekatan ketetapan biaya oleh PLN dan undang-undang yang berlaku. Bermula dari keraguan pada kala ingin membeli dan alat elektronik baru, perlu tahu tagihan yang akan didapat nantinya jika pascabayar atau pulsa yang harus disiapkan jika prabayar.

Pada awalnya bertujuan utama untuk memperkiraan dengan perhitungan terdekat, sehingga belum menggunaan pendekatan simulasi secara nyata. Jadi hanya mencatat penggunaan rata-rata sehari dan mengalikannya untuk sebulan. Sehingga bukan mencatat penggunaan setiap hari dalam sebulan, walaupun fitur tersebut mungkin akan didukung nanti. Akan dilengkapi dengan ekstensi/perluasan pengetahuan budaya nasional (Indonesia) dalam penggunaan listrik sehari-hari di berbagai tempat, golongan tarif, dan kegunaan. Masih dibuat khusus untuk penggunaan energi listrik dan amat sederhana. Tapi jika diperlukan dapat diperluas dengan energi bahan bakar minyak, gas, dan lain-lain.

Kemampuan dan nilai masih dibatasi oleh informasi perhitungan dari PLN dan pemerintah yang belum terbuka dan diketahui secara mudah untuk publik. Sehingga sebagian besar menggunakan perkiraan terdekat yang umumnya dipakai. Juga memang saat ini untuk mempercepat pengembangan awal belum ada pemilihan golongan tarif dengan simbol seperti Rumah Tangga (R1, R2, R3), Sosial (S1, S2), Bisnis (B1, B2), dan lainnya. Lagipula akan lebih memudahkan pengguna untuk memulai tanpa harus mengetahui walaupun bisa agak mengurangi akurasi.

Dibuat berdasarkan pengalaman akan keraguan perhitungan untuk memperkirakan biaya dari penggunaan listrik secara manual. Sebagian besar pengguna atau pelanggan listrik ingin mengetahui dan seharusnya mengetahui lebih mengenai tagihan atau biaya yang perlu disiapkan per bulan tanpa harus berada pada kondisi setelah satu bulan pemakaian listrik. Sehingga bisa menjadi alternatif untuk mengatasi keraguan jika terdapat alat elektronik baru dalam lingkungan yang digunakan. Perlu diketahui bahwa ini masih dalam tahap eksperimen dan bertujuan utama untuk edukasi karena berawal dari tugas pembelajaran.

Perlu diketahui bahwa banyak sekali aplikasi seperti ini dalam berbagai bentuk seperti situs web, aplikasi, dan cara manual. Tapi yang ditekankan dalam aplikasi ini adalah penyesuaian dengan aturan PLN serta preferensi jenis layanan prayabar dan pascabayar. Terlebih lagi proyek ini lebih digagas dengan serius namun tetap santai dan dikembangkan secara terbuka.

Informasi Tambahan

Kontribusi

Kontribusi sangat disambut dalam bentuk dan ukuran apa saja seperti:

Harap menggunakan bahasa Inggris untuk pesan perubahan / commit message agar lebih mudah diakses untuk pengembangan. Nanti jika diterima maka akan termasuk dalam rilis stabil selanjutnya dan Anda akan diberi kredit.

Tips hemat energi

Catatan untuk orang umum, khususnya Indonesia.

  • Membuat kebiasaan hemat energi menjadi budaya nasional.
  • Menggunakan peralatan listrik seperlunya.
  • Membiasakan mengecek meteran secara berkala.
  • Menyiapkan pulsa/token listrik untuk berjaga-jaga bagi pelanggan listrik prabayar.
  • Menghindari biaya keterlambatan (BK) dengan bersiap setiap bulan atau beralih ke langganan listrik prabayar.
  • Mengcegah penyalahgunaan listrik oleh orang lain.
  • Mengotomatisasi alat elektronik dengan menjadwalkan proses. Seperti di komputer atau ponsel yang terdapat aplikasi untuk menjadwalkan kapan sistemnya akan dihibernasi / hibernate atau dimatikan / shut down secara otomatis setelah pemakaian tertentu. Sehingga baterai dan penggunaan energi lebih irit.
  • Mencegah putusya arus listrik secara tiba-tiba dengan mengetahui batas daya listrik.
  • Mengetahui adanya Penertiban Pemakaian Tenaga Listrik (P2TL).
  • Mengetahui adanya Hari Listrik Nasional (HLN) setiap tanggal 27 Oktober.
  • Mengetahui adanya Jam Bumi / Earth Hour setiap akhir bulan Maret. (Walaupun banyak spekulasi mengenai ini.)

Daftar Berita


Log Perubahan

EUC/Kargupy 0.1-0.8

Kargu 0.1

Kargu 0.2

Kargu x.x (TODO)

  • Layar muka / splash screen sederhana.
  • Antarmuka pengguna / user interface dengan HoloEverywhere dan ActionBarSherlock untuk kompatibilitas dengan Android versi lama.
  • Aset visual tambahan.
  • Mengadakan:
  • perihal aplikasi
  • bantuan pengguna
  • pengaturan pengguna
  • Menggunakan Integrasi Kontinu (IK) / Continuous Integration (CI) bernama Travis-CI.

Alur Skema

Skema Simulasi Listrik oleh PLN

Simulasi yang diberikan oleh Perusahaan Listrik Negara (PT PLN) yaitu Simulasi Listrik memerlukan data pelanggan listrik pascabayar dan hanya dapat mengambil masukan berupa:

  • golongan tarif tanpa simbol
  • batas daya dalam volt ampere (VA)
  • jumlah pemakaian dalam kiloWatt per jam (kWh)

Lalu memberikan keluaran berupa:

  • biaya beban dalam kilovolt ampere per bulan (kVA/bulan)
  • biaya abonemen dalam Rupiah (Rp)
  • jumlah pemakaian dalam kiloWatt per jam (kWh)
  • biaya beban dalam Rupiah (Rp)
  • biaya total dalam Rupiah (Rp)

Di akhir pengguna bisa melakukan perhitungan ulang. Kemungkinan tidak adanya kostumisasi adalah saat itu belum banyak yang menggunakan listrik prabayar.

Skema Perkiraan oleh Kargu

Inti penyelesaian agak berbeda dengan simulasi biaya oleh PLN atau tabel perhitungan lainnya. Dimana pada umumnya memerlukan informasi penggunaan per bulan yang sudah berlalu (untuk pelanggan listrik pascabayar), sedangkan aplikasi ini hanya memerlukan informasi umum yang telah diketahui secara mudah, baik pelanggan listrik prabayar atau pascabayar, yaitu:

  • batas daya listrik rumah atau tempat tinggal,
  • beberapa alat elektronik yang sudah diketahui atau akan dipakai,
  • jenis alat elektronik, atau
  • daya yang dibutuhkan dan waktu penggunaannya berdasarkan perkiraan maksimum.

Masukan menjadi seperti:

Tabel Masukan

Variabel Ukuran Nilai Blok
Daya Listrik Volt Ampere 2200 Pickers
Elektronik Watt 100 Text
Jam 24 Pickers

Hasilnya adalah informasi detail mengenai:

  • perbandingan budaya penggunaan daya listrik dengan daerah sekitar,
  • daftar alat elektronik dan atributnya, serta
  • beberapa nilai Watt, kWh, biaya, harga, tagihan, pajak, dan total biaya yang sebaiknya disiapkan; dalam ukuran waktu jam, harian, dan bulanan.

Keluaran menjadi seperti:

Tabel Hitung

Variabel Ukuran Nilai
Daya Listrik Volt Ampere 2200
Elektronik Watt 100
Jam 24
Watt/Jam 2400
Total Watt/Jam 100
Pengunaan Watt/Hari 2400
kWh/Hari 2.4
kWh/Bulan 72.0

Tabel Biaya

Variabel Ukuran Nilai
Biaya Langganan Rupiah 59400
Harga/kWh Rupiah 650
Biaya/Bulan xPajak
Prabayar Rupiah 46800
Pascabayar Rupiah 106200
Pajak/Bulan Persen 10
Biaya/Bulan
Prabayar Rupiah 51480
Pascabayar Rupiah 116820

Di akhir pengguna bisa melakukan perhitungan ulang. Dan rencananya bisa menyimpan data masukan dan hasil laporan yang didapat.


Membangun

Untuk membangunnya direkomendasikan dengan spesifikasi kebutuhan perangkat lunak / software dependency berikut:

  • Sistem operasi seperti Unix:
  • Ubuntu
  • Arch
  • Mac OS X
  • Git
  • IDE untuk Java seperti Eclipse atau IntelliJ IDEA
  • Ant versi 1.8.0+
  • Maven versi 3.0.0+
  • SDK (KPPL) Android versi 21+
  • Ruby versi 2.0.0+ (untuk tes dengan Calabash)
  • dan lainnya sesuai preferensi Anda

Juga direkomendasikan dengan variabel alamat lintasan / path di konfigurasi shell (bash/zsh/dll) seperti berikut jika belum diatur:

export ANDROID_HOME = "/alamat/lintasan/ke/android-sdk/"
export ANDROID_TOOLS = "/alamat/lintasan/ke/android-sdk/tools/"
export ANDROID_PTOOLS = "/alamat/lintasan/ke/android-sdk/platform-tools/"

export JAVA_HOME="/usr/lib/jvm/java-7-oracle"
export ANT_HOME = "/usr/local/apache-ant-1.8.4/"
export MAVEN_HOME = "/usr/local/apache-maven-3.0.5/"
export M3_HOME = "/usr/local/apache-maven-3.0.5/"
export M3 = "/usr/local/apache-maven-3.0.5/"

PATH=$PATH:$ANDROID_TOOLS:$ANDROID_PTOOLS:$ANT_HOME/bin:$MAVEN_HOME/bin:$M2_HOME/bin:$M2/bin

Lalu jalankan dengan salah satu perintah berikut:

  • mvn clean package untuk membuat APK saja
  • mvn clean install untuk membuat APK dan menjalankan tes integrasi (membutuhkan perangkat Android di emulator atau nyata)
  • ant clean debug untuk membuat APK mode antikutu / debug saja

Untuk hal pengembangan lain seperti:

  • pengetesan:
  • Calabash versi 0.4.0+ (Instal dengan sudo gem install calabash-android jika belum ada)
  • Robotium
  • pengendali kebutuhan:
  • Roboguice
  • pemecahan masalah / troubleshooting:
  • periksa kembali seluruh hal penting yang dibutuhkan
  • cek jika ada kesalahan ketik

Kata-Kata Lain

Lisensi

Kode sumber dirilis di bawah Lisensi MIT.

Berkas gambar, visual, dan suara dirilis di bawah lisensi Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported.

Ucapan Terima Kasih

  • Google, Android, dan Open Handset Alliance
  • Komunitas Sumber Terbuka
  • Proyek, aplikasi, dan perpus:
  • Android-Maven-Plugin
  • ActionBarSherlock
  • Calabash
  • RoboGuice
  • dan lain-lain

Bahan, referensi, atau tautan yang belum disebutkan di sini terdapat di berkas pengembangan atau mungkin tersebar di beberapa berkas teks berekstensi .mkd.


  • [KARGU]: Kalkulator Perkiraan Penggunaan
  • [P2TL]: Penertiban Pemakaian Tenaga Listrik
  • [HLN]: Hari Listrik Nasional
  • [MIT]: Massachusetts Institute of Technology