Implementation Plan: Rebuild Aplikasi Sertifikasi Halal (SiHalal)

Dokumen ini adalah panduan utama pengembangan aplikasi SiHalal.
Berdasarkan analisa langsung dari sistem existing: https://ptsp.halal.go.id

1. Hasil Analisa Sistem Existing (ptsp.halal.go.id)

1.1 Fitur — Role: UMKM (Pelaku Usaha)

Kategori	Menu	Deskripsi
MENU UTAMA	Dashboard	Welcome page, langkah cepat (Lengkapi Profil → Siapkan Dokumen → Pantau Status), notifikasi keamanan
MENU UTAMA	Pelaku Usaha	Profil usaha lengkap (nama, alamat, kota, provinsi, kodepos, telepon, email, perizinan, KBLI)
SERTIFIKASI HALAL	Tagihan / Invoice	Daftar tagihan pembayaran sertifikasi
SERTIFIKASI HALAL	Status Permohonan	Tracking status pengajuan sertifikasi
SERTIFIKASI HALAL	Pengajuan Self Declare Mandiri	Pengajuan sertifikasi mandiri untuk UMKM mikro (kuesioner)
SERTIFIKASI HALAL	Pengajuan Self Declare	Pengajuan self declare standar
SERTIFIKASI HALAL	Pengajuan Reguler	Pengajuan sertifikasi reguler (non-UMKM mikro)
KALKULATOR	Kalkulator Simulasi Perhitungan	Simulasi biaya sertifikasi halal
REGISTRASI SHLN	Invoice	Invoice khusus registrasi SHLN
REGISTRASI SHLN	Submissions	Pendaftaran sertifikat halal luar negeri

Detail Halaman Pelaku Usaha:

Profil: Nama PU, Alamat, Kota/Kab, Provinsi, Kodepos, Negara, Telepon, Email
Perizinan: No. Izin, Penerbit, Nama Izin
KBLI (Klasifikasi Baku Lapangan Usaha Indonesia)
Tombol: Kembali, Simpan

Detail Pengajuan Self Declare Mandiri:

Tabel: NO, ID REG, NOMOR DAFTAR, TANGGAL, NAMA PU, JENIS PRODUK, STATUS, AKSI
Tombol: Buat Pengajuan +
Form berisi kuesioner self-assessment

Detail Pengajuan Reguler:

Tabel: NO, NOMOR DAFTAR, TANGGAL DAFTAR, NAMA PU, JENIS DAFTAR, JENIS PRODUK, STATUS, AKSI
Tombol: Ajukan Layanan

Detail Submissions (SHLN):

Tabel: NO, SUBMISSION NUMBER, NO SHLN, DATE, TYPE OF REGISTRATION, STATUS, REGISTRATION NUMBER, RENEWAL, ACTION
Tombol: Add Submission +
Alert: "Please upload the NIB file in the Business Actor menu"

1.2 Fitur — Role: Fasilitator

Kategori	Menu	Deskripsi
PENDAFTAR	Profile	Profil fasilitator (nama, jenis, wilayah kerja, PIC)
FACILITATE REGISTRATION	Daftar Fasilitas	Melihat program fasilitasi yang sudah dibuat & kuota
FACILITATE REGISTRATION	Entri Fasilitas	Membuat program fasilitasi baru
DAFTAR PELAKU USAHA	Pembatalan	Kelola permintaan pembatalan sertifikasi
DAFTAR PELAKU USAHA	Inquiry	Pencarian & review data pengajuan UMKM
INVOICE	Invoice Fasilitasi	Kelola tagihan fasilitasi

Detail Profile Fasilitator:

Nama Fasilitator, Jenis Fasilitator (dropdown)
Alamat, Provinsi, Kabupaten/Kota, Kecamatan (cascading dropdown)
Kodepos, Email
Nama Penanggung Jawab, Nomor Kontak PIC Dinas
Tombol: Simpan Perubahan

Detail Daftar Fasilitas:

Tabel: NO, KODE FASILITASI, TAHUN, NAMA PROGRAM FASILITASI, JENIS, TANGGAL AKTIF, KUOTA, SISA, STATUS, ACTION
Alur status: Reguler & Self Declare

Detail Entri Fasilitas:

