# Role Content Author

Pengembang Soal TOEFL bertanggung jawab membuat dan merapikan konten TOEFL, mulai dari metadata paket, passage, audio group, soal, opsi jawaban, kunci jawaban, preview, sampai submit paket ke review.

## Menu Utama

- Author Dashboard
- Paket TOEFL
- Passage & Soal
- Review Workflow
- Preview Konten

## Hak Akses

- Membuat paket TOEFL.
- Mengedit metadata paket.
- Membuat passage reading.
- Membuat audio group listening dengan cue waktu.
- Membuat soal, opsi, kunci jawaban, dan tipe soal.
- Import soal dari template CSV/Excel jika tersedia.
- Melihat quality dashboard.
- Submit paket untuk review.

## Workflow Membuat Paket TOEFL

```mermaid
flowchart TD
    A["Buka Author > Paket TOEFL"] --> B["Klik Create Paket"]
    B --> C["Isi kode, judul, deskripsi, dan jenis paket"]
    C --> D["Simpan"]
    D --> E["Buka detail paket"]
    E --> F["Lengkapi metadata"]
```

### Langkah Kerja

1. Buka `Author > Paket TOEFL`.
2. Klik tombol create paket.
3. Isi kode paket, judul, deskripsi, status, dan jenis paket.
4. Simpan.
5. Buka detail paket melalui action pada daftar paket.
6. Gunakan section Metadata Paket hanya untuk mengedit informasi paket yang sudah ada.

## Workflow Passage & Audio Group Builder

```mermaid
flowchart TD
    A["Pilih paket"] --> B["Pilih section"]
    B --> C{"Section"}
    C -->|Listening| D["Buat audio group dan cue"]
    C -->|Reading| E["Buat passage bacaan"]
    C -->|Structure| F["Buat komponen structure atau written expression"]
    D --> G["Lanjut ke Question Builder"]
    E --> G
    F --> G
```

### Listening

- Semua Part A, Part B, dan Part C berbasis audio.
- Buat group sesuai part dan cue waktu audio.
- Satu file audio master boleh dipakai oleh beberapa group.
- Isi `audio_start_seconds`, `audio_end_seconds`, dan label cue dengan teliti.
- Student player akan diarahkan ke cue aktif dan tidak ditujukan untuk scrub bebas pada mode production.

### Structure

- Tidak membutuhkan passage panjang.
- Gunakan komponen untuk membedakan `Structure` dan `Written Expression`.
- Isi passage/media tidak perlu ditampilkan untuk section ini.

### Reading

- Buat passage bacaan terlebih dahulu.
- Setelah passage dibuat, tambahkan beberapa soal untuk passage tersebut.
- Perhatikan distribusi tipe soal seperti main idea, detail, vocabulary, inference, dan reference jika digunakan.

## Workflow Question Builder

```mermaid
flowchart TD
    A["Pilih section"] --> B["Pilih komponen/passage/audio group yang sudah ada"]
    B --> C["Isi teks soal atau prompt"]
    C --> D["Isi opsi A-D"]
    D --> E["Tandai satu kunci jawaban"]
    E --> F["Pilih tipe soal"]
    F --> G["Simpan"]
    G --> H["Cek di Kumpulan Soal"]
```

### Catatan Penting

- Jika komponen sudah pernah dibuat, pilih komponen yang ada. Jangan membuat komponen baru untuk konteks yang sama.
- Nomor soal dapat dikosongkan agar sistem memilih urutan aman.
- Setiap soal harus punya empat opsi dan tepat satu kunci jawaban.
- Untuk official package, soal tanpa kunci atau opsi tidak lengkap akan menjadi blocker.

## Workflow Quality Dashboard

```mermaid
flowchart LR
    A["Authoring Quality Dashboard"] --> B["Cek blocker"]
    B --> C["Perbaiki soal, opsi, audio cue, atau passage"]
    C --> D["Cek ulang"]
    D --> E["Submit Review"]
```

### Hal yang Dicek

- Jumlah soal per section.
- Listening Part A/B/C.
- Reading passage coverage.
- Soal tanpa jawaban benar.
- Soal tanpa opsi lengkap.
- Audio group tanpa cue.
- Duplicate order.
- Reading tanpa tipe soal.

## Workflow Submit Review

1. Buka paket.
2. Periksa quality dashboard.
3. Pastikan tidak ada blocker untuk official package.
4. Klik submit review.
5. Tunggu scorer melakukan review.
6. Jika dikembalikan untuk revisi, perbaiki catatan lalu submit ulang.

## Praktik Baik

- Gunakan kode paket yang konsisten, misalnya `TOEFL-OFFICIAL-2026-001`.
- Pisahkan paket demo, practice, dan official.
- Hindari mengedit paket official setelah dipublish tanpa workflow revisi.
- Simpan audio listening di storage publik yang dapat diakses browser.