← Kembali

Template Refactoring Dashboard — Base.html Unifikasi

dashboard html refactor template
## errors - Halaman performance dan entry analysis memiliki duplicate `.wrapper` div yang bikin layout broken — margin dobel, spacing kacau - Ada orphan `` tanpa pembuka di beberapa halaman — HTML invalid, browser render mode quirks - Menu Users & Security muncul untuk semua user termasuk yang bukan admin — privilege escalation secara visual - Navigasi (navbar/topbar) muncul di halaman login dan error pages yang seharusnya tidak perlu - Watchlist tidak extend `base.html` — perubahan layout harus di-edit di 2 tempat - TemplateSyntaxError saat render watchlist: ``` [2026-06-21 23:51:53,589] ERROR django.request Internal Server Error: / Traceback (most recent call last): ... django.template.exceptions.TemplateSyntaxError: Template: /var/mrcuan-apps/web/templates/dashboard/watchlist.html, Invalid block tag on line 505: 'endblock', expected 'elif', 'else' or 'endif'. Did you forget to register or load this tag? ``` ## context Dashboard web sudah berkembang dari prototype ke production dengan ~10 template files. Awalnya setiap halaman dibuat standalone cepat tanpa base template. Admin dan user management features ditambahkan kemudian. Watchlist adalah halaman yang paling stabil dan paling sering diakses — styling-nya dijadikan referensi untuk base template. ## problem Tidak ada satu source of truth untuk layout dashboard. Setiap halaman punya struktur HTML sendiri-sendiri, CSS sendiri-sendiri, dan navigasi sendiri-sendiri. Ini menyebabkan inkonsistensi visual, broken HTML karena copy-paste yang tidak rapi, dan maintenance overhead yang besar — setiap perubahan layout harus diulang di 10+ file. ## investigation Dibuka satu per satu template HTML di browser — dicek perbedaan rendering. Dibandingkan struktur ` ` antar halaman untuk mencari ketidakseimbangan. Dicek juga file `watchlist.html` yang sudah punya layout pill-style navbar yang stabil — dijadikan acuan. Untuk admin links, dicek apakah ada conditional `{% if is_admin %}` di template — ternyata tidak ada, langsung render raw. ```python # Template error karena {% if %} blok tidak balance # watchlist.html line 505: # {% if something %} # ... # {% endif %} <-- ini ditulis {% endblock %} salah ``` ## root-cause Tidak adanya `base.html` yang mewariskan struktur layout ke child templates. Developer sebelumnya (mungkin karena buru-buru) membuat setiap halaman sebagai self-contained HTML. Watchlist dibuat dengan struktur yang baik tapi tidak di-extract ke base template. Admin menu tidak dilindungi dengan conditional block karena tidak ada mekanisme role-checking di template layer. ```python # Penyebab: mismatch tag {% if %} ditutup dengan {% endblock %} # Seharusnya {% endif %}. Ini typo pas refactor dari base template ke child template. ``` ## solution - Buat `base.html` dengan topbar + navbar pill style yang diambil dari watchlist — layout utama untuk semua halaman - Semua halaman dashboard dialihkan jadi child template yang `{% extends "base.html" %}` - Navbar conditional: bungkus menu sensitif dengan `{% if is_admin %}` - Hapus duplicate `.wrapper` dan orphan `` di performance/entry_analysis — div count balance - Standardisasi header gradient: `background: linear-gradient(to right, #c7d7ff, #818cf8)` di semua halaman - Watchlist pakai `topbar_right` block, `extra_css`, `extra_js` — tidak perlu override base layout - Hapus `index.html` (template lama yang sudah tidak dipakai) - Auth/error pages (login, verify, upgrade, 403) tetap extend `base.html` tapi dengan navbar hidden via conditional `user.id` ## insight Base template adalah investasi yang harus dilakukan SEBELUM halaman bertambah banyak, bukan setelahnya. Pill-style navbar dari watchlist terbukti stabil dan scalable — lebih baik extract ke base template lebih awal. Conditional rendering untuk role-based menu harus ada dari awal, jangan nanti-nanti. Gradient header yang konsisten memberi identitas visual yang kuat tanpa Tailwind. ## gotchas - `{% extends %}` harus jadi baris PERTAMA di child template — kalau ada whitespace sebelum tag, Django bakal silent fail - Block `extra_css` harus dipanggil di dalam ``, bukan di bottom — kalau di bottom, FOUC (Flash of Unstyled Content) - Conditional navbar di auth pages: `user.id` bisa throw error kalau user object None — perlu `user.is_authenticated` check dulu - Waktu hapus `index.html`, pastikan tidak ada view yang masih `render(request, 'index.html')` — 404 silent sampai dicek logs - Gradient CSS di inline style tidak bisa dipindah ke CSS file karena nilai gradient spesifik per halaman — lebih baik pakai CSS variable

Terakhir diperbarui 31 Jul 2026 00:15

Comments