Cara Menggunakan Obsidian untuk Membuat Sistem Referensi Proyek dengan Dataview Query

Kalau kamu sering mengelola banyak proyek sekaligus—entah itu proyek coding, riset, atau eksperimen pribadi—pasti pernah mengalami masalah ini: catatan berserakan, referensi sulit dilacak, dan kamu lupa di mana menyimpan dokumentasi penting. Obsidian dengan plugin Dataview bisa jadi solusi praktis untuk membuat sistem referensi proyek yang terstruktur dan mudah diakses. Artikel ini akan memandu kamu membuat sistem referensi yang benar-benar bisa dipakai sehari-hari, lengkap dengan query Dataview yang siap pakai.

Kenapa Obsidian dan Dataview?

Obsidian adalah aplikasi note-taking berbasis markdown yang menyimpan semua catatan sebagai file lokal. Artinya, kamu punya kontrol penuh atas data tanpa bergantung pada cloud service. Plugin Dataview mengubah Obsidian menjadi semacam database personal—kamu bisa membuat query untuk mengambil, memfilter, dan menampilkan informasi dari catatan-catatanmu secara otomatis.

Kombinasi ini cocok untuk developer yang butuh tracking proyek, dokumentasi API, snippet code, atau bahkan bug log. Semua bisa diorganisir dengan metadata dan ditampilkan sesuai kebutuhan tanpa harus scroll manual.

Persiapan Awal

Pertama, install Obsidian di perangkatmu. Untuk pengguna Termux, kamu bisa mengakses vault Obsidian lewat file manager atau text editor favorit karena semua file disimpan dalam format markdown biasa. Setelah itu, aktifkan plugin Dataview dari Settings → Community Plugins → Browse → cari "Dataview" → Install dan Enable.

Buat struktur folder dasar untuk proyek. Contoh sederhana:

• Projects/ - folder utama untuk semua proyek
• References/ - dokumentasi, artikel, atau resource eksternal
• Templates/ - template untuk catatan baru

Struktur ini fleksibel, sesuaikan dengan workflow-mu sendiri.

Langkah Praktis Membuat Sistem Referensi

1. Buat Template Proyek dengan Metadata
   Buka folder Templates dan buat file baru bernama project-template.md. Isi dengan struktur dasar seperti ini:

   ---
   project: 
   status: active
   tech: []
   started: 
   deadline: 
   priority: medium
   ---
   
   ## Deskripsi
   [Jelaskan tujuan proyek]
   
   ## Tech Stack
   - 
   
   ## Referensi
   - 
   
   ## Catatan
   

   Bagian di antara tanda --- adalah frontmatter, tempat kamu menyimpan metadata yang bisa di-query oleh Dataview. Field seperti status, tech, dan priority akan sangat berguna nanti.
2. Buat Catatan Proyek Pertama
   Buat file baru di folder Projects, misalnya api-automation.md. Copy template tadi dan isi metadata-nya:

   ---
   project: API Automation Tool
   status: active
   tech: [Python, FastAPI, PostgreSQL]
   started: 2024-01-15
   deadline: 2024-03-01
   priority: high
   ---
   

   Isi bagian deskripsi, tech stack, dan referensi sesuai kebutuhan proyekmu.
3. Buat Dashboard dengan Dataview Query
   Sekarang bagian menariknya. Buat file baru bernama Dashboard.md di root vault atau folder Projects. Di sini kamu akan membuat query untuk menampilkan semua proyek aktif:

   ```dataview
   TABLE status, tech, deadline, priority
   FROM "Projects"
   WHERE status = "active"
   SORT priority DESC, deadline ASC
   ```
   

   Query ini akan menampilkan tabel berisi semua proyek dengan status "active", diurutkan berdasarkan prioritas dan deadline. Kamu bisa melihat overview semua proyek aktif dalam satu halaman.