Tabel: NO, NAMA FASILITASI, TAHUN, JENIS, TANGGAL AKTIF, TANGGAL SELESAI, KUOTA, STATUS, ACTION
Tombol: Tambah Pengajuan +

Detail Inquiry:

Filter: Nomor Pendaftaran, Nama Pelaku Usaha, Status Permohonan, Tipe Pengajuan, Sumber Pembiayaan, Kode Fasilitas
Tabel: PILIH, NO, NO DAFTAR, NAMA PU, TANGGAL, JENIS DAFTAR, JENIS PRODUK, KODE FASILITASI, STATUS, ACTION
Tombol: View, Download Excel, Pembatalan (batch)

Detail Pembatalan:

Filter: Nama Pelaku Usaha (dropdown), Isian Pencarian
Tabel: NO, NO DAFTAR, TANGGAL, NAMA PU, JENIS DAFTAR, JENIS PRODUK, NO SERTIFIKAT, STATUS

Detail Invoice Fasilitasi:

Tabel daftar invoice terkait program fasilitasi

1.3 Fitur Umum (Semua Role)

Fitur	Detail
Multi-bahasa	Switcher ID / EN (di header)
Login	Username + Password + reCAPTCHA
Registrasi	Tipe Pengguna (Fasilitator / Pelaku Usaha), Nama, Email, No HP (+62), Password, Konfirmasi
Lupa Password	Reset password via email
Dokumentasi	Link panduan penggunaan sistem
Theme Customizer	Primary color, Dark/Light mode (optional)
Integrasi	Terhubung ke OSS & BSE (referensi)

2. Arsitektur & Teknologi

Komponen	Teknologi
Backend & Web UI	Laravel 12 (PHP 8.2+), Blade Templating
Auth & RBAC	Laravel Breeze + Spatie Permission
Database	MySQL 8.0+
CSS Framework	Tailwind CSS
Build Tool	Vite
Localization	Laravel Localization (ID & EN)
API (Fase lanjutan)	Laravel Sanctum

3. Sistem Role (3 Level Akses)

Perbedaan dari sistem existing: Kita menambahkan role Administrator yang tidak ada di ptsp.halal.go.id

3.1 Role: Administrator (BARU)

Modul	Fitur
Dashboard	Statistik global: total pengajuan, UMKM terdaftar, fasilitator aktif, sertifikat terbit. Charts & grafik.
Manajemen User	CRUD semua user, assign/ubah role, aktivasi/deaktivasi akun
Manajemen Role & Permission	Kelola role dan permission via Spatie
Manajemen Jenis Sertifikasi	CRUD jenis sertifikasi (Self Declare Mandiri, Self Declare, Reguler, SHLN)
Verifikasi & Approval	Review final pengajuan, terbitkan sertifikat, set nomor sertifikat
Manajemen Fasilitator	Lihat, verifikasi, dan kelola data semua fasilitator
Manajemen Pelaku Usaha	Lihat, verifikasi, dan kelola data semua pelaku usaha
Laporan & Ekspor	Laporan pengajuan, statistik per wilayah, export Excel/PDF
Activity Log	Log semua aktivitas user di sistem
Pengaturan Sistem	Konfigurasi umum aplikasi (nama, logo, kontak, dll)

3.2 Role: Fasilitator

Modul	Fitur
Dashboard	Statistik UMKM binaan, pengajuan pending, kuota tersisa
Profile	Kelola profil fasilitator (nama, jenis, wilayah, PIC)
Daftar Fasilitas	Lihat semua program fasilitasi & tracking kuota
Entri Fasilitas	Buat program fasilitasi baru (nama, tahun, jenis, periode, kuota)
Inquiry	Pencarian & review pengajuan UMKM dengan multi-filter + export Excel
Pembatalan	Kelola permintaan pembatalan sertifikasi
Invoice Fasilitasi	Lihat & kelola tagihan fasilitasi

3.3 Role: UMKM (Pelaku Usaha)

Modul	Fitur
Dashboard	Welcome page, langkah cepat, notifikasi
Profil Pelaku Usaha	Kelola profil usaha (nama, alamat, perizinan, KBLI)
Pengajuan Self Declare Mandiri	Pengajuan sertifikasi mandiri + kuesioner self-assessment
Pengajuan Self Declare	Pengajuan self declare standar
Pengajuan Reguler	Pengajuan sertifikasi reguler
Status Permohonan	Tracking status semua pengajuan
Tagihan / Invoice	Lihat tagihan & status pembayaran
Kalkulator Simulasi	Simulasi biaya sertifikasi
Registrasi SHLN	Pendaftaran sertifikat halal luar negeri

