DOKUMENTASI PROGRAM MASTER APS

1. Deskripsi Singkat:

   • Program ini dibuat dengan tujuan untuk memudahkan pencatatan stok komoditas pada CV BumiAji dan mempermudah untuk owner dalam men-generate informasi yang dibutuhkan dalam bisnis berupa laporan rekap penjualan, panen, dan laporan laba rugi. Program ini juga dilengkapi dengan 1 Area Chart yang menggambarkan kenaikan/penurunan pada penjualan tiap bulan, serta 2 Pie Chart yang menggambarkan proporsi pasar dan komoditas serta produk yang dijual terhadap seluruh pemasukan pada CV. BumiAji.
   • Program ini terdiri dari 10 entitas yang dapat dilihat pada models.py pada folder guava yang merupakan satu-satunya app pada project ini.

2. Instalasi:

   Untuk menjalankan program ini, sebelumnya perlu melakukan instalasi framework django dan package weasyprint melalui cmd atau terminal vscode.

   • Install django: pip install django
   • Install Weasyprint = pip install weasyprint

3. Penggunaan

   Untuk menggunakan program ini, anda bisa menjalankan perintah: 'python manage.py runserver' pada terminal. Setelah itu akan muncul address http://127.0.0.1:8000/ untuk menjalankan program secara lokal pada komputer anda.

   Penggunaan Program ini dibatasi pada 3 role utama yaitu owner, admin, dan karyawan dimana penggunaan role disini sebagai bentuk dari Authentication dan Authorization untuk membatasi hak akses stakeholder pada sistem.

   Pertama, user akan diarahkan menuju laman login untuk masuk dengan akun yang sudah terdaftar. Jika akun adalah sebagai admin/owner maka akan langsung menampilkan dashboard ketika selesai login. Sedangkan untuk karyawan akan diarahkan ke laman mitra. Kedua, user dapat mengakses fitur-fitur yang diperbolehkan untuk masing-masing role. Ketiga, ketika selesai, user diperkenankan untuk logout dari sistem.

4. Penjelasan Program Pada Program Master ini, Semua Code relevan dan bisa digunakan sebagai penunjang pembuatan program kelompok. Namun perlu diketahui bahwa pada beberapa function, digunakan syntax khusus yang tidak diwajibkan ada pada program kelompok. function-function tersebut adalah: i. def create_panen(request, id): & def ubah_panen(request, id): function ini menggunakan inline formset factory untuk memudahkan pembuatan (create) data untuk hubungan one to many antara panen dan detail panen ii. def create_detailpenjualan_produk(request, id): & def create_detailpenjualan_komoditas(request, id): function ini menggunakan inline formset factory untuk memudahkan pembuatan (create) data untuk hubungan one to many antara penjualan dan detail penjualan. kedua fungsi ini juga memisahkan pengisian detail penjualan menjadi 2 form yang berbeda, 1 untuk detail penjualan produk, dan 1 lagi untuk detail penjualan komoditas.

5. Referensi Dokumentasi Resmi Django : https://docs.djangoproject.com/en/4.2/ Youtube : Keyword: Django Course, Django Tutorial, Django Inline Formset, etc

6. Kontak faiqulm.losik@gmail.com apslosik.ub@gmail.com