Panduan SMIS Helper

Pendaftaran setiap kejohanan SMIS biasanya makan 2 sampai 3 jam:

• Daftar setiap peserta satu-satu
• Isi 10+ medan setiap orang
• Tetapkan acara, kategori, kelas
• Upload gambar, IC, sahsiah satu fail per peserta
• Muat turun M01/R01 berasingan

SMIS Helper menyelesaikan semua dalam satu klik.

Buka smis.davinhub.com, kemudian klik butang Pasang Percuma di Chrome. Halaman SMIS Helper di Chrome Web Store akan terbuka secara automatik.

Atau, klik pautan ini terus: Buka SMIS Helper di Chrome Web Store ↗

Di halaman SMIS Helper, klik butang biru Add to Chrome di sebelah kanan atas.

Satu dialog pengesahan akan muncul. Klik Add extension untuk siapkan pemasangan.

Klik ikon 🧩 puzzle di kanan atas Chrome untuk buka senarai extension.

Cari SMIS Helper dalam senarai, kemudian klik ikon 📌 pin di sebelahnya.

Selepas dipinkan, ikon SMIS Helper akan muncul terus di toolbar, anda boleh klik bila-bila masa untuk buka popup.

SMIS Helper hanya berfungsi di laman smis.events (tanda 1). Buka laman ini dahulu sebelum gunakan extension.

Klik ikon SMIS Helper di toolbar (tanda 2), popup akan muncul (tanda 3). Tetapi popup belum boleh digunakan sehingga anda log masuk ke smis.events.

Masukkan username dan password di kotak log masuk (tanda 4) untuk akses sistem.

Selepas log masuk, pergi ke halaman DAFTAR Peserta dalam smis.events, kemudian klik ikon SMIS Helper sekali lagi.

Pastikan bar status di atas popup berwarna hijau dan menunjukkan nama kejohanan anda (tanda 1), ini bermakna extension sudah dikesan dan sedia digunakan.

Anda ada dua pilihan:

• Jana template (tanda 2), extension akan baca tetapan kejohanan anda dan jana fail Excel yang dah disesuaikan untuk event tersebut, lengkap dengan dropdown Acara, Tahun, dan Kaum yang betul.
• Papar peserta sedia ada, kalau anda sudah daftar peserta sebelum ini, klik butang ini untuk extension ambil senarai peserta dari SMIS dan paparkan terus dengan acara serta maklumat mereka.

Buka fail Excel yang anda muat turun tadi. Anda akan nampak nama fail di atas adalah nama kejohanan anda (tanda 1).

Pastikan anda berada di sheet pertama, Maklumat Sekolah (tanda 2). Sheet ini turut menyenaraikan semua acara yang tersedia untuk kejohanan anda (tanda 3), sebagai rujukan semasa anda isi peserta nanti.

Bahagian paling penting ialah Kod Sekolah (tanda 4). Isi kod sekolah anda di sini, selepas anda upload semula template ini ke SMIS Helper, extension akan automatik ambil maklumat sekolah dari SMIS dan isikan semua sekali.

Pergi ke sheet kedua, Senarai Peserta (tanda 1). Di sinilah anda isi semua maklumat peserta.

Lajur dengan tanda * dan diserlahkan kuning adalah Wajib (tanda 2):

• Nama Penuh, seperti dalam Kad Pengenalan / MyKid
• No. KP / MyKid, 12 digit, tanpa sengkang
• Jantina, L (Lelaki) atau P (Perempuan)
• Acara, pilih dari dropdown

Lajur lain pun digalakkan diisi, terutama No. Peserta / Bib dan Tahun / Tingkatan. Walaupun tidak ditanda wajib, sesetengah kejohanan memerlukan maklumat ini untuk mematuhi peraturan, luangkan sedikit masa di sini supaya proses kemudian lebih lancar.

Jika anda tidak pasti tentang sesuatu format atau cara isi, pergi ke sheet ketiga, Panduan (tanda 1).