4. Database Design

Tabel yang Sudah Ada (dari migration saat ini)

users — Data pengguna + profil fields (phone, address, id_number, avatar, is_active)
businesses — Data pelaku usaha
certification_types — Jenis sertifikasi
certification_submissions — Pengajuan sertifikasi
products — Produk dalam pengajuan
ingredients — Bahan baku produk
production_processes — Proses produksi
activity_logs — Log aktivitas
Tabel Spatie Permission (roles, permissions, model_has_roles, dll)

Tabel Baru yang Dibutuhkan

-- Profil Fasilitator (terpisah dari users)
facilitators
├── id, user_id (FK → users)
├── name, type (jenis fasilitator)
├── address, province, city, district, postal_code
├── email, pic_name, pic_phone
└── timestamps

-- Program Fasilitasi
facilitation_programs
├── id, facilitator_id (FK → facilitators)
├── code (kode fasilitasi), name, year, type (reguler/self_declare)
├── start_date, end_date, quota, remaining_quota
├── status (draft/active/completed/cancelled)
└── timestamps

-- Jawaban Kuesioner Self Declare
self_declare_answers
├── id, submission_id (FK → certification_submissions)
├── question_key, answer, notes
└── timestamps

-- Tagihan / Invoice
invoices
├── id, submission_id (FK → certification_submissions)
├── invoice_number, va_number (Virtual Account)
├── amount, due_date, paid_at
├── status (pending/paid/overdue/cancelled)
├── invoice_file, type (sertifikasi/fasilitasi/shln)
└── timestamps

-- Dokumen Pendukung (Polymorphic)
documents
├── id, documentable_id, documentable_type
├── type (nib/permit/certificate/kbli/other)
├── name, file_path, file_size
├── uploaded_by (FK → users)
└── timestamps

-- Permintaan Pembatalan
cancellation_requests
├── id, submission_id (FK → certification_submissions)
├── requested_by (FK → users), reason
├── status (pending/approved/rejected)
├── processed_by (FK → users), processed_at
└── timestamps

Update Tabel Existing

-- Update: businesses (tambah kolom)
+ nib_file (path file NIB)
+ country (negara, default: Indonesia)
+ kbli_code, kbli_name
+ permit_number, permit_issuer, permit_name

-- Update: certification_submissions (tambah kolom)
+ facilitation_program_id (FK → facilitation_programs)
+ type ENUM('self_declare_mandiri', 'self_declare', 'reguler', 'shln')
+ product_type, product_name
+ funding_source (sumber pembiayaan)
+ shln_number (untuk tipe SHLN)
+ renewal_of (FK → self, untuk perpanjangan)
+ registration_number (nomor pendaftaran/daftar)
+ verified_at, verified_by

5. Alur Pengajuan Sertifikasi

UMKM                          FASILITATOR                    ADMINISTRATOR
─────                          ───────────                    ─────────────
1. Lengkapi Profil Usaha
2. Pilih Jenis Pengajuan
   ├── Self Declare Mandiri
   │   └── Isi Kuesioner
   ├── Self Declare
   ├── Reguler
   └── SHLN
3. Isi Data Produk & Bahan
4. Upload Dokumen
5. Submit Pengajuan
   │
   ├── [status: submitted] ──→ 6. Review & Verifikasi
   │                              ├── Setujui (verified)
   │                              ├── Minta Revisi (needs_revision)
   │                              └── Tolak (rejected)
   │
   │   ← [needs_revision] ────── Perbaiki & Submit Ulang
   │
   │                              │ [verified] ──→ 7. Approval Final
   │                              │                   ├── Approve (approved)
   │                              │                   └── Reject (rejected)
   │                              │
   │                              │               8. Terbitkan Sertifikat
   │                              │                   └── [certified]
   │                              │                       ├── Nomor Sertifikat
   │                              │                       ├── Masa Berlaku
   │                              │                       └── File Sertifikat
   │
   └── 9. Lihat Status & Download Sertifikat

