PANDUAN PORTOIN
Dokumentasi Proyek IoT yang Mudah Dinilai
Proyek IoT perlu menjelaskan besaran yang dipantau, perjalanan data, dan hasil pengujian. Foto perangkat menjadi lebih jelas bila terhubung dengan arsitektur sistem.
Tentukan kebutuhan sistem
Sebut besaran, lingkungan, pengguna, serta tindakan yang diharapkan. Gambarkan sensor, mikrokontroler, jaringan, backend, dan antarmuka sesuai sistem yang dibangun. Tidak semua proyek memerlukan seluruh komponen itu.
Bedakan prototipe lokal dan sistem lapangan. Tulis kontribusi pada firmware, komunikasi, atau dashboard. Daftar komponen tanpa hubungan belum menjelaskan cara kerja.
Dokumentasikan data dan gangguan
Jelaskan interval pembacaan, format pesan, serta penanganan koneksi terputus jika telah diterapkan. Pengujian memiliki kondisi dan satuan. Screenshot dashboard diberi keterangan tentang data yang ditampilkan.
Jangan mencantumkan SSID, password, atau token perangkat. Gunakan konfigurasi demo terpisah. Jika belum menguji kegagalan koneksi, nyatakan keterbatasan tersebut secara terbuka.
Buat bukti yang terbaca
Pilih diagram, foto, grafik, serta video alur kerja. Ringkas hasil dan masalah terbuka. Koneksi berhasil satu kali bukan bukti keandalan jangka panjang.
Di Portoin, sampul mengenalkan perangkat dan galeri memuat hasil uji. Kode serta video menjadi pendukung. PDF dapat memisahkan kebutuhan, arsitektur, demonstrasi, dan hasil pengukuran.