4. Query Berdasarkan Teknologi
   Misalnya kamu ingin melihat semua proyek yang menggunakan Python:

   ```dataview
   LIST
   FROM "Projects"
   WHERE contains(tech, "Python")
   ```
   

   Atau tampilkan proyek dengan deadline dalam 30 hari ke depan:

   ```dataview
   TABLE deadline, status, priority
   FROM "Projects"
   WHERE deadline <= date(today) + dur(30 days)
   SORT deadline ASC
   ```
   

5. Buat Sistem Referensi Terhubung
   Untuk setiap resource atau dokumentasi penting, buat catatan di folder References dengan metadata yang relevan. Contoh fastapi-docs.md:

   ---
   type: documentation
   related: [API Automation Tool]
   tech: [Python, FastAPI]
   url: https://fastapi.tiangolo.com
   ---
   

   Kemudian di dashboard, tambahkan query untuk menampilkan referensi berdasarkan proyek:

   ```dataview
   LIST
   FROM "References"
   WHERE contains(related, "API Automation Tool")
   ```
   

Kesalahan yang Sering Terjadi

• Metadata tidak konsisten - Gunakan format yang sama untuk field seperti status. Jangan campur "active", "Active", dan "in progress" karena query akan gagal mengenali. Buat daftar nilai yang diizinkan dan patuhi.
• Lupa mengaktifkan Dataview - Query tidak akan jalan kalau plugin belum diaktifkan. Cek di Settings → Community Plugins.
• Syntax query salah - Dataview punya syntax spesifik. Kalau query tidak muncul atau error, cek dokumentasi resmi Dataview atau periksa typo di nama field.
• Terlalu banyak metadata di awal - Mulai dengan field dasar dulu (status, priority, deadline). Tambahkan field baru seiring kebutuhan berkembang. Sistem yang terlalu kompleks di awal justru bikin malas maintain.
• Tidak backup vault - Meskipun file lokal, tetap backup vault secara berkala. Gunakan git atau sync ke cloud storage pribadi.

Tips Aman dan Etis

Sistem referensi ini untuk produktivitas pribadi dan dokumentasi proyek yang sah. Jangan gunakan untuk menyimpan credential, API key, atau informasi sensitif dalam plaintext. Kalau perlu menyimpan informasi sensitif, gunakan password manager yang proper atau enkripsi file terpisah.

Untuk pengguna Termux, pastikan permission folder vault sudah benar dan tidak accessible oleh aplikasi lain tanpa izin. Obsidian menyimpan file dalam format markdown biasa, jadi siapa pun yang punya akses ke folder bisa membaca isinya.

Kalau kamu sharing vault lewat git atau cloud, review dulu isi catatan. Jangan sampai ada informasi internal perusahaan, data klien, atau kode proprietary yang tidak boleh dipublikasikan.

Workflow Praktis Sehari-hari

Setelah sistem berjalan, workflow harianku jadi seperti ini: buka Dashboard untuk cek proyek aktif dan deadline mendekat, update status proyek yang sudah selesai atau tertunda, tambahkan referensi baru kalau menemukan artikel atau dokumentasi berguna, dan gunakan search atau query untuk menemukan informasi spesifik tanpa harus ingat di file mana disimpan.

Sistem ini bukan cuma untuk proyek besar. Aku juga pakai untuk tracking eksperimen kecil, bug yang belum sempat difix, atau ide fitur yang muncul tiba-tiba. Dengan metadata yang tepat, semua bisa dilacak dan diprioritaskan.

Kesimpulan

Obsidian dengan Dataview memberikan fleksibilitas untuk membuat sistem referensi proyek yang sesuai dengan cara kerjamu. Tidak ada aturan baku—kamu bisa mulai sederhana dengan beberapa field metadata dan query dasar, lalu kembangkan seiring kebutuhan. Yang penting konsisten dalam mengisi metadata dan rutin review dashboard agar sistem tetap relevan. Dengan pendekatan ini, kamu punya kontrol penuh atas dokumentasi proyek tanpa bergantung pada tool eksternal yang mungkin berubah atau hilang suatu saat.