# Catatan Diskusi Aplikasi PetroPrabu
Tanggal Inisiasi: 8 Oktober 2026

## 1. Ikhtisar Aplikasi (Overview)
- **Nama Perusahaan**: PD. PETRO PRABU (Pengelola Jaringan Gas & Unit Usaha Daerah Kota Prabumulih)
- **Nama Aplikasi**: Sistem Informasi Manajemen PD. PETRO PRABU
- **Framework / Tech Stack**: Laravel (PHP), Web Application
- **Alamat Kantor**: Jalan Lingkar Komplek Islamic Center (RUSUNAWA lantai 3) Kel. Muara Dua, Kec. Prabumulih Timur, Kota Prabumulih
- **Kontak**: 0812 1212 7775 | Email: petroprabu69@yahoo.com
- **Cakupan Akun Pengguna**: Akun pengguna sistem dimulai dari **Direktur (Utama)** ke bawah hingga tingkat Manajerial, Kabag, Kasubag, Divisi Operasional, dan Staf/Petugas Lapangan.

---

## 2. 3 Pilar Utama Sistem Aplikasi
1. **Database Pelanggan (Customer Master & Services)**
   - Profil & Master Data Pelanggan (No. Pelanggan, NIK, Nama, Alamat, Kategori/Sektor, Koordinat Lokasi, No. Seri Meteran).
   - Pencatatan Meteran & Billing (Stand Meter, Histori Pemakaian, Tagihan Bulanan, Status Tunggakan/Pembayaran).
   - Pengaduan & Layanan Pelanggan (Permohonan Pasang Baru, Keluhan Kebocoran/Teknis, Tiket Service).

2. **Database Pegawai (Employee & Account Management)**
   - Profil Data Pegawai (NIP/NIK Karyawan, Nama, Jabatan/Role, Sub-bagian/Divisi, Kontak, Status Kepegawaian).
   - Manajemen Akun Login & Autentikasi Sistem (Disambungkan dengan Hak Akses RBAC).

3. **Record Kegiatan Perusahaan (Company Activity Tracking & Operation Logs)**
   - **Log Activity / Catatan Kegiatan**: Pencatatan aktivitas harian/berkala setiap divisi & staf (Jargas, Air Minum, Konstruksi, dll.).
   - **Surat Perintah Kerja (SPK) / Work Orders**: Penugasan perbaikan, pencatatan meteran lapangan, audit K3/HSE, dan maintenance.
   - **System Audit Trail**: Tracking histori aksi user (siapa mencatat apa, kapan, dan perubahan data).
   - **Laporan Ringkasan Kegiatan**: Laporan berkala operasional & keuangan untuk Direktur Utama & Manajerial.

---

## 3. Sistem Approval & Workflow Berjenjang (Multi-Stage Approval Engine)
Setiap alur kerja operasional / permohonan dilaksanakan secara **bertahap lintas bagian/divisi dengan sistem Approve (Persetujuan Atasan)** dan **Supervisi Master oleh Direktur Utama**.

### A. Detail Alur Tiket Pengaduan & Approval Atasan (Ticket Lifecycle)

