Draf untuk perbincangan · Bukan spesifikasi muktamad

Aliran Sistem IPITVET – PTPK

Bagaimana data penilaian bergerak dari institusi ke keputusan anugerah, apa yang berbeza daripada sistem sedia ada, dan enam keputusan yang masih menunggu jawapan PTPK.

SkopPTPK sahaja
Asasipitvet_v2
Tarikh10 Ogos 2026
StatusMenunggu pengesahan keperluan
Ringkasan

Tiga perubahan pada aliran

Sistem PTPK mewarisi keseluruhan aliran ipitvet_v2. Yang berubah hanya tiga perkara — tetapi ketiga-tiganya menyentuh bahagian yang berlainan dalam rantaian, jadi kesannya bukan kosmetik.

  • Rantaian semakan menjadi lebih pendek. Lapisan Kementerian digugurkan; PTPK mengambil kedudukan pelulus akhir.
  • Data boleh masuk melalui dua jalur. Selain diisi dalam sistem, data sedia ada boleh diimport.
  • Ada fasa baharu di hujung. Selepas indeks dikira, satu kitaran anugerah menilai dan menyusun kedudukan institusi.

Formula ROI, ROV dan Indeks Akhir tidak disentuh langsung. Sebabnya diterangkan di Fasa 4.

Rajah 01

Rantaian kelulusan: sedia ada berbanding PTPK

SISTEM SEKARANG · 3 LAPIS SEMAKAN Pengguna Institusi Pentadbir Institusi Kementerian Pentadbir Sistem Selesai dua peringkat ini bergabung SISTEM PTPK · 2 LAPIS SEMAKAN Pengguna Institusi Pentadbir Institusi PTPK Selesai
Rajah 01 Peranan Kementerian dan Pentadbir Sistem runtuh menjadi satu peringkat PTPK. Kesannya bukan sekadar satu menu hilang: setiap status MINISTRY_*, kebenaran semakan, dan laluan pemberitahuan e-mel yang bergantung pada entiti Kementerian perlu ditulis semula.

Satu perkara yang saya syorkan diputuskan di sini juga: adakah PTPK dan Pentadbir Sistem itu orang yang sama. Jika ya, satu akaun akan menguruskan pengguna, meluluskan data, dan menentukan pemenang anugerah sekali gus. Itu satu titik kegagalan audit pada sistem yang keputusannya melibatkan pengiktirafan rasmi.

Rajah 02

Aliran penuh, Fasa 0 hingga 5

FASA 0 Persediaan Institusi · orientasi teras · program · pengguna · bank soalan tambahan FASA 1 Buka pusingan penilaian Tarikh mula & tamat · pilih institusi · sistem jana satu rekod bagi setiap institusi FASA 2 Kemasukan data — dua jalur Jalur A — isi dalam sistem setiap nilai + lampiran bukti Jalur B — import daripada data sedia ada · baharu hantar untuk semakan FASA 3 Semakan dua lapis Pentadbir Institusi PTPK tolak — pulang kepada Pentadbir Institusi tolak diterima — rekod dikunci FASA 4 Pengiraan indeks ROI · ROV · Indeks Akhir — formula sedia ada, tidak diubah FASA 5 Kitaran anugerah · baharu Kategori · kriteria · skor & ranking · terbit dan bekukan keputusan
Rajah 02 Gelung merah ialah laluan pembetulan. Penolakan sentiasa pulang satu peringkat sahaja — PTPK menolak kepada Pentadbir Institusi, Pentadbir Institusi menolak kepada Pengguna Institusi di Fasa 2. Rekod hanya dikunci selepas PTPK menerima.
Fasa 0–1

Persediaan dan pembukaan pusingan

Fasa 0 · Persediaan

  • Daftar institusi di bawah seliaan PTPK, dan tetapkan orientasi teras setiap institusi (Industri atau Sosial). Pilihan ini menentukan set pemberat yang digunakan sepanjang pengiraan — ia bukan label.
  • Daftar program setiap institusi: tahap sijil, jenis TVET, dan sifat program.
  • Daftar pengguna: Pentadbir Institusi dan Pengguna Institusi.
  • Susun Bank Soalan Tambahan PTPK — soalan baharu di luar set asal.Baharu

Tiada lagi entiti Kementerian pada mana-mana skrin atau jadual.

