Patch Upgrade v4

Perhatian

Lakukan backup database dan folder aplikasi sebelum setiap upgrade patch.

Perhatian

Yii2 menuju End-of-Life akhir 2027. Migrasi ke Yii3 memerlukan penulisan ulang kode. ILDIS v5 sedang dirancang dengan stack modern — pelajari roadmap di halaman Upgrade v4 ke v5.

Instruksi Umum Upgrade Patch

1. Backup

   mysqldump -u root -p nama_database > backup_$(date +%Y%m%d).sql

2. Pull kode terbaru

   git fetch origin
   git checkout tags/v4.x.x

   Atau jika menggunakan branch:

   git pull origin main

3. Update dependensi

   composer install --no-dev

4. Jalankan migrasi (jika ada)

   php yii migrate/up --interactive=0

5. Clear cache

   php yii cache/flush-all

6. Verifikasi

   • Buka frontend dan backend
   • Pastikan fitur utama berjalan normal

---

Riwayat Rilis v4

Tabel berikut menyediakan daftar rilis patch ILDIS v4 beserta catatan penting.

Versi	Tanggal Rilis	Changelog	Catatan
v4.6.0	28 Mei 2026	Lihat Release	Footer CMS dinamis, redesign visitor counter, font Inter
v4.5.0	28 Mei 2026	Lihat Release	Dropdown tahun pada form dokumen, fix double menu dan password reset
v4.4.1	28 Mei 2026	Lihat Release	Perbaikan minor
v4.4.0	28 Mei 2026	Lihat Release	Dokumen Pembentukan PUU, user/create non-interaktif, Traefik/SSL di install.sh, nginx logging
v4.3.4	26 Mei 2026	Lihat Release	Logging login failure, docs: Traefik/SSL/superadmin spec
v4.3.3	26 Mei 2026	Lihat Release	Fix CSP pada halaman login
v4.3.2	26 Mei 2026	Lihat Release	Fix deteksi /opt writable pada install.sh
v4.3.1	26 Mei 2026	Lihat Release	Fallback direktori jika /opt/ildis tidak writable
v4.3.0	26 Mei 2026	Lihat Release	reCAPTCHA opsional di backend, fix Docker+migrasi
v4.2.1	26 Mei 2026	Lihat Release	Perbaikan minor
v4.2.0	25 Mei 2026	Lihat Release	⚠ Breaking: PHP ≥8.3, install.sh, visitor counter, Symfony Mailer
v4.1.4	13 Mei 2026	Lihat Release	Perbaikan minor
v4.1.3	13 Mei 2026	Lihat Release	Fix filter berita yang dipublikasikan
v4.1.2	12 Mei 2026	Lihat Release	Perbaikan minor
v4.1.0	—	—	Penambahan dukungan Docker

ℹ️ Versi yang tidak memiliki link berarti rilis tersebut tidak dipublikasikan dengan GitHub Release page, atau catatan rilis tersebar dalam repository utama.

---

Catatan Breaking Change

v4.2.0

• PHP Requirement: Minimum PHP 8.3. Jika server Anda masih menggunakan PHP 7.4, upgrade PHP terlebih dahulu sebelum update ILDIS ke v4.2.0.
• Mailer: SwiftMailer digantikan dengan yii2-symfonymailer. Pastikan variabel MAILER_DSN telah dikonfigurasi di file .env.

---

Panduan Upgrade v4.1 ke v4.2

Upgrade ke v4.2.0 memperkenalkan fitur Visitor Counter yang membutuhkan tabel baru di database dan perubahan requirement PHP.

Apa yang Baru — Visitor Counter

Fitur ini menyediakan:

1. visitor_log — menyimpan data kunjungan per user
2. visitor_stats — menyimpan agregasi harian/mingguan/bulanan
3. Menu “Statistik Pengunjung” di backend admin panel

Apa yang Baru — install.sh (One-Click Install)

v4.2.0 memperkenalkan install.sh yang mendukung:

• Instalasi Docker/Podman otomatis
• Generasi .env dan docker-compose.yml
• Skrip update.sh untuk update non-teknis

Pilihan Upgrade

Opsi A: Via Yii Migrate

Untuk instalasi baru atau yang sudah pakai migrasi.

php yii migrate/up --interactive=0

Atau spesifik ke path migrasi:

php yii migrate/up --interactive=0 --migrationPath=@console/migrations

Opsi B: Manual SQL

Untuk database lama dari ildis_v4.sql.

Perhatian

Jika database Anda dibuat dari dump SQL lama, perintah php yii migrate bisa gagal karena migrasi baseline (pembuatan tabel yang sudah ada) belum tercatat di tabel migration. Gunakan SQL manual ini:

1. Tabel visitor_log:

