Aplikasi akademik kampus: KRS, perkuliahan (jadwal, materi, tugas, quiz), presensi, ujian, nilai & remidi, ujian susulan, tugas akhir & wisuda, cuti, dan keuangan. Dibangun dengan Laravel 12 + Inertia + Vue 3.
Satu kode dipakai banyak kampus (klien). Perbedaan antarklien diatur lewat feature flag dan pengaturan di aplikasi, bukan lewat cabang kode.
Dokumentasi lain:
- docs/system-flow.md — alur proses bisnis per fitur.
- docs/standar-ui.md — standar tampilan yang wajib diikuti halaman baru.
- CHANGELOG.md — riwayat perubahan.
Isi README:
- Kebutuhan
- Feature flag per klien
- Panel developer
- Contoh
.envdua klien - Onboarding klien baru
- Alur pemakaian dari awal
- Pengembangan
- PHP 8.2+ dengan ekstensi
pdo_mysql,mbstring,dom,gd,intl,fileinfo. - MySQL 8 / MariaDB 10.6+ (beberapa migrasi memakai
ALTER ... MODIFYkhusus MySQL; SQLite hanya untuk tes). - Node.js 20+ untuk build aset.
- Composer 2.
Fitur yang bisa berbeda antarklien terdaftar di config/client.php dan dibaca lewat
App\Feature::aktif('nama').
| Flag | Env | Bawaan | Nyala | Mati |
|---|---|---|---|---|
kelola_role |
FEATURE_KELOLA_ROLE, LOCK_KELOLA_ROLE |
mati | Admin bisa menambah dan menghapus role di menu Kelola Role. | Menu Kelola Role tetap ada: admin bisa melihat role dan mengubah nama/hak aksesnya, tetapi tombol Tambah dan Hapus disembunyikan dan rutenya 404. Role baru disusun developer di panel /dev/roles; admin tetap bisa memberi role itu ke user. |
keuangan |
FEATURE_KEUANGAN, LOCK_KEUANGAN |
mati | Jenis biaya, tagihan semester/remidi/susulan, bukti bayar, Info Biaya Kuliah, kunci KRS sampai lunas. | Menu tagihan & info biaya disembunyikan (404), KRS tidak dikunci tagihan, remidi dan ujian susulan gratis. Bukti bayar cuti/pendadaran/wisuda tetap wajib. |
| materi | FEATURE_MATERI, LOCK_MATERI | nyala | Materi per kelas untuk admin, dosen, dan mahasiswa. | Menu, bagian di halaman kelas, berkas, dan rutenya 404. |
| tugas | FEATURE_TUGAS, LOCK_TUGAS | nyala | Tugas per kelas, pengumpulan, dan penilaiannya. | Seperti materi; Beranda tanpa tugas bertenggat dan tanpa pengumpulan yang perlu dinilai. |
| quiz | FEATURE_QUIZ, LOCK_QUIZ | nyala | Quiz per kelas. | Quiz kelas 404. Lembar soal ujian online tetap jalan bila ujian_online nyala (middleware fitur.quiz). |
| ujian_online | FEATURE_UJIAN_ONLINE, LOCK_UJIAN_ONLINE | nyala | Mode ujian unggah berkas dan soal di sistem. | Semua ujian (UTS/UAS/remidi/susulan) tatap muka: pilihan mode disembunyikan dan ditolak server, rute soal/jawaban online 404. |
| presensi_qr | FEATURE_PRESENSI_QR, LOCK_PRESENSI_QR | nyala | Presensi mandiri mahasiswa lewat QR/PIN. | Presensi hanya dicatat manual oleh dosen/admin; tombol dan rute QR/PIN 404. |
| pindah_kelas | FEATURE_PINDAH_KELAS, LOCK_PINDAH_KELAS | nyala | Pengajuan pindah kelas paralel dan persetujuannya. | Menu, pengaturan, dan rutenya 404. Admin tetap bisa membuka kunci KRS dari detail mahasiswa. |
| ujian_susulan | FEATURE_UJIAN_SUSULAN, LOCK_UJIAN_SUSULAN | nyala | Pengajuan susulan UTS/UAS, jadwal, dan tagihannya. | Menu, pengaturan, dan rutenya 404; jenis susulan tidak bisa dijadwalkan; finalisasi nilai tidak menunggu susulan. |
Bawaan materi s.d. ujian_susulan sengaja nyala karena fiturnya sudah lama ada: instalasi yang tidak
mengisi .env-nya tidak berubah. Presensi manual dan remidi bukan flag: selalu ada di semua klien.
- Nama tidak terdaftar di
config/client.php→ mati. LOCK_*=true→ ikutFEATURE_*di.env. Override database diabaikan dan tidak bisa disimpan.- Ada override di tabel
pengaturan_fitur(diatur developer di/dev/fitur) → ikut override. - Selain itu → ikut
FEATURE_*di.env.
Fitur yang punya butuh ikut mati bila salah satu dependensinya mati. Override dibaca dengan satu query dan
di-cache (kunci fitur.override); cache dibuang otomatis setiap kali override diubah.
Pakai LOCK_*=true untuk fitur yang sudah dipastikan di kontrak klien, supaya tidak bisa diubah dari panel.
- Daftarkan di
config/client.php(label,keterangan,default,locked,butuh). - Tambahkan
FEATURE_<NAMA>=<bawaan>danLOCK_<NAMA>=falseke.env.example(dicek olehFeatureFlagTest; fitur baru bawaanfalse, fitur lama yang dijadikan flagtruedan didaftarkan diFITUR_BAWAAN_NYALAtes itu). - Pasang di kode: middleware rute
fitur:<nama>, kuncifiturdi menuAppSidebar.vue,useFitur().aktif('<nama>')di Vue,Feature::aktif('<nama>')di PHP. Izin menu milik fitur didaftarkan diPermissionCatalog::FITURagar disembunyikan dari role selama fitur mati. - Tambahkan nama ke tipe
fiturdiresources/js/types/index.ts. - Tulis tes keadaan mati (lihat
KeuanganMatiTest,KelolaRoleMatiTest).tests/TestCase.phpmenyalakan fitur lama untuk tes yang sudah ada.
Panel /dev hanya terdaftar bila DEV_PANEL=true, dan hanya bisa dibuka akun ber-role developer
(disertai konfirmasi kata sandi).
- Fitur Klien (
/dev/fitur): toggle tiap flag, tombol Ikuti bawaan untuk menghapus override, dan riwayat perubahan (tabellog_pengaturan_fitur). Flag terkunci tampil disabled dan ditolak 403. Perubahan yang melanggar dependensi ditolak. - Kelola Role (
/dev/roles): menyusun role dan hak aksesnya, termasuk tambah dan hapus. Selalu tersedia untuk developer, terlepas dari flagkelola_role.
Role developer tidak pernah muncul di aplikasi dan hanya diberikan lewat perintah:
php artisan sia:developer <username> # jadikan akun admin/karyawan sebagai developer
php artisan sia:developer <username> --cabut # kembalikan ke role AdminRute /dev dibaca saat aplikasi boot. Setelah mengubah DEV_PANEL di server yang memakai cache, jalankan
php artisan config:cache && php artisan route:cache (atau optimize:clear).
Hanya bagian yang berbeda antarklien; sisanya ikut .env.example.
Klien A — kampus swasta dengan pembayaran lewat sistem. Keuangan dipastikan nyala dan dikunci; role diatur developer.
APP_NAME="SIA Kampus A"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://sia.kampus-a.ac.id
APP_TIMEZONE=Asia/Jakarta
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=sia_kampus_a
DB_USERNAME=sia_kampus_a
DB_PASSWORD=ganti-dengan-sandi-kuat
FEATURE_KELOLA_ROLE=false
LOCK_KELOLA_ROLE=true
FEATURE_KEUANGAN=true
LOCK_KEUANGAN=true
DEV_PANEL=falseKlien B — kampus yang pembayarannya masih di luar sistem. Keuangan mati tetapi tidak dikunci, supaya developer bisa menyalakannya dari panel setelah klien siap; panel developer dibuka.
APP_NAME="SIA Kampus B"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://akademik.kampus-b.ac.id
APP_TIMEZONE=Asia/Makassar
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=sia_kampus_b
DB_USERNAME=sia_kampus_b
DB_PASSWORD=ganti-dengan-sandi-kuat
FEATURE_KELOLA_ROLE=false
LOCK_KELOLA_ROLE=false
FEATURE_KEUANGAN=false
LOCK_KEUANGAN=false
DEV_PANEL=trueZona waktu yang tampil ke pengguna diatur lagi per institusi di Pengaturan Sistem → Institusi.
-
Ambil kode dan pasang dependensi
git clone https://github.com/Velocity-Developer/sia-vd.git sia-klien && cd sia-klien composer install --no-dev --optimize-autoloader npm ci && npm run build
-
Siapkan
.env: salin.env.example, isi database,APP_URL,APP_ENV=production,APP_DEBUG=false, lalu tentukan flag sesuai kontrak klien (lihat contoh di atas).cp .env.example .env php artisan key:generate
-
Database dan data dasar
php artisan migrate --force php artisan db:seed --force # di production hanya menyinkronkan izin + role bawaan (Admin, Dosen, Mahasiswa) php artisan storage:link # logo institusi dan gambar tampilan
Jangan jalankan
DemoSeederdi server klien: seeder itu menghapus data akademik untuk diganti data demo. -
Akun admin pertama (production tidak punya akun bawaan):
php artisan tinker
$u = App\Models\User::create([ 'name' => 'Admin Kampus', 'username' => 'admin', 'email' => 'admin@kampus.ac.id', 'password' => 'ganti-sandi-awal', 'role_id' => App\Models\Role::system(App\UserType::Admin)->id, ]); $u->forceFill(['email_verified_at' => now()])->save(); $u->adminProfile()->create(['nomor_induk' => 'ADM-001']);
-
Akun developer (bila panel dipakai): buat akun admin/karyawan dengan cara yang sama, lalu
php artisan sia:developer <username>dan pastikanDEV_PANEL=true. -
Layanan dan cache
- Jalankan worker antrean (
QUEUE_CONNECTION=database), misalnya sebagai layanan systemd:php artisan queue:work --tries=3. - Wajib: pasang penjadwal Laravel lewat cron user aplikasi, tiap menit:
* * * * * cd /path/aplikasi/current && php artisan schedule:run >/dev/null 2>&1. Penjadwal menjalankansia:tutup-otomatis: mengirim otomatis quiz/ujian online yang waktunya habis (walau browser mahasiswa tertutup) dan menutup pertemuan tepat di jam akhir. Tanpa cron, attempt menggantung dan dashboard admin menampilkan peringatan "Penjadwal otomatis tidak berjalan".rilis/deploy-sia.sh cekmenampilkan status cron dan kapan penjadwal terakhir jalan. - Naikkan batas unggah PHP (
upload_max_filesize,post_max_size) sesuai kebutuhan berkas kuliah. - Sesudah
.envfinal:php artisan config:cache && php artisan route:cache && php artisan view:cache.
- Jalankan worker antrean (
-
Pengaturan di aplikasi (masuk sebagai admin → Pengaturan Sistem)
- Institusi: nama, singkatan, logo, alamat, zona waktu.
- Email: SMTP untuk verifikasi email dan atur ulang kata sandi.
- Akademik: skala nilai, batas SKS, jumlah pertemuan, syarat ujian, remidi, susulan, TA, cuti.
- Tampilan: nama aplikasi, favicon, halaman masuk.
-
Role dan fitur (masuk sebagai developer →
/dev)- Susun role tambahan (misalnya Staf Keuangan, Staf Akademik) di Kelola Role.
- Periksa status tiap flag di Fitur Klien, lalu kunci (
LOCK_*=true) flag yang sudah final. - Setelah selesai, pertimbangkan
DEV_PANEL=falselaluconfig:cache && route:cache.
-
Data awal dan semester pertama: ikuti Alur pemakaian dari awal.
Urutan kerja sejak aplikasi terpasang sampai mahasiswa lulus. Aturan rinci tiap langkah ada di docs/system-flow.md (nomor bagian ditulis di kolom Rujukan).
flowchart TD
A[A. Persiapan sekali di awal<br/>pengaturan, data master, akun] --> B1
subgraph B[B. Setiap semester]
B1[Tahun akademik aktif] --> B2[Kelas kuliah + jadwal mingguan]
B2 --> B3[Generate pertemuan]
B3 --> B4[Tagihan semester*]
B4 --> B5[KRS mahasiswa]
B5 --> B6[Perkuliahan: materi, tugas, quiz, presensi]
B6 --> B7[UTS / UAS + susulan]
B7 --> B8[Nilai akhir + finalisasi]
B8 --> B9[Remidi]
B9 --> B10[KHS & transkrip]
end
B10 -->|semester berikutnya| B1
B10 --> C[C. Akhir studi<br/>TA → pendadaran → wisuda → SKL → Lulus]
* Hanya bila fitur keuangan aktif.
| # | Langkah | Oleh | Menu | Rujukan |
|---|---|---|---|---|
| A1 | Isi identitas institusi (nama, logo, zona waktu), SMTP, aturan akademik (skala nilai, batas SKS, jumlah pertemuan, syarat ujian, remidi, susulan, TA, cuti), tampilan halaman masuk. Zona waktu ditetapkan sekali di awal karena mengubahnya tidak menggeser data lama. | Admin | Pengaturan Sistem | 4 |
| A2 | Data master berurutan: dosen calon dekan/kaprodi (menu Dosen, program studi dikosongkan dulu) → Fakultas (dekan) → Program Studi (kaprodi) → lengkapi program studi dosen tadi → Ruang → Mata Kuliah (SKS, semester, prasyarat, tanda TA/Skripsi untuk mata kuliah skripsi). | Admin | Master Akademik | 3.2 |
| A3 | Akun Dosen (NIDN, program studi opsional), Mahasiswa (NIM, angkatan, prodi, dosen wali; semester dihitung otomatis dari angkatan), dan Karyawan. Role tambahan (mis. Staf Keuangan) disusun developer di /dev/roles atau admin bila kelola_role aktif. |
Admin / developer | Master Akademik (Dosen, Mahasiswa), Pengguna & Akses (Karyawan) | 3.3, 3.4 |
| A4 | Keuangan aktif: Jenis Biaya (semester, remidi, susulan, serta info pendadaran/wisuda/cuti) dan tarif per prodi/angkatan. | Admin | Keuangan | 6.1 |
Dosen dan mahasiswa masuk memakai NIDN/NIM/username. Akun buatan admin belum terverifikasi emailnya, jadi saat pertama masuk pengguna diminta memverifikasi email: pastikan SMTP (A1) sudah benar sebelum membagikan akun.
| # | Langkah | Oleh | Menu | Rujukan |
|---|---|---|---|---|
| B1 | Buat Tahun Akademik (2026/2027 Ganjil/Genap) dengan tanggal kuliah, periode KRS, periode cuti, batas input nilai, batas bayar remidi, dan batas input nilai remidi, lalu aktifkan. Hanya satu yang boleh aktif: nonaktifkan tahun lama dulu. |
Admin | Master Akademik → Tahun Akademik | 3.1 |
| B2 | Buat Kelas Kuliah per mata kuliah (dosen pengampu, kapasitas, jumlah pertemuan). Kelas TA/Skripsi boleh tanpa dosen dan tanpa jadwal. | Admin | Perkuliahan → Kelas Kuliah | 5.1 |
| B3 | Isi jadwal mingguan (hari, jam, ruang; bentrok kelas/ruang/dosen ditolak). Admin dari halaman kelas atau menu Jadwal Kelas; dosen dari menu Jadwal Mengajar untuk kelasnya sendiri. | Admin, dosen | Jadwal Kelas | 5.2 |
| B4 | Generate pertemuan per kelas dari jadwal mingguan (UTS di pertemuan n/2, UAS di pertemuan n). Lakukan sesudah jadwal final; sejak ada pertemuan, tanggal mulai tahun akademik terkunci dan perubahan berikutnya dilakukan per pertemuan dengan alasan. | Admin, dosen | Presensi | 9.1 |
| B5 | Keuangan aktif: terbitkan tagihan semester sebelum periode KRS; mahasiswa mengunggah bukti di Biaya Kuliah, admin memverifikasi. Bila sakelar Kunci KRS menyala, KRS terkunci sampai lunas. | Admin, mahasiswa | Keuangan → Tagihan Mahasiswa | 6.2–6.4 |
| B6 | KRS selama periode: mahasiswa mengambil kelas yang ditawarkan (semester ini, tertunda, mengulang, prasyarat, batas SKS dari IPS, bentrok, kapasitas), lalu Simpan KRS untuk mengunci. Sesudahnya perubahan lewat pindah kelas (bila dibuka) atau admin membuka kunci KRS. | Mahasiswa | Rencana Studi (KRS) | 7, 16 |
| B7 | Perkuliahan: materi, tugas, dan quiz dari halaman kelas atau menu Materi/Tugas/Quiz (tombol Tambah + isian Kelas Kuliah); dosen membuka pertemuan, mencatat presensi manual atau QR/PIN, menyetujui izin/sakit, mengisi jurnal. | Dosen, admin, mahasiswa | Konten Kelas, Presensi | 8, 9 |
| B8 | UTS: admin membuat jadwal ujian (massal dari pertemuan UTS atau satu per satu, mode tatap muka / unggah berkas / soal online) lalu menerbitkan; dosen menyiapkan soal; mahasiswa mengerjakan dan mengunduh kartu ujian; dosen menilai 0–100 lalu merilis nilai. Mahasiswa yang berhalangan mengajukan ujian susulan. | Admin, dosen, mahasiswa | Jadwal Ujian, Ujian Susulan | 10, 13 |
| B9 | UAS dengan alur yang sama. Syarat kehadiran ujian dan dispensasi berlaku bila diaktifkan. | Admin, dosen, mahasiswa | Jadwal Ujian | 9.4, 10 |
| B10 | Nilai akhir (huruf) diisi manual di tabel Nilai Mahasiswa, lalu Finalisasi sebelum batas input nilai. Nilai tugas/quiz/ujian tidak dihitung otomatis menjadi huruf. | Dosen (admin) | Kelas Kuliah → Nilai | 11 |
| B11 | Remidi: kunci daftar peserta (usulan otomatis D/E yang ikut UAS) → keuangan aktif: tagihan remidi & bukti bayar → admin menjadwalkan ujian remidi → dosen menilai dan menetapkan huruf baru → finalisasi remidi sebelum batas input nilai remidi. | Dosen, admin, mahasiswa | Kelas Kuliah, Tagihan Remidi, Jadwal Ujian | 12 |
| B12 | Hasil studi: mahasiswa melihat dan mengunduh KHS dan transkrip. IPS semester ini menentukan batas SKS dan kuota tagihan semester berikutnya; kembali ke B1. | Mahasiswa | Kartu Hasil Studi, Transkrip Nilai | 11.3 |
| # | Langkah | Oleh | Menu | Rujukan |
|---|---|---|---|---|
| C1 | Mahasiswa mengambil mata kuliah TA/Skripsi di KRS (minimal SKS lulus sesuai Pengaturan Akademik) dan mengambilnya lagi tiap semester sampai dinilai. | Mahasiswa | KRS | 14.7 |
| C2 | Pengajuan TA/Skripsi; admin mengesahkan judul dan menetapkan pembimbing (maks 2). | Mahasiswa, admin | Tugas Akhir & Wisuda; Administrasi → TA & Wisuda | 14.2 |
| C3 | Pendaftaran pendadaran (syarat SKS, tanpa E, semua nilai lengkap, bukti bayar) → disetujui salah satu pembimbing → admin menjadwalkan dengan 3 penguji dan surat PDF. | Mahasiswa, dosen, admin | Bimbingan TA; TA & Wisuda | 14.3 |
| C4 | Tiga penguji menilai 0–100; ketua menetapkan lulus / lulus revisi / tidak lulus. Huruf lulus otomatis masuk ke KRS mata kuliah TA. | Dosen penguji | Bimbingan TA | 14.4 |
| C5 | Admin membuka Periode Wisuda; mahasiswa mendaftar (data ijazah, toga, foto, bukti bayar); admin menyetujui → Generate SKL → status mahasiswa menjadi Lulus. | Admin, mahasiswa | Administrasi → Periode Wisuda | 14.5 |
- Cuti dan aktif kembali: pengajuan cuti di periode cuti tahun akademik, bukti bayar wajib, disetujui admin (15).
- Pindah kelas: bila formulirnya dibuka di Pengaturan Akademik, disetujui admin (16).
- Info kuliah, Beranda per peran (pengingat tagihan, jadwal, izin, remidi, TA), dan dokumen PDF (17).
- Status dosen/mahasiswa: dosen Nonaktif dan mahasiswa selain Aktif/Cuti/Lulus tidak bisa masuk (3.3).
composer install && npm install
cp .env.example .env && php artisan key:generate
php artisan migrate --seed # di non-production ikut mengisi data demo
composer run dev # server, antrean, dan Vite sekaligusAkun demo (dari DemoSeeder): admin admin / 11111, dosen 22222 / 22222, mahasiswa 33333 / 33333.
Pemeriksaan sebelum commit:
php artisan test
vendor/bin/pint --test
npx eslint resources/js
npx vue-tsc --noEmit