Pustaka Citra Bahasa · v57Panduan akaun guru, kelas, bahan dan rekod NILAM

Pustaka Citra Bahasa v57

Versi ini mengandungi paparan baharu, pembetulan mic dan Bilik Bersama, akaun guru berasingan, pentadbir, senarai kelas/murid, simpanan awan dan penyediaan rekod NILAM untuk dipindahkan ke AINS.

Baca dahulu: ZIP mengandungi kod aplikasi dan pelayan. Akaun e-mel serta simpanan awan memerlukan pemasangan di bawah pada akaun Cloudflare dan Supabase milik anda. ZIP ini belum mewujudkan projek, menghantar e-mel atau mencipta kata laluan sebenar. E-mel pentadbir utama telah ditetapkan kepada izzat310504@gmail.com.

1. Fail yang digunakan

Fail sokongan pelayan lama dikekalkan untuk rujukan. Untuk akaun e-mel dan simpanan berasingan, gunakan pelayan-v57, bukan pelayan v50.

2. Sediakan pengesahan e-mel Supabase

  1. Cipta projek dalam akaun Supabase anda. Bahagian ini menggunakan Auth sahaja; bahan dan data aplikasi disimpan di Cloudflare.
  2. Dalam tetapan Auth, aktifkan log masuk e-mel/kata laluan dan pengesahan e-mel. Pendaftaran guru baharu perlu dibenarkan.
  3. Tetapkan Site URL kepada URL utama Pages anda, contohnya https://nama-aplikasi.pages.dev/. Masukkan URL yang sama dalam senarai Redirect URLs. Jika aplikasi berada dalam subfolder, masukkan URL subfolder yang tepat.
  4. Sediakan custom SMTP untuk penghantaran pengesahan dan pemulihan kata laluan kepada guru lain. SMTP lalai Supabase terhad dan tidak sesuai untuk pendaftaran umum guru.
  5. Simpan Project URL dan publishable key / anon public key. Jangan gunakan service_role atau secret key sebagai kunci awam aplikasi.

Panduan rasmi SMTP: https://supabase.com/docs/guides/auth/auth-smtp

3. Cipta D1 dan R2 di Cloudflare

Pasang Node.js LTS pada komputer anda. Buka terminal dalam folder sokongan/pelayan-v57.

npx wrangler@4 login
npx wrangler@4 d1 create pustaka-citra-bahasa
npx wrangler@4 r2 bucket create pustaka-citra-bahasa-materials

Salin database_id daripada output D1. Bucket R2 ini kekal private; akses bahan melalui Worker mengikut akaun dan profil murid. Jangan aktifkan pautan public bucket.

Jika nama sumber tersebut sudah wujud dalam akaun anda dan memang untuk Pustaka ini, gunakan sumber itu. Jangan menggantikan D1 atau R2 aplikasi lain.

4. Isi tetapan pelayan

Jalankan:

node setup-config.mjs

Pembantu meminta nama Worker, URL Pages, nama dan ID D1, bucket R2, Project URL Supabase serta e-mel pentadbir. Ia tidak meminta kata laluan akaun atau rahsia SMTP.

Untuk kemas kini pelayan Bilik Bersama sedia ada, kekalkan nama Worker galeri-bilik-bersama jika itulah nama pelayan anda. GalleryRoom dan tag migrasi Durable Object v1 dikekalkan. ID D1 sifar dalam fail contoh mesti diganti dengan ID sebenar.

Kemudian jalankan:

npx wrangler@4 d1 execute pustaka-citra-bahasa --remote --file=schema.sql
npx wrangler@4 secret put SUPABASE_ANON_KEY
npx wrangler@4 deploy

Masukkan publishable key / anon public key apabila arahan secret memintanya. Ia digunakan untuk menghubungi Supabase Auth dan memang kunci awam. Jangan masukkan kunci service_role.

schema.sql boleh dijalankan semula kerana menggunakan CREATE TABLE IF NOT EXISTS. Nama D1 dalam arahan perlu sama dengan nama yang anda isi. Arahan deploy memerlukan tetapan D1/R2 yang sebenar.

Tetapan yang diperlukan:

TetapanKegunaan
ALLOWED_ORIGINSURL Pages yang dibenarkan, dipisahkan koma
ADMIN_EMAILizzat310504@gmail.com
SUPABASE_URLProject URL Supabase Auth
SUPABASE_ANON_KEYPublishable / anon public key, melalui arahan secret
DBBinding D1 kepada pangkalan data Pustaka
MEDIABinding kepada bucket R2 private
ROOMSBinding Durable Object GalleryRoom

5. Muat naik aplikasi Pages

  1. Tamatkan bilik lama sebelum menukar frontend dan Worker kepada v57.
  2. Jika URL Worker berubah, ubah nilai teacherServer dalam deployment.json di aras utama ZIP. Gunakan URL asas HTTPS Worker, tanpa laluan tambahan.
  3. Muat naik fail aplikasi ke Cloudflare Pages. index.html mesti berada di aras utama folder yang dimuat naik.
  4. Pastikan URL Pages sepadan dengan ALLOWED_ORIGINS dan URL pengesahan/pemulihan Supabase.
  5. Buka Pages. Tekan Log Masuk → Guru → Daftar akaun.

Kod aplikasi boleh dijalankan sebagai laman statik. Sebelum pelayan v57 disediakan, mod Teroka Sendiri menggunakan koleksi dalam ZIP. Pelayan lama masih boleh digunakan melalui pilihan Kunci guru lama; fungsi akaun berasingan tidak aktif dalam mod itu.

6. Aktifkan pentadbir dan guru

Pentadbir utama