```
[Konsumen / Pelanggan]
         │ (Menyampaikan Pengaduan)
         ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 1. TAHAP PELAYANAN PELANGGAN                                          │
│    - Staf Pelayanan: Input Data Tiket (ID Pelanggan, Kategori, Deskripsi)│
│    - APPROVE ATASAN: Kasubag/Kabag Pelayanan Pelanggan                │
│      (Memeriksa & Menyetujui Disposisi Tiket ke Billing & IT)          │
└──────────────────────────────────┬─────────────────────────────────────┘
                                   │
                                   ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 2. TAHAP BILLING & IT                                                  │
│    - Staf Billing & IT: Verifikasi Data Tagihan, Meteran, & Log Sistem │
│    - APPROVE ATASAN: Kasubag/Kabag Billing & IT                        │
│      (Memeriksa & Menyetujui Disposisi Perintah Kerja ke Maintenance) │
└──────────────────────────────────┬─────────────────────────────────────┘
                                   │
                                   ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 3. TAHAP MAINTENANCE (DIVISI JARGAS / TEKNISI LAPANGAN)                 │
│    - Staf/Kabag Maintenance: Penugasan Teknisi Lapangan                │
│    - Teknisi Lapangan: Eksekusi Perbaikan & Input 17 Field Laporan     │
│      (25 jenis perbaikan, material, 4 foto bukti, GPS)                 │
│    - APPROVE ATASAN: Kasubag Maintenance / Kabag Usaha                 │
│      (Memeriksa & Menyetujui Laporan Hasil Perbaikan Lapangan)         │
└──────────────────────────────────┬─────────────────────────────────────┘
                                   │
                                   ▼
┌────────────────────────────────────────────────────────────────────────┐
│ 4. TAHAP CUSTOMER SERVICE (CS / HUMAS)                                 │
│    - Staf CS: Menghubungi Konsumen, Konfirmasi Penyelesaian & Feedback │
│    - APPROVE ATASAN / CLOSE: Kasubag Pelayanan / Humas                 │
│      (Approval Akhir & Penutupan Tiket -> Status: CLOSED)              │
└────────────────────────────────────────────────────────────────────────┘
```

#### Rincian Mekanisme Approval Atasan (Gate Approval):
- **Staf / Operator**: Berperan mengisi data, melakukan verifikasi teknis, atau mengeksekusi perbaikan di lapangan.
- **Atasan (Kasubag / Kabag)**: Menerima notifikasi approval di dashboard. Atasan berhak **Approve (Lanjut ke Divisi Berikutnya)**, **Reject/Revisi (Kembalikan ke Staf)**, atau **Re-assign (Ubah Penugasan)**.

---

### B. Dashboard Executive Oversight & Akses Monitoring Direktur Utama

Pihak Eksekutif (**Direktur Utama**, **Manager Keuangan & Administrasi**, **Manager Usaha & HSE**, dan **Badan Pengawas**) memiliki akun dengan hak akses **Master Monitoring (Full Read & Audit Oversight)**:

1. **Live Master Monitoring Ticket Dashboard**:
   - Melihat **seluruh tiket pengaduan** dari semua divisi secara real-time tanpa batasan divisi.
   - Filter komprehensif: Berdasarkan Divisi, Status Workflow (`Draft`, `Menunggu Approval Atasan`, `Proses Lapangan`, `Closed`), Tanggal, Jenis Pengaduan, dan Tingkat Urgensi.