10. Terima Invoice
11. Lakukan Pembayaran

6. Fase Pengembangan (Roadmap)

Fase 1: Foundation & Auth ✅ (Sebagian sudah selesai)

Inisialisasi project Laravel 12 + Composer + NPM
Setup database MySQL dengan migration awal
Setup Spatie Permission (3 Role: administrator, facilitator, umkm)
Seeder: User demo (admin, fasilitator, umkm) + Certification Types
Migrasi baru: Tabel facilitators, facilitation_programs, invoices, documents, self_declare_answers, cancellation_requests
Update migrasi: Tambah kolom baru ke businesses & certification_submissions
Setup Localization (file bahasa ID & EN untuk semua label)
Redesign Layout Utama:
- Sidebar navigasi (sesuai role)
- Header (logo, dokumentasi, language switcher, profil dropdown)
- Footer
- Responsive design
Modul Auth:
- Login (email + password)
- Register (pilih tipe pengguna: Fasilitator / Pelaku Usaha)
- Lupa Password (reset via email)
- Email Verification
- Middleware role-based redirect

Fase 2: Modul UMKM (Pelaku Usaha)

Dashboard UMKM
- Welcome message
- Langkah cepat (1. Profil → 2. Dokumen → 3. Status)
- Notifikasi keamanan
- Quick links (Pelaku Usaha, Status Pengajuan)
CRUD Profil Pelaku Usaha
- Form lengkap: nama, alamat, kota, provinsi, kodepos, negara, telepon, email
- Section Perizinan: no. izin, penerbit, nama izin
- Section KBLI: kode & nama KBLI
- Upload file NIB
Pengajuan Self Declare Mandiri
- Tabel daftar pengajuan dengan search
- Form buat pengajuan baru
- Kuesioner self-assessment (multi-step)
- Upload dokumen pendukung
Pengajuan Self Declare
- Tabel daftar pengajuan
- Form pengajuan standar
Pengajuan Reguler
- Tabel daftar pengajuan dengan pagination
- Form "Ajukan Layanan"
- Input produk, bahan, proses produksi
Status Permohonan
- Tabel tracking semua pengajuan
- Filter by status
- Detail view per pengajuan
Tagihan / Invoice
- Tabel daftar tagihan
- Status pembayaran (pending, paid, overdue)
Kalkulator Simulasi Perhitungan
- Form input parameter (jenis produk, jumlah, dll)
- Kalkulasi otomatis estimasi biaya
Registrasi SHLN
- Invoice SHLN
- Submission list (add, view, renewal)

Fase 3: Modul Fasilitator

Dashboard Fasilitator
- Statistik UMKM binaan
- Pengajuan pending review
- Kuota program tersisa
- Panduan keamanan akun
Profile Fasilitator
- Form: nama, jenis fasilitator, alamat, wilayah (province/city/district cascading)
- Kodepos, email, PIC name, PIC phone
Daftar Fasilitas
- Tabel program fasilitasi: kode, tahun, nama, jenis, tanggal aktif, kuota, sisa, status
- Alur status penjelasan (Reguler & Self Declare)
Entri Fasilitas
- Form buat program fasilitasi baru
- Tabel list program: nama, tahun, jenis, periode, kuota, status
Inquiry
- Multi-filter: nomor pendaftaran, nama PU, status, tipe, sumber pembiayaan, kode fasilitas
- Tabel hasil dengan checkbox batch selection
- Tombol: View detail, Download Excel, Pembatalan batch
Pembatalan
- Filter: Nama PU, search text
- Tabel: no daftar, tanggal, nama PU, jenis, produk, no sertifikat, status
Invoice Fasilitasi
- Daftar invoice terkait program fasilitasi

Fase 4: Modul Administrator (BARU)

