# 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