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
Comments