Dashboard Admin
- Kartu statistik: total UMKM, total fasilitator, total pengajuan, sertifikat terbit
- Chart: pengajuan per bulan, per jenis, per status
- Tabel pengajuan terbaru
Manajemen User
- Tabel semua user dengan filter (role, status)
- CRUD user (tambah, edit, hapus)
- Assign/ubah role
- Aktivasi/deaktivasi akun
Manajemen Jenis Sertifikasi
- CRUD jenis sertifikasi (nama, slug, deskripsi, aktif/nonaktif)
Verifikasi & Approval
- Dashboard pengajuan masuk
- Detail view pengajuan lengkap (profil PU, produk, bahan, dokumen)
- Aksi: Approve, Reject, Minta Revisi (dengan catatan)
- Terbitkan sertifikat (nomor, masa berlaku, upload file)
Manajemen Fasilitator
- Tabel semua fasilitator dengan filter
- Detail & verifikasi data fasilitator
Manajemen Pelaku Usaha
- Tabel semua pelaku usaha dengan filter
- Detail & verifikasi data usaha
Laporan & Ekspor
- Laporan pengajuan per periode
- Statistik per wilayah (provinsi/kota)
- Export ke Excel dan PDF
Activity Log
- Tabel log aktivitas: user, aksi, deskripsi, waktu, IP
- Filter by user, aksi, tanggal
Pengaturan Sistem
- Nama aplikasi, logo, kontak
- Konfigurasi email notification
- Maintenance mode

Fase 5: Polish & Testing

Upload & manajemen dokumen (polymorphic)
Notifikasi (email + in-app notification)
Responsive design optimization
Multi-bahasa final check (semua label ID & EN)
UAT (User Acceptance Testing)
Bug fixing & performance tuning
Dokumentasi pengguna

7. Struktur File Project (Target)

halal_web/
├── app/
│   ├── Http/
│   │   ├── Controllers/
│   │   │   ├── Admin/
│   │   │   │   ├── DashboardController.php
│   │   │   │   ├── UserController.php
│   │   │   │   ├── CertificationTypeController.php
│   │   │   │   ├── VerificationController.php
│   │   │   │   ├── FacilitatorController.php
│   │   │   │   ├── BusinessController.php
│   │   │   │   ├── ReportController.php
│   │   │   │   ├── ActivityLogController.php
│   │   │   │   └── SettingController.php
│   │   │   ├── Facilitator/
│   │   │   │   ├── DashboardController.php
│   │   │   │   ├── ProfileController.php
│   │   │   │   ├── FacilitationController.php
│   │   │   │   ├── InquiryController.php
│   │   │   │   ├── CancellationController.php
│   │   │   │   └── InvoiceController.php
│   │   │   ├── Umkm/
│   │   │   │   ├── DashboardController.php
│   │   │   │   ├── BusinessProfileController.php
│   │   │   │   ├── SelfDeclareController.php
│   │   │   │   ├── RegularSubmissionController.php
│   │   │   │   ├── StatusController.php
│   │   │   │   ├── InvoiceController.php
│   │   │   │   ├── CalculatorController.php
│   │   │   │   └── ShlnController.php
│   │   │   └── Auth/
│   │   └── Middleware/
│   │       └── RoleMiddleware.php
│   └── Models/
│       ├── User.php
│       ├── Business.php
│       ├── Facilitator.php
│       ├── FacilitationProgram.php
│       ├── CertificationType.php
│       ├── CertificationSubmission.php
│       ├── Product.php
│       ├── Ingredient.php
│       ├── ProductionProcess.php
│       ├── SelfDeclareAnswer.php
│       ├── Invoice.php
│       ├── Document.php
│       ├── CancellationRequest.php
│       └── ActivityLog.php
├── resources/views/
│   ├── layouts/
│   │   ├── app.blade.php (main layout)
│   │   ├── sidebar.blade.php
│   │   ├── header.blade.php
│   │   └── footer.blade.php
│   ├── admin/
│   │   ├── dashboard.blade.php
│   │   ├── users/
│   │   ├── certifications/
│   │   ├── verification/
│   │   ├── reports/
│   │   └── settings/
│   ├── facilitator/
│   │   ├── dashboard.blade.php
│   │   ├── profile/
│   │   ├── facilitation/
│   │   ├── inquiry/
│   │   ├── cancellation/
│   │   └── invoice/
│   ├── umkm/
│   │   ├── dashboard.blade.php
│   │   ├── business/
│   │   ├── submissions/
│   │   ├── status/
│   │   ├── invoice/
│   │   ├── calculator/
│   │   └── shln/
│   ├── auth/
│   └── components/
├── routes/
│   ├── web.php
│   ├── admin.php
│   ├── facilitator.php
│   └── umkm.php
├── lang/
│   ├── id/
│   └── en/
└── database/
    ├── migrations/
    └── seeders/

