📦 GitPaham Visual Guide
⚡ Panduan Praktis Khusus Rekan Kerja Awam & Data Engineers

Pahami Git Tanpa Pusing:
Analogi Meja Kerja & Kardus Paket

Tidak perlu hafalan ratusan kode rumit. Cukup bayangkan pekerjaanmu seperti merapikan berkas di meja, memasukkannya ke kardus, melakbannya, lalu mengirimkannya ke ekspedisi.

Simulator Interaktif 4 Zona Git

Klik tombol perintah di kanan untuk melihat pergerakan file secara langsung.

1. Meja Kerja Working Dir
🪑 File yang sedang kamu ketik/edit di laptop
2. Kardus Paket Staging Area
📦 File yang sudah dipilih via git add
3. Gudang Laptop Local Commits
🏷️ Paket yang sudah dilakban & bersegel tanggal
4. Server Pusat GitHub Cloud
☁️ Gudang pusat yang bisa dilihat seluruh tim
$ Simulator siap. Klik 'Tulis Script Baru' untuk mulai.
💡 Apa yang terjadi sekarang?
Pekerjaan Git selalu berputar di 4 zona ini. Saat kamu mengetik file di VS Code atau DBeaver, file baru ada di zona 1 (Meja Kerja). Belum aman sebelum masuk zona 3 (Commit).

Kamus Analogi Visual: Perintah Dasar

Bayangkan perintah terminal sebagai aktivitas fisik sehari-hari di kantor.

🔍

git status

Pengecekan Meja
Analogi: Cek Kerapian Meja Kerja

Melihat kondisi berkas di meja: mana kertas yang baru ditulis (merah / untracked), mana yang sudah masuk kardus paket (hijau / staged), dan mana yang belum beres.

📦

git add

Masukkan ke Kardus
Analogi: Memilih File untuk Dikirim

Di meja kerjamu mungkin ada 5 file, tapi kamu hanya mau kirim 2 file yang sudah selesai. Perintah ini memasukkan file pilihanmu ke dalam kotak kardus terbuka (Staging Area).

🏷️

git commit -m

Lakban Kardus & Beri Label
Analogi: Menyegel Save-Point Permanen

Kardus dilakban rapat dan ditempeli stiker catatan jelas, misalnya: "Perbaikan query SQL laporan bulanan". Sekarang berkas ini resmi tersimpan aman di harddisk laptopmu.

🚚

git push

Kirim ke Ekspedisi
Analogi: Kirim Paket ke Gudang Pusat

Kardus yang sudah kamu lakban di laptopmu dikirim lewat kurir internet menuju gudang cloud GitHub. Setelah sampai, teman satu timmu bisa melihat dan mengambil hasilnya.

📥

git pull

Ambil Paket Terbaru
Analogi: Ambil Kiriman Rekan Tim

Sebelum mulai mengetik di pagi hari, ambil dulu kiriman berkas terbaru dari rekan tim di GitHub ke mejamu, agar kamu tidak mengerjakan hal yang sudah dikerjakan orang lain.

🌿

git checkout -b

Meja Kerja Cadangan
Analogi: Fotokopi Dokumen ke Meja Sebelah

Jangan pernah langsung coret-coret dokumen asli utama (main branch). Buat cabang fotokopi, utak-atik di sana sepuasnya. Jika gagal, tinggal buang fotokopinya tanpa merusak file utama.

Perhatian Khusus untuk Rekan Data Engineers 🛠️

Sebagai Data Engineer, ada 3 jebakan umum yang sering bikin sistem tim berantakan.

🚫 1. Jangan Upload File Data Jumbo ke Git!

File seperti dataset.csv (500MB) atau data.parquet (2GB) Haram Masuk Git! Git menyimpan rekaman riwayat setiap byte. Kalau file besar ikut ter-commit, repositori tim akan bengkak bergiga-giga dan gagal push.

# Masukkan aturan ini di file .gitignore :
*.csv
*.parquet
*.xlsx
data/
raw_data/

⚠️ 2. Tragedi Jupyter Notebook (.ipynb)

File notebook menyimpan gambar grafik dan riwayat run sel dalam kode teks rahasia yang panjang. Kalau dua orang mengedit notebook yang sama, Git akan bingung dan terjadi merge conflict ribuan baris.

# Tips Praktis Sebelum git add file .ipynb:
1. Di menu Jupyter: Pilih Cell -> All Output -> Clear.
2. Simpan file notebook yang sudah bersih.
3. Baru lakukan git add file.ipynb.

📝 3. Hindari Pesan Commit Basi ("update", "fix")

Jika seminggu lagi ada error pada pipeline data, pesan commit yang baik memudahkan tim menemukan letak masalah tanpa harus membuka satu per satu file lama.

# Buruk: git commit -m "update script"
# Baik: git commit -m "feat(etl): tambah filter tanggal transaksi invalid"

🤝 4. Pull Request (PR) adalah Temanmu

Jangan takut kode buatanmu salah. Di GitHub, kamu cukup push branch fiturnu lalu buat Pull Request. Anggap PR seperti menaruh berkas di meja senior untuk minta dicek paraf sebelum dimasukkan ke brankas utama.

🕷️ 5. Khusus Script Crawling & Scraping

Saat membuat script scraper/crawler di VS Code atau Antigravity, seringkali script otomatis men-download ratusan file HTML atau JSON mentah dan menyimpan cookie login. Jangan sampai file hasil unduhan dan session cookies ini ikut terdorong ke GitHub!

# Selalu masukkan folder output crawl ke .gitignore :
output/
scraped_data/
downloads/
*.html_dump
cookies.json
.env
.venv/
__pycache__/

🖱️ 6. Takut Terminal? Pakai Menu Visual di VS Code & Antigravity!

Kamu tidak harus selalu mengetik perintah hitam-putih di terminal. Di VS Code maupun Antigravity, ada panel Source Control (tekan Ctrl + Shift + G):

1. Klik ikon tanda tambah (+) pada file = sama dengan git add
2. Ketik catatan di kotak pesan lalu klik centang (Commit) = sama dengan git commit
3. Klik tombol 'Sync Changes' / 'Push' = sama dengan git push

5 Langkah Kerja Harian Standar (Sontek Ini!)

Ritual harian sederhana saat mulai ngoding tugas baru sampai selesai.

1

Pagi Hari

git pull origin main

Ambil pembaruan terbaru dari teman satu tim agar mejamu tidak ketinggalan.

2

Bikin Meja Baru

git checkout -b feat/task

Buat cabang baru khusus tugasmu hari ini, jangan ngoding di cabang main.

3

Pilih File

git add pipeline.py

Masukkan berkas yang sudah selesai kamu ketik ke dalam kotak kardus paket.

4

Segel Save Point

git commit -m "..."

Lakban kardus dan beri catatan singkat apa fungsi kode yang baru dibuat.

5

Kirim ke Tim

git push origin feat/task

Kirim ke GitHub, lalu klik tombol 'Create Pull Request' di web browser.