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 aplikasi di aras utama ZIP: muat naik ke Cloudflare Pages seperti biasa.
sokongan/pelayan-v57/: kod Cloudflare Worker, D1, R2 dan Bilik Bersama.sokongan/pelayan-v57/schema.sql: jadual akaun, kelas, murid, koleksi, rekod bacaan dan draf NILAM.sokongan/pelayan-v57/setup-config.mjs: pembantu mengisi tetapan awam pelayan.CONTOH_SENARAI_MURID.csv: contoh import nama murid.CATATAN_V57.md: perubahan dan batas pengujian.
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
- Cipta projek dalam akaun Supabase anda. Bahagian ini menggunakan Auth sahaja; bahan dan data aplikasi disimpan di Cloudflare.
- Dalam tetapan Auth, aktifkan log masuk e-mel/kata laluan dan pengesahan e-mel. Pendaftaran guru baharu perlu dibenarkan.
- 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. - Sediakan custom SMTP untuk penghantaran pengesahan dan pemulihan kata laluan kepada guru lain. SMTP lalai Supabase terhad dan tidak sesuai untuk pendaftaran umum guru.
- Simpan Project URL dan publishable key / anon public key. Jangan gunakan
service_roleatau 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-materialsSalin 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.mjsPembantu 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 deployMasukkan 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:
| Tetapan | Kegunaan |
|---|---|
ALLOWED_ORIGINS | URL Pages yang dibenarkan, dipisahkan koma |
ADMIN_EMAIL | izzat310504@gmail.com |
SUPABASE_URL | Project URL Supabase Auth |
SUPABASE_ANON_KEY | Publishable / anon public key, melalui arahan secret |
DB | Binding D1 kepada pangkalan data Pustaka |
MEDIA | Binding kepada bucket R2 private |
ROOMS | Binding Durable Object GalleryRoom |
5. Muat naik aplikasi Pages
- Tamatkan bilik lama sebelum menukar frontend dan Worker kepada v57.
- Jika URL Worker berubah, ubah nilai
teacherServerdalamdeployment.jsondi aras utama ZIP. Gunakan URL asas HTTPS Worker, tanpa laluan tambahan. - Muat naik fail aplikasi ke Cloudflare Pages.
index.htmlmesti berada di aras utama folder yang dimuat naik. - Pastikan URL Pages sepadan dengan
ALLOWED_ORIGINSdan URL pengesahan/pemulihan Supabase. - 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
- Akaun guru baharu bermula dengan koleksi buku kosong. Tekan Salin bahan contoh untuk menyalin buku asal ZIP ke akaun, atau tambah bahan sendiri.
- Buku, video Jendela Ilmu, permainan, Laman Hikayat, poster, muzik dan bahan persembahan boleh diurus dalam panel sedia ada.
- Seret fail ke ruang muat naik atau tekan untuk memilih fail. Draf dan fail dihantar kepada akaun secara automatik. Tunggu tanda Disimpan dalam akaun guru sebelum menutup panel.
- Fail besar dihantar dalam bahagian 10 MB. Had asal kekal: Jendela Ilmu 100 MB; Laman Hikayat 200 MB; video buku beraudio 300 MB; LED 30 MB; gambar/audio/PDF lazimnya 20 MB. Had dipaparkan pada ruang masing-masing.
- Draf belum lengkap disimpan tetapi belum muncul sebagai buku murid. Bahan draf tidak boleh dibaca melalui sesi murid.
- Guru boleh membuang buku dan bahan daripada koleksi sendiri. Bilik Bersama yang sedang berjalan menggunakan salinan koleksi ketika bilik dicipta; cipta bilik baharu untuk menggunakan perubahan terbaru.
- Jika dua tab/peranti menyimpan koleksi sama serentak, pelayan menolak simpanan daripada salinan yang sudah lapuk. Muat semula koleksi terkini sebelum menyambung. Simpan salinan ZIP jika perlu sebelum menggantikan kerja setempat.
- Eksport/import ZIP masih disediakan sebagai sandaran. Import koleksi menggantikan koleksi akaun yang sedang log masuk, selepas pengesahan. Ia tidak mengimport akaun, kata laluan atau senarai murid.
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
- Guru membuka Kelas Saya, menambah nama kelas dan senarai murid.
- Taip satu nama setiap baris, atau import CSV/TXT. CSV boleh mempunyai lajur
NamadanKelas. Jika lajur Kelas diisi, baris yang sepadan dengan kelas terpilih digunakan. Semak nama dan tekan Tambah nama. - Maksimum 200 nama setiap import. Nama boleh dikemas kini atau diarkibkan. Rekod murid yang diarkibkan dikekalkan.
- Kongsi kod kelas untuk pembelajaran sendiri. Kod ini kekal sehingga guru menukarnya atau mengarkibkan kelas.
- 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.
- Murid memasukkan kod → memilih kelas → memilih nama → memilih dan menggayakan karakter. Nama/kelas daripada senarai dikunci semasa menggayakan karakter.
- 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
- Guru boleh menggunakan mic tanpa had kawasan selepas menyertai bilik.
- Mic murid ditutup ketika menunggu. Selepas Mula, mic boleh dibuka di luar pustaka dan dalam Bulatan Bicara dalaman. Di dewan, mic murid hanya mengikut giliran pentas; kawalan khas guru boleh memberi atau menyekat kebenaran.
- Lingkaran biru samar tanpa label turut ditambah di kawasan bangku/air pancut di taman. Kawasan luar kekal menyokong suara berhampiran.
- Guru boleh mengawal mic/speaker ahli, chat, giliran pentas dan penutupan bilik.
- Permintaan audio lama tidak boleh aktif semula selepas keluar bilik. Sesi ditolak dibersihkan, dan sambungan semula berhenti jika bilik telah ditutup.
- Pelayar memerlukan HTTPS dan kebenaran mic. Klik ikon speaker untuk membenarkan/mencuba semula suara jika perlu. WebRTC sebenar perlu diuji dengan dua peranti.
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 deployGunakan 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
- Daftar/sahkan e-mel pentadbir, kemudian daftar satu guru lain dan luluskan melalui panel.
- Tambah buku berbeza dalam dua akaun. Pastikan akaun kedua tidak melihat bahan/kelas akaun pertama.
- Tambah kelas/nama, cuba kod kelas dari peranti murid dan semak pilih nama sebelum karakter.
- Cipta Bilik Bersama, sertai dari dua peranti, tekan Mula dan uji mic, kawalan guru, giliran pentas serta penutupan sesi.
- Tamatkan bacaan, tulis rumusan, semak draf muncul di Bacaan & NILAM. Uji Salin/Buka AINS secara berasingan.
- Log keluar dan log masuk semula; pastikan draf, bahan dan rekod profil berkod masih ada.
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.