8. Catatan Penting

Fitur yang TIDAK diimplementasi (integrasi pihak ketiga):

❌ Integrasi OSS (memerlukan API resmi Kementerian Investasi)
❌ Integrasi BSE (Balai Sertifikasi Elektronik)
❌ Payment Gateway (invoice sebagai tracking manual saja)
❌ reCAPTCHA (bisa ditambahkan nanti jika diperlukan)

Akun Demo untuk Testing:

Role	Email	Password
Administrator	admin@halal.go.id	password123
Fasilitator	priojava1@gmail.com	Jokopurwanto87
UMKM	suprianto2125@gmail.com	Jokopurwanto87$

Appendix A: Master Plan Awal (Referensi Asli)

Catatan berikut adalah plan awal yang dibuat sebelum analisa sistem existing.
Dipertahankan sebagai referensi untuk keputusan arsitektur dan requirement keamanan/performa.

A.1 Arsitektur & Teknologi (Plan Awal)

Backend & Web UI: Laravel 11+ (PHP 8.2+), Blade Templating, Laravel Breeze/Jetstream (dimodifikasi untuk RBAC Spatie).
Mobile App: React Native.
Database: MySQL 8.0+ (dengan optimasi Indexing dan Partitioning untuk data historis).
API: RESTful API menggunakan Laravel Sanctum untuk otentikasi Mobile App.
Localization: Laravel Localization (ID & EN) + i18n untuk React Native.

A.2 Keamanan & Performa (Mandatory)

Security:
- CSRF Protection (Web)
- XSS Prevention
- SQL Injection Guards (ORM strict mode)
- Rate Limiting (mencegah DDoS/Brute-force)
- Sanitasi input ketat
Performance:
- Redis untuk caching kueri berat (misal: dashboard admin) dan manajemen Queue
- Queue untuk pengiriman email/notifikasi agar tidak membebani proses sinkron

A.3 Roadmap Awal (4 Fase)

Fase 1: Setup, Analisa, dan Database Design

Inisialisasi repository Laravel dan React Native.
AI melakukan scraping/crawling ke sistem existing (dibantu user untuk bypass CAPTCHA).
Pembuatan ERD dan Migrasi Database (Tabel Users, Roles, Pengajuan, Bahan, Proses, Log_Aktivitas).
Setup Laravel Spatie Permission untuk 3 Role: SuperAdmin, Fasilitator, UMKM.

Fase 2: Core Backend & Web UI (Laravel Blade)

Setup Multi-bahasa (Localization).
Pembuatan Layout Utama dengan desain UI/UX Government yang profesional, bersih, dan responsif (Tailwind CSS/Bootstrap).
Modul Auth (Login, Register, Lupa Password).
Modul Dashboard masing-masing Role.
CRUD Master Data (Admin).
Flow Pengajuan Sertifikasi (UMKM -> Fasilitator -> Admin).

Fase 3: API & Mobile App (React Native)

Pembuatan Endpoint REST API dengan Sanctum.
Setup navigasi React Native (Stack & Tab Navigator).
Implementasi UI Mobile untuk UMKM (Pengajuan & Tracking) dan Fasilitator (Verifikasi).
Integrasi API Multi-bahasa ke Mobile.

Fase 4: Testing & Deployment

UAT (User Acceptance Testing).
Load Testing ringan.
Persiapan environment production (Nginx server blocks, SSL, optimasi MySQL).

A.4 Catatan Perbedaan Plan Awal vs Plan Final

Aspek	Plan Awal	Plan Final
Laravel Version	11+	12 (sesuai project saat ini)
Role	SuperAdmin, Fasilitator, UMKM	Administrator, Fasilitator, UMKM
Database Design	6 tabel dasar	14+ tabel (berdasarkan analisa sistem existing)
Fitur Detail	Belum dispesifikasi	Detail lengkap per modul per role
Mobile App	React Native (Fase 3)	Ditunda, fokus Web UI dulu
Keamanan	CSRF, XSS, SQLi, Rate Limiting	Sama + ditambahkan ke implementasi
Performa	Redis caching & Queue	Diimplementasi saat fase Polish

Terakhir diperbarui: 16 April 2026