Penyerahan adalah tahap yang menentukan apakah seluruh analisis berubah menjadi keputusan, dan paketnya terdiri atas tiga bagian yang saling mengunci, yaitu laporan tertulis, dek presentasi, dan repository yang dapat direproduksi. Topik ini menyusun ketiganya untuk proyek penutup, dengan README sebagai pintu masuk repository dan daftar periksa akhir sebagai gerbang kiriman. Setelah membacanya, penyerahan berjalan sebagai proses yang terukur, bukan pengiriman berkas yang berharap terbaca.
Tiga bagian paket dan perannya#
Laporan tertulis membawa keputusan beserta dasarnya kepada pembaca yang membutuhkan konteks, dan bentuknya adalah ringkasan eksekutif satu halaman yang diperluas. Dek presentasi melayani momen keputusan bersama, dengan enam slide yang memimpin dengan keputusan sebagaimana modul presentasi. Repository membawa kebenaran teknisnya, yaitu kode dan data yang menghasilkan setiap angka, dan ketiganya menyebut angka yang sama.
Pembaca yang berbeda menemukan dirinya di bagian yang berbeda, yaitu pemutus keputusan membuka laporan, peserta rapat menerima deknya, dan penerus teknis membuka repository. Ketidakcocokan antar bagian adalah cacat yang paling cepat meruntuhkan kepercayaan, sehingga angka disalin dari satu sumber keluaran pipeline ke ketiganya, bukan diketik ulang.
Urutan pengerjaannya juga terbalik dari kesan umum, yaitu repository dirapikan lebih dahulu, lalu laporan menyebut hash commit yang tertuju padanya, dan dek disusun terakhir dari laporan yang sudah ditinjau. Urutan ini membuat setiap bagian dibangun di atas bagian yang sudah beku.
README sebagai pintu masuk repository#
README adalah halaman pertama yang dibaca penerus teknis, dan isinya terdiri atas tiga bagian wajib, yaitu cara menjalankan dari nol, struktur berkasnya, dan keputusan analisis beserta batasnya. Templat proyek penutup jalur ini memuat ketiganya secara lengkap.
# README: Analisis Kualitas Udara Dua Stasiun
Analisis ujung-ke-ujung yang menjawab pertanyaan: apakah PM2.5 Stasiun B
berbeda nyata dari Stasiun A, dan seberapa besar?
## Cara menjalankan
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 pipeline.py
```
Keluaran: ringkasan angka di terminal dan berkas `ringkasan-pipeline.png`
di folder yang sama.
## Struktur
- `pipeline.py`: seluruh alur dari berkas mentah sampai grafik.
- `ukuran_udara.csv`: data mentah (jangan disunting; hasil pembersihan
dikerjakan kode, bukan penyuntingan berkas).
- `ringkasan-pipeline.png`: grafik keluaran yang dibangun ulang setiap
eksekusi.
## Keputusan analisis yang tercatat
- Nilai hilang tiga wujud (kosong, `kosong`, `-999.0`) dinetralkan saat
pembacaan.
- Baris ganda eksak dibuang; kunci ganda (stasiun, waktu) dinyatakan nol.
- Nilai di atas 500 diperlakukan sebagai kegagalan sensor dan menjadi
data hilang, bukan nol.
- Model awal: regresi linear dengan dummy stasiun, dinilai pada 25% data
uji berbiji 42.
## Batas
Data latihan dua hari; pola pekanan dan musiman belum dapat dinyatakan.
Hipotesis lanjutan tercatat pada notebook EDA.Bagian “cara menjalankan” diuji dengan menyalin tiga perintahnya ke mesin yang bersih, dan README yang perintahnya gagal adalah penyerahan yang gagal pada langkah pertamanya. Bagian keputusan menyimpan kamus pembersihan dalam bahasa manusia, dan bagian batas menyatakan dua hari data secara terbuka, sejalan dengan kejujuran pada seluruh modul sebelumnya.
README juga menyebut asal-usul datanya beserta ketentuan pakainya, dan tautan ini menutup rantai akuntabilitas yang dibangun pada modul etika, sehingga siapa pun dapat menelusuri sumbernya tanpa bertanya.
Daftar periksa akhir sebelum mengirim#
Gerbang terakhir adalah daftar periksa yang dijalankan dengan jujur, dan butirnya menutup seluruh jalur. Enam pertanyaannya berbunyi berikut.
- Apakah repository berjalan dari nol dengan tiga perintah README?
- Apakah setiap angka pada laporan dapat dilacak ke keluaran pipeline?
- Apakah batas data dinyatakan pada halaman pertama laporan?
- Apakah dek memimpin dengan keputusan dan menghabiskan durasinya?
- Apakah hash commit yang dirujuk laporan benar-benar ada?
- Apakah data beserta izin pakainya tercatat asal-usulnya?
Kegagalan pada satu butir bukan akhir proyek, melainkan pekerjaan yang tersisa, dan daftar itu dijalankan ulang setiap kali paket dikirim ulang. Kebiasaan ini sekaligus menjadi bekal profesionalnya, karena pola penyerahan yang sama berlaku dari proyek latihan sampai laporan yang menunggu keputusan anggaran.
Kesalahan umum#
Kesalahan pertama adalah mengirim tiga berkas yang angkanya berbeda. Laporan yang menulis 0.657 dan dek yang menulis 0.84 meruntuhkan kepercayaan lebih cepat daripada metode yang lemah, dan satu sumber keluaran menutupnya.
Kesalahan kedua adalah README yang tidak pernah diuji dari nol. Lingkungan baru yang gagal pada instalasi membuat penerus teknis menyerah sebelum sampai pada analisisnya, dan uji tiga perintah pada mesin bersih adalah pemeriksaan sepuluh menitnya.
Kesalahan ketiga adalah laporan tanpa batas yang dinyatakan. Pembaca yang membawa angka dua hari ke rapat anggaran tahunan adalah akibat langsung dari batas yang disembunyikan, dan satu kalimat batas menjaga paket tetap dapat dipertanggungjawabkan.
Ringkasan#
- Paket penyerahan terdiri atas laporan, dek, dan repository yang menyebut angka yang sama dari satu sumber keluaran.
- Urutan pengerjaannya berawal dari repository, lalu laporan yang menunjuk hash commit, dan dek terakhir dari laporan yang beku.
- README memuat cara menjalankan dari nol, keputusan analisis, dan batasnya, dan tiga perintahnya diuji pada mesin yang bersih.
- Enam pertanyaan daftar periksa menjadi gerbang akhir, dan kegagalannya adalah pekerjaan tersisa, bukan alasan mengirim.
Referensi#
- Cookiecutter Data Science — driven data — konvensi struktur repository yang melandasi paket penyerahan ini.
- Storytelling with Data — Cole Nussbaumer Knaflic, Wiley — rujukan dek dan laporan yang memimpin dengan keputusan.