Penjelasan kode kita: P4 dan polling
Materi pendamping (pelajaran Go yang bisa dijalankan, glossary, bukti tes, draf laporan) ada di
D:/Kuliah/Tugas-AAT/explain/dan belum ada di situs ini. Rujukan kebelajar_go/danGLOSSARY.mddi dokumen-dokumen ini menunjuk ke sana.
Tujuh dokumen, satu untuk tiap bagian kode yang berkaitan dengan P4 dan polling. Kode yang ditampilkan dikutip otomatis dari file aslinya (lengkap dengan nomor barisnya), jadi dijamin sama dengan yang ada di repo. Penjelasannya memakai bahasa biasa, dan istilah teknis tidak diterjemahkan supaya cocok dengan yang dipakai asisten dan dokumentasi.
Prasyarat
- Syntax Go yang belum kamu pahami:
../belajar_go/(tiap dokumen menyebut nomor pelajaran yang relevan). - Istilah yang belum familier:
../GLOSSARY.md.
Urutan baca
Dari yang paling mendasar ke yang merakit semuanya:
| # | Dokumen | Isi | Pemilik |
|---|---|---|---|
| 1 | 01_domain_hazard_event.md | bentuk data HazardEvent | Grace |
| 2 | 02_config_dan_env.md | bagaimana konfigurasi dan rahasia masuk | tim |
| 3 | 03_pondasi_core.md | correlation ID, log, HTTP client, server, health check | tim |
| 4 | 04_store_mongodb.md | penyimpanan di MongoDB (P4) | kamu |
| 5 | 05_api_hazards.md | jalur baca untuk bnpb-api (P4) | kamu |
| 6 | 06_ingest_polling.md | loop polling (polling) | kamu (klien sumber: Grace) |
| 7 | 07_main_perakitan.md | merakit semuanya | kamu (bagian P4 dan polling) |
Kalau waktunya terbatas, baca 4, 6, 7 dulu. Itu inti tugasmu.
Struktur tiap dokumen
Semua dokumen mengikuti pola yang sama supaya mudah ditulis ulang dengan kata-katamu:
- Kenapa ada: masalah apa di soal yang dijawabnya.
- Kenapa dibutuhkan: apa yang rusak atau tidak bisa didemokan kalau bagian itu tidak ada.
- Kodenya, per bagian: kutipan kode, lalu penjelasan langkah demi langkah.
- Cara menjelaskan dalam 30 detik: contoh ringkasan yang bisa kamu ucapkan.
- Yang sudah dibuktikan dan Batasan: apa yang aman diklaim, dan apa yang tidak.
- Latihan: pertanyaan untuk menguji pemahamanmu.
Bagaimana dokumen ini dibuat
Kutipan kode diambil oleh skrip dari file di AAT/services/bnpb-aggregator/. Kalau kode
berubah, nomor baris di dokumen ini bisa bergeser. Itu tidak mengubah isi kutipan pada saat
dokumen dibuat, tetapi kalau kode sudah diubah banyak, minta agar dokumen dibuat ulang.