Daftar menggunakan izzat310504@gmail.com, cipta kata laluan sendiri dan sahkan pautan e-mel. Selepas log masuk, pelayan mengenal pasti e-mel yang telah disahkan ini sebagai pentadbir. Akaun dan kata laluan belum dibuat oleh ZIP.

Guru lain

Guru mendaftar menggunakan e-mel sendiri, mengesahkan e-mel dan log masuk. Akaun guru akan menunggu kelulusan. Pentadbir membuka Panel Guru → Pentadbir → Luluskan / Aktifkan.

Setiap guru mempunyai koleksi, muat naik, kelas, senarai nama dan rekod murid masing-masing. Guru lain tidak boleh membaca atau menyunting koleksi tersebut melalui API. Pentadbir mengurus status akaun; paparan ini tidak membuka bahan peribadi semua guru secara automatik.

Apabila akaun guru dinyahaktifkan, akses awan ditutup, sesi murid dibatalkan dan Bilik Bersama guru itu ditutup. Data dikekalkan supaya akaun boleh diaktifkan semula.

Apabila guru keluar dari Panel Guru ke muka depan, sesi log masuk ditamatkan. Guru perlu log masuk semula untuk mengurus bahan. Pemulihan selepas refresh Bilik Bersama memerlukan pengesahan pelayan dahulu.

7. Bahan dan simpanan automatik

Bahan v56 dalam ZIP asal dikekalkan. Untuk membawa bahan yang hanya berada dalam pelayar lama, eksport ZIP daripada versi lama dahulu, kemudian import melalui Simpanan & Penerbitan selepas log masuk akaun v57.

8. Kelas dan pilihan nama murid

  1. Guru membuka Kelas Saya, menambah nama kelas dan senarai murid.
  2. Taip satu nama setiap baris, atau import CSV/TXT. CSV boleh mempunyai lajur Nama dan Kelas. Jika lajur Kelas diisi, baris yang sepadan dengan kelas terpilih digunakan. Semak nama dan tekan Tambah nama.
  3. Maksimum 200 nama setiap import. Nama boleh dikemas kini atau diarkibkan. Rekod murid yang diarkibkan dikekalkan.
  4. Kongsi kod kelas untuk pembelajaran sendiri. Kod ini kekal sehingga guru menukarnya atau mengarkibkan kelas.
  5. Untuk sesi serentak, gunakan Cipta Kod Kelas pada bahagian Bilik Bersama di bawah senarai kelas. Kod bilik ini berbeza daripada kod kelas kekal dan tamat selepas empat jam atau apabila guru menamatkannya.
  6. Murid memasukkan kod → memilih kelas → memilih nama → memilih dan menggayakan karakter. Nama/kelas daripada senarai dikunci semasa menggayakan karakter.
  7. Dalam Bilik Bersama, murid menunggu sehingga guru menekan Mula. Untuk kod kelas pembelajaran sendiri, murid terus meneroka selepas menyiapkan karakter.

Murid tidak memerlukan e-mel. Pilihan nama ialah aliran kelas berdasarkan kod yang dikongsi guru; murid perlu memilih nama sendiri. Guru boleh menukar kod dan mengarkibkan profil untuk menutup akses baharu.

9. Bacaan, medal dan AINS

Pilihan empat bahasa dikekalkan. Fiksi hanya Buku Bacaan tanpa audio. Bukan Fiksi boleh berbentuk Buku Bacaan atau Buku Beraudio.

Guru boleh menambah penerbit, tahun terbit, ISBN dan bilangan halaman dalam maklumat tambahan buku. Selepas murid menamatkan bacaan, aplikasi membuka Sediakan Rekod NILAM. Ia juga boleh dibuka daripada menu Rekod NILAM Saya atau kawalan pembaca.

Maklumat buku diisi untuk membantu murid. Murid menulis rumusan dan pengajaran sendiri. Draf disimpan pada profil murid berkod; mod Teroka Sendiri menyimpan pada peranti. Murid boleh menyalin maklumat, memuat turun teks dan membuka https://ains.moe.gov.my/ untuk log masuk DELIMa serta memindahkan rekod.

Tiada penghantaran automatik atau pengesahan rasmi AINS dalam aplikasi ini. Kotak “Saya telah merekodkan bacaan ini dalam AINS” ialah pengakuan sendiri. Guru menyemak/pengesahan rasmi melalui AINS. Medan di sini ialah draf bibliografi, bukan dakwaan bahawa semua medan sepadan tepat dengan borang AINS semasa.

Panel Bacaan & NILAM menunjukkan bilangan buku, persembahan dan draf murid milik guru tersebut. Tiga medal di tengah bar atas mempunyai rupa berbeza, kelabu sebelum misi selesai dan berwarna selepas selesai. Halakan tetikus atau ketik untuk deskripsi.

10. Mic dan Bulatan Bicara

Untuk rangkaian yang memerlukan relay, tetapkan TURN pada Worker dan cipta bilik baharu:

npx wrangler@4 secret put TURN_URLS
npx wrangler@4 secret put TURN_SHARED_SECRET
npx wrangler@4 deploy

Gunakan alamat TURN dan shared secret daripada pelayan/penyedia TURN anda. Alternatif kelayakan khusus: TURN_USERNAME bersama TURN_CREDENTIAL. ZIP tidak menyediakan pelayan TURN atau akaun penyedia secara automatik.

11. Semakan selepas pemasangan

Ujian kod dan pengasingan akaun telah dijalankan dengan Auth/R2/peranti audio simulasi serta pertanyaan SQLite sebenar. Paparan desktop dan telefon disemak dalam pelayar. Penghantaran e-mel sebenar, projek Cloudflare/Supabase anda, WebRTC dua peranti dan proses akaun DELIMa/AINS masih perlu diuji selepas pemasangan.

Rujukan teknikal rasmi