logo
Mr. Capsules
Documentation
GENERAL GUIDE
MCP & API GATEWAY
MANAGEMENT DIVISION
DEVELOPMENT DIVISION
REVIEW & QA DIVISION
DOKUMENTASI GUIDE UMUM

1. Pengantar MR-CAPSULES

๐Ÿ“– ISTILAH PENTING (buat yang masih awam):
  • Open-source = kode dan pengelolaannya terbuka, siapa saja boleh ikut berkontribusi
  • CBT pool = kumpulan soal pilihan ganda yang bisa dipakai berulang untuk latihan/ujian
  • HTML = format file dasar halaman web; semua materi/soal di platform ini disimpan sebagai file .html

MR-CAPSULES adalah platform edukasi open-source untuk melestarikan dan mendistribusikan bahan belajar mahasiswa kedokteran/kesehatan di satu tempat. Materi kuliah, praktikum, dan soal tahun-tahun sebelumnya diubah jadi basis data HTML pilihan ganda yang bisa dipakai berulang (CBT pool).

2. Pengenalan Admin Panel

๐Ÿ“– ISTILAH PENTING (buat yang masih awam):
  • CBT = Computer Based Test, ujian teori lewat komputer (bukan kertas)
  • Kanban Board = papan tugas dengan kolom-kolom (Open → In Progress → Done) supaya progres kerja gampang dipantau
  • MCP = "jembatan" yang memungkinkan AI seperti Claude terhubung langsung ke Admin Panel dan menjalankan tugas otomatis
  • HTML = format file dasar halaman web; semua materi/soal di platform ini disimpan dalam bentuk file .html
  • Live Preview = fitur untuk langsung melihat tampilan file HTML tanpa perlu upload dulu

Semua kontributor bekerja lewat Admin Panel, yang punya 4 fitur utama:

  • Dashboard: Analitik aplikasi (uptime, total pengguna, member online), log aktivitas, dan papan peringkat kontributor (Leaderboard).
  • Files (File Manager): Tempat mengelola folder dan file HTML langsung. Ada HTML Editor berbasis CodeMirror dengan live preview buat ngecek materi.
  • Team (Organization): Manajemen anggota divisi, filter pengguna (Admin, Banned, Online), fitur Broadcast pengumuman, dan pengaturan global (Maintenance / Sign-up).
  • Tasks (Task Board): Papan proyek dengan sistem Kanban (Open, In Progress, Developed, In Review, Done) plus tampilan Silabus. Tugas bisa dibagi per semester dan kategori materi (CBT, OSCE, Video, Summary).

3. Pembagian Divisi Kontributor

Kontribusi di MR-CAPSULES dibagi ke beberapa divisi. Tidak perlu ragu untuk daftar โ€”ย sistemnya didesain supaya gampang dipelajari siapa saja.

PENTING: Tidak perlu pengalaman coding, IT, atau organisasi untuk masuk divisi mana pun. Alur kerja teknisnya akan dijelaskan setelah kamu bergabung.

A. Management Division (Pengurus)

Menjaga kelancaran alur kerja dari Task Board sampai publikasi: assign tugas di Kanban Board, kelola pengguna di tab Team, dan menyiarkan pengumuman.

B. Development Division (Pembuat Konten)

Meracik materi mentah jadi file HTML/CBT yang interaktif. Ambil tugas di Task Board, kerjakan, lalu pindahkan ke kolom Developed (Wait for Review).

Catatan Teknis: kita tidak melakukan coding asli/manual.

Pembuatan dan perbaikan kode semuanya lewat Vibe Coding โ€” istilah untuk men-generate kode pakai AI seperti Claude atau Antigravity. Peran developer lebih ke Prompt Engineer: menyuruh AI membuat soal dengan template yang sudah ada, lalu memasukkannya ke HTML Editor di tab Files.

C. Review & QA Division (Koreksi)

Memastikan setiap materi yang masuk kolom In Review di Task Board bebas dari typo atau konsep yang keliru.

Reviewer mengecek live preview di HTML Editor, mencocokkan kunci jawaban dengan referensi asli. Kalau lolos, tugas digeser ke Done. Kalau ada yang salah, dikembalikan ke kolom In Progress supaya Developer memperbaikinya lewat AI lagi.

MCP & API GATEWAY GUIDE

1. Integrasi MCP & API Gateway (AI Assistant Integration)

๐Ÿ“– ISTILAH PENTING (buat yang masih awam):
  • MCP (Model Context Protocol) = standar yang memungkinkan AI Assistant (Claude, dll) terhubung ke aplikasi lain. Cara pakainya BUKAN seperti coding atau "manggil fungsi" — Anda cukup chat/ngobrol biasa dengan Claude, lalu Claude sendiri yang otomatis menjalankan aksinya di belakang layar (mengambil task, upload file, dsb). Sama persis seperti Anda minta tolong asisten manusia, hanya saja asistennya AI yang langsung bisa "menyentuh" data di MR-CAPSULES.
  • API Gateway = pintu masuk yang mengatur lalu lintas permintaan dari luar (misalnya dari AI) ke sistem MR-CAPSULES
  • API Key = kunci rahasia berbentuk teks untuk membuktikan identitas saat AI/aplikasi luar mengakses server
  • OAuth 2.0 = metode login aman tanpa perlu membagikan password langsung ke aplikasi pihak ketiga
  • Connector = fitur di Claude.ai untuk menyambungkan Claude ke layanan luar, termasuk MR-CAPSULES
๐Ÿ’ฌ INTINYA: MCP = NGOBROL, BUKAN CODING
Cukup ketik permintaan dalam bahasa biasa ke chat Claude, misalnya: "Buatkan task baru untuk materi Fisiologi Saraf blok 1.3" atau "Cek file apa saja yang ada di folder blok 2.5". Claude yang menerjemahkan permintaan itu jadi aksi teknis (memanggil tool tasks_create, content_list, dsb) di belakang layar. Tidak perlu menghafal nama tool atau menulis kode.

MR-CAPSULES menyediakan API Gateway & Model Context Protocol (MCP) serverless ganda berbasis Streamable HTTP (MCP 2025-06-18) dan OpenAPI 3.0.3 REST Actions. Lewat arsitektur ini, AI Assistant seperti Claude.ai Web, Claude Desktop, ChatGPT Custom GPTs, atau AI Agent otonom dapat berkolaborasi langsung mengelola konten, task board, dan catatan medis DoctorTablet.

A. Cara Mengoperasikan & Mengisi API Key

  1. Buka Admin Panel dan pastikan akun kamu sudah terhubung ke salah satu Divisi (Management, Development, atau Review).
  2. Pilih tab API Keys di navigasi utama.
  3. Isi nama kunci di bidang Key Name (contoh: ChatGPT Custom Connector atau Claude Web MCP) dan tentukan masa berlaku (Expires In).
  4. Klik + Generate Key. Kunci rahasia berawalan mrc_... akan muncul di kotak kuning.
  5. Klik Copy dan simpan kuncinya segera — kunci ini di-hash satu arah (SHA-256) dan tidak bisa ditampilkan ulang.

B. Menghubungkan ke Claude.ai Web (Custom Connector)

Integrasi MCP MR-CAPSULES mendukung OAuth 2.0 PKCE Auto-Discovery (RFC 8414 & RFC 7591) resmi.

  1. Buka Claude.ai → Settings → Connectors → klik Add Custom Connector (BETA).
  2. Name: isi dengan Mr Capsules.
  3. URL: isi dengan https://mr-capsules.vercel.app/api/mcp
  4. Advanced settings: biarkan kosong — otorisasi OAuth 2.0 PKCE berjalan otomatis lewat Auto-Discovery.
  5. Klik Add → Connect → masuk dengan akun Mr. Capsules kamu untuk mengotorisasi sesi.

