Official VS Code Extension untuk ekosistem InvoiceQu. Ekstensi ini membantu para developer dan freelancer melacak waktu kerja secara langsung dari dalam editor VS Code dan mengelola tugas proyek yang terintegrasi dengan akun cloud InvoiceQu.
✨ Fitur Utama
Pencatatan Sesi Kerja Real-time: Mulai dan hentikan pelacak waktu kerja Anda langsung dari sidebar atau status bar di pojok kanan bawah.
Dua Tampilan Utama (Tasks & Projects):
📋 Tasks: Kelola daftar tugas Anda. Tandai tugas sebagai selesai atau aktifkan kembali secara langsung melalui checkbox interaktif di sidebar.
📂 Projects: Lacak status proyek secara keseluruhan. Tandai proyek sebagai selesai (completed) atau kembalikan ke aktif (active) langsung dari ekstensi.
Sinkronisasi Otomatis: Semua data sesi kerja, status tugas, dan status proyek langsung tersinkronisasi dengan database awan InvoiceQu.
Pencarian & Penyaringan Cepat: Cari tugas atau proyek tertentu dengan mudah menggunakan kolom filter yang responsif.
Integrasi VS Code Status Bar: Lihat status pelacakan waktu dan nama tugas aktif Anda kapan saja tanpa harus membuka sidebar.
🚀 Cara Memulai
Ikuti langkah mudah berikut untuk menghubungkan editor VS Code Anda dengan akun InvoiceQu:
Langkah 1: Hubungkan API Key
Buka sidebar InvoiceQu dengan mengklik ikon jam pasir/stopwatch (Ikon InvoiceQu) pada Activity Bar di sisi kiri.
Masukkan API Key Anda ke dalam kolom yang tersedia.
Bagaimana cara mendapatkan API Key?
Masuk ke akun Anda di invoicequ.my.id, buka halaman Pengaturan > API Keys, lalu salin kunci yang diawali dengan iq_live_ atau iq_test_.
Klik tombol Connect to InvoiceQu. Jika berhasil, status akan berubah menjadi Connected.
Langkah 2: Pilih Tugas (Target Task)
Setelah terhubung, daftar proyek dan tugas Anda akan dimuat secara otomatis di panel bagian bawah.
Cari tugas yang ingin Anda kerjakan di bawah tab Active Tasks.
Klik tombol ⏱️ Track pada tugas pilihan Anda. Tugas tersebut kini akan ditetapkan sebagai Target Task aktif pada panel kendali sesi.
Langkah 3: Mulai Melacak Waktu
Klik tombol Mulai Pelacakan di sidebar, atau klik teks status bar di pojok kanan bawah ($(clock) Ready: Nama Task).
Indikator waktu akan mulai berjalan dan status bar akan berkedip/merah untuk menandakan pelacakan sedang berlangsung.
Setelah selesai bekerja, klik tombol Hentikan Pelacakan (atau status bar) untuk menyimpan sesi kerja.
⚠️ Catatan: Sesi kerja kurang dari 10 detik secara otomatis akan diabaikan demi menjaga keakuratan data.
⚙️ Pengaturan Ekstensi (Configuration Settings)
Ekstensi ini menyediakan konfigurasi berikut yang dapat Anda sesuaikan di dalam VS Code Settings (Ctrl+, atau Cmd+,):
Kunci Konfigurasi
Tipe
Deskripsi
invoicequ.apiKey
string
API Key akun InvoiceQu Anda untuk otentikasi.
invoicequ.defaultProjectId
string
ID Proyek bawaan (opsional).
invoicequ.defaultTaskId
string
ID Tugas bawaan (opsional).
🛠️ Shortcut & Perintah Command Palette
Buka Command Palette (Ctrl+Shift+P atau Cmd+Shift+P) dan ketik perintah berikut:
InvoiceQu: Start Time Tracking - Mulai pelacakan tugas yang dipilih saat ini.
InvoiceQu: Stop Time Tracking - Hentikan pelacakan dan kirim catatan waktu ke InvoiceQu.
InvoiceQu: Set API Key - Buka panel koneksi API Key di sidebar.
❓ FAQ & Troubleshooting
Kenapa tombol "Mulai Pelacakan" tidak bisa diklik (Disabled)?
Anda harus memilih salah satu tugas dari daftar di bawahnya terlebih dahulu dengan mengklik tombol ⏱️ Track agar sistem mengetahui sesi kerja ini ditujukan untuk tugas yang mana.
Mengapa data tugas saya tidak muncul setelah memasukkan API Key?
Pastikan koneksi internet Anda aktif dan API Key yang Anda masukkan sudah benar (diawali dengan iq_live_ atau iq_test_). Anda juga dapat memuat ulang daftar secara manual dengan mengklik tombol 🔄 (Refresh Data) di sebelah bar pencarian.
Dikembangkan dengan penuh dedikasi untuk produktivitas freelancer dan developer.
