Gambaran Umum

Pengenalan Sistem Payroll Terpadu PT Putra Sinar Fisip.

Sistem Payroll Terpadu adalah aplikasi berbasis web untuk mengelola penggajian karyawan secara terstruktur, fleksibel, dan terintegrasi — dari pengaturan gaji, acuan gaji, hitung gaji, penyesuaian, hingga slip gaji.

Dibangun dengan Laravel 11, PHP 8.2+, Tailwind CSS, dan Alpine.js. Basis data menggunakan SQLite dengan Eloquent ORM.

Instalasi & Setup

Persyaratan Sistem

• PHP ^8.2
• Composer
• Node.js ^20
• SQLite / MySQL / PostgreSQL
• Laragon / XAMPP / Valet

Langkah Instalasi

1. git clone https://github.com/HugoEdmoundo/payroll-app.ptpsf.git
2. cd payroll-app.ptpsf
3. composer install
4. copy .env.example .env
5. php artisan key:generate
6. php artisan migrate
7. npm install && npm run build
8. php artisan serve

Pastikan database/database.sqlite sudah ada sebelum migrasi.

Autentikasi

Login

Masukkan email dan password yang telah didaftarkan administrator.

Session & Akses

Sesi aktif hingga logout. Dua tingkat akses: Superadmin (full) dan User (terbatas). Detail di Pengguna & Role.

Alur Data & Cascade

Sistem menggunakan pendekatan Source of Truth pada modul Pengaturan Gaji.

Karyawan (Harian/OJT/Kontrak)
  |
  v
Salary Templates + Pengaturan BpjsKoperasi
  |
  v
NKI + Absensi + Kasbon + Acuan Gaji
  |
  v
Hitung Gaji (kalkulasi final)
  |
  v
Slip Gaji (PDF/Excel)

Data Cascade: Perubahan pada NKI, Absensi, atau Acuan Gaji otomatis merambat ke Hitung Gaji via Observer Pattern.

Struktur Database

11 tabel utama dengan SQLite:

Unique constraint (karyawan_id, periode) di setiap tabel transaksi.

Relasi Antar Tabel

Pola Observer

Data cascade otomatis via Eloquent Observer:

PengaturanGaji::observe(PengaturanGajiObserver::class);
AcuanGaji::observe(AcuanGajiObserver::class);
HitungGaji::observe(HitungGajiObserver::class);
NKI::observe(NKIObserver::class);
Absensi::observe(AbsensiObserver::class);

Karyawan

Pusat data master karyawan dengan informasi personal, employment, dan kompensasi.

Status Pegawai Otomatis

class Karyawan extends Model {
    public function calculateStatusPegawai() {
        $days = $this->join_date->diffInDays(now());
        if ($days < 14)  return 'Harian';
        if ($days < 104) return 'OJT';
        return 'Kontrak';
    }
}

CRUD & Fitur

• Tambah, edit, lihat, hapus karyawan
• Import/export Excel (dengan template)
• Riwayat jabatan (Job Movement) tercatat otomatis

Penghapusan bersifat permanen (hard delete) — menghapus semua data terkait.

Pengaturan Gaji

Source of Truth untuk komponen gaji. Disimpan di salary_templates dengan dua tipe: Standard dan Status.

Standard Template

Untuk karyawan Kontrak, dikombinasikan dengan jenis_karyawan, jabatan, lokasi_kerja.

Status Template

Untuk Harian dan OJT.

$model->gaji_nett = $model->gaji_pokok + ($model->tunjangan_prestasi ?? 0);
$model->total_gaji = $model->gaji_nett;

BPJS & Koperasi

Konfigurasi global untuk semua karyawan di tabel pengaturan_bpjs_koperasi.

Karyawan Harian & OJT tidak mendapat BPJS.

Master Wilayah & Status Pegawai

Master Wilayah

Master Status Pegawai

Absensi

Mencatat kehadiran per periode untuk menghitung potongan absensi.

potongan = (absence + tanpa_keterangan) / jumlah_hari_bulan
           x (gaji_pokok + tunjangan_prestasi + tunjangan_operasional)

NKI (Nilai Kinerja Individu)

Penilaian kinerja yang mempengaruhi Tunjangan Prestasi. Hanya untuk Kontrak.

nilai_nki = (kemampuan x 0.20) + (kontribusi_1 x 0.20)
           + (kontribusi_2 x 0.40) + (kedisiplinan x 0.20)

if (nilai_nki >= 8.5) -> 100%  |  >= 8.0 -> 80%  |  < 8.0 -> 70%

Kasbon & Cicilan

Dua metode: Langsung (potong sekali) dan Cicilan (tiap bulan).

Cicilan disimpan di kasbon_cicilan dengan field: cicilan_ke, periode, nominal_cicilan, status.

Acuan Gaji

Base reference per karyawan per periode. Semua komponen dikumpulkan di sini sebelum Hitung Gaji.

$model->total_pendapatan = sum(semua pendapatan);
$model->total_pengeluaran = sum(semua pengeluaran);
$model->gaji_bersih = total_pendapatan - total_pengeluaran;

Unique constraint: unique(id_karyawan, periode).

Hitung Gaji

Inti sistem payroll — kalkulasi final dengan data Acuan Gaji + penyesuaian.

Alur

1. Acuan Gaji dibuat → sistem generate Hitung Gaji (AcuanGajiObserver)
2. Kalkulasi ulang NKI & Absensi
3. Adjustment bisa ditambahkan via modal
4. Status: Draft → Preview → Approved

Adjustments (JSON)

{
    "gaji_pokok": { "type": "+", "nominal": 500000, "description": "Bonus" },
    "koperasi":   { "type": "-", "nominal": 100000, "description": "Koreksi" }
}

total_pendapatan = sum(12 pendapatan + adjustments pendapatan)
total_pengeluaran = sum(7 pengeluaran + adjustments pengeluaran)
gaji_bersih = total_pendapatan - total_pengeluaran

Penyesuaian

Adjustment memungkinkan modifikasi komponen gaji tanpa mengubah data Acuan Gaji asli. Berguna untuk:

• Bonus — pembayaran satu kali
• Denda — potongan tambahan
• Koreksi — error data approved
• Insentif — tambahan khusus

Slip Gaji

Output akhir payroll. Setiap karyawan approved memiliki slip PDF & Excel.

Pengguna & Role

Hak Akses

Hierarki pengecekan permission:

public function hasPermission($key) {
    if ($this->isSuperadmin()) return true;
    if (!$this->is_active) return false;
    // Priority 1: User-specific permission
    // Priority 2: Role-based permission
    return false;
}

Module permissions: karyawan.view, karyawan.create, payroll.hitung-gaji, admin.users, dll.

Pengaturan Sistem

Menu Admin → Settings untuk:

• Jabatan per Jenis Karyawan
• Dynamic Fields custom
• Konfigurasi umum aplikasi

Log Aktivitas

Semua aksi signifikan dicatat di activity_logs:

Import & Export

FAQ