CREATE TABLE IF NOT EXISTS `visitor_log` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `visitor_fingerprint` VARCHAR(64) NOT NULL,
  `visitor_cookie_id` VARCHAR(64) NOT NULL,
  `document_id` VARCHAR(100) DEFAULT NULL,
  `page_url` VARCHAR(500) NOT NULL,
  `visit_date` DATE NOT NULL,
  `visit_time` DATETIME NOT NULL,
  `is_unique` TINYINT(1) NOT NULL DEFAULT 0,
  `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_visitor_log_fingerprint_date` (`visitor_fingerprint`, `visit_date`),
  KEY `idx_visitor_log_document_date` (`document_id`, `visit_date`),
  KEY `idx_visitor_log_visit_time` (`visit_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

2. Tabel visitor_stats:

CREATE TABLE IF NOT EXISTS `visitor_stats` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `stat_type` ENUM('daily','weekly','monthly','yearly','all_time') NOT NULL,
  `stat_date` DATE NOT NULL,
  `document_id` VARCHAR(100) DEFAULT NULL,
  `total_visits` INT(10) UNSIGNED NOT NULL DEFAULT 0,
  `unique_visits` INT(10) UNSIGNED NOT NULL DEFAULT 0,
  `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_visitor_stats_type_date_doc` (`stat_type`, `stat_date`, `document_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

3. Menu backend:

INSERT INTO `menu` (`name`, `route`, `data`, `order`)
VALUES ('Statistik Pengunjung', '/visitor-report/index', '{"icon": "chart-bar"}', 999);

Verifikasi

Setelah migrasi berhasil:

1. Cek tabel sudah ada:

   mysql -u root -p -e "SHOW TABLES LIKE 'visitor%';" nama_database

2. Cek menu backend — login ke admin panel, seharusnya ada menu “Statistik Pengunjung” di sidebar.

3. Cek visitor tracking aktif — akses frontend, lalu cek browser cookie __visitor_id. Cookie ini di-set otomatis oleh component VisitorCounter.

4. Opsional: jalankan agregasi manual (untuk mengisi statistik awal):

   php yii visitor/aggregate --days=1

Setup Cron (Production)

Untuk agregasi harian otomatis, tambahkan ke crontab:

# Agregasi statistik pengunjung setiap jam 3 pagi
0 3 * * * cd /path/to/project && php yii visitor/aggregate >> /var/log/visitor_aggregate.log 2>&1

---

Panduan Upgrade v4.3 ke v4.4

v4.4.0 memperkenalkan fitur Dokumen Pembentukan PUU dan peningkatan signifikan pada install.sh.

Apa yang Baru — Dokumen Pembentukan PUU

Fitur ini menyediakan:

1. Manajemen Dokumen Pembentukan PUU di backend dengan CRUD ter-scoped
2. URL berbasis slug untuk halaman publik Dokumen Pembentukan PUU
3. Menu sidebar “Dokumen Pembentukan PUU” di bawah “Dokumen Hukum”
4. RBAC migration untuk akses controller dan menu entry

Apa yang Baru — install.sh

Peningkatan signifikan pada skrip instalasi:

1. Integrasi Traefik reverse proxy dan SSL otomatis
2. Pembuatan superadmin saat instalasi
3. Konfigurasi nginx dengan access log dan error log
4. user/create CLI non-interaktif (mendukung flag --interactive=0)

Pilihan Upgrade

Opsi A: Via Yii Migrate

php yii migrate/up --interactive=0

Migrasi ini akan menambahkan:

• Tabel dan RBAC untuk Dokumen Pembentukan PUU
• Menu sidebar untuk Dokumen Pembentukan PUU

Opsi B: Docker/Podman

Jika menggunakan instalasi Docker/Podman:

./install.sh --update

Skrip akan otomatis menjalankan migrasi setelah pull image baru.

Verifikasi

Setelah upgrade:

1. Cek menu Dokumen Pembentukan PUU — login ke backend, buka sidebar, seharusnya ada menu “Dokumen Pembentukan PUU” di bawah “Dokumen Hukum”.

2. Cek CRUD — buat, baca, update, hapus entri Dokumen Pembentukan PUU untuk memastikan RBAC berjalan.

3. Cek frontend — akses halaman publik Dokumen Pembentukan PUU via URL berbasis slug.

---

Panduan Upgrade v4.5 ke v4.6

v4.6.0 memperkenalkan Footer CMS dan redesign Visitor Counter.

Apa yang Baru — Footer CMS

Fitur ini menyediakan:

1. footer_section dan footer_link — tabel untuk mengelola section dan link footer secara dinamis dari backend
2. Menu “Footer Section” dan “Footer Link” di sidebar admin
3. Query caching dengan invalidation untuk footer sections
4. Seed data bawaan untuk footer section dan footer link

Apa yang Baru — Visitor Counter Redesign

• Tampilan visitor counter di frontend di-redesign
• Font diubah ke Inter (menggantikan font sebelumnya)

Pilihan Upgrade

Opsi A: Via Yii Migrate

php yii migrate/up --interactive=0

Migrasi ini akan menambahkan:

• Tabel footer_section dan footer_link dengan seed data
• Menu backend untuk manajemen footer

Opsi B: Docker/Podman

./install.sh --update

Verifikasi

Setelah upgrade:

1. Cek menu Footer — login ke backend, seharusnya ada menu “Footer Section” dan “Footer Link” di sidebar.

2. Cek frontend footer — buka frontend, seharusnya footer menampilkan section dan link dinamis (bukan hard-coded).

3. Cek visitor counter — buka frontend, seharusnya visitor counter tampil dengan desain baru dan font Inter.

---

Ringkasan

• Docker/Podman → ./install.sh --update akan otomatis backup database, pull image baru, dan jalankan migrasi.
• Manual → jalankan php yii migrate/up --interactive=0, atau gunakan SQL manual jika migrasi baseline bermasalah.
• Selalu cek tabel riwayat rilis di atas untuk mengetahui apakah versi tertentu membutuhkan migrasi database atau langkah tambahan.