Direktiva Studio — Buku Manual Pengguna (ID/EN)

Versi 2025-08-28

Direktiva Studio — Buku Manual Pengguna

Versi: 2025-08-28

1. Ringkasan

Direktiva Studio adalah tool web untuk membuat naskah Hook–Body–CTA beserta ide visual sinematik dan prompt T2I/I2V. Cocok untuk konten pendek, iklan, dan kampanye afiliasi. Aplikasi bersifat SPA, ringan, dan mendukung mode terang/gelap serta bahasa Indonesia/Inggris.

2. Persiapan

  1. Login: Masuk menggunakan akun Anda (bila diaktifkan oleh admin).
  2. Kunci API Gemini (opsional tetapi direkomendasikan): Buka Pengaturan → masukkan Gemini API Key.
    Kunci disimpan di Local Storage perangkat Anda dan digunakan saat memanggil endpoint /api milik Anda melalui HTTPS.
  3. Bahasa & Tema: Atur bahasa (ID/EN) dan mode (Terang/Gelap) dari header.

3. Alur Cepat (±2 menit)

  1. Buka tab Generator → isi Product Name & Product Description.
  2. Pilih Visual Strategy & Aspect Ratio.
  3. (Opsional) Gunakan Analyze Image untuk menghasilkan Visual DNA dari gambar referensi.
  4. Klik Generate → tunggu hasil skrip & ide visual tiap scene.
  5. Gunakan Additional Assets untuk judul, thumbnail, dan pendukung lain.
  6. Copy Full Script atau Download All (PDF/XLSX/DOCX).

4. Fitur Utama

4.1 Generator Naskah

  • Struktur Hook–Body–CTA dengan opsi gaya (tone persona, target audiens).
  • Rasio: 9:16, 1:1, 16:9; serta strategi visual (mis. luxury, tech, lifestyle).
  • Hasil menyertakan teks scene + ide visual sinematik + prompt T2I/I2V.

4.2 Analyze Image (Visual DNA)

  • Unggah gambar referensi untuk menganalisis lighting, color palette, lens/angle, ambience—sebagai panduan gaya visual.
  • Hasil analisis dapat langsung memengaruhi gaya prompt yang dihasilkan.

4.3 Additional Assets

  • Judul video, ide thumbnail, deskripsi singkat, dan elemen pendukung lainnya.

4.4 Persona & Preset

  • Kelola Persona (tone/target) dan preset strategi—mempercepat konsistensi gaya konten.

4.5 History

  • Simpan dan kelola hasil yang pernah dibuat. Anda dapat membuka kembali, menyalin, atau mengunduh ulang.

4.6 Ekspor

  • Copy Full Script ke clipboard.
  • Download All: ekspor ke PDF, XLSX, DOCX (menggunakan Web Worker agar tetap responsif).

4.7 Pengaturan

  • Masukkan/kelola Gemini API Key.
  • Atur bahasa (ID/EN) dan tema (Terang/Gelap).

4.8 UI Hasil: Kartu & Overlay

  • Hasil ditampilkan sebagai kartu ringkas di panel kanan.
  • Klik kartu untuk membuka Overlay berisi Hook/Body/CTA, A/B variants, ide visual, dan aset.
  • Tersedia tombol Copy untuk Hook, Body, CTA, serta prompt T2I/I2V.
  • Badge Score dan Best of All tampil proporsional di mode terang/gelap.

4.9 Rank All & Skoring

  • Jika Anda generate ≥ 2 skrip, toolbar Rank All muncul.
  • Skor 60–98 dengan variasi berbasis konten + content hashing untuk tie-break.
  • Duplikasi dideteksi dan sistem melakukan top-up untuk keragaman.

4.10 Additional Assets

  • Generate judul/caption, hashtag per platform (mis. TikTok, Shopee), dan ide thumbnail.
  • Hasil aset tersimpan pada skrip dan akan muncul kembali saat overlay dibuka ulang.

4.11 VO Preview (Gemini/API)

  • Preview suara dengan cache agar tidak regenerate berulang untuk konten yang sama.
  • Tombol Stop menghentikan audio HTML5 dan speechSynthesis (fallback).
  • Dukungan unduh VO pack dan salin SSML.

4.12 Akun & Keamanan

  • Halaman Account: profil (nama, username, bio) dan keamanan.
  • Update Email/Password melalui tautan konfirmasi email (bukan ganti langsung).
  • Forgot Password: kirim tautan reset dari halaman login.
  • Single Session: akun hanya aktif di satu perangkat; sesi lain akan keluar otomatis.

