Skip to content
Velocity-DeveloperPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

165 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SIA VD — Sistem Informasi Akademik

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:

Isi README:

  1. Kebutuhan
  2. Feature flag per klien
  3. Panel developer
  4. Contoh .env dua klien
  5. Onboarding klien baru
  6. Alur pemakaian dari awal
  7. Pengembangan

Kebutuhan

  • PHP 8.2+ dengan ekstensi pdo_mysql, mbstring, dom, gd, intl, fileinfo.
  • MySQL 8 / MariaDB 10.6+ (beberapa migrasi memakai ALTER ... MODIFY khusus MySQL; SQLite hanya untuk tes).
  • Node.js 20+ untuk build aset.
  • Composer 2.

Feature flag per klien

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.

Urutan penentuan status

  1. Nama tidak terdaftar di config/client.php → mati.
  2. LOCK_*=true → ikut FEATURE_* di .env. Override database diabaikan dan tidak bisa disimpan.
  3. Ada override di tabel pengaturan_fitur (diatur developer di /dev/fitur) → ikut override.
  4. 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.

Menambah flag baru

  1. Daftarkan di config/client.php (label, keterangan, default, locked, butuh).
  2. Tambahkan FEATURE_<NAMA>=<bawaan> dan LOCK_<NAMA>=false ke .env.example (dicek oleh FeatureFlagTest; fitur baru bawaan false, fitur lama yang dijadikan flag true dan didaftarkan di FITUR_BAWAAN_NYALA tes itu).
  3. Pasang di kode: middleware rute fitur:<nama>, kunci fitur di menu AppSidebar.vue, useFitur().aktif('<nama>') di Vue, Feature::aktif('<nama>') di PHP. Izin menu milik fitur didaftarkan di PermissionCatalog::FITUR agar disembunyikan dari role selama fitur mati.
  4. Tambahkan nama ke tipe fitur di resources/js/types/index.ts.
  5. Tulis tes keadaan mati (lihat KeuanganMatiTest, KelolaRoleMatiTest). tests/TestCase.php menyalakan fitur lama untuk tes yang sudah ada.

Panel developer

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 (tabel log_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 flag kelola_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 Admin

Rute /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).

Contoh .env dua klien

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=false

Klien 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=true

Zona waktu yang tampil ke pengguna diatur lagi per institusi di Pengaturan Sistem → Institusi.

Onboarding klien baru

  1. 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
  2. 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
  3. 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 DemoSeeder di server klien: seeder itu menghapus data akademik untuk diganti data demo.

  4. 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']);
  5. Akun developer (bila panel dipakai): buat akun admin/karyawan dengan cara yang sama, lalu php artisan sia:developer <username> dan pastikan DEV_PANEL=true.

  6. 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 menjalankan sia: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 cek menampilkan status cron dan kapan penjadwal terakhir jalan.
    • Naikkan batas unggah PHP (upload_max_filesize, post_max_size) sesuai kebutuhan berkas kuliah.
    • Sesudah .env final: php artisan config:cache && php artisan route:cache && php artisan view:cache.
  7. 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.
  8. 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=false lalu config:cache && route:cache.
  9. Data awal dan semester pertama: ikuti Alur pemakaian dari awal.

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]
Loading

* Hanya bila fitur keuangan aktif.

A. Persiapan (sekali di awal)

# 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.

B. Setiap semester

# 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

C. Akhir studi

# 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

D. Kapan saja

  • 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).

Pengembangan

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 sekaligus

Akun 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

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages