Apa Perbedaan Manifest, Report, dan Finding? Apa Arti Istilah Hierarki Data dalam Arsitektur Perangkat Lunak? Mengapa Desain API Dibuat Berlapis? Bagaimana Perbedaan Metadata, Artifact, dan Payload!

Apakah Anda sering menemukan istilah seperti Manifest, Report, Finding, dan Evidence saat membaca dokumentasi API, output pemindai keamanan, atau alur kerja CI/CD? Istilah-istilah ini bukanlah sintaks dari bahasa pemrograman tertentu, melainkan istilah hierarki data standar dalam industri. Apa sebenarnya arti istilah-istilah ini?

Konsep Utama: Memahami Hierarki Data Melalui “Pemeriksaan Kesehatan”

Kita bisa membayangkan proses ini seperti alur pemeriksaan kesehatan di rumah sakit. Keempat istilah ini bersesuaian tepat dengan tingkatan data dari ringkasan tingkat tinggi hingga data mentah di tingkat paling bawah.

Istilah	Analogi Pemeriksaan Kesehatan	Penjelasan dalam Arsitektur Perangkat Lunak
`Manifest`	Formulir Pendaftaran Pemeriksaan	Mengumumkan item yang akan dieksekusi, versi, dan konfigurasi lingkungan; merupakan data deskriptif.
`Report`	Laporan Hasil Pemeriksaan Lengkap	Ringkasan lengkap setelah eksekusi selesai, mencakup status keseluruhan dan hasil audit.
`Finding`	Catatan Tinta Merah pada Laporan	Temuan spesifik yang dilingkari dalam laporan, seperti “Hipertensi Terdeteksi” atau celah keamanan.
`Evidence`	Struk Data Tensimeter	Bukti mentah objektif yang mendukung temuan, seperti catatan log atau nilai pengukuran data.

Istilah-istilah ini bukanlah kata kunci khusus bahasa pemrograman, melainkan model data bersama standar industri.

Kita dapat menggunakan diagram Mermaid untuk menggambarkan hubungan hulu/hilir dan cakupan dari keempat konsep ini dalam struktur data:

  graph TD
    A["Manifest (Spesifikasi Eksekusi/Metadata)"] -->|Mendefinisikan Cakupan & Eksekusi| B["Report (Laporan Ringkasan Lengkap)"]
    B -->|Berisi Banyak| C["Finding (Temuan Spesifik/Observasi)"]
    C -->|Mengkaitkan Banyak| D["Evidence (Bukti Mentah Objektif)"]

Mengapa Memakai Desain Berlapis? 3 Keuntungan Utama Hierarki Data

Mengapa sistem harus memisahkan data secara detail alih-alih memasukkan semuanya ke dalam satu objek JSON raksasa? Desain ini menawarkan beberapa keuntungan besar:

Desain arsitektur API yang luar biasa membuat pemuatan antarmuka frontend lebih lancar, serta meningkatkan kredibilitas dan fleksibilitas data.

Keuntungan	Penjelasan
Pemisahan Tanggung Jawab (Separation of Concerns)	Antarmuka frontend dapat memuat ringkasan `Finding` terlebih dahulu untuk tampilan cepat, lalu mengambil data `Evidence` yang besar hanya saat dibutuhkan.
Kredibilitas Tinggi	Menyediakan `Evidence` membuktikan bahwa `Finding` bukan positif palsu (false positive), sehingga secara signifikan meningkatkan kemampuan audit sistem.
Skalabilitas Fleksibel	Satu `Finding` dapat dikaitkan secara fleksibel dengan beberapa `Evidence` tanpa merusak format data asli.

Tambahan Istilah Umum Lainnya: Metadata, Artifact, dan Payload

Selain empat tingkat utama di atas, saat merancang API, membangun pipeline, atau menentukan format transmisi, Anda pasti akan sering melihat tiga istilah ini: Metadata, Artifact, dan Payload:

Istilah	Definisi Utama	Analogi Kehidupan Nyata	Contoh Penerapan Praktis Arsitektur Perangkat Lunak
`Metadata`	Data yang menjelaskan data itu sendiri	Label pengiriman pada paket, informasi EXIF foto	`HTTP Header`, stempel waktu permintaan `timestamp`, informasi halaman `page`.
`Artifact`	Hasil fisik nyata yang dihasilkan setelah proses	Mobil yang diproduksi pabrik, CD pemeriksaan medis	File `.apk` yang dibangun, `Docker Image`, laporan audit `PDF`.
`Payload`	Data bisnis utama yang benar-benar ingin ditransmisikan	Ponsel pintar di dalam kotak paket pengiriman	Konten bisnis `JSON` di dalam `HTTP POST Body`.

Payload seperti barang di dalam paket pengiriman, sedangkan Metadata adalah label alamat yang ditempel di luar paket.

Untuk membantu memahami bagaimana ketiganya bekerja sama, perhatikan struktur data API Request khas berikut:

{
  "metadata": {
    "version": "v1.2.0",
    "timestamp": "2026-08-02T15:08:41Z",
    "request_id": "req-98765"
  },
  "payload": {
    "report_id": "REP-2026-001",
    "status": "COMPLETED",
    "artifact_url": "https://example.com/artifacts/build-report.pdf"
  }
}

Dalam contoh JSON ini:

metadata menyediakan konteks transmisi dan lingkungan (versi, stempel waktu, ID permintaan).
payload berisi data logika bisnis utama yang dikirim (ID laporan, status).
artifact_url menunjuk ke file nyata yang dihasilkan dari tugas build ini (Artifact).

Kekuatan Kosakata Bersama: Jembatan Komunikasi Antar-Sistem

Ketika berbagai alat dan tim mengadopsi model data serupa ini (misalnya Report -> Findings -> Evidence), biaya komunikasi antar-tim akan berkurang secara drastis.

Bayangkan Report yang dihasilkan oleh alat CI/CD Anda dapat langsung ditransmisikan ke sistem keamanan untuk dianalisis—itulah kekuatan integrasi dari bahasa domain bersama.

  sequenceDiagram
    autonumber
    actor CI as CI/CD Pipeline
    participant Scanner as Pemindai Keamanan
    participant Dashboard as Dasbor Manajemen
    
    CI->>Scanner: Menyediakan Manifest untuk Pemindaian
    Scanner->>Scanner: Menghasilkan Report dan Findings
    Scanner->>Dashboard: Mengirim Payload Terstruktur (Finding + Evidence)
    Dashboard-->>CI: Menampilkan Hasil Audit

Ringkasan

Pada dasarnya, tujuan dari istilah-istilah ini adalah untuk menyelesaikan masalah komunikasi dan strukturisasi data antar-sistem skala besar.

Saat menghubungkan sistem atau merancang API, cobalah menerapkan konsep hierarki data ini ke dalam struktur Payload Anda agar desain sistem Anda lebih profesional dan mudah dikembangkan!