Panduan Pemakaian

Panduan Pemakaian

Setelah app dan worker berjalan, buka http://localhost:3000. Salinan UI berbahasa Indonesia.

Alur UI detail

Langkah klik demi klik di bawah merangkum kemampuan dari route & spesifikasi repo. Label tombol persis di layar bisa sedikit berbeda antar versi minor — sesuaikan dengan yang Anda lihat di UI.

Home (/)

Dashboard ringkas: ringkasan status / statistik aplikasi. Titik masuk setelah login-free start.

Settings (/settings) — lakukan dulu

Sebelum generate massal:

1. Tambah Text credential (provider OpenAI-compatible) dan tandai sebagai default bila diminta UI.
2. Tambah Image credential (Ideogram disarankan untuk skill flashcard bilingual bawaan).
3. Opsional: atur storage Lokal, S3, atau Connect Google Drive.
4. Opsional: refresh / kelola ModelPrice (estimasi biaya; sumber harga publik + harga Ideogram).

Tanpa credential IMAGE, generate gambar akan gagal dengan pesan seperti belum ada IMAGE credential.

Skills (/skills)

Prompt runtime disimpan di database (SkillTemplate), bukan di-hardcode di UI generate.

• Seed awal sudah mengisi template flashcard anak bilingual dan cover.
• Anda bisa buat, clone, edit, dan uji template prompt.
• Dokumen skill di folder .cursor/skills/… (jika ada di paket) adalah spesifikasi desain; yang dipakai runtime adalah template di DB + aturan layout di layanan image.

Generator (/generator)

1. Pilih kategori (seed contoh: peralatan sekolah, hewan, kendaraan, buah, bagian tubuh, warna — daftar tepat mengikuti seed DB).
2. Mulai job generate sejumlah kartu.
3. Sistem memakai LLM untuk kosakata JSON, menghindari normalizedSlug yang sudah ada (anti-duplikat), merender prompt template, memanggil provider image, menyimpan file + thumbnail, dan menulis baris Flashcard.
4. Pantau progress job (status QUEUED → RUNNING → DONE / FAILED).

Worker harus berjalan; jika tidak, job tertahan di QUEUED.

Jobs (/jobs)

Daftar job generate/pack beserta chart. Berguna untuk memantau antrian dan riwayat kegagalan.

Assets (/assets)

Galeri kartu yang sudah digenerate.

1. Telusuri / saring kartu.
2. Multi-select kartu yang ingin dikemas.
3. Kirim ke alur pack.

File lokal runtime ada di folder storage/ (tidak ikut git/ZIP) dan dilayani lewat /api/files?path=….

Packs (/packs)

1. Buat pack dari kartu terpilih.
2. Generate cover AI (memakai skill/template cover).
3. Unduh ZIP berisi cover, gambar kartu bernomor, dan manifest.json (isi persis mengikuti implementasi pack-product).

Job pack juga membutuhkan worker.

Usage (/usage)

Lihat pemakaian token in/out dan estimasi biaya per panggilan AI (baris AiUsage, harga dari ModelPrice). Berguna mengontrol biaya sebelum generate besar-besaran.

Tips praktis

• Uji prompt di Skills sebelum job kategori besar.
• Simpan kunci hanya di Settings / .env.local, bukan di chat atau screenshot.
• Setelah mengubah prisma/schema.prisma: pnpm db:generate && pnpm db:push.