Fasa 1 · Buka pusingan penilaian

  • PTPK mencipta satu pusingan: tajuk, tarikh mula, tarikh tamat.
  • Pilih institusi yang terlibat; sistem menjana satu rekod penilaian bagi setiap institusi.
  • Setiap rekod bermula pada status menunggu jawapan institusi.
Fasa 2 · Rajah 03

Jalur import, langkah demi langkah

Import bukan sekadar membaca fail Excel. Langkah yang menentukan ialah validasi sebelum menulis — data mentah masuk ke kawasan staging dahulu, dan hanya berpindah ke rekod sebenar selepas setiap baris lulus semakan.

KAWASAN STAGING · DATA SEBENAR BELUM DISENTUH 1 · Muat turun templat 2 · Muat naik fail institusi 3 · Validasi setiap baris 4 · Sahkan tulis ke rekod 5 · Masuk aliran kelulusan lulus ada ralat — laporan per baris, betulkan dan muat naik semula tidak melompat terus ke Selesai
Rajah 03 Templat mesti dijana bagi setiap institusi setiap pusingan — barisnya bergantung pada senarai program institusi itu. Templat generik akan gagal dipadankan, dan padanan program adalah tempat kebanyakan import gagal.

Perkara yang perlu diputuskan sebelum jalur ini boleh direka

  • Bukti. Setiap nilai dalam Jalur A wajib disertakan lampiran; fail Excel tidak membawa lampiran. Jika bukti digugurkan sepenuhnya untuk data import, semakan di Fasa 3 menjadi formaliti kosong.
  • Idempoten. Muat naik semula fail yang sama mesti mengemas kini, bukan menghasilkan pendua.
  • Tidak memintas kelulusan. Data import mesti melalui Fasa 3 yang sama. Jika tidak, data yang menjadi asas anugerah tidak boleh diaudit.
Fasa 4 · Rajah 04

Dua lapisan data, dua skor berasingan

PTPK mahu menambah struktur soalan, tetapi menyatakan ia tidak menyentuh pengiraan. Ini rekabentuk yang memenuhi kehendak itu dan membenarkan mereka berubah fikiran kemudian tanpa sistem ditulis semula.

DATA PENGIRAAN KELUARAN Lapisan 1 — Data Teras bintang · pemberat · nisbah guru:pelajar purata pendapatan · kadar pekerjaan beku — tidak boleh diubah admin Lapisan 2 — Soalan Tambahan bank soalan PTPK · dinamik setiap soalan bawa metadata skor, dimatikan secara lalai Formula IPITVET pemberat kajian · tidak diubah Enjin Skor Anugerah kriteria ditakrif oleh PTPK ROI · ROV · Indeks Akhir setara merentas sistem IPITVET Skor & Ranking Anugerah keputusan PTPK sendiri indeks menyumbang kepada skor anugerah tiada laluan ke formula
Rajah 04 Laluan yang tiada ialah bahagian terpenting rajah ini. Soalan tambahan memberi kesan kepada keputusan anugerah tanpa menyentuh indeks — jadi indeks kekal boleh dibandingkan merentas tahun dan merentas ketiga-tiga sistem IPITVET.

Kenapa formula tidak boleh sekadar ditambah

ROV (Industri) = Kelestarian × 21.1971 + Impak Ekonomi × 25.7341 + Kadar Pekerjaan × 25.9193 + Kadar Industri × 27.1495 ────────────────────────────────────── jumlah = 100.0000 Indeks Akhir = ROI × 0.47 + ROV × 0.53 (Industri) = ROI × 0.35 + ROV × 0.65 (Sosial)

Pemberat ini berpunca daripada satu kajian dan telah dinormalkan kepada 100. Menambah komponen kelima bermakna keempat-empat pemberat sedia ada menjadi tidak sah dan kesemuanya perlu diterbitkan semula serta disahkan semula oleh pihak kajian. Itu kerja metodologi, bukan kerja pengaturcaraan — kita tidak boleh menetapkan nombor baharu sendiri.

Sebab itu setiap soalan Lapisan 2 disimpan bersama metadata skornya sejak hari pertama — jenis skor, pemberat, arah, dan penanda dikira / tidak dikira yang lalainya mati. Hari PTPK memutuskan sesuatu soalan patut masuk pengiraan, ia menjadi perubahan tetapan dan versi formula baharu, bukan penulisan semula.

Satu keperluan yang wajib, tanpa mengira keputusan mereka

Setiap rekod penilaian perlu menyimpan versi formula dan pecahan pengiraan sebagai snapshot, bukan nombor akhir sahaja. Tanpa ini, sebarang perubahan formula pada masa hadapan akan menulis ganti keputusan tahun sebelumnya secara senyap apabila pengiraan semula dijalankan. Untuk sistem yang tujuannya membandingkan institusi merentas tahun bagi tujuan anugerah, kebolehbandingan itulah produknya.

Fasa 5

Kitaran anugerah

Kategori anugerah belum ditetapkan oleh PTPK. Itu bukan sebab untuk menunggu — ia sebab untuk membina fasa ini secara generik, supaya mereka boleh mentakrif kategori sendiri kemudian tanpa kod diubah.

  • Buka kitaran anugerah bagi satu pusingan atau satu tahun tertentu.
  • Takrif kategori, dan bagi setiap kategori takrif kriteria. Setiap kriteria menunjuk kepada satu sumber: Indeks Akhir, satu soalan Lapisan 2, atau markah manual juri.
  • Sistem mengira skor dan menyusun kedudukan institusi.
  • PTPK menyemak; juri menambah markah jika kategori itu memerlukannya.
  • Terbit — keputusan dibekukan sebagai snapshot. Jika data dibetulkan pada tahun berikutnya, senarai pemenang tahun ini tidak berubah sendiri.
Terbuka

Enam keputusan yang menunggu jawapan PTPK

Yang berikut mengubah bentuk aliran, bukan sekadar butiran skrin. Setiap satu perlu dijawab sebelum rekabentuk terperinci boleh dimulakan.

01

Siapa yang memasukkan data import — institusi sendiri, atau PTPK secara pukal untuk semua institusi?

Kesan pada aliran Ini soalan terbesar. Jika PTPK mengimport secara pukal, institusi mungkin tidak perlu masuk sistem langsung untuk mengisi data. Fasa 2 dan Fasa 3 runtuh menjadi hampir satu langkah, dan peranan Pengguna Institusi menjadi hampir kosong. Jawapannya menentukan sama ada kita membina sistem pengumpulan data atau sistem analisis data.

02

Apakah dasar bukti bagi data yang diimport?

Kesan pada aliran Fail Excel tidak membawa lampiran. Jika bukti dikecualikan, semakan Fasa 3 kehilangan asasnya dan data anugerah menjadi tidak boleh diaudit. Pilihan: muat naik bukti secara pukal, atau satu pengesahan bertulis oleh Pentadbir Institusi bagi setiap penghantaran.

03

PTPK ialah Pentadbir Sistem, atau peranan yang berasingan?

Kesan pada aliran Jika sama, satu akaun menguruskan pengguna, meluluskan data, dan menentukan pemenang. Memisahkan pentadbir sistem daripada pegawai penilai hampir tiada kos teknikal, tetapi menyelamatkan integriti proses anugerah.

04

Soalan tambahan — satu set tetap yang sudah diketahui, atau pembina soalan yang admin boleh tambah bila-bila masa?

Kesan pada aliran Set tetap boleh dibina sebagai medan biasa. Pembina soalan dinamik memerlukan bank soalan, penyimpanan jawapan generik, versi borang, dan paparan yang dijana — beza saiz kerja boleh mencapai tiga hingga empat kali ganda.

05

Anugerah dinilai berdasarkan satu pusingan, atau trend beberapa tahun?

Kesan pada aliran Jika trend, versi formula dan snapshot pengiraan menjadi wajib dari hari pertama, bukan sesuatu yang boleh ditambah kemudian. Data lama tidak boleh diperbaiki secara surut.

06

Institusi yang tidak menghantar sebelum tarikh tutup — dikecualikan daripada anugerah, atau dikira sifar?

Kesan pada aliran Sistem sekarang hanya membiarkan rekod itu kosong. Untuk tujuan anugerah, dua jawapan ini menghasilkan senarai pemenang yang berbeza.

Nota

Apa yang tidak berubah

  • Formula ROI, ROV dan Indeks Akhir, termasuk kesemua pemberat kajian.
  • Pembezaan antara orientasi teras Industri dan Sosial, yang menggunakan set pemberat berlainan.
  • Struktur data teras: institusi, program, dan jawapan per program.
  • Prinsip bahawa data hanya sah selepas melalui rantaian kelulusan sehingga hujung.

Dokumen ini menerangkan aliran yang dicadangkan, bukan yang telah dipersetujui. Jawapan kepada enam keputusan di atas akan mengubah beberapa bahagiannya.