C. Menghubungkan ke ChatGPT (Custom GPT Actions & Connectors)

ChatGPT Custom GPTs menggunakan standar OpenAPI 3.0.3 untuk memanggil fungsi eksternal secara otomatis.

โšก OPENAI 30-ACTION LIMIT PRESET:
OpenAI membatasi maksimal 30 operasi per Action Connector. MR-CAPSULES menyediakan skema terkurasi otomatis:
  • https://mr-capsules.vercel.app/api/openapi.json?category=essential (Default ~24 Tools: DoctorTablet + Content + Tasks)
  • https://mr-capsules.vercel.app/api/openapi.json?category=doctortablet (8 Tools Khusus Vault Catatan Medis)
  • https://mr-capsules.vercel.app/api/openapi.json?category=content (12 Tools Manajemen File & Materi)
  • https://mr-capsules.vercel.app/api/openapi.json?category=tasks (14 Tools Kanban Board & QA Review)
  1. Buka ChatGPT → Explore GPTs → klik Create (atau edit Custom GPT kamu) → masuk ke tab Configure.
  2. Gulir ke bawah ke bagian Actions → klik Create new action.
  3. Pada kolom Schema, klik Import from URL → tempelkan URL skema: https://mr-capsules.vercel.app/api/openapi.json (atau pilih preset kategori di atas).
  4. Klik Import. Seluruh tools akan langsung terpetakan sebagai Action endpoints ChatGPT.
  5. Konfigurasi Autentikasi:
    • Opsi 1 - API Key (Rekomendasi Cepat): Pilih API Key → Auth Type: Bearer → Tempel API Key mrc_... yang digenerate di Admin Panel.
    • Opsi 2 - OAuth 2.0: Pilih OAuth → Auth URL: https://mr-capsules.vercel.app/authorize → Token URL: https://mr-capsules.vercel.app/token → Scope: mcp → Token Exchange: Default (POST).
  6. Privacy Policy URL: Isi dengan https://mr-capsules.vercel.app/docs#privacy.
  7. Instruksi Custom GPT (System Prompt): Salin instruksi sintesis medis DoctorTablet di bawah ini ke kolom Instructions GPT kamu.
๐Ÿ“‹ SYSTEM PROMPT DOCTORTABLET UNTUK CHATGPT & CLAUDE:
"Anda adalah Medical AI Assistant MR-CAPSULES & DoctorTablet. Saat membuat catatan medis (doctortablet_save_note): 1) Analisis & petakan struktur hirarki topik terlebih dahulu. 2) Tulis materi dengan high-density reasoning, studi kasus, & jebakan ujian (BUKAN transkrip slide PPT mentah). 3) WAJIB sertakan Callouts GitHub ([!NOTE], [!TIP], [!WARNING]), Tabel komparasi, Diagram Mermaid, dan Rumus Matematika/Skor Medis dalam format LaTeX ($...$ / $$...$$). 4) Parameter author WAJIB nama lengkap pengguna tanpa gelar akademis."

D. Menghubungkan ke Google Antigravity (Agent & IDE Connector)

