<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Pradipta Arya on Medium]]></title>
        <description><![CDATA[Stories by Pradipta Arya on Medium]]></description>
        <link>https://medium.com/@diptaarya18?source=rss-a0ab27b3e064------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>Stories by Pradipta Arya on Medium</title>
            <link>https://medium.com/@diptaarya18?source=rss-a0ab27b3e064------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 23:44:18 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@diptaarya18/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Monitor Error Django Secara Real-Time dengan Sentry dan Thunder Client]]></title>
            <link>https://medium.com/@diptaarya18/monitor-error-django-secara-real-time-dengan-sentry-dan-thunder-client-ca1e17635752?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/ca1e17635752</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Tue, 20 May 2025 03:42:56 GMT</pubDate>
            <atom:updated>2025-05-20T03:42:56.921Z</atom:updated>
            <content:encoded><![CDATA[<p>Saat membangun aplikasi web, kita pasti akan berhadapan dengan berbagai macam error, dari yang ringan sampai yang membuat server crash. Dalam proyek Django yang saya kerjakan, saya mulai menggunakan <strong>Sentry</strong> untuk memonitor error secara real-time dan <strong>Thunder Client</strong> untuk menguji API langsung dari Visual Studio Code. Blog ini merangkum langkah-langkah setup hingga penanganan error yang saya temui.</p><h3>Kenapa Monitoring Itu Penting?</h3><p>Dalam pengembangan aplikasi, error itu tidak bisa dihindari. Tapi yang lebih penting dari “tidak error” adalah: <strong>bagaimana kita tahu jika error itu terjadi?</strong></p><p>Tanpa monitoring, kita hanya mengandalkan laporan dari pengguna — yang biasanya datang telat, tidak jelas, atau bahkan tidak pernah disampaikan. Monitoring memungkinkan kita untuk:</p><ul><li>Mengetahui error <strong>sedetik setelah terjadi</strong></li><li>Melihat <strong>jejak lengkap penyebab error</strong></li><li>Memperbaiki sebelum user bahkan menyadarinya</li></ul><p>Itulah kenapa saya memilih mengintegrasikan <strong>Sentry</strong> dalam proyek Django ini: untuk memantau error dan performa aplikasi secara real-time.</p><h3>1. Setup Awal Sentry di Django</h3><p>Langkah pertama adalah mengintegrasikan Sentry ke dalam proyek Django:</p><pre>pip install sentry-sdk</pre><p>Kemudian saya tambahkan konfigurasi berikut ke settings.py:</p><pre>import sentry_sdk<br>from sentry_sdk.integrations.django import DjangoIntegration<br><br>sentry_sdk.init(<br>    dsn=&quot;https://&lt;DSN-ANDA&gt;@sentry.io/&lt;PROJECT_ID&gt;&quot;,<br>    integrations=[DjangoIntegration()],<br>    traces_sample_rate=1.0,<br>    send_default_pii=True,<br>)</pre><h3>2. Uji Error Pertama: Endpoint /sentry-test/</h3><p>Untuk memastikan integrasi berhasil, saya buat satu endpoint khusus:</p><pre>def sentry_test(request):<br>    division_by_zero = 1 / 0</pre><p>Ketika saya mengakses http://localhost:8000/sentry-test/, hasilnya adalah:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*U96ZH2vyFvFR7jy1uugANw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CZsVklOWO8EK2A7iKlE4hA.png" /></figure><ul><li>Error 500 di browser</li><li>Masuknya error ZeroDivisionError ke dashboard Sentry</li></ul><p>Sukses! Sentry sudah bekerja dengan baik.</p><h3>3. Install Thunder Client untuk Testing API</h3><p>Untuk menguji endpoint API, saya memilih <strong>Thunder Client</strong>, plugin ringan di Visual Studio Code:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VT_GRV5MNPbzZ6moI4UCiA.png" /></figure><ul><li>Buka Extensions</li><li>Cari <strong>Thunder Client</strong></li><li>Klik <strong>Install</strong></li></ul><p>Dengan ini, saya bisa melakukan request POST, GET, dll ke API backend tanpa perlu tool terpisah.</p><h3>4. Hit Endpoint Tambah Produk dengan Harga Tinggi</h3><p>Saya menggunakan endpoint berikut untuk menambah produk:</p><pre>POST /api/produk/create</pre><p>Body request berisi data produk dengan harga jual tidak wajar:</p><pre>{<br>  &quot;nama&quot;: &quot;Produk Mahal&quot;,<br>  &quot;harga_modal&quot;: 1000000,<br>  &quot;harga_jual&quot;: 10000000000000,<br>  &quot;stok&quot;: 10,<br>  &quot;satuan&quot;: &quot;pcs&quot;,<br>  &quot;kategori&quot;: &quot;Premium&quot;<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BvHSr8QXitlry1Jy4XVidg.png" /></figure><p>Hasilnya? Error 500 lagi. Tapi kali ini errornya adalah:</p><pre>&lt;class &#39;decimal.InvalidOperation&#39;&gt;</pre><p>Sentry langsung mencatatnya sebagai InvalidOperation, karena nilai DecimalField terlalu besar untuk disimpan di database.</p><h3>5. Revisi Code Tambah Produk dengan Constraint</h3><p>Untuk mencegah input nilai harga yang tidak valid, saya menambahkan validasi batas maksimum harga:</p><pre>from decimal import Decimal, InvalidOperation<br><br>MAX_DECIMAL = Decimal(&quot;99999999.99&quot;)<br># Di dalam endpoint create_produk<br>try:<br>    if Decimal(payload.harga_modal) &gt; MAX_DECIMAL or Decimal(payload.harga_jual) &gt; MAX_DECIMAL:<br>        return 422, {&quot;message&quot;: &quot;Harga terlalu besar. Maksimum 99.999.999,99&quot;}<br>except InvalidOperation:<br>    return 422, {&quot;message&quot;: &quot;Format harga tidak valid&quot;}</pre><h3>6. Revisi Code Edit Produk (Update)</h3><p>Agar endpoint update produk juga aman, saya menambahkan validasi yang sama ke fungsi update_produk:</p><pre>if &#39;harga_modal&#39; in update_data and Decimal(update_data[&#39;harga_modal&#39;]) &gt; MAX_DECIMAL:<br>    return 422, {&quot;message&quot;: &quot;Harga modal terlalu besar.&quot;}<br><br>if &#39;harga_jual&#39; in update_data and Decimal(update_data[&#39;harga_jual&#39;]) &gt; MAX_DECIMAL:<br>    return 422, {&quot;message&quot;: &quot;Harga jual terlalu besar.&quot;}</pre><p>Dengan ini, semua input harga yang tidak wajar akan dikembalikan dengan HTTP 422 beserta pesan kesalahan yang informatif.</p><h3>7. Uji Kembali Setelah Revisi</h3><p>Setelah revisi validasi, saya coba lagi menambahkan produk dengan harga 1.000.000.000.000. Kali ini tidak muncul error 500.</p><p>Sebaliknya, saya menerima response:</p><pre>{<br>  &quot;message&quot;: &quot;Harga terlalu besar. Maksimum 99.999.999,99&quot;<br>}</pre><p>dengan status HTTP <strong>422 Unprocessable Entity</strong> — sesuai ekspektasi. Error berhasil ditangani dengan baik, user mendapat respon yang jelas, dan tidak ada lagi crash di server maupun di Sentry.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/807/1*REee2XDRkwAOaoz2Cjq9sA.png" /></figure><h3>8. Integrasi Sentry ke Discord untuk Notifikasi Langsung</h3><p>Satu fitur Sentry yang sangat berguna adalah kemampuannya untuk terhubung langsung ke Discord. Ini memungkinkan tim developer mendapat notifikasi real-time saat ada error, langsung di ruang diskusi yang mereka gunakan.</p><h3>Cara Integrasinya:</h3><ol><li>Buka <strong>Server Discord</strong> kamu</li><li>Masuk ke Server Settings &gt; Integrations &gt; Webhooks</li><li>Klik <strong>New Webhook</strong> dan pilih channel tempat notifikasi akan dikirim</li><li>Copy <strong>Webhook URL</strong></li><li>Kembali ke dashboard Sentry</li><li>Masuk ke Settings &gt; Integrations &gt; Discord</li><li>Klik <strong>Add Installation</strong>, lalu paste Webhook URL tadi</li></ol><p>Setelah ini, setiap error baru yang terjadi akan langsung muncul di channel Discord yang ditentukan, lengkap dengan:</p><ul><li>Nama project</li><li>Jenis error</li><li>Stack trace singkat</li><li>Link langsung ke detail error di dashboard Sentry</li></ul><p>Dengan integrasi ini, monitoring bukan hanya terjadi di dashboard yang jarang dibuka, tapi langsung masuk ke ruang diskusi aktif. Respon jadi lebih cepat, dan error bisa ditangani sebelum merembet ke pengguna lain. Dan discord anda akan muncul seperti ini:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nG5LkT_32hRM7PAoY18rIA.png" /></figure><h3>Refleksi</h3><p>Dari proses setup hingga debugging yang saya lalui, saya menyadari bahwa monitoring bukanlah pelengkap, tapi justru bagian krusial dari sistem yang andal. Dengan <strong>Sentry</strong>, saya bisa langsung tahu saat sistem jatuh, dan dengan <strong>Discord</strong>, saya bisa tahu <em>kenapa</em> dan <em>di mana</em>, tanpa harus menunggu laporan user.</p><p>Tool seperti <strong>Thunder Client</strong> juga mempermudah proses pengujian endpoint secara cepat, terutama saat menangani bug atau validasi input.</p><p>Meskipun error seperti harga terlalu besar tampak sepele, jika dibiarkan bisa membuat aplikasi tidak stabil. Kombinasi <strong>monitoring, validasi, dan notifikasi</strong> membantu saya menyelesaikan masalah lebih cepat, lebih akurat, dan lebih percaya diri.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ca1e17635752" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Meningkatkan Kualitas API Django Ninja melalui Automatic Testing dan Static Analysis]]></title>
            <link>https://medium.com/@diptaarya18/meningkatkan-kualitas-api-django-ninja-melalui-automatic-testing-dan-static-analysis-5f8e98eef968?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/5f8e98eef968</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Mon, 19 May 2025 16:48:39 GMT</pubDate>
            <atom:updated>2025-05-19T16:59:42.856Z</atom:updated>
            <content:encoded><![CDATA[<p>Dalam dunia pengembangan perangkat lunak, menjaga kualitas kode bukan sekadar formalitas — ia adalah fondasi dari skalabilitas dan keberlanjutan produk. Dalam blog ini, saya ingin membagikan pengalaman saya dalam meningkatkan kualitas API backend Django Ninja yang saya kembangkan, khususnya pada modul produk/api.py. Pendekatan ini tidak lepas dari inspirasi dua artikel hebat tentang <strong>static analysis</strong> menggunakan SonarQube dan bagaimana pentingnya kolaborasi serta standarisasi dalam tim development.</p><h3>Konteks: Mengelola Produk dalam Sistem Multi-Tenant</h3><p>Modul produk/api.py merupakan pusat dari fitur manajemen produk untuk setiap toko (tenant) dalam sistem kami. Mulai dari melihat daftar produk, membuat, memperbarui, menghapus, hingga menghitung produk paling laku dan stok rendah—semua terpusat di satu modul ini.</p><p>Beberapa tantangan yang muncul selama pengembangannya:</p><ul><li>Menjaga validasi data tetap terkontrol tanpa mengorbankan fleksibilitas.</li><li>Menjamin data tetap terisolasi per toko.</li><li>Menghindari duplikasi logika saat menangani autentikasi dan hak akses.</li></ul><h3>Refactor &amp; Struktur API</h3><p>Untuk memastikan kualitas dan keterbacaan, kami memecah skema dan autentikasi sebagai berikut:</p><ul><li>AuthBearer: Autentikasi custom menggunakan JWT.</li><li>ProdukResponseSchema, CreateProdukSchema, UpdateProdukSchema: Mengelola data masuk dan keluar secara eksplisit.</li><li>Endpoint menggunakan pola REST, misalnya:</li><li>GET /produk/page/{page} → untuk pagination.</li><li>POST /produk/create → untuk menambah produk.</li><li>GET /produk/low-stock → untuk mendeteksi produk dengan stok rendah.</li></ul><p>Refactoring dilakukan agar setiap fungsi API:</p><ul><li>Memiliki validasi dan pengecekan kepemilikan toko secara eksplisit.</li><li>Menangani response yang konsisten dengan status HTTP.</li><li>Mudah diuji karena tidak memiliki dependensi eksplisit terhadap objek global.</li></ul><h3>Implementasi Automatic</h3><p>Setelah struktur cukup solid, kami masuk ke tahap pengujian. Di sinilah produk/tests.py berperan besar. Kami membuat <strong>unit test dan integrasi ringan</strong> untuk menguji seluruh endpoint utama. Fokus kami adalah:</p><ul><li>Validasi input dan output (schema).</li><li>Perlakuan terhadap user tanpa toko.</li><li>Filtering, sorting, dan paginasi yang benar.</li><li>Fungsi bisnis seperti produk terlaris dan stok rendah.</li></ul><h3>Contoh Pengujian:</h3><pre>def test_get_units(self):<br>    request = MockRequest(user_id=self.user1.id)<br>    status, data = get_units(request)<br>    self.assertEqual(status, 200)<br>    self.assertEqual(data, [&#39;Pcs&#39;])</pre><p>Pengujian ini mengecek bahwa endpoint GET /produk/units mengembalikan satuan milik toko terkait. Kami juga menyiapkan kasus negatif seperti:</p><pre>def test_get_units_no_toko(self):<br>    request = MockRequest(user_id=self.user_no_toko.id)<br>    status, resp = get_units(request)<br>    self.assertEqual(status, 404)<br>    self.assertEqual(resp[&#39;message&#39;], &quot;User doesn&#39;t have a toko&quot;)</pre><h3>Mocking dan Isolasi</h3><p>Beberapa fungsi seperti get_top_selling_products menggunakan model TransaksiItem, yang tidak selalu ideal untuk diuji secara langsung. Di sinilah kami menggunakan patch untuk membuat mock query:</p><pre>@patch(&#39;produk.api.TransaksiItem.objects.filter&#39;)<br>def test_get_most_popular_products(self, mock_filter):<br>    # ...</pre><p>Mocking ini sangat krusial untuk:</p><ul><li>Mengontrol data uji.</li><li>Mempercepat proses pengujian.</li><li>Menghindari ketergantungan pada data riil atau integrasi database kompleks.</li></ul><h3>Analisis Statis dan Pemeriksaan Kode</h3><p>Setelah pengujian berjalan stabil, langkah berikutnya adalah <strong>static analysis </strong>menggunakan SonarQube. Dengan menghubungkan pipeline CI/CD ke SonarQube dapat ditemukan Issues berikut:</p><h3>1. Avoid Duplication: Gunakan Konstanta untuk Pesan Error</h3><p>Masalah: &quot;User doesn&#39;t have a toko&quot; muncul di banyak tempat (9–11 kali).</p><p><strong>Solusi:</strong><br> Tambahkan konstanta global di awal file produk/api.py:</p><pre>NO_TOKO_MESSAGE = &quot;User doesn&#39;t have a toko&quot;</pre><p>Lalu ganti semua penggunaan literal string tersebut:</p><pre>return 404, {&quot;message&quot;: NO_TOKO_MESSAGE}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zNzMDb7mr3JYhkRKb7X42g.png" /></figure><h3>2. Remove Unused Variable: e Tidak Digunakan</h3><p>Masalah: Kamu menangkap exception sebagai except Exception as e: tapi tidak menggunakan e.</p><p><strong>Solusi: Hapus </strong><strong>as e</strong>:</p><pre>except Exception:<br>    return 404, {&quot;message&quot;: &quot;Produk tidak ditemukan&quot;}</pre><p>Namun jika hanya ingin tangkap DoesNotExist, lebih baik gunakan:</p><pre>from django.core.exceptions import ObjectDoesNotExist<br><br>try:<br>    ...<br>except ObjectDoesNotExist:<br>    return 404, {&quot;message&quot;: &quot;Produk tidak ditemukan&quot;}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9hOb_sZu_DlpjeXU2kg-sw.png" /></figure><h3>3. Remove Unused Local Variable: stocks di Testing</h3><p>Masalah: Di produk/tests.py, kamu mendefinisikan variabel stocks tapi tidak digunakan.</p><p><strong>Solusi:</strong><br> Cukup hapus deklarasi stocks karena kamu sudah menggunakan ekspresinya di assertTrue:</p><pre>stocks = [item[&#39;stock&#39;] for item in items]</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gFs6pZbcXtK2VzCHb5uhfg.png" /></figure><p>Dengan perubahan-perubahan ini, Issues terkait modul produk sudah teratasi, sehingga code menjadi lebih bersih dan rapih.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*s0nrw79FbelW6Yz3pw7HuQ.png" /></figure><h3>Tentang “Integrasi Tools dalam Pipeline CI/CD”</h3><p>Mengintegrasikan tools seperti <strong>SonarQube</strong> ke dalam <strong>pipeline CI/CD</strong> merupakan salah satu best practice terpenting dalam menjaga kualitas perangkat lunak secara otomatis dan berkelanjutan. Dengan integrasi ini, proses analisis kode dan pengujian tidak lagi dilakukan secara manual oleh developer, melainkan menjadi bagian dari alur otomatis setiap kali terjadi perubahan kode.</p><p>Dalam proyek ini, kami menggunakan GitHub Actions sebagai platform CI/CD utama. File sonarqube.yml yang ditempatkan di direktori .github/workflows/ dirancang untuk menjalankan analisis SonarQube secara otomatis setiap kali terjadi push atau pull_request ke cabang mana pun (&quot;**&quot;).</p><h4>Rangkaian Proses dalam sonarqube.yml:</h4><ol><li><strong>Checkout Repository</strong><br> Menyalin kode terbaru dari GitHub ke runner untuk dianalisis.</li><li><strong>Setup Python Environment</strong><br> Mengatur lingkungan Python yang konsisten di versi 3.10, sesuai dengan dependensi proyek.</li><li><strong>Install Dependencies &amp; Coverage</strong><br> Menginstall requirements dari requirements.txt serta coverage untuk menghasilkan laporan pengujian otomatis.</li><li><strong>Run Tests with Coverage</strong><br> Menjalankan test pada modul produk dan menghasilkan file coverage.xml. File ini nantinya akan dibaca oleh SonarQube sebagai dasar coverage metric.</li><li><strong>Run SonarQube Scanner</strong><br> Menggunakan action resmi dari SonarSource (sonarqube-scan-action@v2) untuk mengirim hasil analisis ke server SonarQube. Konfigurasi seperti projectKey, host.url, dan token login dimasukkan sebagai secret untuk alasan keamanan.</li></ol><p>Berikut adalah YAML-nya:</p><pre>name: SonarQube Analysis<br>on:<br>  push:<br>    branches:<br>      - &quot;**&quot;<br>  pull_request:<br>    branches:<br>      - &quot;**&quot;<br>jobs:<br>  sonar:<br>    runs-on: ubuntu-latest<br>    steps:<br>      - name: Checkout Repository<br>        uses: actions/checkout@v4<br>...</pre><h3>Implementasi Static Analysis Mandiri dengan Bandit</h3><p>Dalam pengembangan backend Django kami, menjaga keamanan bukan hanya soal endpoint, tetapi juga soal kebiasaan kecil seperti cara kita menulis test. Untuk itu, kami menerapkan <em>static analysis</em> secara lokal menggunakan Bandit, sebuah tool Python untuk mendeteksi potensi kerentanan keamanan secara otomatis dari kode sumber.</p><h3>Tujuan Penggunaan Bandit</h3><ul><li>Mendeteksi pola kode yang berpotensi menjadi celah keamanan</li><li>Mencegah kebocoran kredensial melalui <em>hardcoded secret</em></li><li>Memberikan validasi awal terhadap standar keamanan kode tim</li></ul><h3>Kasus yang Ditemukan: Hardcoded Password dalam Test</h3><p>Setelah menjalankan perintah:</p><pre>bandit -r produk/</pre><p>Bandit menandai beberapa baris kode test seperti berikut</p><pre>self.user1 = User.objects.create_user(username=&#39;user1&#39;, email=&#39;user1@example.com&#39;, password=&#39;pass&#39;)</pre><p>Masalah yang dilaporkan:</p><blockquote><strong><em>Possible hardcoded password</em></strong><em> — meskipun ini digunakan dalam konteks pengujian lokal, Bandit mengidentifikasinya sebagai potensi risiko keamanan (CWE-259).</em></blockquote><h3>Solusi: Gunakan secrets.token_urlsafe() untuk Dummy Password</h3><p>Alih-alih menggunakan string &quot;testing123!&quot; atau &quot;pass&quot; yang mudah ditebak dan ditandai sebagai insecure, kami menggantinya menjadi password acak yang aman dengan library bawaan Python:</p><pre>import secrets<br><br>dummy_password = secrets.token_urlsafe(12)<br>self.user1 = User.objects.create_user(<br>    username=&#39;user1&#39;,<br>    email=&#39;user1@example.com&#39;,<br>    password=dummy_password<br>)</pre><p>Keuntungan pendekatan ini:</p><ul><li>Tidak ditandai sebagai <em>hardcoded password</em> oleh Bandit</li><li>Aman digunakan berulang dalam konteks testing</li><li>Meningkatkan disiplin keamanan bahkan pada skenario internal</li></ul><h3>Hasil Evaluasi Bandit</h3><p>Setelah refactor:</p><ul><li>Semua peringatan terkait password hilang</li><li>Tidak ditemukan eval, exec, atau unsafe function lain</li><li>Kode test menjadi lebih aman dan tetap dapat digunakan untuk validasi fungsionalitas</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5f8e98eef968" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Membangun Aplikasi Aman untuk UMKM: Studi Kasus LANCAR dan Penerapan Secure Programming]]></title>
            <link>https://medium.com/@diptaarya18/membangun-aplikasi-aman-untuk-umkm-studi-kasus-lancar-dan-penerapan-secure-programming-c219a8fda00f?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/c219a8fda00f</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Wed, 14 May 2025 15:26:49 GMT</pubDate>
            <atom:updated>2025-05-19T15:16:37.900Z</atom:updated>
            <content:encoded><![CDATA[<h3>Pendahuluan</h3><p>LANCAR adalah aplikasi keuangan yang membantu UMKM dalam pencatatan arus kas, pembuatan laporan keuangan, dan menjembatani akses ke Bank Perkreditan Rakyat (BPR). Karena aplikasi ini menangani data sensitif, penerapan <strong>secure programming</strong> bukan hanya nilai tambah — tetapi keharusan.</p><p>Blog ini akan menjelaskan bagaimana LANCAR mengimplementasikan praktik keamanan berdasarkan standar OWASP dan best practice lain dalam pengembangan perangkat lunak, mulai dari backend, frontend, hingga proses pengembangan menyeluruh.</p><h3>1. Analisis Ancaman &amp; Risiko</h3><p>Dalam pengembangan aplikasi LANCAR, kami mengidentifikasi sejumlah potensi ancaman keamanan yang bisa muncul, terutama karena aplikasi ini bersifat multi-tenant dan menangani data keuangan yang sensitif. Beberapa ancaman yang kami analisis antara lain:</p><ul><li><strong>Penyalahgunaan Token JWT</strong><br> Pengguna jahat dapat mencoba memanipulasi token JWT untuk mendapatkan akses yang tidak sah ke data pengguna lain, termasuk toko atau laporan keuangan yang bukan miliknya.</li><li><strong>Akses Tidak Sah karena Bypass Role</strong><br> Jika tidak dilakukan kontrol yang ketat berdasarkan peran (role), maka user dengan role rendah seperti <em>Karyawan</em> bisa saja mencoba melakukan aksi yang seharusnya hanya bisa dilakukan oleh <em>Pemilik</em> atau <em>Pengelola</em>.</li><li><strong>Penyalahgunaan Token Undangan</strong><br> Token undangan bisa disalahgunakan apabila tidak ada masa berlaku yang jelas atau jika tidak divalidasi secara menyeluruh terhadap toko dan pengguna yang sah.</li><li><strong>Kebocoran Secrets dan Konfigurasi</strong><br> Karena aplikasi menggunakan OAuth dan JWT, terdapat beberapa credential penting seperti GOOGLE_CLIENT_SECRET yang berisiko bocor jika tidak dikelola dengan benar di .env.</li><li><strong>Penghapusan Data atau Akses Tidak Sah oleh Pengguna Internal</strong><br> Risiko ini muncul terutama jika <em>Pemilik</em> toko tidak sadar bahwa mereka bisa menghapus pengguna lain, atau jika tidak ada validasi terhadap identitas dan hubungan antar pengguna dalam satu toko.</li></ul><p>Seluruh ancaman ini dianalisis menggunakan pendekatan berbasis prinsip dari OWASP Top 10 dan OWASP Risk Rating, sehingga setiap risiko dapat diprioritaskan dan ditanggulangi dengan tepat.</p><h3>2. Autentikasi dan Autorisasi Aman</h3><h3>Backend: Django + JWT</h3><p>Kami menggunakan rest_framework_simplejwt untuk mengatur token-based authentication.</p><h4>Contoh: Generate Access &amp; Refresh Token</h4><pre>from rest_framework_simplejwt.tokens import RefreshToken</pre><pre>@router.post(&quot;/process-session&quot;)<br>def process_session(request, session_data: SessionData):<br>    user = get_or_create_user(session_data.user)<br>    refresh = RefreshToken.for_user(user)</pre><pre>    return {<br>        &quot;refresh&quot;: str(refresh),<br>        &quot;access&quot;: str(refresh.access_token),<br>        ...<br>    }</pre><h3>Validasi Token</h3><pre>@router.post(&quot;/validate-token&quot;)<br>def validate_token(request, token_data: TokenValidationRequest):<br>    try:<br>        AccessToken(token_data.token)<br>        return {&quot;valid&quot;: True}<br>    except TokenError:<br>        return {&quot;valid&quot;: False}</pre><h3>Role-Based Access Control</h3><pre>@router.post(&quot;/send-invitation&quot;, auth=AuthBearer())<br>def send_invitation(request, payload: InvitationRequest):<br>    user = User.objects.get(id=request.auth)</pre><pre>if user.role not in [&#39;Pemilik&#39;, &#39;Pengelola&#39;]:<br>        return 400, {&quot;error&quot;: &quot;Hanya Pemilik atau Pengelola yang dapat mengirim undangan.&quot;}</pre><h3>Frontend: Next.js + NextAuth</h3><p>Frontend menangani login menggunakan Google OAuth yang aman dan tidak menyimpan token di localStorage.</p><h4>Autentikasi Google + Validasi Backend</h4><pre>useEffect(() =&gt; {<br>    if (session) {<br>        fetch(`${config.apiUrl}/auth/process-session`, {<br>            method: &#39;POST&#39;,<br>            headers: { &#39;Content-Type&#39;: &#39;application/json&#39; },<br>            body: JSON.stringify({ user: session.user }),<br>        })<br>        .then(response =&gt; response.json())<br>        .then(data =&gt; {<br>            setAuthData({<br>                user: data.user,<br>                access: data.access,<br>                refresh: data.refresh<br>            });<br>            router.push(&#39;/&#39;);<br>        });<br>    }<br>}, [session]);</pre><h4>Proteksi Akses Berdasarkan Role</h4><p>Setiap route yang sensitif hanya dapat diakses oleh role tertentu. Di sisi frontend, data role disimpan di context dan digunakan untuk membatasi fitur (misal: hanya Pemilik bisa menghapus user).</p><h3>3. Penerapan Secure Coding &amp; Pengujian</h3><h3>Validasi Token Undangan + Expiry</h3><pre>decoded = jwt.decode(payload.token, settings.SECRET_KEY, algorithms=[&quot;HS256&quot;])<br>if now() &gt; datetime.fromtimestamp(decoded[&quot;exp&quot;]):<br>    return {&quot;valid&quot;: False, &quot;error&quot;: &quot;Token expired&quot;}</pre><h3>Input Sanitization dan Duplicate Check</h3><pre>email = payload.email.strip().lower()<br>if User.objects.filter(email=email, toko=user.toko).exists():<br>    return 400, {&quot;error&quot;: &quot;User sudah ada di toko ini.&quot;}</pre><h3>Token Hanya untuk Toko yang Sah</h3><pre>if invitation.toko.id != user.toko.id:<br>    return 403, {&quot;message&quot;: &quot;You don&#39;t have permission to delete this invitation&quot;}</pre><h3>Pengujian Keamanan dengan Postman</h3><p>Untuk memastikan bahwa fitur-fitur keamanan di aplikasi <em>LANCAR</em> benar-benar bekerja sebagaimana mestinya, saya melakukan serangkaian pengujian manual menggunakan Postman. Pengujian ini berfokus pada validasi autentikasi, autorisasi berbasis role, validitas token, serta perlindungan terhadap akses ilegal.</p><h3>1. Pengujian Autentikasi dan Token</h3><p>Langkah pertama adalah melakukan login melalui endpoint /auth/process-session, di mana token access dan refresh diberikan setelah autentikasi berhasil. Token ini saya gunakan dalam header Authorization untuk mengakses endpoint yang dilindungi seperti /auth/get-users.</p><p>Saya juga melakukan uji coba tanpa token dan dengan token yang telah dimanipulasi untuk memastikan sistem menolak akses yang tidak sah. Hasilnya, server secara konsisten memberikan response 401 Unauthorized atau pesan error &quot;Token not valid&quot; untuk token yang salah.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/1*eZd8VZWz9peTxXRkPZsKOQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/958/1*wBurmgoukWoM8uSC_bedBA.png" /></figure><h3>2. Pengujian Akses Berdasarkan Role</h3><p>Karena LANCAR menggunakan skema role-based access control (Pemilik, Pengelola, Karyawan), saya melakukan pengujian pada endpoint send-invitation. Saat menggunakan token dari user dengan role Pemilik, permintaan berhasil. Namun saat menggunakan token dari role Karyawan, server memberikan respon error &quot;Hanya Pemilik atau Pengelola yang dapat mengirim undangan.&quot;</p><p>Hal ini menunjukkan bahwa sistem telah menerapkan kontrol akses berdasarkan peran dengan benar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/947/1*ncjXkyMlRds6pZp6MeJ3Tg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/959/1*bW6ZOvoFLYnjk7kEdWl4OA.png" /></figure><h3>3. Pengujian Token Undangan dan Expiry</h3><p>Saya juga menguji fitur undangan yang menggunakan JWT dengan masa aktif 1 hari. Setelah mengirim undangan, saya mencoba memvalidasi token tersebut melalui endpoint /auth/validate-invitation. Jika token valid dan belum kadaluarsa, maka proses registrasi user baru berhasil. Namun ketika saya mencoba token yang telah expired atau dimanipulasi, sistem menolak dengan error &quot;Token expired&quot; atau &quot;Invalid token&quot;.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/959/1*-1yrrIjkj4koM2m-kFgssQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/1*l3GNQMq2YOpjAn3D_HKEOA.png" /></figure><h3>4. Simulasi Penyerangan Token</h3><p>Untuk menguji perlindungan terhadap token tampering, saya mengganti isi payload JWT dengan nilai yang tidak sesuai (misalnya mengganti toko_id). Hasilnya, server tetap memverifikasi validitas token menggunakan SECRET_KEY dan mencegah manipulasi token dari sisi klien.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/961/1*NYjf5iS9B84NlRL1wSX1Cg.png" /></figure><h3>4. Keamanan dalam Proses SDLC</h3><h3>.env (FrontEnd) dan Manajemen Secrets</h3><pre>GOOGLE_CLIENT_SECRET=GOCSPX-XX...<br>NEXTAUTH_SECRET=my_ultra_secure_nextauth_secret</pre><h3>Penutup</h3><p>Melalui pengujian menyeluruh menggunakan Postman, saya dapat memastikan bahwa fitur-fitur keamanan yang dibangun dalam aplikasi <em>LANCAR</em> tidak hanya bersifat deklaratif, tetapi benar-benar bekerja dalam skenario nyata. Mulai dari autentikasi, otorisasi, hingga validasi token dan peran pengguna, seluruhnya telah diuji untuk memastikan tidak ada celah yang bisa dimanfaatkan.</p><p>Secara langsung, penerapan ini juga mencerminkan kepatuhan terhadap beberapa poin krusial dalam <strong>OWASP Top 10</strong>, antara lain:</p><ul><li><strong>A01: Broken Access Control</strong><br> Telah diantisipasi melalui role-based access (Pemilik, Pengelola, Karyawan) yang dikontrol ketat pada setiap endpoint.</li><li><strong>A02: Cryptographic Failures</strong><br> Token JWT dikodekan dengan algoritma yang aman (HS256) dan hanya valid selama jangka waktu tertentu, sehingga mencegah reuse dan tampering.</li><li><strong>A05: Security Misconfiguration</strong><br> Konfigurasi secrets disimpan dalam .env dan tidak di-commit ke repository. Endpoint yang membutuhkan autentikasi tidak dapat diakses tanpa token yang valid.</li><li><strong>A07: Identification and Authentication Failures</strong><br> Proses login menggunakan Google OAuth dikombinasikan dengan token JWT, memastikan bahwa hanya pengguna yang terverifikasi yang dapat mengakses sistem.</li></ul><h3>Analisis Fitur Produk (produk/api.py) Berdasarkan OWASP Top 10</h3><p>Sebagai salah satu fitur inti aplikasi LANCAR, modul produk/api.py menangani proses pencatatan, pembaruan, dan penghapusan produk UMKM. Karena fitur ini diakses oleh semua role dalam toko (Pemilik, Pengelola, Karyawan), penting untuk memastikan keamanannya telah dirancang dan diuji secara menyeluruh. Berikut adalah analisis implementasi <em>secure programming</em> pada modul ini, dibandingkan dengan panduan <em>How to Prevent</em> dari OWASP Top 10.</p><h3>Implementasi OWASP yang Telah Dilakukan</h3><h4>A01: Broken Access Control</h4><ul><li>Semua endpoint mengecek user.toko untuk memastikan pengguna hanya bisa mengakses, mengubah, atau menghapus produk milik tokonya sendiri.</li><li>Query-filter seperti Produk.objects.filter(toko=user.toko) mencegah akses data lintas tenant.</li><li>Fitur ini tidak perlu pembatasan tambahan berbasis role, karena semua role di dalam toko memang diizinkan mengakses fitur produk.</li></ul><h4>A02: Cryptographic Failures</h4><ul><li>Token JWT didekode menggunakan jwt.decode() dengan HS256 dan kunci rahasia (SECRET_KEY) dari environment.</li><li>Hanya token yang valid dan ditandatangani dengan kunci resmi yang diterima sistem.</li></ul><h4>A03: Injection</h4><ul><li>Semua interaksi basis data dilakukan melalui ORM Django (.get_or_create, .filter, .create) yang aman terhadap SQL Injection.</li><li>Parameter seperti nama produk, kategori, dan satuan berasal dari input pengguna, namun tetap diproses melalui ORM dan tidak digunakan untuk membentuk query mentah.</li></ul><h4>A05: Security Misconfiguration</h4><ul><li>Middleware keamanan standar sudah diaktifkan (SecurityMiddleware, CSRFViewMiddleware, XFrameOptionsMiddleware, dll.)</li><li>Setiap endpoint dilindungi oleh AuthBearer, yang hanya mengizinkan pengguna dengan token sah mengakses API.</li></ul><h4>A07: Identification and Authentication Failures</h4><ul><li>Sistem autentikasi menggunakan token JWT.</li><li>Token dibaca dan diambil user_id-nya, kemudian diverifikasi apakah pengguna dan toko yang bersangkutan benar-benar ada.</li></ul><h3>Perbaikan Tambahan untuk Memenuhi OWASP Lebih Lengkap</h3><p>Meski fitur produk/api.py sudah cukup aman, ada beberapa poin dari <em>How to Prevent</em> OWASP yang <strong>masih bisa ditingkatkan</strong>:</p><h4>A03: Injection</h4><ul><li><strong>Belum ada validasi eksplisit terhadap input teks</strong> seperti nama, kategori, atau satuan.</li></ul><p>Perbaikan:</p><ul><li>Tambahkan validasi panjang dan karakter pada input melalui schema.</li></ul><pre>... = Field(..., max_length=100)</pre><h4>A05: Security Misconfiguration</h4><ul><li>Middleware sudah cukup lengkap, namun <strong>header keamanan tambahan belum dikonfigurasi secara eksplisit</strong>.</li><li>Konfigurasi tambahan di settings.py:</li></ul><pre>SECURE_HSTS_SECONDS = 31536000<br>SECURE_HSTS_INCLUDE_SUBDOMAINS = True<br>SECURE_CONTENT_TYPE_NOSNIFF = True<br>SECURE_BROWSER_XSS_FILTER = True</pre><h4>A07: Token Expiry Validation</h4><ul><li>Saat ini jwt.decode() belum secara eksplisit memverifikasi apakah token sudah kedaluwarsa.</li><li>Perbaikan:</li></ul><pre>jwt.decode(token, settings.SECRET_KEY, algorithms=[&quot;HS256&quot;], options={&quot;verify_exp&quot;: True})</pre><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c219a8fda00f" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Optimasi Performa API Django Menggunakan Django Silk: Studi Kasus Endpoint Produk]]></title>
            <link>https://medium.com/@diptaarya18/optimasi-performa-api-django-menggunakan-django-silk-studi-kasus-endpoint-produk-639f8e276c4d?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/639f8e276c4d</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Wed, 14 May 2025 11:10:26 GMT</pubDate>
            <atom:updated>2025-05-14T11:18:11.929Z</atom:updated>
            <content:encoded><![CDATA[<p>Dalam proses pengembangan backend, performa API seringkali menjadi penentu pengalaman pengguna. Pada proyek ini, saya menggunakan Django Silk sebagai tool untuk melakukan profiling terhadap beberapa endpoint penting. Melalui profiling ini, saya berhasil mengidentifikasi bottleneck dan melakukan optimasi yang berdampak nyata terhadap waktu respon API.</p><h3>Setup Awal: Integrasi Django Silk</h3><p>Berikut adalah langkah-langkah singkat untuk mengintegrasikan Django Silk ke dalam proyek Django:</p><ol><li><strong>Install Silk</strong></li></ol><pre>pip install django-silk</pre><p><strong>2. Tambahkan ke </strong><strong>INSTALLED_APPS dan middleware</strong></p><pre>INSTALLED_APPS = [<br>    ...<br>    &#39;silk&#39;,<br>]<br><br>MIDDLEWARE = [<br>    &#39;silk.middleware.SilkyMiddleware&#39;,<br>    ...<br>]</pre><p><strong>3. Tambahkan route Silk</strong></p><pre>urlpatterns = [<br>    path(&#39;silk/&#39;, include(&#39;silk.urls&#39;, namespace=&#39;silk&#39;))<br>]</pre><p><strong>4. Migrasi</strong></p><pre>python manage.py migrate</pre><ol><li><strong>Akses:</strong> <a href="http://localhost:8000/silk/">http://localhost:8000/silk/</a></li></ol><h3>Menyuntikkan Data Dummy</h3><p>Agar proses profiling lebih akurat, saya menambahkan dummy data produk dengan field seperti:</p><ul><li>id, nama, foto, harga_modal, harga_jual, stok</li><li>Foreign key: kategori, user</li></ul><p>Saya menggunakan script sederhana atau admin panel Django untuk menyuntikkan ±1000 produk.</p><h3>Setup Postman: Tiga Endpoint yang Diprofiling</h3><p>Saya menyiapkan 3 request di Postman untuk diuji melalui Silk:</p><ol><li>GET /api/produk/low-stock → Menampilkan produk dengan stok rendah</li><li>GET /api/produk/page/10 → Pagination ke halaman 10</li><li>GET /api/produk → Tampilan default halaman 1</li></ol><p>Setiap request dikirim dengan <strong>Bearer Token JWT</strong> dan disesuaikan dengan struktur endpoint Django Ninja.</p><h3>Hasil Profiling Awal</h3><p>Berikut adalah hasil awal profiling dari ketiga endpoint tersebut:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/602/1*CDXN7IAh5uxsj4amy3awwg.png" /><figcaption><strong>Catatan:</strong> Meskipun query count-nya rendah, waktu total tergolong tinggi terutama untuk /api/produk.</figcaption></figure><h3>Analisis Masalah</h3><p>Dari hasil di atas, saya mengidentifikasi beberapa potensi penyebab lambatnya respon:</p><ol><li><strong>N+1 Query Problem</strong> — meskipun tidak ekstrem, beberapa foreign key (seperti kategori, user) dipanggil secara tidak efisien oleh .from_orm() saat serialisasi.</li><li><strong>Data Query Tanpa Projection</strong> — penggunaan .all() tanpa .only() mengakibatkan seluruh field model dimuat, meskipun hanya sebagian kecil yang ditampilkan.</li><li><strong>Manual Pagination dan Sorting</strong> — perhitungan total pages dan slicing dilakukan di Python, bukan di level database.</li><li><strong>Tidak ada prefetch</strong> untuk relasi yang digunakan di response.</li></ol><h3>Menambahkan SQL Query Plan (Custom Profiling)</h3><p>Untuk melihat bagaimana query dieksekusi oleh database PostgreSQL, saya menggunakan perintah:</p><pre>EXPLAIN ANALYZE SELECT * FROM produk_produk WHERE user_id = X AND stok &lt; 10 ORDER BY id;</pre><p>Dari hasil tersebut, saya dapat melihat apakah query melakukan <strong>sequential scan</strong> atau sudah menggunakan <strong>index scan</strong>. Jika ditemukan bahwa query masih melakukan sequential scan, maka dapat ditambahkan index pada field user_id dan stok di model:</p><pre>class Produk(models.Model):<br>    ...<br>    class Meta:<br>        indexes = [<br>            models.Index(fields=[&quot;user_id&quot;, &quot;stok&quot;]),<br>        ]</pre><p>Langkah ini termasuk bentuk <strong>kustomisasi profiling</strong> di level SQL untuk mengoptimalkan performa.</p><h3>Pemanfaatan AI Tools untuk Optimasi</h3><p>Selama proses optimasi, saya menggunakan bantuan AI (dalam hal ini ChatGPT) untuk:</p><ul><li>Menganalisis pola N+1 query</li><li>Memberikan rekomendasi refactoring dengan .select_related() dan .only()</li><li>Memberikan justifikasi teknik optimalisasi berdasarkan hasil Silk dan query SQL</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/808/1*3aJEMrY6JekDyEgIAf9L6w.png" /></figure><p>Dengan pendekatan ini, AI digunakan bukan sekadar sebagai “asisten debugging”, tetapi sebagai <strong>partner dalam decision-making teknis</strong> berdasarkan hasil profiling.</p><h3>Proses Optimasi</h3><p>Berikut langkah-langkah optimasi yang saya lakukan:</p><h3>1. Tambahkan .select_related()</h3><p>Untuk eager loading pada foreign key:</p><pre>Produk.objects.select_related(&quot;kategori&quot;, &quot;user&quot;)</pre><h3>2. Tambahkan .only() agar hanya field yang dibutuhkan saja yang diambil:</h3><pre>.only(&quot;id&quot;, &quot;nama&quot;, &quot;foto&quot;, &quot;harga_modal&quot;, &quot;harga_jual&quot;, &quot;stok&quot;, &quot;kategori__nama&quot;, &quot;user&quot;)</pre><h3>3. Menambahkan indeks untuk field stok, kategori_id, dan user_id di model untuk kecepatan filter dan sort (opsional tapi disarankan).</h3><h3>Hasil Setelah Optimasi</h3><p>Setelah implementasi optimasi, berikut hasil profiling terbaru:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/602/1*QYfAPlt2ld94uSzzbGvZDg.png" /><figcaption><strong>Performa meningkat signifikan</strong> terutama pada endpoint /api/produk, dari 173ms → 75ms</figcaption></figure><h3>Analisis Dampak Optimasi</h3><h4>1. Pengurangan Overhead di Python Layer</h4><p>Endpoint /api/produk mengalami penurunan waktu total dari 173ms menjadi 75ms. Ini menunjukkan bahwa bottleneck sebelumnya bukan terletak pada query database, melainkan pada proses setelah data diambil—yaitu saat serialisasi, perulangan, dan pemrosesan data di Python. Dengan membatasi field yang diambil (.only(...)) dan melakukan preloading relasi (.select_related(...)), proses serialisasi jadi lebih ringan karena Django tidak perlu melakukan lazy loading untuk setiap relasi.</p><h4>2. Eliminasi Query Tambahan dari Relasi</h4><p>Sebelum optimasi, ProdukResponseSchema.from_orm(p) kemungkinan besar memicu query tambahan ke kategori dan user, karena data tersebut dibutuhkan untuk membentuk response JSON. Setelah digunakan select_related(), data tersebut sudah tersedia dalam cache ORM sehingga tidak perlu query tambahan. Ini membantu mempertahankan jumlah query tetap rendah (2–3 query per endpoint), meskipun data kompleks.</p><h4>3. Efisiensi Akses Data</h4><p>Penggunaan .only() secara langsung membatasi data yang ditarik dari database hanya pada field yang benar-benar digunakan dalam response. Ini mengurangi penggunaan memori dan mempercepat transfer data antara database dan aplikasi Django.</p><h4>4. Stabilitas pada Endpoint Khusus</h4><p>Untuk endpoint seperti /api/produk/low-stock, waktu total tidak mengalami penurunan signifikan. Hal ini disebabkan karena logika filter sudah cukup sederhana dari awal, dan dataset yang diproses relatif kecil. Namun, penggunaan .select_related() dan .only() tetap bermanfaat karena menjamin efisiensi saat dataset membesar.</p><h4>5. Konsistensi Performa</h4><p>Profiling ulang menunjukkan bahwa semua endpoint kini memiliki waktu respon yang lebih konsisten, dengan distribusi antara waktu query dan waktu total yang lebih seimbang. Ini menunjukkan bahwa beban di sisi aplikasi backend sudah lebih terkontrol dan tidak lagi menyumbat pipeline respon secara signifikan.</p><h3>Prediksi Dampak Jangka Panjang dari Optimasi</h3><ol><li><strong>Respon API yang Lebih Stabil untuk Jumlah Data Besar</strong><br> Setelah optimasi dilakukan, waktu respon API secara konsisten berada di kisaran 60–80 milidetik. Ini menandakan bahwa sistem sekarang lebih efisien dalam memproses permintaan. Saat jumlah entri produk bertambah menjadi ribuan, performa ini diperkirakan akan tetap stabil karena query yang digunakan sudah disederhanakan dan tidak memuat data berlebih.</li><li><strong>Penurunan Beban Database dan Konsumsi Sumber Daya</strong><br> Dengan menurunkan jumlah query tambahan yang sebelumnya tersembunyi akibat pemanggilan relasi secara implisit, sistem kini hanya menjalankan 2–3 query per permintaan. Hal ini akan mengurangi beban kerja database, menurunkan konsumsi memori dan CPU, serta memungkinkan deployment di server dengan spesifikasi lebih rendah tanpa mengorbankan performa.</li><li><strong>Peningkatan Skalabilitas Sistem</strong><br> Optimasi ini memperkuat fondasi backend untuk menangani skala pengguna yang lebih besar. Jika sebelumnya bottleneck akan muncul saat traffic atau data meningkat, sekarang sistem telah lebih siap untuk skenario skala menengah hingga tinggi, termasuk integrasi dengan dashboard, mobile apps, atau front-end analytics.</li><li><strong>Kemudahan Maintenance dan Biaya Operasional Lebih Rendah</strong><br> Dengan menghilangkan potensi N+1 query dan membatasi field yang diambil, pengembangan fitur baru akan lebih mudah karena kode menjadi lebih eksplisit dan efisien. Developer tidak perlu lagi melakukan debugging untuk query tersembunyi, yang seringkali sulit dilacak. Ini akan berdampak pada berkurangnya waktu maintenance dan biaya operasional dalam jangka panjang.</li><li><strong>Kesiapan untuk Implementasi Caching atau Load Balancing</strong><br> Sistem yang telah optimal dalam struktur datanya akan lebih mudah untuk ditingkatkan melalui caching (misalnya Redis) atau load balancing antar server. Karena endpoint sudah ringan, penambahan fitur ini nantinya tidak akan menutup lubang performa, tetapi benar-benar meningkatkan kapasitas layanan.</li></ol><h3>Penutup</h3><p>Profiling adalah bagian penting dari proses development, khususnya saat API sudah berinteraksi dengan banyak data. Dengan memanfaatkan <strong>Django Silk</strong>, saya dapat menemukan bottleneck secara visual, melakukan perbaikan terukur, dan mengamati peningkatannya secara langsung.</p><p>Dengan optimasi yang dilakukan, API kini dapat merespons lebih cepat, menggunakan lebih sedikit sumber daya, dan lebih siap menangani data dalam skala lebih besar. Performa bukan hanya soal mengurangi jumlah query, tetapi juga tentang bagaimana data diakses dan dikelola secara efisien di setiap lapisan aplikasi.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=639f8e276c4d" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Meningkatkan Kualitas Kode Backend melalui Testing dan Bantuan AI: Studi Kasus Modul Produk]]></title>
            <link>https://medium.com/@diptaarya18/meningkatkan-kualitas-kode-backend-melalui-pengujian-otomatis-dan-bantuan-ai-studi-kasus-pada-8a979a55e4eb?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/8a979a55e4eb</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Mon, 12 May 2025 14:06:22 GMT</pubDate>
            <atom:updated>2025-05-19T04:50:41.485Z</atom:updated>
            <content:encoded><![CDATA[<p>Dalam pengembangan perangkat lunak, pengujian (testing) merupakan elemen krusial untuk menjamin stabilitas dan keandalan sistem. Pada artikel ini, saya ingin membagikan pengalaman dalam meningkatkan cakupan pengujian (code coverage) modul backend produk menggunakan Django, serta bagaimana AI dapat mendukung proses tersebut melalui saran perbaikan, penerapan teknik lanjutan seperti <strong>mock dan stub</strong>, hingga membantu mengkritisi dan menyempurnakan pendekatan yang digunakan.</p><h3>Key Problems</h3><p>Modul produk dalam backend Django kami, setelah semua revisi dan refactor, sempat tertinggal, sehingga memiliki tingkat coverage testing yang rendah, hingga di bawah 75%. Banyak fungsi penting seperti <em>create</em>, <em>update</em>, <em>pagination</em>, <em>get low stock</em>, hingga <em>get most popular products</em> belum diuji secara menyeluruh. Selain itu, banyak juga failed test dan juga error yang muncul karena model, schema, dan request yang tidak sesuai konteks (misalnya penggunaan user pada model yang sudah berpindah ke toko).</p><h3>Peran AI dalam Menyusun dan Memperbaiki Testing</h3><p>Dengan bantuan AI (ChatGPT), saya dapat:</p><ul><li><strong>Menyusun test-case awal</strong> yang sesuai dengan model, schema, dan API terbaru.</li><li><strong>Mengidentifikasi bug umum</strong> seperti unexpected keyword arguments atau validasi pydantic yang gagal.</li><li><strong>Memberikan contoh implementasi mock dan stub</strong>, terutama untuk query database kompleks seperti .annotate().order_by() yang tidak bisa dijalankan langsung tanpa data nyata.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/784/1*JNB7psqoiUw3e3-qpycfsA.png" /></figure><ul><li><strong>Menambahkan test</strong> untuk meningkatkan coverage percentage code</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/792/1*EDDIc3liaD00ZKkNk_au5w.png" /></figure><p>Namun, bantuan AI tidak selalu langsung sempurna. Sebagai developer, saya melakukan beberapa penyesuaian, seperti:</p><ul><li>Mengubah semua User.objects.create(...) menjadi create_user(...) dengan argumen email.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/804/1*RMIVEZh_1WKlZqR8ftYHoQ.png" /></figure><ul><li>Menyesuaikan setup data test dengan membuat Toko terlebih dahulu dan mengasosiasikan ke User.</li><li>Memperbaiki validasi UpdateProdukSchema agar semua field Optional.</li></ul><h3>Mengapa Penggunaan AI Secara Langsung Tanpa Supervisi Tidak Selalu Efektif?</h3><p>Menggunakan AI secara langsung dalam pengujian perangkat lunak dapat meningkatkan <strong>kecepatan</strong> dan <strong>efisiensi</strong>. AI mampu menghasilkan pengujian otomatis dengan cepat, mengidentifikasi potensi bug, serta memberikan solusi yang bisa mempercepat siklus pengujian. Namun, AI tidak sepenuhnya memahami <strong>konteks spesifik</strong> aplikasi atau <strong>kebutuhan unik</strong> dari setiap proyek, yang bisa menyebabkan saran yang terlalu umum atau tidak relevan, terutama untuk aplikasi yang kompleks.</p><p>Selain itu, meskipun AI dapat menghasilkan <strong>stub</strong> dan <strong>mock</strong> untuk menggantikan dependensi eksternal dalam pengujian, ia sering kali kesulitan untuk melakukan <strong>verifikasi interaksi</strong> yang kompleks. AI lebih cenderung fokus pada <strong>hasil cepat</strong>, sedangkan pengujian perangkat lunak sering memerlukan pendekatan yang lebih <strong>kreatif</strong> dan <strong>fleksibel</strong> dalam menangani <strong>edge-case</strong> dan <strong>keamanan aplikasi</strong>, yang sering kali sulit untuk diotomatiskan.</p><h3>Peran Manusia dalam Testing Berbasis AI</h3><p>Meskipun AI dapat mempercepat proses pengujian, <strong>supervisi manusia</strong> tetap diperlukan untuk memastikan <strong>konteks yang tepat</strong> dan mengidentifikasi <strong>potensi masalah yang tersembunyi</strong>. Manusia mampu memberikan <strong>perspektif kreatif</strong> dalam pengujian dan memperbaiki kesalahan yang mungkin tidak terdeteksi oleh AI, serta memastikan bahwa teknik pengujian yang diterapkan sesuai dengan <strong>standar dan pola pengujian</strong> proyek yang spesifik.</p><h3>Penggunaan Mock dan Stub dalam Pengujian</h3><p>Dalam proses pengujian, saya menggunakan dua pendekatan penting untuk memastikan bahwa unit test benar-benar fokus pada kode yang diuji:</p><ul><li><strong>Stub</strong> digunakan untuk <strong>mengisolasi</strong> bagian yang diuji dari dependensi eksternal.</li><li><strong>Mock</strong> digunakan untuk <strong>mengontrol dan memverifikasi interaksi</strong> antara komponen.</li></ul><h3>1. Stub: Mengisolasi Fungsi dari Akses Database</h3><h4>Contoh kode:</h4><pre>@patch(&#39;produk.api.Produk.objects.get&#39;, return_value=fake_prod)</pre><h4>Digunakan pada:</h4><ul><li>test_get_most_popular_products</li><li>test_get_top_selling_products</li></ul><h4>Tujuan:</h4><p>Mengganti fungsi Produk.objects.get yang sebenarnya akan mengakses database dengan stub yang selalu mengembalikan objek dummy fake_prod.</p><h4>Alasan:</h4><ul><li>Kita tidak ingin tes gagal hanya karena produk dengan ID tertentu tidak tersedia di database.</li><li>Fokus pengujian ada pada <strong>logika pemrosesan data produk yang sudah diambil</strong>, bukan pada mekanisme pengambilan dari database.</li><li>Dengan stub, kita pastikan tes berjalan cepat, deterministik, dan tidak tergantung pada isi database.</li></ul><h3>2. Mock: Mengontrol dan Memverifikasi Interaksi</h3><h4>Contoh kode:</h4><pre>@patch(&#39;produk.api.get_produk_paginated&#39;)<br>def test_get_produk_default(self, mock_paginated):<br>    ...<br>    mock_paginated.assert_called_once_with(request, page=1, sort=&#39;-id&#39;)</pre><h4>Digunakan pada:</h4><ul><li>test_get_produk_default</li></ul><h4>Tujuan:</h4><p>Memastikan bahwa get_produk_default() benar-benar memanggil get_produk_paginated() dengan parameter yang sesuai.</p><h4>Alasan:</h4><ul><li>Kita tidak ingin menguji ulang logika get_produk_paginated(), karena sudah diuji di tempat lain.</li><li>Mock digunakan agar kita bisa <strong>memverifikasi interaksi</strong>, bukan hasil akhir saja.</li><li>Dengan begitu, jika suatu saat parameter berubah atau fungsi tidak dipanggil, kita bisa langsung mengetahuinya.</li></ul><h3>3. Stub + Mock: Query Kompleks Disederhanakan dan Diverifikasi</h3><h4>Contoh kode:</h4><pre>@patch(&#39;produk.api.TransaksiItem.objects.filter&#39;)<br>def test_get_top_selling_products(self, mock_filter):<br>    mock_qs = MagicMock()<br>    mock_qs.values.return_value = mock_qs<br>    mock_qs.annotate.return_value = mock_qs<br>    mock_qs.order_by.return_value = [{&#39;product__id&#39;: self.prod_id, &#39;sold&#39;: 5}]<br>    mock_filter.return_value = mock_qs</pre><h4>Digunakan pada:</h4><ul><li>test_get_top_selling_products</li><li>test_get_most_popular_products</li></ul><h4>Tujuan:</h4><ul><li><strong>Stub</strong>: Menyediakan data penjualan buatan (MagicMock) agar tidak tergantung pada transaksi nyata.</li><li><strong>Mock</strong>: Memberi kontrol penuh atas hasil .values(), .annotate(), dan .order_by() dari queryset.</li></ul><h4>Alasan:</h4><ul><li>Query asli terlalu kompleks dan bisa gagal karena struktur DB berubah.</li><li>Dengan mock + stub, kita bisa menguji bahwa fungsi menghasilkan hasil penjualan populer/topselling <strong>dari data yang sudah dikontrol sepenuhnya</strong>.</li></ul><h3>Perbedaan Antara Stub dan Mock dalam Pengujian</h3><p>Dalam pengujian perangkat lunak, kita sering kali mendengar istilah <strong>stub</strong> dan <strong>mock</strong>. Keduanya adalah teknik untuk menggantikan bagian dari kode yang tidak ingin atau tidak dapat diuji secara langsung, terutama saat menguji unit tertentu dalam isolasi. Meskipun keduanya digunakan untuk tujuan serupa, mereka memiliki perbedaan yang penting.</p><h4>Stub</h4><ul><li><strong>Definisi</strong>: Stub adalah komponen pengganti sederhana untuk bagian kode yang dipanggil selama pengujian. Stub menggantikan fungsi atau metode yang biasanya mengakses sumber daya eksternal (seperti database atau API) dan memberikan nilai yang telah ditentukan sebelumnya. Stub lebih fokus pada <strong>memberikan data statis</strong> untuk memungkinkan pengujian bagian lain dari sistem.</li><li><strong>Kapan digunakan</strong>: Digunakan saat kita ingin mengisolasi unit pengujian dan tidak ingin fungsi atau metode yang dipanggil berinteraksi dengan dependensi eksternal (misalnya, panggilan API atau database).</li><li><strong>Contoh</strong>: Kita dapat menggunakan stub untuk menggantikan panggilan API yang memerlukan waktu lama atau tidak tersedia selama pengujian.</li></ul><pre>mock_api.get_user_data.return_value = {&#39;id&#39;: 1, &#39;name&#39;: &#39;John Doe&#39;}</pre><h4>Mock</h4><ul><li><strong>Definisi</strong>: Mock lebih canggih dibandingkan stub. Mock tidak hanya <strong>mengganti fungsi atau objek</strong> tetapi juga memungkinkan kita untuk <strong>memverifikasi interaksi</strong> dengan objek tersebut. Dengan mock, kita dapat memeriksa apakah metode tertentu dipanggil dengan parameter yang tepat dan berapa kali metode tersebut dipanggil. Mock digunakan untuk <strong>memverifikasi bahwa bagian sistem berinteraksi dengan cara yang diinginkan</strong>.</li><li><strong>Kapan digunakan</strong>: Digunakan saat kita perlu mengonfirmasi interaksi antara objek-objek dalam sistem. Jika kita ingin memastikan bahwa suatu metode dipanggil dengan parameter tertentu atau bahwa suatu objek berfungsi seperti yang diinginkan dalam konteks pengujian.</li><li><strong>Contoh</strong>: Mock digunakan untuk memverifikasi apakah metode tertentu dipanggil atau tidak.</li></ul><pre>mock_service.process_data.assert_called_once_with({&#39;id&#39;: 1, &#39;name&#39;: &#39;John Doe&#39;})</pre><h3>Analisa dan Manfaat</h3><p>Penerapan AI sangat mempercepat proses setup awal dan debugging, namun tetap memerlukan intervensi manual untuk:</p><ul><li>Menyesuaikan dengan konteks model dan database yang spesifik.</li><li>Memastikan stub/mock dibuat dengan struktur chaining yang tepat.</li><li>Melengkapi edge-case testing seperti user tanpa toko, produk yang tidak ditemukan, dan parameter query yang tidak valid.</li></ul><p>Setelah seluruh perbaikan dan penambahan test dilakukan, coverage testing naik drastis hingga saat ini 88% pada api.py, dan &gt;90% untuk file dalam modul produk.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8a979a55e4eb" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Meningkatkan Efisiensi Tim melalui UI Standardization]]></title>
            <link>https://medium.com/@diptaarya18/meningkatkan-efisiensi-tim-melalui-ui-standardization-9129c6b7cf63?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/9129c6b7cf63</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Mon, 12 May 2025 07:36:00 GMT</pubDate>
            <atom:updated>2025-05-15T14:02:47.985Z</atom:updated>
            <content:encoded><![CDATA[<p>Dalam pengembangan aplikasi modern, konsistensi tampilan dan kemudahan implementasi antarmuka menjadi faktor krusial untuk memastikan pengalaman pengguna yang optimal sekaligus mempercepat proses pengembangan. Salah satu pendekatan yang terbukti efektif dalam menjawab kebutuhan ini adalah <strong>UI Standardization</strong> — sebuah proses menyusun dan menerapkan pedoman desain (design guidelines) secara menyeluruh dalam sebuah sistem.</p><p>Pada proyek ini, kami telah mengimplementasikan UI standardization secara menyeluruh, mulai dari penyusunan komponen visual dalam design guideline hingga integrasi komponen ke dalam source code proyek yang digunakan oleh tim secara konsisten.</p><h3>1. Penyusunan Design Guidelines secara Lengkap</h3><p>Langkah pertama yang dilakukan adalah menyusun <em>design system</em> berupa style guide yang mencakup elemen-elemen kunci berikut:</p><ul><li><strong>Buttons</strong>: Menampilkan berbagai variasi tombol (solid, ghost, disabled, ikon, status/label) dengan ukuran dan gaya yang konsisten.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*r1x_s5zWxH2rLOA0_cP4TA.png" /></figure><ul><li><strong>Forms</strong>: Meliputi komponen input teks, dropdown, radio button, checkbox, toggle, hingga slider dengan berbagai keadaan (default, aktif, error).</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2FMm4ne67Q5Jnp9EW9Ezhw.png" /></figure><ul><li><strong>Colors</strong>: Disusun berdasarkan kategori seperti primary, system background, label, dan action dengan variasi tonalitas dari 100 hingga 500.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LNAtC4Uwn1nCtbwN404UwQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YQR_MrkFe6kI3jj_s6VKwg.png" /></figure><ul><li><strong>Typography</strong>: Menggunakan font <em>SF Pro Display</em> dalam beberapa gaya (Bold, Semibold, Medium, Regular) dan ukuran berbeda, disesuaikan dengan kebutuhan heading maupun body text.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*O3-CygXqBOXJzIJy8eiyHg.png" /></figure><p>Design guideline ini dibuat dalam <em>Hi-Fi Prototype</em> berbasis Figma untuk memastikan tim memiliki acuan visual yang konkret, lengkap, dan mudah dipahami oleh desainer maupun developer.</p><h3>Implementasi Nyata dalam Aplikasi</h3><p>Semua elemen dalam design guideline kami tidak hanya berhenti sebagai acuan visual, tetapi benar-benar digunakan dalam berbagai bagian antarmuka aplikasi. Berikut adalah beberapa contoh nyata implementasi komponen dan style yang telah distandarisasi.</p><h3>Warna: Penanda Aksi dan Status</h3><p>Warna utama biru (Blue-500) diterapkan secara konsisten pada tombol aksi penting, seperti:</p><ul><li><strong>“Perbarui Produk”</strong> pada halaman <em>Produk Paling Laku</em> dan <em>Produk Stok Rendah</em></li><li><strong>Tombol Tambah</strong> (floating action button dengan ikon plus) pada halaman Produk dan Transaksi</li></ul><p>Sementara warna status digunakan untuk membedakan kondisi tertentu:</p><ul><li><strong>Hijau (</strong><strong>Green-300)</strong> untuk status seperti 100 Buah terjual dan “+100%” pemasukan</li><li><strong>Merah (</strong><strong>Red-300)</strong> untuk status stok rendah dan penurunan nilai (-100% pemasukan/pengeluaran)</li><li><strong>Abu-abu (</strong><strong>Gray-300)</strong> untuk status tidak aktif, seperti tab Lunas dan Belum Lunas yang belum dipilih</li></ul><p>Warna-warna ini ditentukan dalam style guide dan dijaga konsistensinya untuk membangun pengalaman visual yang familiar bagi pengguna.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/433/1*A3xZzYDzbwAIpsbN7gVtOA.png" /></figure><h3>Button: Aksi yang Jelas dan Konsisten</h3><p>Penggunaan button dalam aplikasi selalu mengacu pada template yang telah ditentukan:</p><ul><li><strong>Primary Button (Blue)</strong> digunakan untuk tindakan penting seperti:</li><li>Perbarui Produk, Tambah Produk atau Tambah Transaksi</li><li><strong>Tab Button (Fill &amp; Ghost)</strong> digunakan pada filter transaksi (Semua, Lunas, Belum Lunas) dan menunjukkan pilihan aktif dengan warna biru solid</li></ul><p>Desain tombol mengikuti konvensi yang sudah distandarisasi, baik dari sisi ukuran, padding, radius, hingga penggunaan ikon dan font.</p><h3>Typography: Hierarki dan Keterbacaan</h3><p>Penulisan judul dan konten di aplikasi memanfaatkan sistem tipografi yang telah ditetapkan:</p><ul><li><strong>Heading 1 / 2</strong> digunakan untuk judul seperti Produk Paling Laku per Bulan, Transaksi, dan Keuntungan</li><li><strong>Body Medium dan Small</strong> digunakan untuk label seperti barang, Terjual, Rendah, Lunas, dan deskripsi di bawah card</li></ul><p>Dengan penempatan dan ukuran yang konsisten, pengguna bisa dengan cepat memahami struktur informasi dan membedakan bagian utama dari informasi tambahan.</p><h3>2. Implementasi Tool dan Reusable Components di Source Code</h3><p>Untuk menghubungkan pedoman visual dengan implementasi teknis, kami membangun serangkaian <strong>reusable components</strong> yang dapat digunakan lintas fitur.</p><h3>Code &#39;TextInput.tsx&#39;</h3><p>Komponen ini berfungsi untuk input teks yang diimplementasikan pada halaman <em>Tambah Produk</em> dan <em>Edit Produk</em>.</p><pre>function TextInput({ id, label, value, onChange, error, errorMessage }) {<br>  return (<br>    &lt;div&gt;<br>      &lt;label htmlFor={id}&gt;{label}&lt;/label&gt;<br>      &lt;input<br>        id={id}<br>        type=&quot;text&quot;<br>        value={value}<br>        onChange={(e) =&gt; onChange(e.target.value)}<br>        className={error ? &quot;border-red-500&quot; : &quot;border-gray-300&quot;}<br>      /&gt;<br>      {error &amp;&amp; &lt;p&gt;{errorMessage}&lt;/p&gt;}<br>    &lt;/div&gt;<br>  );<br>}</pre><h3>Code &#39;EnhancedDropdown.tsx’</h3><p>Komponen ini berfungsi untuk implementasi dropdown yang mendukung penambahan kategori ataupun satuan baru.</p><pre>function EnhancedDropdown({ selected, options, onSelect, onAddCustom }) {<br>  return (<br>    &lt;div&gt;<br>      &lt;button onClick={() =&gt; setOpen(!open)}&gt;<br>        {selected || &quot;Select&quot;}<br>      &lt;/button&gt;<br>      {open &amp;&amp; (<br>        &lt;ul&gt;<br>          {options.map(option =&gt; (<br>            &lt;li key={option} onClick={() =&gt; onSelect(option)}&gt;<br>              {option}<br>            &lt;/li&gt;<br>          ))}<br>          {onAddCustom &amp;&amp; (<br>            &lt;li onClick={() =&gt; onAddCustom(&quot;New Category&quot;)}&gt;Add Custom&lt;/li&gt;<br>          )}<br>        &lt;/ul&gt;<br>      )}<br>    &lt;/div&gt;<br>  );<br>}</pre><h3>3. Disiplin Penggunaan oleh Tim</h3><p>UI Standardization ini tidak hanya berhenti di level desain dan komponen, tetapi juga sudah:</p><ul><li><strong>Diadopsi oleh anggota tim</strong> dalam pengembangan fitur frontend seperti tambah dan edit produk.</li><li><strong>Mendukung advanced prototyping</strong>, di mana komponen dalam source code mencerminkan prototipe di Figma.</li><li><strong>Diverifikasi melalui code review dan kolaborasi lintas fungsi</strong> (designer–developer) agar semua fitur baru mengikuti standar ini.</li></ul><h3>4. Manfaat Nyata dari Standardisasi UI</h3><p>Penerapan UI Standardization ini telah memberikan dampak positif yang signifikan:</p><ul><li><strong>Konsistensi tampilan</strong> di seluruh halaman aplikasi</li><li><strong>Percepatan proses pengembangan</strong> karena developer tinggal menggunakan komponen siap pakai</li><li><strong>Skalabilitas</strong> untuk fitur baru tanpa harus mendesain ulang dari nol</li><li><strong>Kolaborasi tim lebih efisien</strong>, karena semua pihak mengacu pada guideline dan komponen yang sama</li></ul><h3>Kesimpulan</h3><p>UI Standardization bukan sekadar dokumentasi desain, tetapi merupakan strategi integral yang menghubungkan desain, implementasi, dan kolaborasi tim. Dengan menyusun pedoman desain yang jelas, membangun komponen reusable, dan menerapkannya secara konsisten, tim dapat bekerja lebih efisien, menghasilkan produk yang lebih rapi, dan memberikan pengalaman pengguna yang optimal.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9129c6b7cf63" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Penerapan SOLID Principle dan Best Practices pada Aplikasi LANCAR]]></title>
            <link>https://medium.com/@diptaarya18/penerapan-solid-principle-pada-page-tambah-produk-aplikasi-lancar-cf9aa8e45e46?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/cf9aa8e45e46</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Tue, 25 Mar 2025 01:44:45 GMT</pubDate>
            <atom:updated>2025-05-08T02:05:31.274Z</atom:updated>
            <content:encoded><![CDATA[<p>Saat mengembangkan fitur Tambah Produk di aplikasi LANCAR, kami berusaha menerapkan prinsip <strong>SOLID</strong> — lima prinsip desain perangkat lunak yang membantu kode tetap bersih, modular, dan mudah dirawat. Walau SOLID umumnya diasosiasikan dengan pemrograman berorientasi objek, prinsip ini juga sangat efektif diterapkan dalam pengembangan backend berbasis Django-Ninja seperti di proyek ini.</p><p>Berikut adalah <strong>penerapan SOLID dan best practices</strong> yang kami implementasikan di backend aplikasi LANCAR, khususnya pada modul “produk/api.py”.</p><p><strong>Berikut adalah Detail Penerapannya:</strong></p><h3>S — Single Responsibility Principle (SRP):</h3><p>Kami memisahkan setiap tanggung jawab ke dalam fungsi yang berbeda, misalnya:</p><ul><li>get_produk_by_id hanya untuk mengambil produk berdasarkan ID.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/547/1*8im-f7aqqhdx8R4_lGes0A.png" /></figure><ul><li>create_produk hanya untuk menambahkan produk baru.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/738/1*y0htsFNwtykyd9XkF4AI9g.png" /></figure><ul><li>update_produk fokus pada update data produk.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/719/1*jmJXJCOJDJ6UTlRiOzNCTA.png" /></figure><ul><li>Validasi file gambar dilakukan secara lokal pada fungsi create_produk dan update_produk.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/725/1*voutP_YVMEaUR2lwBsLzug.png" /></figure><p>Dengan struktur seperti ini, setiap perubahan hanya perlu dilakukan di fungsi yang spesifik. Misalnya, jika validasi gambar berubah, kami hanya perlu mengubah bagian validasi di satu tempat tanpa mengganggu fungsi lain.</p><h3>O — Open/Closed Principle (OCP):</h3><p>Untuk menjaga fleksibilitas, logika seperti filtering dan sorting produk disusun agar mudah ditambahkan aturan baru. Contoh:</p><ul><li>Sorting stok diatur melalui parameter URL (asc, desc).</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/670/1*s6Q0if_xblSUlY-JQklITg.png" /></figure><ul><li>Paginasi bisa diatur via query string ?per_page=7.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/407/1*AaiDCrYxZM4mvPC8Gpjwfg.png" /></figure><p>Artinya, jika ke depan kami ingin menambahkan filter berdasarkan kategori atau harga, kami cukup menambahkan parameter baru di fungsi tanpa mengubah struktur dasarnya.</p><h3>L — Liskov Substitution Principle (LSP):</h3><p>Kami menggunakan class AuthBearer yang meng-extend HttpBearer dari Ninja. AuthBearer menggantikan HttpBearer dengan menambahkan decoding JWT menggunakan jwt.decode().</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/643/1*JJJGFfCvHDxKgoGxTVw4cQ.png" /></figure><p>Karena class ini masih kompatibel dengan interface HttpBearer, semua route tetap bekerja tanpa perlu mengetahui detail implementasi AuthBearer. Ini menjaga kestabilan sistem meski implementasi otentikasi diperluas.</p><h3>Selain itu, ada juga beberapa <em>Best Practices</em> yang diterapkan, seperti:</h3><h3>1. Modularisasi dengan Router</h3><p><strong>Best Practice</strong>: Gunakan Router() per domain untuk modularisasi.</p><p><strong>Potongan kode:</strong></p><pre>router = Router(auth=AuthBearer())</pre><p>Router ini dipisahkan per fitur (produk), sehingga mudah diatur dan di-maintain.</p><h3>2. Pemisahan Schema Input dan Output</h3><p><strong>Best Practice</strong>: Gunakan CreateProdukSchema dan ProdukResponseSchema untuk memisahkan data input dan output.</p><p><strong>Potongan kode:</strong></p><pre>@router.post(&quot;/create&quot;, response={201: ProdukResponseSchema, 422: dict})<br>def create_produk(request, payload: CreateProdukSchema, foto: UploadedFile = None):<br>    ...<br>    return 201, ProdukResponseSchema.from_orm(produk)</pre><p>Schema input (CreateProdukSchema) dan output (ProdukResponseSchema) digunakan secara jelas.</p><h3>3. Autentikasi dengan HttpBearer dan JWT</h3><p><strong>Best Practice</strong>: Gunakan HttpBearer untuk otentikasi berbasis token.</p><p><strong>Potongan kode:</strong></p><pre>class AuthBearer(HttpBearer):<br>    def authenticate(self, request, token):<br>        try:<br>            payload = jwt.decode(token, settings.SECRET_KEY, algorithms=[&quot;HS256&quot;])<br>            user_id = payload.get(&quot;user_id&quot;)<br>            if user_id:<br>                return user_id<br>        except jwt.PyJWTError:<br>            return None<br>        return None</pre><p>Implementasi AuthBearer memastikan bahwa hanya user yang memiliki token valid yang bisa mengakses endpoint.</p><h3>4. Optimasi Queryset dengan select_related</h3><p><strong>Best Practice</strong>: Gunakan select_related untuk menghindari N+1 query.</p><p><strong>Potongan kode:</strong></p><pre>queryset = Produk.objects.select_related(&quot;kategori&quot;).order_by(sort)</pre><p>Dengan ini, pengambilan produk dan kategori dilakukan dalam satu query.</p><h3>5. Penanganan Error dan Status Code yang Konsisten</h3><p><strong>Best Practice</strong>: Gunakan kode status HTTP yang sesuai dan beri pesan yang jelas.</p><p><strong>Potongan kode:</strong></p><pre>if sort not in [None, &quot;stok&quot;, &quot;-stok&quot;, &quot;-id&quot;]:<br>    return HttpResponseBadRequest(&quot;Invalid sort parameter. Use &#39;asc&#39; or &#39;desc&#39;.&quot;)</pre><pre>if not user.toko:<br>    return 404, {&quot;message&quot;: &quot;User doesn&#39;t have a toko&quot;}</pre><p>Penanganan error dilakukan secara eksplisit di hampir setiap endpoint.</p><h3>6. Pengujian yang Lengkap</h3><p><strong>Best Practice</strong>: Uji success, failure, dan edge case menggunakan unit test.</p><p><strong>Potongan kode:</strong></p><pre>def test_create_produk_success(self):<br>    payload = {<br>        &quot;nama&quot;: &quot;Monitor&quot;,<br>        &quot;harga_modal&quot;: 1200000,<br>        &quot;harga_jual&quot;: 1500000,<br>        &quot;stok&quot;: 15,<br>        &quot;satuan&quot;: &quot;PCS&quot;,<br>        &quot;kategori&quot;: &quot;Elektronik&quot;<br>    }<br>    response = self.client.post(self.url, data=payload)<br>    self.assertEqual(response.status_code, 201)</pre><pre>def test_create_produk_negative_price(self):<br>    payload = {<br>        &quot;nama&quot;: &quot;Test Negative Price&quot;,<br>        &quot;harga_modal&quot;: -100000,<br>        &quot;harga_jual&quot;: -150000,<br>        &quot;stok&quot;: 10,<br>        &quot;satuan&quot;: &quot;PCS&quot;,<br>        &quot;kategori&quot;: &quot;Elektronik&quot;<br>    }<br>    response = self.client.post(self.url, data=payload)<br>    self.assertEqual(response.status_code, 422)</pre><p>Test case mencakup berbagai jenis masukan, sesuai dengan prinsip Test-Driven Development (TDD) dan quality assurance.</p><h3>Mengapa Penerapan Ini Penting?</h3><p>Penerapan prinsip <strong>SOLID</strong> dan berbagai <strong>best practice</strong> di sisi backend bukan sekadar formalitas teknikal, melainkan fondasi penting dalam menjaga ketahanan dan kelincahan sistem kami. Hal ini terbukti saat bisnis meminta penambahan fitur baru, seperti endpoint <strong>“produk stok rendah” (/low-stock)</strong>. Dengan arsitektur yang sudah modular, kami bisa mengimplementasikan fitur tersebut <strong>secara terpisah</strong>, tanpa perlu menyentuh fungsi-fungsi inti seperti create_produk() atau update_produk().</p><p>Pendekatan ini meminimalisir risiko <strong>regresi</strong> — bug baru yang muncul karena perubahan di bagian lain kode. Dalam sistem yang tidak mengikuti prinsip SOLID, satu perubahan kecil saja bisa berdampak besar dan tak terduga, terutama jika logika bisnis saling bertumpuk dalam satu fungsi.</p><p>Sebaliknya, struktur kami yang <strong>terpisah, jelas, dan teruji</strong> memungkinkan proses pengembangan berjalan lebih cepat, lebih aman, dan jauh lebih menyenangkan bagi tim. Setiap komponen hanya bertanggung jawab atas satu hal, mudah diuji secara unit, dan jika ada perubahan pada kebutuhan bisnis, efeknya bisa dibatasi secara lokal tanpa merusak stabilitas sistem secara keseluruhan.</p><p>Bagi developer, hal ini berarti <strong>lebih sedikit waktu debugging, lebih banyak waktu berinovasi</strong>. Sementara Bagi user, hal ini berarti <strong>pengalaman aplikasi yang lebih stabil dan minim gangguan</strong>, bahkan ketika fitur baru terus ditambahkan.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cf9aa8e45e46" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Dari Test ke Produk: Penerapan TDD FullStack di Aplikasi untuk UMKM]]></title>
            <link>https://medium.com/@diptaarya18/first-week-of-sprint-1-the-warmup-d008a4052af8?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/d008a4052af8</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Mon, 03 Mar 2025 15:18:53 GMT</pubDate>
            <atom:updated>2025-05-14T08:16:32.122Z</atom:updated>
            <content:encoded><![CDATA[<p>Perjalanan ini dimulai dari mata kuliah Proyek Perangkat Lunak di mana kami sebagai tim mendapatkan client dan harus develop aplikasi yang mereka inginkan. Aplikasi ini merupakan aplikasi dengan konsep untuk bridging the gap between UMKM and BPR, sambil membantu UMKM dalam kebutuhan pencatatan keuangannya, seperti Pencatatan Arus Kas dan Laporan Keuangan).</p><p>Dalam membangun aplikasi untuk pelaku UMKM, kualitas dan keandalan fitur menjadi kunci utama. Salah satu pendekatan yang kami gunakan untuk menjamin kualitas adalah Test-Driven Development (TDD). Dengan menulis test sebelum membangun logika utama, kita tidak hanya memastikan aplikasi bekerja sesuai harapan, tetapi juga meminimalkan potensi bug sejak awal.</p><p><strong>Test-Driven Development (TDD)</strong> adalah pendekatan pengembangan perangkat lunak di mana kita menulis test terlebih dahulu sebelum menulis kode program yang sebenarnya. Siklus utamanya dikenal sebagai <strong>Red-Green-Refactor</strong>, yang terdiri dari tiga tahap:</p><ol><li><strong>Red</strong> — Tulis test terlebih dahulu yang pasti gagal karena fitur belum diimplementasikan.</li><li><strong>Green</strong> — Tulis kode minimum agar test tersebut bisa lulus.</li><li><strong>Refactor</strong> — Perbaiki atau bersihkan kode tanpa mengubah perilaku, sambil memastikan semua test tetap hijau.</li></ol><p>Pendekatan ini membantu memastikan bahwa setiap bagian kode memiliki test yang menyertainya, dan perubahan ke depannya tidak merusak fitur yang sudah ada.</p><p>Dalam pengujian perangkat lunak, kita mengenal tiga jenis skenario utama: <strong>Success Case</strong>, <strong>Failed Case</strong>, dan <strong>Corner Case</strong>. <em>Success Case</em> menunjukkan bahwa sistem bekerja sebagaimana mestinya saat menerima input yang benar. <em>Failed Case</em> memastikan sistem menolak atau menangani input yang tidak valid secara tepat. Sementara itu, <em>Corner Case</em> menguji batas atau kondisi ekstrem yang jarang terjadi namun tetap mungkin dialami pengguna. Ketiga jenis case ini sangat penting untuk menciptakan sistem yang kuat dan tahan banting.</p><p>Dalam blog ini, kita akan membahas 5 fitur utama pada proses tambah produk yang diuji secara menyeluruh — meliputi success case, failed case, dan corner case — baik dari sisi frontend maupun backend.</p><h3>1. Fitur: Membuat Produk (create_produk)</h3><h4>Success Case:</h4><p>Produk berhasil dibuat dengan kategori dan satuan baru.</p><pre>def test_create_produk(self):<br>    payload = CreateProdukSchema(<br>        nama=&#39;NewProd&#39;,<br>        harga_modal=500,<br>        harga_jual=800,<br>        stok=3,<br>        satuan=&#39;Box&#39;,<br>        kategori=&#39;CatC&#39;<br>    )<br>    request = MockRequest(user_id=self.user1.id)<br>    status, resp = create_produk(request, payload=payload)<br>    self.assertEqual(status, 201)<br>    self.assertEqual(resp.nama, &#39;NewProd&#39;)</pre><h4>Corner Case:</h4><p>Produk dibuat dengan stok = 0 atau nama yang sangat panjang.</p><pre>def test_create_produk_zero_stok(self):<br>    payload = CreateProdukSchema(<br>        nama=&#39;ProdukStok0&#39;,<br>        harga_modal=1000,<br>        harga_jual=1500,<br>        stok=0,<br>        satuan=&#39;Pcs&#39;,<br>        kategori=&#39;CatZ&#39;<br>    )<br>    request = MockRequest(user_id=self.user1.id)<br>    status, resp = create_produk(request, payload=payload)<br>    self.assertEqual(status, 201)<br>    self.assertEqual(resp.stok, 0.0)</pre><h4>Failed Case:</h4><p>Produk dibuat oleh user yang tidak memiliki toko.</p><pre>def test_create_produk_no_toko(self):<br>    payload = CreateProdukSchema(<br>        nama=&#39;InvalidProduct&#39;,<br>        harga_modal=100,<br>        harga_jual=150,<br>        stok=1,<br>        satuan=&#39;Box&#39;,<br>        kategori=&#39;Y&#39;<br>    )<br>    request = MockRequest(user_id=self.user_no_toko.id)<br>    status, resp = create_produk(request, payload=payload)<br>    self.assertEqual(status, 422)<br>    self.assertEqual(resp[&#39;message&#39;], &quot;User doesn&#39;t have a toko&quot;)</pre><h3>2. Fitur: Mengupdate Produk (update_produk)</h3><h4>Success Case:</h4><p>Update stok dari produk berhasil.</p><pre>def test_update_produk(self):<br>    payload = UpdateProdukSchema(<br>        nama=None,<br>        harga_modal=None,<br>        harga_jual=None,<br>        stok=99,<br>        satuan=None,<br>        kategori=None<br>    )<br>    request = MockRequest(user_id=self.user1.id)<br>    status, resp = update_produk(request, id=self.sample_prod.id, payload=payload)<br>    self.assertEqual(status, 200)<br>    self.assertEqual(resp.stok, 99.0)</pre><h4>Corner Case:</h4><p>Hanya sebagian field yang di-update, misalnya hanya harga_jual.</p><pre>def test_partial_update_produk(self):<br>    payload = UpdateProdukSchema(<br>        nama=None,<br>        harga_modal=None,<br>        harga_jual=2000,<br>        stok=None,<br>        satuan=None,<br>        kategori=None<br>    )<br>    request = MockRequest(user_id=self.user1.id)<br>    status, resp = update_produk(request, id=self.sample_prod.id, payload=payload)<br>    self.assertEqual(status, 200)<br>    self.assertEqual(resp.harga_jual, 2000.0)</pre><h4>Failed Case:</h4><p>Update dilakukan oleh user tanpa toko atau produk tidak ditemukan.</p><pre>def test_update_invalid_negative(self):<br>    with self.assertRaises(ValidationError):<br>        UpdateProdukSchema(<br>            nama=None,<br>            harga_modal=None,<br>            harga_jual=None,<br>            stok=-5,<br>            satuan=None,<br>            kategori=None<br>        )</pre><h3>3. Fitur: Menghapus Produk (delete_produk)</h3><h4>Success Case:</h4><p>Produk berhasil dihapus.</p><pre>def test_delete_produk(self):<br>    request = MockRequest(user_id=self.user1.id)<br>    data = delete_produk(request, id=self.sample_prod.id)<br>    self.assertEqual(data[&#39;message&#39;], &#39;Produk berhasil dihapus&#39;)<br>    self.assertFalse(Produk.objects.filter(id=self.sample_prod.id).exists())</pre><h4>Corner Case:</h4><p>Menghapus produk yang baru saja dibuat atau ID yang valid tapi milik toko lain.</p><pre>def test_delete_recently_created_produk(self):<br>    produk = Produk.objects.create(<br>        nama=&#39;Temp&#39;,<br>        foto=None,<br>        harga_modal=100,<br>        harga_jual=150,<br>        stok=5,<br>        satuan=&#39;Pcs&#39;,<br>        kategori=self.cat1,<br>        toko=self.toko1<br>    )<br>    request = MockRequest(user_id=self.user1.id)<br>    data = delete_produk(request, id=produk.id)<br>    self.assertEqual(data[&#39;message&#39;], &#39;Produk berhasil dihapus&#39;)</pre><h4>Failed Case:</h4><p>Coba hapus produk milik user lain → exception.</p><pre>def test_delete_other_users_produk(self):<br>    other_prod = Produk.objects.filter(toko=self.toko2).first()<br>    request = MockRequest(user_id=self.user1.id)<br>    with self.assertRaises(Exception):<br>        delete_produk(request, id=other_prod.id)</pre><h3>4. Fitur: Mengambil Produk Berdasarkan ID (get_produk_by_id)</h3><h4>Success Case:</h4><p>Produk dengan ID valid dikembalikan.</p><pre>def test_get_produk_by_id_success(self):<br>    request = MockRequest(user_id=self.user1.id)<br>    status, resp = get_produk_by_id(request, id=self.sample_prod.id)<br>    self.assertEqual(status, 200)<br>    self.assertEqual(resp.id, self.sample_prod.id)</pre><h4>Corner Case:</h4><p>Produk milik toko lain atau ID edge-case (misal: id=0).</p><pre>def test_get_produk_by_id_different_toko(self):<br>    prod_other = Produk.objects.filter(toko=self.toko2).first()<br>    request = MockRequest(user_id=self.user1.id)<br>    status, resp = get_produk_by_id(request, id=prod_other.id)<br>    self.assertEqual(status, 404)<br>    self.assertEqual(resp[&#39;message&#39;], &#39;Produk tidak ditemukan&#39;)</pre><h4>Failed Case:</h4><p>Produk tidak ditemukan.</p><pre>def test_get_produk_by_id_not_found(self):<br>    request = MockRequest(user_id=self.user1.id)<br>    status, resp = get_produk_by_id(request, id=9999)<br>    self.assertEqual(status, 404)<br>    self.assertEqual(resp[&#39;message&#39;], &#39;Produk tidak ditemukan&#39;)</pre><h3>5. Fitur: Mendapatkan Produk Low Stock (get_low_stock_products)</h3><h4>Success Case:</h4><p>Produk dengan stok rendah berhasil dikembalikan.</p><pre>def test_low_stock_products(self):<br>    request = MockRequest(user_id=self.user1.id)<br>    status, items = get_low_stock_products(request)<br>    self.assertEqual(status, 200)<br>    self.assertTrue(all(item[&#39;stock&#39;] &lt; 10 for item in items))</pre><h4>Corner Case:</h4><p>Tidak ada produk dengan stok rendah.</p><pre>def test_low_stock_products_empty(self):<br>    Produk.objects.filter(toko=self.toko1).update(stok=100)<br>    request = MockRequest(user_id=self.user1.id)<br>    status, items = get_low_stock_products(request)<br>    self.assertEqual(status, 200)<br>    self.assertEqual(len(items), 0)</pre><h4>Failed Case:</h4><p>User tidak memiliki toko → status 404.</p><pre>def test_low_stock_user_no_toko(self):<br>    request = MockRequest(user_id=self.user_no_toko.id)<br>    status, resp = get_low_stock_products(request)<br>    self.assertEqual(status, 404)<br>    self.assertEqual(resp[&#39;message&#39;], &quot;User doesn&#39;t have a toko&quot;)</pre><h3>Kesimpulan</h3><p>Dengan menerapkan TDD secara konsisten pada 5 fitur penting ini, kita memastikan bahwa aplikasi UMKM tidak hanya berjalan dengan baik di skenario umum, tetapi juga tetap tangguh saat menghadapi input yang tidak biasa. Pendekatan ini mempercepat proses debugging, meningkatkan kepercayaan diri developer, dan menjamin kualitas aplikasi di tangan pengguna akhir.</p><p>Selain itu, TDD juga berfungsi sebagai dokumentasi hidup: setiap test menggambarkan perilaku yang diharapkan dari fitur. Ini sangat membantu saat tim berkembang, saat melakukan refactoring, atau saat menambahkan fitur baru. Dengan test sebagai pengaman, perubahan kode bisa dilakukan dengan lebih berani dan terkontrol.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d008a4052af8" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Merancang UI Design Aplikasi LANCAR]]></title>
            <link>https://medium.com/@diptaarya18/merancang-ui-design-aplikasi-lancar-c4050a1be558?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/c4050a1be558</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Mon, 03 Mar 2025 15:07:59 GMT</pubDate>
            <atom:updated>2025-05-15T04:52:18.537Z</atom:updated>
            <content:encoded><![CDATA[<p>Salah satu proses dalam sprint planning adalah membuat prototype dari aplikasi ini. Proses perancangan ini tidak hanya sekadar membuat tampilan menarik, tetapi juga mempertimbangkan prinsip <em>usability</em> agar pengalaman pengguna lebih optimal.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/375/1*WAq0l617qc_g8DSi-_O2GQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/375/1*geGF5wrY_ATfc9tCidG6Ug.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YiJO9I_bxDYCjvGn6xbdrw.png" /></figure><p>Sebagai acuan dalam desain, saya menerapkan <strong>10 Usability Heuristics</strong> dari Jakob Nielsen untuk memastikan antarmuka mudah digunakan. Beberapa prinsip utama yang saya terapkan termasuk:</p><h3>1. Visibility of System Status</h3><ul><li>Pada <strong>Laporan Keuangan</strong>, indikator status keuangan (misalnya laba atau rugi) diperlihatkan dengan jelas.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/947/1*8Z04ZYNKnsYAJBV5tWSoCw.png" /></figure><h3>2. Match Between System and the Real World</h3><ul><li>Dalam <strong>Pembukuan Digital</strong>, istilah yang digunakan sesuai dengan yang sering dipakai dalam dunia akuntansi dan keuangan, seperti “Pemasukan”, “Pengeluaran”, “Laba Rugi”, dan “Neraca”.</li><li>Tampilan <strong>Struk Digital</strong> menyerupai struk fisik, dengan informasi yang familiar bagi pengguna seperti nomor transaksi, tanggal, dan total pembayaran.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/401/1*44ho3bO8AROZJUkF70MH7A.png" /></figure><h3>3. User Control and Freedom</h3><ul><li><strong>Tombol kembali (back button)</strong> disediakan dalam beberapa alur, seperti pada <strong>pengajuan pendanaan</strong>, untuk memungkinkan pengguna kembali ke langkah sebelumnya tanpa kehilangan data.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/597/1*yeXmwoB3Gc7YH3OvU60udw.png" /></figure><h3>4. Consistency and Standards</h3><ul><li><strong>Ikon, warna, dan elemen UI</strong> di semua halaman aplikasi dirancang secara konsisten agar pengguna tidak perlu belajar ulang saat berpindah halaman.</li><li><strong>Tata letak elemen dalam Laporan Keuangan </strong>mengikuti standar sistem pembukuan yang umum digunakan.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/749/1*4ZdrYvQRh5IlKWGodGQr9Q.png" /></figure><h3>5. Error Prevention</h3><ul><li><strong>Review Form Pengajuan Pinjaman</strong> membantu pengguna mengecek apakah data mereka benar sebelum dikirim.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/583/1*LWHPyQ5x4a2VbbfklfLaLQ.png" /></figure><h3>6. Recognition Rather Than Recall</h3><ul><li>Pada <strong>Riwayat Pengajuan Pendanaan</strong>, pengguna bisa melihat daftar pengajuan sebelumnya, sehingga tidak perlu mengingat detailnya satu per satu.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/362/1*kRFji5DLIRwlsxbE9LaEQw.png" /></figure><p>Riwayat transaksi ditampilkan, <strong>tetapi</strong> masih belum ada fitur seperti autofill atau saran otomatis berdasarkan input sebelumnya atau input yang konsisten diisi. Tanpa fitur ini, pengguna harus mengingat dan memasukkan data yang sama berulang kali, meningkatkan beban kognitif.</p><h3>7. Flexibility and Efficiency of Use</h3><ul><li><strong>Fitur Multi-User</strong> memungkinkan lebih dari satu pengguna mengakses sistem sesuai dengan perannya, meningkatkan fleksibilitas aplikasi untuk UMKM.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/430/1*dVT2MRQULllsrfqE52W_pw.png" /></figure><h3>8. Aesthetic and Minimalist Design</h3><ul><li>Desain <strong>halaman yang diterapkan </strong>menggunakan <strong>hierarki visual</strong> yang jelas, menghilangkan elemen yang tidak perlu agar informasi lebih mudah dipahami.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/778/1*b2xdajG-0FUTiy6cK1VJCA.png" /><figcaption>*<strong>Hierarki Visual </strong>adalah yang mengatur elemen visual berdasarkan tingkat kepentingannya, membantu pengguna memahami informasi dengan cepat dan mudah. Hierarki Visual dapat dicapai melalui teknik seperti ukuran, warna, tipografi, dan tata letak.</figcaption></figure><p>Desain minimalis diterapkan, <strong>tetapi</strong> tidak dijelaskan apakah ada opsi untuk menyesuaikan tampilan sesuai preferensi pengguna (misalnya, mode gelap atau penyesuaian ukuran teks). Tanpa opsi kustomisasi, aplikasi mungkin tidak memenuhi kebutuhan semua pengguna.</p><h3>9. Help Users Recognize, Diagnose, and Recover from Errors</h3><ul><li><strong>Pesan error yang jelas dan spesifik</strong> muncul jika pengguna salah memasukkan data dalam form pengajuan atau laporan keuangan.</li><li><strong>Namun,</strong> tidak ada informasi mengenai adanya panduan atau bantuan untuk mengatasi kesalahan tersebut. Tanpa bantuan tambahan, pengguna mungkin kesulitan memahami dan memperbaiki kesalahan yang terjadi.</li></ul><h3>10. Help and Documentation</h3><p>Aplikasi LANCAR masih belum memiliki fitur bantuan atau dokumentasi dalam aplikasi, seperti User Manual atau panduan umum menggunakan aplikasinya. Ketiadaan sumber bantuan dapat menyulitkan pengguna baru dalam memahami cara menggunakan aplikasi atau menyelesaikan masalah yang mereka hadapi.</p><h3>Benchmarking Fitur Pencatatan Pengeluaran dan Pemasukan</h3><p>Untuk meningkatkan fitur pencatatan pengeluaran dan pemasukan pada aplikasi LANCAR, kami melakukan benchmarking dengan membandingkan aplikasi LANCAR dengan aplikasi <strong>Paper.id</strong>, yang sudah memiliki fitur serupa. Benchmarking ini bertujuan untuk mengidentifikasi fitur unggulan yang bisa diadaptasi dan dioptimalkan dalam aplikasi LANCAR, serta memberikan pengalaman pengguna yang lebih baik.</p><h4>1. Aplikasi LANCAR</h4><p>Aplikasi LANCAR memberikan tampilan yang simpel dan mudah dipahami dengan menampilkan <strong>Total Pemasukan dan Pengeluaran</strong>, serta informasi terkait <strong>Transaksi yang sudah tercatat</strong>. Pengguna dapat melihat ringkasan transaksi mereka dalam bentuk yang jelas dan langsung mengakses informasi yang diperlukan. Fitur filter untuk memilih transaksi berdasarkan status “Lunas” atau “Belum Lunas” juga disediakan, memudahkan pencatatan pengeluaran dan pemasukan.</p><p><strong>Key Takeaway:</strong></p><ul><li><strong>Dashboard Ringkasan</strong> yang jelas memungkinkan pengguna untuk melihat status keuangan secara cepat.</li><li>Penyajian total dan status transaksi secara langsung sangat membantu pengguna yang ingin melacak pengeluaran dan pemasukan secara real-time.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/429/1*PPgyWdYj5N_VKbQ50jrgdw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/438/1*6qt0k03k-nT0BDBiu1ChhA.png" /></figure><h4>2. Aplikasi Paper.id</h4><p>Aplikasi <strong>Paper.id</strong> menampilkan <strong>pencatatan pemasukan</strong> dan <strong>pengeluaran</strong> yang lebih rinci. Pengguna dapat menambah transaksi dengan memilih kategori seperti <strong>Penjualan Barang</strong> dan mencatat <strong>total pemasukan</strong> dan <strong>modal</strong> untuk setiap transaksi. Fitur <strong>pembayaran lunas, lunas parsial, dan belum lunas</strong> juga diintegrasikan dalam setiap pencatatan, memudahkan pengguna untuk melacak status pembayaran.</p><p>Selain itu, aplikasi ini dilengkapi dengan kemampuan untuk membuat dan mengelola <strong>invoice pembelian</strong> dan <strong>pembayaran</strong>. Pengguna dapat menambah produk, menghitung <strong>diskon produk</strong>, serta mengelola biaya kirim dan pajak dengan rinci. Hal ini memberikan kontrol lebih besar dalam pencatatan pengeluaran dan transaksi.</p><p><strong>Key Takeaway:</strong></p><ul><li><strong>Pembuatan Invoice</strong> dan pengelolaan transaksi secara rinci mempermudah pelacakan pengeluaran yang lebih terstruktur.</li><li>Pengguna bisa mengelola transaksi dengan lebih detail, termasuk dengan fitur <strong>biaya kirim</strong>, <strong>diskon produk</strong>, dan <strong>pajak</strong> yang memberikan fleksibilitas dalam pengelolaan keuangan.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/828/1*EdWLOlNwAHddQcU4j_i4Cw.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/828/1*dyCgHjvY3sZcAFNcHeatzA.jpeg" /></figure><h3>Integrasi Pembelajaran dalam Aplikasi LANCAR</h3><p>Dari benchmarking yang dilakukan, beberapa fitur dari <strong>Paper.id</strong> yang kami adopsi untuk aplikasi LANCAR antara lain:</p><ul><li><strong>Dashboard Ringkasan Transaksi</strong> yang menampilkan total pemasukan, pengeluaran, dan saldo yang mudah dipahami oleh pengguna.</li><li><strong>Fitur Filter Transaksi</strong>, yang memungkinkan pengguna memisahkan transaksi berdasarkan status “Lunas” atau “Belum Lunas”.</li><li><strong>Pencatatan Pengeluaran dan Pemasukan </strong>yang mempermudah pencatatan dengan rincian jenis pengeluaran atau pemasukan apa yang dilakukan.</li></ul><p>Dengan mengintegrasikan fitur-fitur tersebut, aplikasi LANCAR bertujuan untuk memberikan pengalaman pengguna yang lebih baik dalam mengelola pemasukan dan pengeluaran untuk UMKM.</p><p>Hasil akhir dari perancangan ini adalah wireframe dan mockup yang tidak hanya mengikuti standar usability, tetapi juga lebih relevan dengan kebutuhan pengguna yang terbiasa dengan aplikasi pembukuan digital. Dengan menerapkan prinsip-prinsip desain yang tepat dan melakukan analisis perbandingan, saya berharap UI Design yang dibuat dapat meningkatkan efisiensi dan kemudahan dalam mengelola transaksi keuangan bagi pengguna.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c4050a1be558" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Starting a new App called LANCAR]]></title>
            <link>https://medium.com/@diptaarya18/starting-a-new-app-called-lancar-12df1eb5cf7a?source=rss-a0ab27b3e064------2</link>
            <guid isPermaLink="false">https://medium.com/p/12df1eb5cf7a</guid>
            <dc:creator><![CDATA[Pradipta Arya]]></dc:creator>
            <pubDate>Thu, 27 Feb 2025 02:27:15 GMT</pubDate>
            <atom:updated>2025-02-27T02:27:15.269Z</atom:updated>
            <content:encoded><![CDATA[<p>Perjalanan ini dimulai dari mata kuliah Proyek Perangkat Lunak di mana kami sebagai tim mendapatkan client dan harus develop aplikasi yang mereka inginkan. Aplikasi ini merupakan aplikasi dengan konsep untuk bridging the gap between UMKM and BPR while helping UMKM on their own financial needs (e.g Pencatatan Arus Kas dan Laporan Keuangan).</p><p>Tanggal 25 Februari 2025 menjadi langkah awal dalam perjalanan kami mengembangkan aplikasi yang berperan sebagai <em>middle man</em> antara Bank Perkreditan Rakyat (BPR) dan Usaha Mikro Kecil dan Menengah (UMKM). Kami memulai dengan sesi <em>Sprint Planning</em>, di mana seluruh tim berkumpul untuk merancang strategi pengembangan dan menyusun backlog yang akan dikerjakan dalam sprint pertama.</p><p>Untuk memastikan estimasi pekerjaan yang lebih akurat, kami menggunakan metode <em>Planning Poker</em> dalam menentukan <em>story points</em> untuk setiap backlog. Pendekatan ini membantu kami menyepakati tingkat kompleksitas dan usaha yang dibutuhkan dalam menyelesaikan setiap fitur atau tugas. Setelah itu, backlog yang telah ditentukan kami pecah menjadi tugas-tugas yang lebih kecil dan dikelola menggunakan Jira. Ini juga menjadi kesempatan bagi tim untuk mempelajari lebih dalam tentang Jira sebagai alat manajemen proyek yang akan membantu kami dalam kolaborasi dan pemantauan progres.</p><p>Setelah backlog dipecah menjadi <em>task</em>, tahap selanjutnya adalah meng-<em>assign</em> tugas kepada setiap anggota tim sesuai dengan keahlian dan kapasitas masing-masing. Dengan semua persiapan ini, kami siap memulai sprint pertama dan bergerak menuju pengembangan aplikasi yang diharapkan dapat memberikan manfaat besar bagi para pengguna.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=12df1eb5cf7a" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>