Sheet ini menyenaraikan langkah-demi-langkah cara isi template, plus NOTA PENTING tentang format yang sering jadi masalah:

• Format Tarikh, YYYY-MM-DD (contoh: 2010-05-15)
• Format No. KP / MyKid, 12 digit penuh, tanpa sengkang
• Nama Penuh, mesti sama persis dengan Kad Pengenalan / MyKid
• Acara, pilih dari dropdown; jika peserta sertai banyak acara, tambah baris baru dengan IC sama, atau pisahkan dengan koma (,)

Bonus: sheet ini juga ada rujukan ringkas semua 25 lajur template dan senarai penuh acara yang tersedia untuk kejohanan anda.

Berikut contoh bagaimana template anda sepatutnya kelihatan selepas selesai diisi:

• Maklumat Sekolah, Kod Sekolah sudah diisi (tanda 1).
• Senarai Peserta, semua lajur Wajib (Nama Penuh, No. KP, Jantina, Acara) sudah diisi untuk setiap peserta, dan lajur tambahan seperti Tahun dan Kaum turut dilengkapkan (tanda 2).

Buka popup SMIS Helper. Drag fail Excel yang anda telah isi tadi ke kawasan upload, atau klik untuk pilih fail.

Extension akan baca template, sahkan format data (No. KP 12 digit, lajur wajib lengkap), dan paparkan ringkasan peserta yang dikesan.

Pilih Negeri dan PPD dari dropdown, info ini tidak ada dari API sekolah, jadi anda perlu pilih sekali.

Klik Tambah + Kemaskini Peserta. Untuk setiap peserta, extension automatik:

1. Tambah peserta baru ke SMIS
2. Isi semua maklumat (alamat, sekolah, dll.)
3. Tetapkan acara dan kategori
4. Sahkan dengan SMIS

Status setiap peserta dipaparkan secara langsung dalam log popup.

Selepas semua peserta berdaftar, anda perlu muat naik gambar peserta. Kumpul semua foto dalam satu folder di komputer.

Cara nama fail: nama fail boleh terus pakai nama atau No. KP peserta. Format tidak ketat, contoh:

• 120104134831.jpg, IC 12-digit (paling tepat)
• davinwong.jpg, nama tanpa ruang juga dikesan
• aiman_haziq_zulkarnain.jpg, nama penuh dengan underscore
• chong.jpg, nama pertama sahaja (jika unik)

Jika ada peserta sama nama, guna nama yang lebih panjang atau guna IC supaya extension dapat bezakan.

Buka popup, klik kawasan upload Muat Naik Gambar. Drag semua foto sekali gus, atau klik untuk pilih daripada Finder/Explorer.

Extension akan padankan setiap foto dengan peserta secara automatik dan paparkan preview. Klik Sahkan dan Upload selepas semak preview.

Selepas semua peserta dan dokumen disiapkan, anda perlu muat turun borang M01 (lelaki) atau R01 (perempuan). Borang ini perlu ditandatangan oleh pengetua dan dihantar kembali kepada urusetia kejohanan.

Dalam popup, klik Muat Turun M01/R01. Extension akan iterate setiap peserta dan simpan setiap PDF ke folder Downloads anda.

Untuk 30 peserta, proses ambil ~1-2 minit (bergantung pada kelajuan SMIS). Setiap fail dinamakan dengan IC peserta supaya mudah dicari kemudian.

Sedia Dokumen adalah halaman penuh (bukan popup) untuk dokumen pukal. Buka dengan klik butang Sedia Dokumen di popup, tab baru akan dibuka.

Berbeza dari muat naik gambar di popup (Bahagian 3.8), Sedia Dokumen menambahkan:

• OCR engine, baca teks dalam imej / PDF, auto-padan kepada peserta tanpa perlu nama fail tepat
• Crop interaktif, potong gambar 4:3 dengan drag corners
• Palang batch, lukis watermark “Kegunaan Sukan” pada setiap halaman PDF dalam beberapa saat
• Auto-save, tutup tab, buka semula, sambung daripada tempat anda berhenti

Guna Sedia Dokumen apabila anda ada banyak peserta (10+), atau dokumen scan masih dalam PDF tunggal yang besar (semua IC dalam satu fail).

Buka tab Gambar. Drag fail foto atau klik untuk pilih dari folder.

Extension auto-padan setiap foto kepada peserta berdasarkan nama fail (sama seperti popup di Bahagian 3.8).

Untuk setiap foto, anda boleh:

• Crop, drag corners untuk potong nisbah 4:3 (saiz piawai SMIS)
• Adjust posisi, drag foto dalam kotak crop untuk pilih bahagian yang dipaparkan
• Drag ke peserta lain, jika padanan automatik salah

Klik Upload Gambar setelah semua siap. Progress bar paparkan status setiap foto.

Buka tab Pengenalan Diri. Tab ini untuk salinan IC, MyKid, atau Sijil Lahir.

Cara cepat: gunakan scanner sekolah atau aplikasi telefon (Adobe Scan, Notes, dsb.) untuk scan semua IC dalam satu PDF. Drag PDF tersebut ke kawasan upload.

Extension akan jalankan OCR (Tesseract.js) pada setiap halaman:

1. Cari nombor IC 12-digit dalam imej
2. Padankan kepada peserta dalam senarai
3. Jika gagal IC, fallback kepada nama (case-insensitive)

OCR ambil masa ~5-10 saat per halaman pada kali pertama (engine perlu load). Selepas semua halaman selesai, panel review paparkan semua padanan.

Jika scan kabur dan OCR tidak dapat baca, drag fail manual ke peserta yang betul.

Klik Upload Pengenalan Diri apabila semua disahkan.

Buka tab Pengesahan. Tab ini untuk M01/R01 yang sudah ditandatangan oleh pengetua.

Workflow sama dengan tab Pengenalan Diri (drop PDF / imej, OCR auto-padan), dengan satu tambahan:

Palang “Kegunaan Sukan”, pilih checkbox di bawah review panel. Extension akan lukis watermark merah pada setiap halaman PDF, automatik. Anda tidak perlu tulis tangan satu-satu.

Preview palang dipaparkan dalam thumbnail setiap fail sebelum upload. Edit teks palang jika perlu (default: “KEGUNAAN SUKAN SAHAJA”).

Klik Upload Pengesahan untuk batch upload ke SMIS.

Sedia Dokumen menyimpan semua progress secara automatik dalam pelayar (IndexedDB). Tab boleh ditutup tanpa kehilangan apa-apa.

Untuk sambung:

1. Buka popup, klik Sedia Dokumen
2. Halaman utama paparkan sesi yang ada (dengan stats: jumlah peserta, fail dimuat naik, dll.)
3. Klik Sambung untuk teruskan
4. Atau klik + Mulakan Sesi Baru untuk reset

Sesi dikaitkan dengan kejohanan SMIS, jika anda tukar event, halaman utama akan paparkan sesi yang berbeza.

Selepas semua tab (Gambar, Pengenalan Diri, Pengesahan) telah upload, peserta anda sepatutnya:

• Berdaftar di SMIS dengan acara yang ditetapkan
• Maklumat lengkap (alamat, sekolah, dll.)
• Foto pas 4:3 dimuat naik
• Salinan IC / MyKid dimuat naik
• M01/R01 yang disahkan dimuat naik dengan palang

Buka semula laman SMIS dalam tab lain untuk semak setiap peserta. Setiap satu sepatutnya kelihatan lengkap dengan ikon kamera, ID, dan dokumen.

Jika ada peserta yang gagal dimuat naik, kembali ke tab yang berkenaan dan re-try (tidak perlu mula semula).