5. Keamanan & Privasi

  • API Key Lokal: disimpan di Local Storage dan hanya dipakai lewat HTTPS ke endpoint /api Anda.
  • Email & Password: perubahan dilakukan via email confirmation link. Password reset juga via tautan email.
  • Single Session Guard: aplikasi menyimpan last_session_id pada profil; jika berbeda, pengguna akan otomatis logout.
  • Supabase RLS (rekomendasi): batasi baca/tulis tabel profiles hanya untuk auth.uid() terkait.
  • Konten yang Anda buat tetap milik Anda. Hormati hak cipta materi visual/audio pihak ketiga.

6. PWA & Offline

  • Direktiva Studio mendukung Service Worker untuk cache aset dasar.
  • Anda dapat menambahkan aplikasi ke Home Screen (Add to Home Screen) pada perangkat yang mendukung.

7. Tips & Praktik Terbaik

  • Mulai dari ide besar, lalu susun scene secara ringkas (1-2 kalimat per scene) agar fokus.
  • Gunakan Analyze Image untuk konsistensi gaya visual (lighting, lens, mood).
  • Uji beberapa variasi prompt untuk menemukan performa terbaik.

8. Troubleshooting

  • Toolbar Rank All tidak muncul: pastikan generate ≥ 2 skrip. Toolbar diposisikan di luar panel hasil; muat ulang bila perlu.
  • Copy prompt menampilkan <char-desc>: tombol copy overlay otomatis menghapus tag tersebut dari T2I/I2V.
  • Analyze Image gagal/JSON error: cek koneksi, kunci API, dan server /api/analyzeImage. Aplikasi menangani respons non‑JSON secara aman.
  • Reset password kembali ke login: buka tautan di browser yang sama; aplikasi akan mendeteksi ?code= dan menampilkan dialog setel password baru.
  • Email berubah di auth.users tapi tidak di profiles: login ulang/refresh; aplikasi menyinkronkan email & email_pending ke tabel profiles.
  • Hasil skrip identik: sistem melakukan deduplikasi dan top‑up. Coba ubah persona/target/platform untuk variasi lebih tinggi.
  • VO Stop tidak bekerja: perbarui aplikasi; tombol Stop kini menghentikan audio dan speechSynthesis.
  • Tooltip export tidak hilang: saat menu terbuka, tooltip otomatis disembunyikan.
  • Mode Carousel kosong: buka kartu → overlay; slide dirender dengan Swiper dan muncul setelah init.
  • Supabase “Failed to fetch”: saat offline, aplikasi beralih ke mode offline dan menunda sinkronisasi.

9. FAQ

Apakah saya harus punya API key?

Tidak wajib, namun sangat disarankan untuk hasil paling stabil dan cepat.

Apakah data saya aman?

Ya. Kunci API tersimpan lokal di perangkat Anda. Komunikasi berlangsung via HTTPS.

Bisakah saya mengedit hasil?

Tentu. Gunakan fitur History untuk membuka kembali hasil, lalu salin/unduh dan ubah sesuai kebutuhan.

10. Kontak & Dukungan

Jika Anda mengalami kendala atau ingin memberikan masukan, hubungi tim Anda/administrator proyek.

Direktiva Studio — User Manual

Version: 2025-08-28

1. Overview

Direktiva Studio is a web tool for generating Hook–Body–CTA scripts with cinematic visual ideas and T2I/I2V prompts. Great for short-form content, ads, and affiliate campaigns. It is a lightweight SPA with Light/Dark themes and English/Indonesian support.

2. Setup

  1. Login: Sign in with your account (if enabled by your admin).
  2. Gemini API Key (optional but recommended): Open Settings → paste your Gemini API Key.
    The key is stored in your device’s Local Storage and used when calling your /api endpoints over HTTPS.
  3. Language & Theme: Choose ID/EN and Light/Dark from the header.

3. Quick Start (~2 minutes)

  1. Open the Generator tab → fill in Product Name & Product Description.
  2. Select Visual Strategy & Aspect Ratio.
  3. (Optional) Use Analyze Image to extract Visual DNA from a reference image.
  4. Click Generate → get script & per-scene visual ideas.
  5. Use Additional Assets to create titles, thumbnail ideas, and more.
  6. Copy Full Script or Download All (PDF/XLSX/DOCX).

4. Key Features