2. **Tracking Progress & Bottleneck Detection**:
   - Mengetahui posisi presisi tiket saat ini (misal: *Tiket #TK-102 berada di Divisi Maintenance, menanti Approval Kasubag Maintenance*).
   - Indikator durasi/SLA (Signal Alert jika ada tiket yang mandek > 24 jam di salah satu bagian/atasan).
3. **Audit Trail & Transparency Log**:
   - Membuka riwayat kronologis lengkap dari tiket (Siapa yang menginput, siapa atasan yang menyetujui, tanggal & jam approval, foto perbaikan teknisi, hingga hasil rilis CS ke konsumen).
4. **Laporan & Analytics Manajemen**:
   - Grafik rekapitulasi performa per divisi, durasi rata-rata penyelesaian pengaduan (MTTR), dan pemetaaan GIS sebaran lokasi perbaikan di Kota Prabumulih.

---

## 4. Analisis Aplikasi Existing (AppSheet Study & Mapping)

### A. Modul Maintenance (AppSheet 1)
1. **Input Data**: Form Pendataan Maintenance (17 Field: Tanggal, Nama, ID Pelanggan, No Meter, Alamat, HP, 25 jenis Uraian Pekerjaan, Material, 4 Foto, GPS, Tunggakan, Status, Petugas).
2. **Data Maintenance**: Master list & Filter data.
3. **Status Laporan**: Monitoring status (Selesai vs Belum Selesai).
4. **Uraian Pekerjaan**: Grouping & Rekap per jenis perbaikan teknis.
5. **Map**: Peta GIS lokasi perbaikan.

### B. Modul Lainnya (Telah Terpetakan & Berjalan)
- *Modul Pelanggan & Catat Meter*
- *Modul Billing & Penagihan*
- *Modul Pengaduan & Layanan Pelanggan (Alur 4 Tahap)*
- *Modul SDM & Pegawai*

---

## 5. Struktur Organisasi & Hierarki Role RBAC (13 Role Berjenjang)

### A. Jajaran Eksekutif & Admin Master (Level 1: System Admin & Executive Oversight)
1. **Super Admin**: Akses Penuh Manajemen Sistem, Pengaturan Web Profil Perusahaan, CMS Post, User & RBAC.
2. **Direktur Utama**: Executive Master View seluruh Tiket Pengaduan, Dashboard Monitoring Lintas Divisi, Live Bottleneck SLA Alert & Audit Trail.
3. **Manager Administrasi & Keuangan**: Master Monitoring Divisi SDM, Keuangan, Billing & IT, dan Pelayanan Pelanggan.
4. **Manager Usaha & HSE**: Master Monitoring Divisi Maintenance, Perencanaan, HSE, dan Operasional Jargas.
5. **Badan Pengawas**: Access Level Read-Only Supervisi Audit Laporan Perusahaan & Pengaduan.

### B. Atasan Divisi / Supervisor (Level 2: Gate Approval Multi-Stage)
6. **Kasubag Pelayanan Pelanggan**: Verifikasi & Approval Stage 1 (Pengaduan Baru -> Disposisi Billing & IT).
7. **Kasubag Billing & IT**: Verifikasi & Approval Stage 2 (Billing & IT -> Disposisi SPK Maintenance).
8. **Kasubag Maintenance**: Verifikasi & Approval Stage 3 (Penugasan SPK & Approval Hasil Pekerjaan Lapangan).
9. **Kasubag Humas**: Approval Stage 4 & Otorisasi Penutupan Tiket (`CLOSE TICKET`).

### C. Staf Operasional & Eksekutor Lapangan (Level 3: Operational Staff)
10. **Staf Pelayanan Pelanggan**: Terima & Input Pengaduan Baru dari Konsumen / Form Pelayanan.
11. **Staf Billing & IT**: Melakukan Verifikasi Tagihan, Meteran, & Log IT Pelanggan.
12. **Teknisi Lapangan (Divisi Jargas)**: Eksekutor Perbaikan Lapangan & Pengisi Form Laporan Maintenance 17 Field (25 jenis perbaikan, material, 4 foto, GPS).
13. **Staf Customer Service (CS)**: Menghubungi Konsumen (Follow-up), Input Feedback & Rating Kepuasan Pelanggan.

---

## 6. Spesifikasi Tech Stack & Arsitektur Aplikasi
- **Framework Backend**: Laravel 11 (PHP 8.2+)
- **Database Management System**: MySQL 8.0+ / MariaDB
- **Frontend & Styling**: TailwindCSS v3
- **Icon Set**: FontAwesome v6 (Pro / Free SVG & Webfonts)
- **Alert & Modal Notifications**: SweetAlert2 (Interactive Dialogs & Toast Notifications)
- **GIS Mapping**: Leaflet.js (Peta Lokasi & Meteran Pelanggan)
- **Pendekatan Pengembangan**: End-to-End Multi-Stage Ticket Workflow & RBAC System

---

## 7. Rancangan Struktur Database (Database Schema & Migrations)

### A. Tabel `roles` (Master Role & RBAC - 13 Role Resmi)
- `id` (PK)
- `name` (Slug Role: `super-admin`, `direktur-utama`, `manager-keuangan`, `manager-usaha`, `badan-pengawas`, `kasubag-pelayanan`, `kasubag-billing-it`, `kasubag-maintenance`, `kasubag-humas`, `staf-pelayanan`, `staf-billing-it`, `teknisi-lapangan`, `staf-cs`)
- `display_name` (Nama Tampilan Role dalam Bahasa Indonesia)
- `guard_name` (web)
- `description`
- `created_at`, `updated_at`

### B. Tabel `users` (Data Pegawai & Akun Sistem)
- `id` (PK)
- `nip_nik` (Unique NIP/NIK Pegawai)
- `name` (Nama Lengkap Pegawai)
- `email` (Unique Login Email)
- `password` (Hashed Password)
- `phone` (Nomor WhatsApp/HP)
- `role_id` (FK -> `roles.id`)
- `subbagian_divisi` (Divisi / Sub-Bagian Kerja)
- `is_active` (Boolean: Active/Inactive)
- `remember_token`, `created_at`, `updated_at`

### C. Tabel `pelanggan` (Master Data Pelanggan)
- `id` (PK)
- `no_pelanggan` (Unique ID Pelanggan PetroPrabu)
- `nik` (NIK KTP Pelanggan)
- `nama_pelanggan`
- `alamat_lengkap`
- `no_hp`
- `sektor_kategori` (Rumah Tangga, Komersial, Industri)
- `no_seri_meteran`
- `latitude`, `longitude` (Koordinat Lokasi GPS)
- `status_langganan` (Aktif, Non-Aktif, Segel)
- `created_at`, `updated_at`

### D. Tabel `referensi` (Master Data Referensi / Lookup Table)
- `id` (PK)
- `kode_group` (misal: `kategori_pengaduan`, `jenis_pekerjaan_maintenance`, `status_tiket`, `material_jargas`)
- `key` (Kode Unik Referensi)
- `value` (Label / Deskripsi Tampilan)
- `deskripsi`
- `urutan` (Sorting Order)
- `is_active` (Boolean)
- `created_at`, `updated_at`

### E. Tabel `tiket` (Header Tiket Pengaduan)
- `id` (PK)
- `nomor_tiket` (Unique, Auto-generated e.g., `TK-202610-0001`)
- `pelanggan_id` (FK -> `pelanggan.id`)
- `kategori_pengaduan_id` (FK -> `referensi.id`)
- `deskripsi_keluhan`
- `foto_awal_path` (Upload Bukti Keluhan Awal)
- `current_stage` (`Pelayanan`, `Billing_IT`, `Maintenance`, `CS`, `Closed`)
- `current_status` (`Draft`, `Pending_Approval_Atasan`, `Disetujui`, `In_Progress`, `Resolved`, `Closed`)
- `assigned_technician_id` (FK -> `users.id`, nullable)
- `created_by_user_id` (FK -> `users.id`)
- `closed_at`, `closed_by_user_id` (FK -> `users.id`, nullable)
- `created_at`, `updated_at`

### F. Tabel `tiket_approvals` (Log Approval Atasan Multi-Stage)
- `id` (PK)
- `tiket_id` (FK -> `tiket.id`)
- `stage_name` (`Pelayanan`, `Billing_IT`, `Maintenance`, `CS`)
- `approver_user_id` (FK -> `users.id`)
- `action` (`Approve`, `Reject`, `Reassign`)
- `catatan_atasan` (Catatan/Disposisi Atasan)
- `approved_at`
- `created_at`, `updated_at`

### G. Tabel `tiket_maintenance_details` (Laporan Perbaikan Lapangan 17 Field AppSheet)
- `id` (PK)
- `tiket_id` (FK -> `tiket.id`)
- `tanggal_pekerjaan` (Datetime)
- `uraian_pekerjaan_ids` (JSON Array dari 25 Jenis Perbaikan)
- `material_digunakan` (JSON / Text Material)
- `foto_sebelum_path`
- `foto_proses_path`
- `foto_sesudah_path`
- `foto_dokumen_path`
- `latitude_gps`, `longitude_gps`
- `status_tunggakan`
- `status_pekerjaan` (`Selesai`, `Belum Selesai`)
- `petugas_lapangan_ids` (JSON / Text)
- `catatan_teknis`
- `created_at`, `updated_at`

### H. Tabel `tiket_cs_feedbacks` (Follow-up CS & Feedback Konsumen)
- `id` (PK)
- `tiket_id` (FK -> `tiket.id`)
- `cs_user_id` (FK -> `users.id`)
- `waktu_kontak` (Datetime)
- `status_konfirmasi` (`Konsumen Puas`, `Belum Selesai`)
- `rating_layanan` (Scale 1-5 / Bintang)
- `catatan_feedback_konsumen`
- `created_at`, `updated_at`

### I. Tabel `activity_logs` (System Audit Trail)
- `id` (PK)
- `user_id` (FK -> `users.id`)
- `action` (Aksi yang dilakukan)
- `description` (Rincian perubahan data)
- `ip_address`
- `user_agent`
- `created_at`, `updated_at`

### J. Tabel `company_profiles` (Profil Perusahaan & Pengaturan Landing Page)
- `id` (PK)
- `nama_perusahaan` (PD. PETRO PRABU)
- `tagline` (Slogan/Tagline Perusahaan)
- `logo_path`, `favicon_path`
- `deskripsi_singkat`
- `sejarah_perusahaan` (Long text)
- `visi_misi` (JSON / Long text)
- `alamat_lengkap`
- `email`, `no_telepon`, `no_whatsapp`
- `google_maps_embed` (Embed Iframe / Koordinat)
- `social_media_links` (JSON: Facebook, Instagram, YouTube, dll)
- `jam_operasional`
- `created_at`, `updated_at`

### K. Tabel `post_categories` (Kategori Postingan / Berita)
- `id` (PK)
- `nama_kategori` (Pengumuman, Berita Jargas, Layanan, Edukasi K3, Kegiatan Perusahaan)
- `slug` (Unique)
- `deskripsi`
- `created_at`, `updated_at`

### L. Tabel `posts` (CMS Postingan Admin / Berita & Pengumuman Frontend)
- `id` (PK)
- `title` (Judul Postingan/Berita)
- `slug` (Unique URL Slug)
- `category_id` (FK -> `post_categories.id`)
- `author_user_id` (FK -> `users.id`)
- `excerpt` (Ringkasan Singkat)
- `content` (Isi Konten Artikel/Berita - HTML / Rich Text)
- `featured_image_path` (Gambar Utama Artikel)
- `status` (`Draft`, `Published`, `Archived`)
- `published_at` (Datetime)
- `views_count` (Default: 0)
- `created_at`, `updated_at`

---

## 8. Daftar Pegawai & Akun Sistem (User Accounts Data)
*(Menunggu daftar pegawai/pekerja dari pengguna)*

---

## 9. Daftar Tugas & Progress (To-Do List)
- [x] Pemetaan struktur organisasi PD. PETRO PRABU ke struktur Role & Modul
- [x] Konfirmasi batasan akun sistem (Direktur Utama ke bawah)
- [x] Perumusan 3 Pilar Utama Sistem
- [x] Penentuan Konsep Multi-Stage Approval Workflow System
- [x] Penetapan Modul Maintenance & Ekstraksi seluruh Field & Option dari AppSheet
- [x] Dokumentasi Spesifikasi Tech Stack (Laravel 11, PHP 8.2, MySQL, TailwindCSS, FontAwesome, SweetAlert)
- [x] Perancangan Skema Database Terintegrasi (Database Schema & Tables)
- [x] Penambahan Modul Profil Perusahaan & CMS Postingan Admin untuk Frontend Web
- [/] Pengguna sedang mempelajari kebutuhan aplikasi & SOP internal perusahaan
- [ ] Membuat Database Migrations & Seeders Laravel
- [ ] Membangun UI Dashboard & Modul Sistem