Google Antigravity dapat terhubung langsung ke MR-CAPSULES melalui server Streamable HTTP MCP atau OAuth 2.0 PKCE Flow.

  1. Opsi 1 - Konfigurasi Streamable HTTP MCP (Direkomendasikan untuk Agen):

    Tambahkan konfigurasi berikut ke berkas konfigurasi MCP Antigravity (mcp.json atau settings.json):

    {
      "mcpServers": {
        "mr-capsules": {
          "url": "https://mr-capsules.vercel.app/api/mcp",
          "headers": {
            "x-api-key": "mrc_your_api_key_here"
          }
        }
      }
    }
  2. Opsi 2 - Otorisasi OAuth 2.0 PKCE Langsung:

    Antigravity mendukung otorisasi OAuth 2.0 native dengan skema pengalihan kustom (antigravity://oauth/callback):

    • Authorization URL: https://mr-capsules.vercel.app/authorize?client_id=antigravity-mcp&redirect_uri=antigravity://oauth/callback&response_type=code
    • Token URL: https://mr-capsules.vercel.app/token
    • One-Click Connect: Jika browser Anda sudah memiliki sesi login aktif di MR-CAPSULES, halaman otorisasi otomatis menyembunyikan formulir dan menampilkan tombol 1-klik "Approve & Connect as [email]".
CATATAN PENGGUNAAN: API Key dibatasi maksimum 5 kunci aktif per pengguna, dengan rate limit 60 request/menit untuk mencegah penyalahgunaan.

E. Ringkasan Kemampuan MCP & Action Tools (78+ Method)

Setelah tersambung, kamu tidak perlu hafal nama-nama fungsi di bawah ini — cukup minta dengan bahasa biasa ke Claude atau ChatGPT, dan AI akan otomatis memilih serta menjalankan fungsi yang sesuai:

  • DoctorTablet Medical Vault (Catatan Medis): doctortablet_list_notes, doctortablet_read_note, doctortablet_save_note, doctortablet_list_categories, doctortablet_create_category, doctortablet_search_notes, doctortablet_delete_note, doctortablet_export_merged_document
  • Materi, Cover & Upload File Besar: content_list, content_get, content_tree, content_upload, content_upload_from_agent_path, upload_init, upload_chunk, upload_commit, upload_status, upload_cancel, content_delete, content_delete_files, content_rename, cover_list, cover_upload, cover_delete
  • Pengelolaan Codebase (SuperAdmin): codebase_read_file, codebase_write_file, codebase_delete_file, codebase_search, codebase_git_history
  • Meta-Tools (Pembuatan Tool MCP Dinamis): mcp_create_tool, mcp_delete_tool, mcp_list_custom_tools
  • Task Board & Workflow: tasks_list, tasks_create, tasks_claim, tasks_unclaim, tasks_submit, tasks_start_review, tasks_approve, tasks_reject, tasks_add_note, tasks_delete, tasks_logs
  • Review & QA: review_issues, review_report, review_resolve, review_delete_issue
  • Organisasi & Divisi: divisions_list, divisions_my, divisions_join, divisions_update_whatsapp, divisions_get_members, divisions_add_member, divisions_remove_member
  • Manajemen Akun & Pengguna: account_manager (Unified), users_create, users_list, users_ban, users_reset_password, users_add_admin, users_remove_admin, users_delete, users_remove_device, users_block_device, contributions_leaderboard, contributions_my, contributions_record
  • Dokumentasi & Sistem: docs_get, docs_update_section, docs_add_section, docs_add_tab, docs_update_tab, docs_delete_tab, system_health, system_cleanup_guests, activity_logs, config_get, config_update, apikeys_list, apikeys_create, apikeys_revoke, oauth_tokens_list, oauth_tokens_revoke

2. Referensi Lengkap MCP Tools & Hak Akses

๐Ÿ’ฌ CARA BACA TABEL DI BAWAH INI:
Tabel-tabel berikut adalah referensi teknis buat yang penasaran ada fungsi apa saja di baliknya. Tapi dalam praktiknya, kamu tidak perlu mengetik nama tool ini secara manual โ€” cukup chat biasa ke Claude (misalnya: "tolong lihat siapa saja anggota divisi Development"), dan Claude yang akan mencocokkan permintaan itu dengan tool yang tepat (divisions_get_members) lalu menjalankannya.

Bagian ini merinci seluruh 78+ method/tools yang tersedia lewat MCP Gateway, dikelompokkan berdasarkan fungsinya, beserta siapa saja yang berwenang memakainya.

PENTING: Meski sebuah tool "tampak" di daftar AI Assistant kamu, eksekusinya tetap divalidasi ulang oleh server berdasarkan role akun yang terhubung. Kalau tidak punya hak akses, permintaan akan ditolak (403/permission error) walau tool-nya sempat dipanggil.

A. Level Akses (Role Hierarchy)

  • SuperAdmin: Pemegang kendali penuh sistem & codebase. Satu-satunya yang dapat mengedit file codebase backend/frontend, mengangkat/menurunkan Admin, dan menghapus akun secara permanen.
  • Admin: Diangkat oleh SuperAdmin. Mengelola konfigurasi sistem, konten, dan moderasi pengguna, namun tidak bisa mengubah hak Admin lain.
  • Reviewer: Anggota Divisi Review & QA. Berwenang atas siklus review tugas (start review, approve, reject, lapor isu).
  • Developer: Anggota Divisi Development. Berwenang mengambil (claim) dan mengumpulkan (submit) tugas.
  • Semua Pengguna Terautentikasi: Akses baca umum serta pengelolaan data milik sendiri (API key, kontribusi, WhatsApp, dsb).

B. Materi, Cover & Upload File Besar

ToolFungsiAkses
content_list, content_get, content_treeMelihat/membaca materi HTMLSemua pengguna terautentikasi
content_upload, content_upload_from_agent_path, content_renameUpload langsung (Base64, max ~3.5MB per request) & move fileDeveloper, Reviewer, Admin, SuperAdmin
upload_init, upload_chunk, upload_commitSistem upload terfragmentasi untuk file besar (video/PDF/pool ZIP tanpa batas ukuran)Developer, Reviewer, Admin, SuperAdmin
upload_status, upload_cancelMengecek status & membatalkan sesi upload terfragmentasiDeveloper, Reviewer, Admin, SuperAdmin
content_delete, content_delete_filesMenghapus materiAdmin, SuperAdmin
cover_listMelihat coverSemua pengguna terautentikasi
cover_upload, cover_deleteMengelola cover semester/blokAdmin, SuperAdmin

C. Pengelolaan Codebase Repository

ToolFungsiAkses
codebase_read_fileMembaca isi file apa saja di seluruh codebase (misal `api/admin.js`, `build.js`)SuperAdmin Only
codebase_write_fileMembuat atau mengedit file apa saja di repository codebaseSuperAdmin Only
codebase_delete_fileMenghapus file apapun di repository codebaseSuperAdmin Only
codebase_searchMencari kata kunci/kode di seluruh repository codebaseSuperAdmin Only
codebase_git_historyMelihat riwayat commit & log aktivitas git di repositorySuperAdmin Only

D. Task Board & Workflow

ToolFungsiAkses
tasks_list, tasks_logsMelihat papan tugas & riwayatSemua pengguna terautentikasi
tasks_create, tasks_deleteMembuat/menghapus tugasManagement (Admin/SuperAdmin)
tasks_claim, tasks_unclaim, tasks_submitMengambil & mengumpulkan tugasDeveloper
tasks_start_review, tasks_approve, tasks_rejectSiklus review tugasReviewer
tasks_add_noteMenambah catatan di log tugasSemua pengguna terautentikasi

E. Review & QA

ToolFungsiAkses
review_issuesMelihat isu review pada tugasReviewer
review_report, review_resolve, review_delete_issueMelaporkan/menyelesaikan/menghapus isuReviewer, Admin, SuperAdmin

F. Organisasi & Divisi

ToolFungsiAkses
divisions_list, divisions_myMelihat daftar/status divisi sendiriSemua pengguna terautentikasi
divisions_join, divisions_update_whatsappBergabung ke divisi & update kontakSemua pengguna terautentikasi
divisions_get_membersMelihat anggota divisi tertentuAdmin, SuperAdmin
divisions_add_member, divisions_remove_memberMenambah/mengeluarkan anggota divisiAdmin, SuperAdmin

G. User, Perangkat & Hak Akses

ToolFungsiAkses
users_listMelihat semua pengguna terdaftarSuperAdmin
users_ban, users_reset_password, users_delete, users_remove_device, users_block_deviceModerasi & keamanan akun/perangkatSuperAdmin
users_add_admin, users_remove_adminMengangkat/menurunkan hak AdminSuperAdmin
contributions_leaderboard, contributions_my, contributions_recordMelihat papan peringkat & riwayat sendiriSemua pengguna terautentikasi

H. Dokumentasi & Sistem

ToolFungsiAkses
docs_get, system_healthMembaca dokumentasi & status sistemSemua pengguna terautentikasi
docs_update_section, docs_add_section, docs_add_tab, docs_update_tab, docs_delete_tabMengedit & mengelola tab/halaman dokumentasiAdmin, SuperAdmin
config_get, config_update, activity_logs, system_cleanup_guestsKonfigurasi global & pemeliharaan sistemAdmin, SuperAdmin
apikeys_list, apikeys_create, apikeys_revokeMengelola API key milik sendiriSemua pengguna terautentikasi
oauth_tokens_list, oauth_tokens_revokeMengelola koneksi OAuth (Claude/MCP) milik sendiriSemua pengguna terautentikasi
CATATAN: Tabel di atas menunjukkan role minimum yang dibutuhkan. Role yang lebih tinggi dalam hierarki (SuperAdmin > Admin > Reviewer/Developer) otomatis mewarisi akses baca dari role di bawahnya.

3. Privacy Policy & Data Protection

MR-CAPSULES Platform berkomitmen penuh untuk menjaga keamanan, privasi data pengguna, dan integritas materi edukasi kedokteran:

  • Zero Data Sale: Kami tidak pernah menjual, menyewakan, atau memperdagangkan data pribadi pengguna kepada pihak ketiga manapun.
  • Autentikasi & Enkripsi: Seluruh komunikasi data dilindungi melalui enkripsi SSL/TLS (HTTPS). Kunci API dan token OAuth di-hash satu arah menggunakan SHA-256 dengan siklus masa kedaluwarsa ketat.
  • Akses AI Assistant: AI Assistant (ChatGPT Custom GPT, Claude MCP) hanya dapat mengakses data dan menjalankan perintah sesuai dengan hak akses (role) pengguna yang terotentikasi. Data percakapan diproses secara langsung antara klien AI dan gateway serverless tanpa penyimpanan histori di luar audit log operasional.
  • Penghapusan Data: Pengguna dapat mencabut kunci API atau memutuskan sesi OAuth kapan saja melalui Admin Panel.
MANAGEMENT DIVISION GUIDE

1. Mengidentifikasi Konten yang Dibutuhkan per Blok

๐Ÿ“– ISTILAH PENTING (buat yang masih awam):
  • Gap konten = materi yang seharusnya ada di silabus tapi belum tersedia file HTML-nya di platform
  • Silabus = daftar resmi kuliah/praktikum dari program studi untuk satu blok
  • Template Lecture = format file HTML berisi rangkuman materi kuliah + kuis (lihat detail lengkap di tab Development Division)
  • Template CBT / Quiz Engine = format file HTML khusus soal ujian murni tanpa rangkuman materi, dengan mode Study/Exam/Drill (lihat detail lengkap di tab Development Division)
  • Task duplikat = dua task berbeda yang ternyata membahas topik yang sama, sehingga membuang waktu Developer
  • MCP = cara menghubungkan Claude ke MR-CAPSULES. Penggunaannya seperti chat biasa, bukan menulis kode — Anda cukup minta ke Claude dalam bahasa sehari-hari, Claude yang menjalankan aksinya

Tugas pertama Management adalah memetakan gap antara materi yang sudah ada di platform dan yang seharusnya ada โ€”ย dilakukan sebelum task apapun dibuat.

A. Langkah Audit Konten

  1. Buka tab Files di Admin Panel → navigasi ke folder blok yang mau diaudit (contoh: content/semester 2/2.5/).
  2. Bandingkan file yang ada dengan silabus blok (daftar kuliah/praktikum resmi dari prodi). Catat materi yang belum punya file HTML.
  3. Cek tab Tasks di Kanban Board โ€”ย pastikan materi yang belum ada itu belum punya task aktif (Open / In Progress / In Review), supaya tidak dobel assignment.

B. Jenis Konten HTML yang Dibutuhkan

Semua konten di MR-CAPSULES berbentuk file .html interaktif. Sesuai penjelasan lengkap di tab Development Division, ada dua jenis template, tergantung sumber materinya:

Fitur / Karakteristik Template HTML Lecture Template HTML CBT
Dipakai untuk task Materi kuliah teori & modul praktikum yang belum pernah dirangkum Naskah soal ujian CBT tahun lalu / bank soal siap pakai
Sumber Utama PPT Kuliah / Modul Praktikum Naskah Soal CBT Tahun Lalu / Bank Soal
Elemen Utama Tab ๐Ÿ“‹ Materi (Rangkuman) + Tab ๐ŸŽฏ Quiz Pure Engine Kuis (Study, Exam, Drill Mode)
Penyajian Materi Sub-tabs, Note boxes, Data tables, Diagram SVG Tidak ada (hanya lewat penjelasan di kuis)
CATATAN UNTUK MANAGEMENT: Saat membuat task (lihat Section 2), tentukan dulu sumbernya: materi kuliah/praktikum baru (→ Template Lecture) atau naskah soal ujian siap pakai (→ Template CBT). Ini membantu Developer langsung tahu template mana yang harus dipakai tanpa perlu tanya lagi.

C. Aturan Prioritas Sumber: PPT Lecture vs. Modul Praktikum

Kalau untuk satu topik yang sama ada dua sumber (PPT lecture dan modul praktikum), ikuti hierarki berikut:

ATURAN EMAS: Pilih satu sumber yang paling lengkap โ€”ย jangan buat dua file HTML terpisah untuk materi yang identik. Tujuannya menghindari duplikasi konten yang bikin bingung pengguna.
KondisiSumber yang DipakaiAlasan
PPT Lecture & Modul Praktikum membahas topik identik, kedalaman berbeda Pilih yang lebih lengkap (biasanya modul praktikum โ€”ย mencakup prosedur + teori) Modul praktikum umumnya sudah merangkum teori dari PPT plus penerapan klinis
PPT Lecture lebih lengkap (lebih banyak slide, lebih detail patofisiologi) Pakai PPT Lecture sebagai basis Materi teori kuliah lebih banyak terangkum di sini
Modul Praktikum membahas prosedur / skill yang tidak ada di PPT Buat dua file terpisah: satu dari PPT (Template Lecture, fokus teori), satu dari modul (Template Lecture juga, fokus prosedur) Isi materi berbeda meski format template sama — tidak redundan
Konten benar-benar sama persis (PPT = ringkasan modul) Pakai modul praktikum, abaikan PPT Hindari duplikasi; modul lebih terstruktur untuk dijadikan materi + soal

D. Cara Mengecek Kelengkapan via Files

  1. Di tab Files, buka folder blok target.
  2. Klik kanan (atau ikon titik tiga) pada file HTML yang ada → pilih Edit Code → pakai Live Preview untuk cepat lihat isinya.
  3. Kalau file yang ada sudah mencakup materi dari PPT dan modul secara memadai, tidak perlu task baru. Kalau belum lengkap, catat untuk dibuatkan task revisi.

2. Menginput Task ke Task Board

Setelah audit selesai dan daftar gap konten tersusun, langkah berikutnya adalah membuat task di Kanban Board. Ada dua cara: manual via Admin Panel, atau chat ke AI via MCP (Claude.ai / Antigravity).

A. Cara Manual (via Admin Panel)

  1. Buka tab Tasks di Admin Panel.
  2. Klik + Create Task (tombol ini hanya muncul untuk akun Management/Admin).
  3. Isi form dengan ketentuan berikut:
    • Title: Nama materi spesifik, jelas, dan konsisten. Format yang direkomendasikan: [Mata Kuliah] [Topik] — [Tipe]
      Contoh: Fisiologi Saraf Otonom — CBT atau Histologi Epitel — Identifikasi
    • Semester: Pilih semester yang sesuai (contoh: semester 2).
    • Block: Isi nomor blok (contoh: 2.5). Wajib diisi agar task muncul di tampilan Silabus.
    • Category: Isi sesuai peruntukan ujian: CBT untuk soal teori, atau nama blok/kategori custom (misal Praktikum Fisio). Field ini bebas diisi — gunakan nama yang konsisten biar gampang difilter di Kanban Board.
    • Priority: Sesuaikan urgensi:
      • urgent — ujian < 2 minggu lagi
      • high — ujian 2–4 minggu
      • normal — standar
      • low — cadangan / tidak mendesak
    • Description: Cantumkan detail sumber materi, misalnya: “Buat soal CBT dari PPT K10 am-i-counseling. Fokus pada prinsip dasar konseling dan hambatan komunikasi. Target ~20 soal.”
    • Target Path (opsional): Kalau sudah tahu path file tujuan, isi di sini (contoh: content/semester 2/2.5/2.5 CBT_K10 am-i-counseling.html) โ€”ย memudahkan Developer tahu di mana menyimpan hasil kerjanya.
    • Assign To (opsional): Pilih Developer tertentu dari dropdown kalau mau mendelegasikan langsung. Kosongkan kalau mau open claim.
  4. Klik Confirm. Task akan muncul di kolom Open pada Kanban Board.
TIPS: Dari tab Files, kamu bisa klik kanan file yang sudah ada → Create Task untuk pre-fill otomatis Target Path dan langsung buka form task. Jauh lebih cepat daripada input manual satu per satu.

B. Cara via MCP (Claude.ai / Antigravity) — Batch Input

Cara ini efisien untuk bikin banyak task sekaligus (misalnya satu blok penuh) tanpa klik-klik berulang di Admin Panel.

Prasyarat: pastikan sudah terhubung ke MCP MR-CAPSULES (lihat tab MCP & API Gateway untuk cara koneksi). Gunakan akun Management/Admin supaya tasks_create tidak ditolak.

Langkah di Claude.ai Web:

  1. Pastikan connector mr capsules sudah aktif (ikon puzzle di sidebar chat).
  2. Kirim prompt seperti berikut ke Claude:

    Contoh prompt batch task creation:

“Gunakan tool tasks_create untuk membuat task berikut di MR-CAPSULES:

1. Title: “Fisiologi Saraf Otonom — CBT”
   semester: “semester 1”, block: “1.3”
   category: “CBT”, priority: “high”
   description: “Buat pool soal pilihan ganda dari PPT K12 Fungsi SSO. Target ~15 soal teori.”

2. Title: “Histologi Epitel — SOE”
   semester: “semester 1”, block: “1.2”
   category: “SOE”, priority: “normal”
   description: “Buat pool soal pilihan ganda prosedural dari modul praktikum Histo Epitel.”

Buat semua task tersebut satu per satu.”

Langkah di Antigravity (agy CLI):

  1. Pastikan MCP MR-CAPSULES sudah dikonfigurasi di Antigravity.
  2. Gunakan perintah langsung di chat Antigravity, misalnya:
    Buat task CBT untuk semua kuliah di blok 2.5 yang belum ada filenya. Gunakan tasks_create via MCP.
  3. Antigravity akan menjalankan tasks_create berurutan untuk tiap item.
PENTING: Sebelum minta AI membuat task batch, selalu sertakan daftar materi yang sudah ada (hasil audit dari Files) supaya AI tidak bikin task untuk konten yang sudah selesai.

C. Parameter Lengkap tasks_create

ParameterTipeWajibKeterangan
titlestringYaNama task, tampil di Kanban Board
descriptionstringTidakDetail sumber, jumlah soal, instruksi Developer
semesterstringTidakContoh: semester 1, semester 2
blockstringTidakContoh: 1.3, 2.5 — tampil di Silabus
categorystringTidakBebas diisi. Gunakan CBT untuk soal teori, SOE untuk soal prosedural, atau nama kategori lain yang konsisten
priorityenumTidaklow / normal / high / urgent

3. Memastikan Developer & Reviewer Tidak Redundan

Redundansi terjadi ketika satu anggota mengerjakan sekaligus mereview konten miliknya sendiri, atau ketika dua Developer membuat file untuk topik yang sama. Ini harus dicegah secara sistematis.

A. Prinsip Pemisahan Peran

  • Developer hanya boleh mengerjakan (claim) dan mengumpulkan (submit) task. Mereka tidak boleh mereview hasil kerja sendiri.
  • Reviewer hanya boleh mereview task yang bukan miliknya. Kalau seorang anggota merangkap Developer & Reviewer, Management harus memastikan dia tidak ditempatkan di tugas yang sama.
  • Management (Admin/SuperAdmin) boleh memantau semua alur, tapi sebaiknya tidak terlibat langsung dalam produksi konten supaya bisa bertindak netral saat eskalasi.

B. Langkah Pencegahan Redundansi Developer

  1. Sebelum membuat task: cek di Kanban Board (kolom Open, In Progress) apakah topik sudah ada task-nya. Pakai filter atau search di tab Tasks.
  2. Saat assign task: kalau assign langsung lewat form (bukan open claim), pastikan tidak ada dua task dengan topik identik yang di-assign ke Developer yang sama.
  3. Kalau dua Developer tidak sengaja mengklaim topik yang sama: Management pakai tasks_delete pada task duplikat, atau tambahkan note lewat tasks_add_note untuk mengarahkan Developer kedua ke topik lain.
  4. Pantau kolom Developed (Wait for Review): kalau ada dua file masuk untuk topik yang sama, Management menentukan mana yang lebih lengkap, lalu reject yang lebih lemah dengan catatan (lewat Reviewer).

C. Langkah Pencegahan Redundansi Reviewer

  1. Saat task masuk kolom In Review, Reviewer yang mengklaim tidak boleh sama dengan Developer yang mengerjakan task itu. Cek nama di log task (tasks_logs) sebelum mulai review.
  2. Kalau tim kecil dan tidak ada Reviewer lain yang tersedia, eskalasi ke Management โ€”ย Management yang melakukan review sementara, atau tunda task sampai Reviewer tersedia.
  3. Gunakan field Note (tasks_add_note) untuk mendokumentasikan siapa yang sudah mereview sesi mana, terutama pada materi besar yang direview bertahap.

D. Monitoring via Kanban Board & Leaderboard

SinyalApa yang Harus Dilakukan Management
Satu Developer dominasi kolom In Progress (>5 task sekaligus) Batasi claim — tambahkan note di task agar Developer fokus menyelesaikan yang ada dulu
Tidak ada aktivitas di kolom In Review >3 hari Ping Reviewer via Broadcast (tab Team) atau tambahkan note urgency
Task di kolom Open sudah lama tidak diklaim Assign langsung ke Developer via form edit task, atau naikkan priority ke urgent
Satu anggota top Leaderboard tapi seluruh task belum Done Cek apakah ada task yang stagnan di In Review — review pipeline mungkin macet

E. Checklist Harian Management

  • Buka Kanban Board → pastikan tidak ada task yang stuck lebih dari 48 jam di satu kolom.
  • Cek Dashboard → Activity Log untuk mendeteksi aksi tak wajar (misal: submit tanpa claim, atau approve oleh Developer).
  • Review kolom Done mingguan → pastikan file HTML-nya benar-benar ada di tab Files (path sesuai).
  • Bandingkan jumlah task Done vs task Open untuk ukuran produktivitas divisi secara keseluruhan.
DEVELOPMENT DIVISION GUIDE

1. Workflow Utama Divisi Development (Vibe Coding)

๐Ÿ“– ISTILAH PENTING (buat yang masih awam):
  • Vibe Coding = cara membuat kode dengan menyuruh AI (Claude/Antigravity) yang menuliskan kodenya, bukan mengetik manual baris per baris
  • Prompt Engineer = peran menyusun instruksi (prompt) yang jelas ke AI supaya hasilnya sesuai kebutuhan, tanpa perlu jago coding
  • Template = file HTML contoh/acuan yang sudah punya struktur baku, dipakai AI sebagai "cetakan" saat membuat file baru
  • Claim Task = mengambil satu pekerjaan dari papan tugas (Kanban Board) supaya jadi tanggung jawab kita mengerjakannya
  • Submit Task = mengumpulkan hasil kerja untuk selanjutnya diperiksa oleh Divisi Review
  • MCP = cara AI terhubung ke server MR-CAPSULES. Cukup chat biasa ke Claude/Antigravity (misal: "ambilkan task nomor sekian" atau "upload file ini ke folder blok 2.5") — tidak perlu menulis kode atau menghafal nama fungsi apapun

Tugas utama Divisi Development adalah meracik materi kuliah/modul mentah atau naskah soal jadi file .html interaktif yang siap dipublikasikan ke MR-CAPSULES.

PRINSIP UTAMA: 100% VIBE CODING
Developer tidak perlu menulis kode HTML/CSS/JS manual baris demi baris. Semua pembuatan kode dilakukan dengan men-generate dan memperbaikinya lewat AI Assistant (seperti Claude.ai atau Antigravity CLI). Peran kamu adalah Prompt Engineer sekaligus pengontrol kualitas materi.
PERINGATAN EDITOR ADMIN PANEL:
Code Editor di tab Files Admin Panel masih dalam tahap pengembangan (eksperimental). Editor bawaan ini aman untuk Live Preview atau edit ringan, tapi tidak disarankan untuk membuat atau mengedit file HTML besar langsung di sana. Pakai AI eksternal (Claude/Antigravity) untuk generate file utuh, lalu upload.

A. Tahapan Alur Kerja Developer

  1. Claim Task di Kanban Board
    • Buka tab Tasks di Admin Panel, atau cukup chat ke AI: "tolong lihat task yang masih terbuka".
    • Cari task berstatus Open yang mau dikerjakan di kolom Kanban.
    • Klik Claim Task (atau chat ke AI: "ambilkan/claim task ini untuk saya"). Status task berubah jadi In Progress dan namamu tercatat sebagai Developer.
  2. Download Template HTML Acuan
    • Via Admin Panel: buka tab Files → navigasi ke folder blok target (contoh: content/semester 2/2.5/) → klik kanan pada salah satu file acuan → pilih Download File.
    • Via chat ke AI: minta saja, misalnya "tolong ambilkan file template acuan dari folder blok 2.5" โ€”ย AI akan membacanya langsung dari server.
  3. Siapkan Bahan Referensi Materi
    • Unduh PPT lecture, modul praktikum (PDF/Word), atau naskah soal CBT tahun lalu yang sesuai dengan task yang kamu klaim.
  4. Beri Pemahaman Template ke AI Terlebih Dahulu
    • Unggah file template .html yang sudah diunduh ke chat AI (Claude / Antigravity).
    • Instruksikan AI membaca dan mempelajari struktur CSS, layout HTML, dan skrip JavaScript-nya dulu sebelum memproses materi.
  5. Masukkan File Referensi & Eksekusi Prompting
    • Lampirkan materi/soal mentah ke chat AI.
    • Gunakan Prompt Formal yang sudah disediakan di bagian 3 dokumentasi ini.
    SELURUH WORKFLOW BISA DIJALANKAN MURNI VIA CLAUDE CONNECTOR
    Semua langkah di atas โ€” dari claim task, membaca template, prompting, sampai upload & submit โ€” bisa dilakukan 100% lewat chat Claude.ai yang terhubung ke MCP MR-CAPSULES, tanpa perlu membuka Admin Panel sekali pun.

    Satu-satunya pengecualian: upload file referensi materi (PPT Lecture, Modul Praktikum, Naskah Soal) tidak bisa lewat Claude Connector karena file itu ada di perangkat lokal kamu. File referensi harus dilampirkan langsung ke chat Claude secara manual sebelum prompting.
  6. Upload Hasil & Submit Task
    • Simpan hasil kode dari AI jadi file ber-ekstensi .html di komputermu.
    • Upload file itu ke folder yang sesuai di tab Files (atau pakai MCP tool content_upload / upload_init).
    • Buka lagi tab Tasks → klik Submit Task (atau MCP tasks_submit). Task akan pindah ke kolom Developed (Wait for Review) untuk diperiksa Divisi Review.

2. Memahami 2 Jenis Template HTML & Perbedaannya

Di MR-CAPSULES (khususnya standar Blok 2.5 FK), ada dua jenis template HTML utama. Developer perlu memilih template yang tepat sesuai jenis task yang diklaim.

A. Template HTML Lecture (Materi & Quiz)

Dipakai saat membuat file dari PPT Lecture atau Modul Praktikum. Contoh file acuan: 2.5 LECTURE_K10 am-i-counseling.html.

  • Struktur 2 Tab Utama: Terdiri dari tab ๐Ÿ“‹ Materi dan tab ๐ŸŽฏ Quiz di bagian atas.
  • Bagian Materi (Interaktif):
    • Materi dipecah menjadi beberapa Sub-Tabs per bab/topik.
    • Memiliki elemen Note Box berwarna (gold, blue, green, red, purp, teal) untuk poin-poin penting.
    • Memiliki Data Tables (dtable-wrap) untuk klasifikasi, dosis, atau kriteria diagnostik.
    • Mendukung diagram/flowchart SVG interaktif (misalnya alur komunikasi atau skema patofisiologi).
  • Bagian Quiz: Menyediakan kuis interaktif dengan pilihan ganda dan pembahasan langsung di tempat untuk menguji pemahaman materi kuliah tersebut.
  • Desain & Tipografi: Menggunakan variabel CSS modern dengan kombinasi font Google Fonts: Syne (Header), DM Sans (Body), dan DM Mono (Code/Data).

B. Template HTML CBT / Soal Ujian (Pure Quiz Engine)

Dipakai khusus saat memasukkan Naskah Soal Ujian Tahun Lalu atau bank soal ujian murni. Contoh file acuan: 2.5 CBT_21 REECHARD GANTENG.html.

  • Tanpa Tab Materi: Berisi 100% engine kuis tanpa penyajian rangkuman kuliah di depannya.
  • 3 Mode Belajar Utama:
    • Study Mode: Menampilkan kunci dan pembahasan komprehensif segera setelah memilih opsi.
    • Exam Mode: Simulasi ujian terwaktu, jawaban tersembunyi hingga kumpul ujian, dilengkapi modal konfirmasi.
    • Drill Mode: Mode pengulangan tanpa skor โ€”ย pengguna harus memilih opsi yang benar untuk maju.
  • Fitur Ujian Lengkap: Question Map (peta nomor), penanda soal (flag ๐Ÿณ๏ธ), statistik & riwayat skor lokal (localStorage), serta analisis akurasi per topik.
  • Struktur Data JS: Soal disimpan dalam array JavaScript utuh di bagian bawah file:
    const QUESTIONS = [{n:1, t:"Topik", q:"Pertanyaan...", o:["A","B","C","D","E"], a:"Kunci Jawaban", exp:"Pembahasan...", src:"Sumber"}, ...];
  • Desain & Tipografi: Menggunakan gaya retro-minimalist yang bersih dengan font Georgia untuk judul dan Courier New untuk elemen data.

C. Tabel Perbandingan Ringkas Template

Fitur / Karakteristik Template HTML Lecture Template HTML CBT
Sumber Utama PPT Kuliah / Modul Praktikum Naskah Soal CBT Tahun Lalu / Bank Soal
Elemen Utama Tab ๐Ÿ“‹ Materi (Rangkuman) + Tab ๐ŸŽฏ Quiz Pure Engine Kuis (Study, Exam, Drill Mode)
Penyajian Materi Sub-tabs, Note boxes, Data tables, Diagram SVG Tidak ada (hanya lewat penjelasan di kuis)
Penyimpanan Soal Terintegrasi dalam fungsi JS kuis interaktif Array JS terstruktur const QUESTIONS = [...]
Tema & Font Modern HSL (Syne + DM Sans + DM Mono) Retro Minimalist (Georgia + Courier New)

3. Guide Prompting AI & Formulasi Resmi (Dengan Breakdown)

Supaya hasil generate kode AI konsisten dan langsung sesuai standar MR-CAPSULES, pakai formulasi prompt resmi berikut saat Vibe Coding.

A. Prompt untuk PPT Lecture / Modul Praktikum (Template Lecture)

Pakai prompt ini kalau kamu mengunggah file Template HTML Lecture dan file PPT/Modul Materi ke AI.

Formulasi Prompt Resmi (Copy & Paste ke AI):

Pahami seluruh struktur, CSS, dan skrip JavaScript dari file template HTML Lecture yang saya berikan.

Tugasmu adalah membuat file HTML lengkap baru berdasarkan materi kuliah/modul yang saya unggah ini, dengan ketentuan berikut:

1. PEMAHAMAN SLIDE/MATERI UTUH:
   Pahami seluruh isi slide/modul dari awal sampai akhir. JANGAN SAMPAI ADA ILUSTRASI, TABEL, DIAGRAM, ATAU MATERI PENTING YANG KELEWAT. Jika ada diagram alur atau hubungan konsep di PPT, sajikan dalam bentuk diagram SVG/Mermaid atau tabel CSS yang rapi di dalam tab Materi.

2. SAJIKAN SESUAI TEMPLATE:
   - Bagi materi ke dalam sub-tabs yang logis (misal: Overview, Patofisiologi, Diagnosis, Tata Laksana, Referensi).
   - Gunakan komponen note box (gold, blue, green, red, purp, teal) untuk menyoroti poin kunci, definisi, atau peringatan klinis.
   - Buat POOL SOAL QUIZ YANG BANYAK di tab Quiz (minimal 15-20 soal pilihan ganda) yang mencakup seluruh poin materi kuliah tersebut, lengkap dengan pembahasannya.

3. JUDUL DAN AKSEN WARNA KUSTOM:
   - Berikan judul yang sesuai dan menarik di bagian header (contoh: "Am I Counseling? โ€”ย Quiz Keterampilan Dasar Konseling").
   - Pilih aksen warna khas di variabel CSS :root (--teal, --blue, --purp, atau --red) yang cocok dengan tema materi medis ini.

Keluarkan seluruh kode HTML utuh dalam satu block code tanpa ada bagian yang dipotong (no placeholders/TODO).

Breakdown Komponen Prompt Lecture:

Aturan / ElemenTujuan & Instruksi Khusus untuk AI
Rule 1: Pemahaman Template Memaksa AI membaca variabel CSS, kelas CSS (dtable-wrap, note, sub-tab), dan fungsi pembuka tab JS agar hasil keluaran tidak merusak layout.
Rule 2: Kelengkapan Slide & Ilustrasi Mencegah AI meringkas secara berlebihan. AI diinstruksikan mengonversi tabel PPT menjadi tabel HTML dan gambar alur menjadi SVG/diagram agar tidak ada informasi medis yang hilang.
Rule 3: Penyajian & Pool Soal Memastikan materi terbagi rapi ke dalam sub-tabs serta menghasilkan pool soal kuis yang cukup banyak untuk latihan mahasiswa.
Rule 4: Judul & Aksen Warna Menjaga estetika visual. Warna aksen disesuaikan dengan topik (contoh: Merah untuk Kardiologi/Vaskular, Biru/Teal untuk Psikiatri/Konseling, Hijau untuk Nutrisi/Gizi).

B. Prompt untuk Soal CBT Tahun Kemarin (Template CBT)

Gunakan prompt ini ketika Anda mengunggah file Template HTML CBT dan naskah/dokumen Soal Ujian CBT Tahun Lalu ke AI.

Formulasi Prompt Resmi (Copy & Paste ke AI):

Pahami seluruh engine kuis, struktur CSS, dan array JavaScript `QUESTIONS` dari file template HTML CBT yang saya berikan.

Tugasmu adalah menyajikan seluruh naskah soal ujian ini ke dalam template HTML CBT tersebut, dengan ketentuan berikut:

1. PRESERVASI KELENGKAPAN SOAL:
   Sajikan TEPAT [masukkan jumlah soal, misal: 105] SOAL dari naskah ini ke dalam array `QUESTIONS`. JANGAN SAMPAI ADA SATU PUN SOAL, OPSI JAWABAN, ATAU NOMOR YANG TERLEWAT ATAU DIPOTONG.

2. FORMULASI ARRAY QUESTIONS:
   Setiap objek soal harus memiliki struktur:
   - `n`: Nomor urut soal (1, 2, 3, dst.)
   - `t`: Nama topik/sub-materi singkat (misal: "Fisiologi Saraf", "Farmakologi", "Gizi Daur Hidup")
   - `q`: Teks pertanyaan lengkap (sertakan kasus/vignette jika ada)
   - `o`: Array 5 pilihan jawaban `["A", "B", "C", "D", "E"]`
   - `a`: Teks string kunci jawaban yang BENAR (harus persis sama dengan salah satu opsi di `o`)
   - `exp`: Pembahasan lengkap dan rinci mengapa jawaban tersebut benar dan mengapa opsi lain kurang tepat, berdasarkan teori medis di PPT/Modul.
   - `src`: Referensi slide/PPT (contoh: "PPT Merokok dan Alkoholisme โ€”ย dr. Yudhi")

3. JUDUL DAN AKSEN WARNA:
   - Sesuaikan bagian `.logo-wordmark` dan `.logo-tag` di header (contoh: "21 PILL SAPI", Blok "2.5").
   - Atur warna aksen visual yang sesuai di CSS :root.

Keluarkan seluruh kode HTML utuh tanpa potongan agar siap saya simpan langsung ke file .html.

Breakdown Komponen Prompt CBT:

Aturan / ElemenTujuan & Instruksi Khusus untuk AI
Rule 1: Pemahaman Engine CBT Memastikan AI mempertahankan fungsi 3 mode (Study, Exam, Drill), Question Map, dan sistem kalkulasi akurasi tanpa mengubah skrip JS bawaan.
Rule 2: Preservasi Presisi Soal Menyebutkan jumlah pasti soal (misal 105 soal) agar AI tidak berhenti di tengah jalan atau sengaja memotong soal dengan komentar /* soal 10-100 disingkat */.
Rule 3: Formulasi Array & Pembahasan Mewajibkan bidang exp (explanation) terisi pembahasan medis yang kaya dan bidang src mencantumkan pemateri/PPT acuan untuk membantu mahasiswa belajar.
Rule 4: Judul & Brand Tag Menjaga identitas file acuan (misalnya nama angkatan/sandi blok seperti "21 PILL SAPI" pada Blok 2.5) agar mudah dikenali di platform.
TIPS DEVELOPER: Jika naskah soal sangat banyak (misalnya >100 soal), AI mungkin mengalami output limit. Jika terpotong, minta AI melanjutkan dengan prompt: "Lanjutkan array QUESTIONS dari nomor [X] sampai selesai dengan format JSON yang sama." Lalu gabungkan kodenya.
REVIEW & QA DIVISION GUIDE

1. Peran & Tanggung Jawab Divisi Review

PRINSIP DASAR REVIEW:
Divisi Review bertugas memastikan setiap file HTML yang masuk dari Developer akurat secara konten medis sebelum dipublikasikan. Satu soal yang salah kunci atau penjelasannya menyesatkan lebih berbahaya daripada tidak ada konten sama sekali.

A. Apa yang Diperiksa oleh Reviewer?

  • Kunci Jawaban: Pastikan field a (answer) dalam setiap soal benar-benar merupakan opsi yang paling tepat secara medis.
  • Pembahasan (Explanation): Pastikan field exp menjelaskan mengapa jawaban benar dan mengapa opsi lain salah secara ilmiah โ€”ย bukan hanya menyebutkan ulang jawabannya.
  • Referensi Sumber: Pastikan field src mencantumkan PPT atau modul yang relevan dan benar.
  • Konsistensi Opsi: Kunci jawaban di field a harus persis sama (karakter demi karakter) dengan salah satu opsi di array o โ€”ย jika tidak cocok, soal akan tidak berfungsi.
  • Tata Bahasa & Ejaan: Tidak ada typo, kalimat ambigu, atau istilah medis yang keliru penulisannya.

B. Aturan Pemisahan Peran (Anti-Redundansi)

ATURAN WAJIB: Developer dan Reviewer untuk satu task yang sama TIDAK BOLEH orang yang sama. Tujuannya adalah memastikan ada perspektif kedua yang independen dalam proses QA. Jika tidak ada Reviewer lain yang tersedia, eskalasikan ke Management untuk reassignment.

2. Dua Jalur Koreksi

Saat Reviewer menemukan kesalahan pada file HTML, tersedia dua jalur tindakan tergantung jenis dan skala kesalahannya:

Jalur Kapan Digunakan Cara Kerja
Jalur A — Patch Langsung via MCP Kesalahan spesifik dan terisolasi: satu soal salah kunci, satu pembahasan keliru, typo pada penjelasan, atau referensi sumber salah nama Reviewer chat ke Claude/Antigravity → Claude langsung patch file HTML di server via MCP
Jalur B — Eskalasi ke Development Kesalahan struktural / masif: >30% soal salah, template HTML rusak, urutan soal kacau, atau soal tidak sesuai materi sama sekali Reviewer hubungi Developer via catatan task atau Broadcast → Developer revisi file ulang → kembali ke Review

3. Jalur A — Patch Langsung via MCP (Claude Connector)

Ini adalah jalur tercepat untuk memperbaiki kesalahan minor tanpa harus melibatkan Developer. Reviewer cukup chat ke Claude.ai (dengan MCP MR-CAPSULES aktif) atau Antigravity CLI.

SELURUH PROSES PATCH BISA DILAKUKAN MURNI VIA CLAUDE CONNECTOR
Tidak perlu membuka code editor, tidak perlu tahu cara edit HTML. Cukup chat ke Claude dengan informasi yang jelas — Claude yang akan membaca file, menemukan soal yang dimaksud, dan memperbaikinya langsung di server.

A. Format Permintaan Patch ke Claude

Gunakan format percakapan natural berikut. Semakin spesifik informasi yang Anda berikan, semakin akurat hasilnya:

Template Permintaan Patch (Sesuaikan dengan kasus Anda):

"Di file [nama file atau path lengkap, misal: content/semester 2/2.5/2.5 CBT_21 REECHARD GANTENG.html],
soal nomor [X] tentang [topik soal] salah.

Kunci jawaban yang benar adalah: [teks jawaban yang benar, harus persis sama dengan salah satu opsi]

Penjelasan (explanation) yang benar:
[Tulis pembahasan baru di sini โ€”ย jelaskan mengapa jawaban benar dan mengapa opsi lain kurang tepat]

Referensi sumber: [PPT/Modul mana, siapa dosennya]

Tolong perbaiki soal tersebut di file HTML-nya langsung."

B. Contoh Nyata Permintaan Patch

Contoh 1 — Salah Kunci Jawaban:

"Di file content/semester 2/2.5/2.5 CBT_21 REECHARD GANTENG.html,
soal nomor 25 tentang latihan fisik pada obesitas, kunci jawabannya salah.

Kunci yang benar adalah: Endurance training tipe non weight bearing

Penjelasan:
Pada pasien obesitas, latihan yang direkomendasikan adalah endurance training tipe NON weight bearing
(seperti berenang atau bersepeda) karena meminimalkan beban pada sendi yang sudah terbebani
berat badan berlebih. Resistance training boleh dilakukan tapi bukan yang pertama direkomendasikan
karena risiko cedera sendi lebih tinggi pada penderita obesitas berat.

Referensi: PPT Exercise for Special Population I - dr. Susi, Slide 14

Tolong perbaiki di file HTML-nya."

Contoh 2 — Pembahasan Keliru/Tidak Lengkap:

"Di file content/semester 2/2.5/2.5 CBT_21 REECHARD GANTENG.html,
soal nomor 13 tentang Neural Tube Defect, kunci jawabannya benar (Asam Folat)
tapi penjelasannya terlalu singkat dan tidak menyebut mekanismenya.

Penjelasan yang lebih lengkap:
Neural Tube Defect (NTD) seperti spina bifida dan anensefali terjadi akibat kekurangan asam folat
pada trimester pertama kehamilan, khususnya saat periode penutupan tabung saraf (hari 21-28 pasca
konsepsi). Asam folat berperan penting dalam sintesis DNA dan pembelahan sel saraf. WHO dan Kemenkes
merekomendasikan suplementasi 400 mcg/hari sejak sebelum kehamilan hingga trimester pertama.
Vitamin B12 juga terlibat dalam metabolisme folat, tapi defisiensi primer yang menyebabkan NTD
adalah asam folat.

Referensi: PPT Gizi dalam Daur Hidup 2 - dr. Madya, Slide 23

Tolong update explanation soal nomor 13 di file tersebut."

C. Apa yang Dilakukan Claude Setelah Menerima Permintaan?

  1. Claude membaca file HTML yang dimaksud via MCP tool content_get.
  2. Claude menemukan soal dengan nomor yang disebutkan dalam array QUESTIONS.
  3. Claude memperbarui field yang salah: a (kunci), exp (explanation), dan/atau src (referensi).
  4. Claude menyimpan perubahan kembali ke server via MCP tool content_upload atau content_patch.
  5. Claude melaporkan perubahan yang telah dilakukan untuk dikonfirmasi Reviewer.
TIPS REVIEWER: Setelah Claude selesai patch, minta Claude menampilkan soal yang sudah diperbaiki untuk verifikasi akhir sebelum mengubah status task. Contoh: "Tampilkan soal nomor 25 yang sudah diperbaiki dari file tersebut".

4. Jalur B — Eskalasi ke Divisi Development

Gunakan jalur ini jika masalah yang ditemukan terlalu besar atau terlalu struktural untuk dipatch satu per satu.

A. Kondisi yang Membutuhkan Eskalasi

KondisiContohTindakan
Banyak soal salah (>30%) Dari 50 soal, 20+ soal kunci atau pembahasannya keliru Kembalikan ke Developer untuk revisi ulang, jangan patch satu per satu
Template HTML rusak Mode Study/Exam/Drill tidak berfungsi, soal tidak ter-render, layout berantakan Kembalikan ke Developer โ€”ย ini masalah kode, bukan konten
Materi tidak sesuai task Task adalah CBT Gizi tapi isinya soal Fisiologi Saraf Kembalikan ke Developer untuk dibuat ulang sesuai deskripsi task
Soal tidak sesuai template yang diminta Task meminta Template Lecture tapi Developer mengumpulkan Template CBT Kembalikan ke Developer dengan catatan jenis template yang benar

B. Cara Mengeskalasi ke Developer

  1. Via Catatan Task di Admin Panel:
    • Buka task yang bersangkutan di Kanban Board → klik Add Note / Comment.
    • Tulis catatan spesifik tentang apa yang perlu diperbaiki dan alasannya.
    • Ubah status task kembali ke In Progress (atau biarkan di In Review dengan catatan) agar Developer tahu ada pekerjaan yang perlu direvisi.
  2. Via Chat ke Claude (MCP):
    • Minta Claude menambahkan catatan ke task: "Tambahkan catatan ke task [ID/nama task]: File perlu direvisi karena [alasan]. Mohon Developer mengerjakan ulang bagian [spesifikasi]."
    • Atau minta Claude mengubah status task kembali: "Set status task ini kembali ke In Progress dan tambahkan note bahwa perlu revisi ulang."
  3. Via Broadcast (Tab Team):
    • Gunakan fitur Broadcast di tab Team untuk mengirim pesan ke Developer yang bersangkutan jika perlu komunikasi langsung dan mendesak.

5. Alur Lengkap Review sampai Approve

LangkahAksi ReviewerStatus Task
1. Ambil Task untuk Direview Buka Kanban, cari task di kolom Developed → klik Claim Review (atau chat ke Claude: "claim review task ini") Developed → In Review
2. Baca & Periksa File HTML Buka file via tab Files (Live Preview) atau minta Claude membacakan isinya. Uji semua soal: kunci, pembahasan, referensi In Review
3a. Jika ada kesalahan minor Patch langsung via Claude Connector (Jalur A) In Review (tetap)
3b. Jika ada kesalahan mayor Tambah catatan & kembalikan ke Developer (Jalur B) In Review → In Progress
4. Approve Task Jika file sudah bersih: klik Approve (atau chat ke Claude: "approve task ini") In Review → Done
CHECKLIST SEBELUM APPROVE:
  • Semua kunci jawaban benar secara medis
  • Semua pembahasan menjelaskan mengapa benar dan mengapa opsi lain salah
  • Referensi sumber (src) sesuai dengan materi blok
  • File HTML berfungsi normal di browser (tidak ada error JS, mode Study/Exam/Drill bekerja)
  • Nama file sesuai konvensi penamaan blok