Gambaran Keseluruhan Pengehosan Sendiri & Pelancaran

Aqiled ialah sistem maklumat sekolah (SIS) sumber terbuka yang bebas dan dibina untuk autonomi institusi pendidikan. Mana-mana sekolah, yayasan pendidikan, atau pembangun boleh meminta kod sumber, melancarkannya pada infrastruktur pelayan sendiri, dan mengekalkan hak milik penuh terhadap rekod pelajar.

Tersedia sekarang. Semakan terakhir: 26 Oktober 2026.

Seni Bina Sistem

Aqiled terdiri daripada tiga komponen utama:

1. API Bahagian Belakang (/back-end): Dibina menggunakan .NET 8/9/10 dan PostgreSQL 18. Mengendalikan logik perniagaan, pengesahan, keselamatan tahap baris (Row-Level Security), pemprosesan latar belakang Hangfire, dan hab masa nyata SignalR.
2. Aplikasi Utama (/front-end): Dibina menggunakan React, Vite, Tailwind CSS, dan TypeScript. Digunakan oleh guru, staf sekolah, pentadbir, murid, dan ibu bapa.
3. Portal Pentadbir Platform (/admin-portal): Digunakan secara eksklusif oleh pengendali platform dalam persekitaran berbilang penyewa (Multi-Tenant). Dinyahdayakan dalam pemasangan sekolah khusus (Single-School).

1. 1Perkakasan Pelayan & OS
2. 2PostgreSQL 18 dengan RLS
3. 3Perkhidmatan .NET API
4. 4Proksi Balikan Nginx/Caddy
5. 5Aplikasi Web React

Mod Pelancaran (Deployment Modes)

Aqiled menyokong dua mod operasi pelancaran:

• Mod Sekolah Khusus (Dedicated Single-School - Disyorkan untuk Sumber Terbuka):
  • Setiap sekolah beroperasi pada pelayan atau kontena berasingan yang tersendiri.
  • Menggunakan kelayakan pangkalan data khusus dan penanda identiti deploymentidentity yang terkunci.
  • Menyahdayakan fungsi superadmin platform, pendaftaran demo, dan penghalaan rentas sekolah.
  • Bahagian hadapan bersambung terus ke laluan /api pada hos yang sama.
• Mod Berbilang Penyewa (Multi-Tenant):
  • Satu pemasangan platform menguruskan pelbagai sekolah yang diasingkan melalui PostgreSQL Row-Level Security.

Pelan Panduan Pelancaran

Untuk memulakan pemasangan sistem anda, ikuti panduan mengikut turutan berikut:

1. Prasyarat Sistem & Pangkalan Data — Saiz perkakasan, keperluan PostgreSQL 18, dan konfigurasi peranan pangkalan data.
2. Pilih kaedah pelancaran anda:
   • Pelancaran Docker Compose — Pemasangan kontena pantas serba lengkap.
   • Pemasangan Bare-Metal & VPS Linux — Pemasangan terus pada Linux menggunakan systemd.
3. Penyediaan Sekolah & Mod Sekolah Khusus — Menjalankan arahan provision-school dan menetapkan identiti penyewa.
4. Proksi Balikan, SSL & WebSockets — Konfigurasi Nginx atau Caddy untuk SSL dan SignalR.
5. Penyelesaian Masalah Pelancaran & Operasi — Pemeriksaan kesediaan sistem (/health/ready) dan penyelesaian ralat umum.