4.1 Script Generator

  • Hook–Body–CTA structure with persona tone and audience targeting.
  • Aspect ratios: 9:16, 1:1, 16:9; visual strategies (e.g., luxury, tech, lifestyle).
  • Outputs text per scene + cinematic visual ideas + T2I/I2V prompts.

4.2 Analyze Image (Visual DNA)

  • Upload a reference image to analyze lighting, color palette, lens/angle, ambience.
  • Analysis can be applied to guide the generated prompts.

4.3 Additional Assets

  • Titles, thumbnail ideas, short descriptions, and other supporting elements.

4.4 Personas & Presets

  • Manage Personas (tone/audience) and strategy presets for consistent output.

4.5 History

  • Save, reopen, copy, and re-download your previous results.

4.6 Export

  • Copy Full Script to clipboard.
  • Download All: export to PDF, XLSX, DOCX (via Web Worker for responsiveness).

4.7 Settings

  • Manage your Gemini API Key.
  • Switch language (ID/EN) and theme (Light/Dark).

4.8 Results UI: Cards & Overlay

  • Results appear as compact cards on the right panel.
  • Click a card to open the Overlay with Hook/Body/CTA, A/B variants, visual ideas, and assets.
  • Copy buttons exist for Hook, Body, CTA, and T2I/I2V prompts.
  • Score and Best of All badges are sized for both light/dark modes.

4.9 Rank All & Scoring

  • When generating ≥ 2 scripts, the Rank All toolbar appears.
  • Scores range 60–98 with content‑based variation and hashing for tie‑breaks.
  • Duplicates are detected and a top‑up pass improves diversity.

4.10 Additional Assets

  • Generate titles/captions, platform‑specific hashtags (e.g., TikTok, Shopee), and thumbnail text.
  • Assets are persisted on the script and reappear when reopening the overlay.

4.11 VO Preview (Gemini/API)

  • Audio is cached so repeated previews don’t re‑generate.
  • Stop halts both HTML5 audio and the speechSynthesis fallback.
  • Download VO packs and copy SSML are supported.

4.12 Account & Security

  • Account page: profile (full name, username, bio) and security.
  • Update Email/Password via confirmation links (not immediate changes).
  • Forgot Password: send a reset link from the login page.
  • Single Session: only one active device; others are signed out.

5. Security & Privacy

  • Local API Key: stored in Local Storage, used only via HTTPS against your /api endpoints.
  • Email & Password: changes occur through email confirmation links. Password resets are link‑based.
  • Single Session Guard: the app stores last_session_id; if it changes, the user is signed out.
  • Supabase RLS (recommended): restrict profiles read/write to the matching auth.uid().
  • You own your generated content. Respect third‑party visual/audio copyrights.

6. PWA & Offline

  • Direktiva Studio uses a Service Worker to cache core assets.
  • You can add it to your Home Screen on supported devices.

7. Tips & Best Practices

  • Start from the big idea, keep scenes short (1–2 lines each) for clarity.
  • Use Analyze Image for consistent visual style (lighting, lens, mood).
  • Try a few prompt variations to find the best performing output.

8. Troubleshooting

  • Rank All toolbar not visible: generate ≥ 2 scripts. The toolbar is placed outside the results panel; reload if needed.
  • Copied prompt shows <char-desc>: overlay copy buttons strip those tags from T2I/I2V prompts.
  • Analyze Image fails/JSON error: check connection, API key, and /api/analyzeImage. The app safely handles non‑JSON replies.
  • Password reset returns to login: open the link in the same browser; the app detects ?code= and shows the set‑new‑password dialog.
  • Email changed in auth.users but not in profiles: re‑login/refresh; the app syncs email & email_pending into profiles.
  • Identical scripts: de‑duplication and a diversity top‑up run are applied. Try different persona/target/platform.
  • VO Stop doesn’t work: update the app; Stop now halts audio and speechSynthesis.
  • Export tooltip sticks: opening the export menu hides the tooltip.
  • Carousel mode empty: open the card → overlay; slides render via Swiper after init.
  • Supabase “Failed to fetch”: when offline, the app switches to offline mode and delays sync.

9. FAQ

Do I need an API key?

Not mandatory, but recommended for best stability and speed.

Is my data safe?

Yes. Your API key is stored locally on your device. All communication is via HTTPS.

Can I edit the outputs?

Absolutely. Use History to reopen results, then copy/download and edit as you like.

10. Contact & Support

If you experience issues or want to share feedback, contact your team/project administrator.