โ† Back

Volume Spike System Overhaul โ€” Boolean ke Multi-State Detection

spike visualization volume watchlist

errors

  • Kolom volume_spike BOOLEAN hanya memberi nilai true/false โ€” user tidak tahu apakah spike itu akumulasi (harga naik) atau distribusi (harga turun)
  • Emoji ๐Ÿ”ฅ ditampilkan untuk SEMUA spike tanpa konteks โ€” misleading, bisa disalahartikan sebagai signal positif padahal itu bisa jadi distribusi (bearish)
  • Watchlist tidak punya sorting โ€” user tidak bisa mengurutkan berdasarkan volume spike atau kolom lain untuk eksplorasi
  • Tidak ada service dedicated untuk spike detection โ€” numpang di service fetcher/analysis yang jadwalnya tidak cocok
  • Migrasi kolom BOOLEAN ke VARCHAR gagal di PostgreSQL tanpa USING clause: ERROR: column "volume_spike" cannot be cast automatically to type character varying(20)

context

Volume spike detection ditambahkan sebagai fitur eksperimental beberapa minggu sebelumnya. Waktu itu cuma boolean โ€” ada spike atau tidak. Setelah live beberapa hari, user feedback menyebutkan bahwa mereka butuh tahu arah spike: apakah harga naik (akumulasi) atau turun (distribusi). Juga butuh informasi multiplier (berapa kali lipat volume normal). Watchlist menampilkan spike sebagai emoji ๐Ÿ”ฅ yang ambigu.

problem

Boolean volume_spike tidak cukup informatif untuk decision-making. Trader perlu tahu apakah spike disertai harga naik (buying pressure/akumulasi) atau harga turun (selling pressure/distribusi). Emoji ๐Ÿ”ฅ tidak membedakan keduanya. Selain itu, tidak ada cara untuk sorting watchlist berdasarkan spike atau kolom lain untuk mengidentifikasi saham yang paling aktif.

investigation

Dicek struktur tabel smart_stock_scores โ€” kolom volume_spike tipe BOOLEAN. Dicek realtime_updater.py โ€” logika deteksi spike hanya bandingkan volume terakhir vs rata-rata, tanpa analisis arah harga. Dicek watchlist.html โ€” spike ditampilkan dengan emoji ๐Ÿ”ฅ tanpa multiplier. Dicek feedback dari user di Telegram group โ€” beberapa komplain bahwa spike selling terlihat sama dengan spike buying. Dicek requirements untuk sorting โ€” tidak ada JavaScript handler untuk tabel sorting.

root-cause

Desain awal spike detection terlalu sederhana: hanya deteksi ada/tidaknya anomali volume tanpa analisis konteks harga. Kolom BOOLEAN tidak bisa menyimpan multi-state. Tidak ada mekanisme untuk menghitung multiplier (berapa kali lipat). Watchlist HTML table tidak punya event handler untuk sorting. Volume spike detection numpang di service yang jadwalnya tidak real-time.

solution

  • Ubah tipe kolom volume_spike dari BOOLEAN ke VARCHAR(20) โ€” nilai: buying (๐Ÿ”ฅ hijau), selling (๐Ÿ”ฅ merah), neutral (๐Ÿ”ฅ kuning), none (โ€”) sql -- PostgreSQL migration fix: ALTER TABLE smart_stock_scores ALTER COLUMN volume_spike TYPE VARCHAR(20) USING CASE WHEN volume_spike THEN 'neutral' ELSE 'none' END;
  • Deteksi: volume 5m terakhir โ‰ฅ 2.5ร— rata-rata 12 candle sebelumnya, arah ditentukan dari % perubahan harga vs rata-rata python # Spike detection logic di tiered_fetcher.py: volume_5m = df['Volume'].iloc[-1] avg_volume_12 = df['Volume'].iloc[-13:-1].mean() ratio = volume_5m / avg_volume_12 if avg_volume_12 > 0 else 0 if ratio >= 2.5: price_change = (df['Close'].iloc[-1] / df['Close'].iloc[-13:-1].mean() - 1) * 100 if price_change > 0.5: spike_type = 'buying' elif price_change < -0.5: spike_type = 'selling' else: spike_type = 'neutral'
  • Tambah kolom volume_spike_ratio untuk multiplier (misal: 60x, 14x, 10x)
  • Tambah service PM2 baru: radar-volume-spike dengan cron */10 * * * *, ThreadPoolExecutor 10 workers โ€” scan 60 top stocks
  • Watchlist visual: โ–ฒ 60x (buying, hijau), โ–ผ 14x (selling, merah), โ—† 10x (neutral, kuning), โ€” (none)
  • Ganti pulse animation dengan opacity glow (spike-glow CSS class)
  • Tambah JavaScript sorting: klik header kolom untuk sort asc/desc, otomatis sembunyikan sektor, tombol โ†ฉ Reset reload page

insight

Boolean hampir never enough untuk data yang punya dimensi arah โ€” selalu pertimbangkan minimal 3-state (positif/negatif/netral). Visualisasi harus mencerminkan sentimen, bukan cuma fakta. Emoji tanpa teks pendamping itu ambigu โ€” kombinasi simbol + teks + warna + multiplier jauh lebih informatif. Sorting adalah fitur esensial untuk data tabular โ€” jangan buat user manual scan 956 baris.

gotchas

  • Migrasi kolom dari BOOLEAN ke VARCHAR di PostgreSQL perlu ALTER TABLE dengan USING clause โ€” ALTER COLUMN volume_spike TYPE VARCHAR(20) USING CASE WHEN volume_spike THEN 'neutral' ELSE 'none' END
  • Query update spike harus atomic โ€” jangan update volume_spike dulu baru volume_spike_ratio, karena bisa inconsistent kalau service restart di tengah
  • Ambang batas 2.5ร— rata-rata 12 candle bisa terlalu sensitif untuk saham dengan volume sporadis โ€” perlu tuning periodik
  • ThreadPoolExecutor 10 workers untuk 60 stocks: pastikan tidak kena rate limit yfinance โ€” spread request dalam 1 menit
  • Spike detection hanya pakai 5m data โ€” kalau ohlc_5m kosong (baru listing/hari pertama), detection skip dengan fallback ke none
  • Sorting JavaScript harus handle tipe data campuran: string (โ–ฒ 60x) vs number โ€” parse multiplier dari string sebelum sort javascript // Sorting spike column โ€” parse multiplier dari string "โ–ฒ 60x" // Tidak bisa sort string langsung, harus extract angka: function parseSpike(val) { const match = val.match(/(\d+)x/); return match ? parseInt(match[1]) : 0; }
  • Cron */10 * * * * berarti spike di-update setiap 10 menit โ€” kalau ada spike dalam 10 menit, bisa missed. 5 menit lebih aman.

Last updated 31 Jul 2026 00:15

Comments