DC4 vs DC4 Plus Harmony Scenario Compare & Manager

Aplikasi desktop GUI untuk membandingkan, menyelaraskan, dan mengelola judul skenario (@s◆...◆) antara D.C.4 Da Capo 4 (All-Age) dan D.C.4 Plus Harmony (18+) dengan sistem pencocokan referensi otomatis dan manajemen backup yang aman.

---

📸 Antarmuka Aplikasi (Screenshots)

🌙 Dark Theme (Mode Gelap)

☀️ Light Theme (Mode Terang)

---

🎯 Latar Belakang & Fungsi Utama

Pada perilisan D.C.4 Plus Harmony (18+), terdapat banyak penambahan rute baru, skenario tambahan, dan adegan dewasa (H-scenes) yang tidak ada pada versi All-Age. Hal ini menyebabkan sebagian judul skenario di dalam file JSON 18+ masih berbahasa Jepang atau memiliki perbedaan struktur judul.

Scenario Compare and Manager diciptakan untuk:

1. Membandingkan Judul Skenario: Menampilkan judul Jepang asli, terjemahan Indonesia saat ini, dan terjemahan referensi dari versi All-Age secara berdampingan.
2. Sinkronisasi Otomatis (Auto-Fill Missing): Otomatis mengisi judul skenario yang sama di versi 18+ menggunakan referensi terjemahan All-Age yang sudah selesai.
3. Penyuntingan Skenario Baru / H-Scene: Menyediakan editor terintegrasi untuk menerjemahkan judul-judul skenario eksklusif 18+ yang belum ada terjemahannya.
4. Pembersihan & Format Judul (Title Sanitizer): Menghilangkan sisa teks Jepang atau karakter pemisah slash yang tidak rapi.
5. Penyimpanan Aman dengan Auto-Backup: Otomatis membuat arsip cadangan bertanggal (timestamped backup) sebelum menyimpan perubahan ke file JSON 18+.

---

✨ Fitur-Fitur Unggulan

🔍 1. Tabel Komparasi Skenario Cerdas

• Kolom Lengkap: File, # (Indeks), Status, Japanese, Current Indonesian, Reference Indonesian.
• Sorotan Warna Status Visual:
  • 🟢 Translated (Hijau): Skenario sudah memiliki terjemahan Indonesia.
  • 🔴 Missing (Merah Muda): Skenario belum memiliki terjemahan Indonesia (masih kosong).
  • 🟡 Needs Review (Kuning): Teks terjemahan masih sama persis dengan teks Jepang asli.

⚡ 2. Eksekusi Cepat & Otomasi

• Auto-fill Missing: Mengisi seluruh judul skenario yang masih kosong di 18+ menggunakan terjemahan dari versi All-Age secara massal dalam hitungan detik.
• Use Reference: Mengisi baris terpilih dengan teks referensi All-Age dalam 1-klik.
• Clean Selected ID & Clean All IDs: Membersihkan sisa fragmen Jepang dan rantai garis miring (/) dari teks terjemahan.
• Next Missing / Prev Missing: Melompat langsung ke baris skenario yang belum diterjemahkan berikutnya.

🎨 3. Dual Theme (High-Contrast Dark & Light Mode)

• Mode Gelap (Dark Theme): Dilengkapi paleta warna deep slate modern dengan teks kontras tinggi yang jernih (crystal-clear readability) sehingga mata tidak cepat lelah saat sesi lokalisasi panjang.
• Mode Terang (Light Theme): Tampilan bersih dan tajam untuk penggunaan di ruangan terang.
• Warna Status Kontras Tinggi: Baris Translated (hijau mint terang), Missing (merah coral terang), dan Needs Review (kuning emas terang) tetap terbaca dengan kontras sempurna di kedua tema.

💾 4. Mode Penyimpanan Fleksibel

Pilih format judul yang diinginkan melalui menu Save Mode:

• jp_id: @s◆Judul Jepang / Judul Indonesia◆ (Bilingual Format)
• id_only: @s◆Judul Indonesia◆ (Indonesian-only Format)
• jp_only: @s◆Judul Jepang◆ (Japanese-only Format)

🛡️ 5. Sistem Backup Otomatis & Log

• Setiap kali tombol Save To 18+ JSON diklik, aplikasi secara otomatis membuat salinan cadangan lengkap ke folder backups/<timestamp>/.
• Riwayat penyimpanan tersimpan rapi dan dapat ditinjau langsung lewat tombol View Log.
• Tombol Export Missing Report untuk mengekspor daftar skenario yang belum diterjemahkan ke dalam file missing_scenario_titles.txt.

---

📊 Konfigurasi Folder (Directory Paths)

Input Folder	Keterangan	Contoh Lokasi
18+ Target JSON	Folder tujuan file JSON Plus Harmony (18+) yang akan diperbarui	...D.C.4 Da Capo 4 Plus Harmony\Advdata\indo json\18+ json
JP Base JSON (18+)	Folder file JSON raw bahasa Jepang versi 18+	...D.C.4 Da Capo 4 Plus Harmony\Advdata\json_raw
ID Reference JSON (all-age)	Folder file JSON terjemahan Indonesia versi All-Age (sebagai acuan)	...Da Capo 4\Advdata\indo json

---

🚀 Instalasi & Menjalankan

Aplikasi ini dibuat menggunakan Python Standar (Tkinter/TTk) sehingga tidak memerlukan instalasi modul pihak ketiga (Zero Dependency)!

1. Clone Repositori

git clone https://github.com/SakuraSymphonyReTranslation/DC4-Scenario-Compare-and-Manager.git
cd DC4-Scenario-Compare-and-Manager

2. Jalankan Aplikasi

• Cara 1 (Batch Script): Cukup klik ganda file run_scenario_compare_manager.bat
• Cara 2 (PowerShell / Command Prompt):

  python scenario_compare_manager.py

  atau:

  py scenario_compare_manager.py

---

📖 Panduan Penggunaan Singkat

1. Jalankan aplikasi, periksa apakah ketiga jalur folder sudah sesuai.
2. Klik Load Data untuk memuat seluruh skenario.
3. Klik Auto-fill Missing untuk langsung mengisi judul-judul yang sama dari versi All-Age.
4. Centang Missing only untuk menampilkan judul skenario yang belum diterjemahkan (biasanya skenario rute baru atau H-scene 18+).
5. Pilih baris, ketikkan judul bahasa Indonesia pada kotak Indonesian (Editable), lalu klik Apply Edit.
6. Setelah selesai, pilih Save Mode yang diinginkan (jp_id atau id_only), lalu klik Save To 18+ JSON.

---

🤝 Lisensi & Kontribusi

Proyek ini dirilis di bawah lisensi MIT License.
Didedikasikan untuk komunitas penerjemahan Visual Novel oleh Sakura Symphony Re:Translation.