Satu Platform, Semua Kendali Proyek Konstruksi Anda

2. Arsitektur Sistem & Stack Teknologi

Stack teknologi modern Single Page Application (SPA) React dengan REST API PHP & Database MySQL:

3. Skema 19 Tabel Database (`kontraktor_erp`)

Struktur tabel terintegrasi penuh untuk mendukung siklus ERP:

# Product Requirements Document (PRD) — Versi 2.5
## E-Manajemen Project (Kontraktor ERP)
**Sistem Terpadu Manajemen Proyek, Rantai Pasok, Keuangan & Akuntansi Konstruksi Multi-Project**

---

| Metadata Dokumen | Rincian |
| :--- | :--- |
| **Nomor Dokumen** | PRD-EMP-2026-V2.5-ENTERPRISE |
| **Tanggal Pembaruan** | 11 Oktober 2026 |
| **Status** | Disetujui (Approved & Production Ready) |
| **Klasifikasi** | Executive & Engineering Standard |
| **Target Platform** | Web Responsive Desktop & Tablet (SPA React + PHP Backend) |
| **Ekosistem Mitra** | Powered by [transbyte.co.id](https://transbyte.co.id) |

---

## 1. Eksekutif Ringkasan (Executive Summary)

**E-Manajemen Project** adalah Enterprise Resource Planning (ERP) vertikal yang dirancang khusus untuk industri jasa konstruksi (general contractor, sub-kontraktor, dan pengembang properti) di Indonesia. Aplikasi ini mengotomasi dan mengintegrasikan seluruh siklus hidup proyek konstruksi, dari fase tender/estimasi pra-kontrak, eksekusi fisik lapangan, rantai pasok material, tata kelola keuangan per-proyek, hingga pembukuan akuntansi *double-entry* dan kepatuhan perpajakan konstruksi (PPN 11% dan PPh Final 4(2)).

### Masalah Utama Industri & Solusi ERP

```
   MASALAH LAPANGAN KONSTRUKSI                     SOLUSI E-MANAJEMEN PROJECT ERP
┌──────────────────────────────────────┐        ┌──────────────────────────────────────┐
│ Data RAB tercecer di spreadsheet     │  ───►  │ Database Harga & Template SNI Terpadu│
├──────────────────────────────────────┤        ├──────────────────────────────────────┤
│ Deviasi jadwal tidak terdeteksi dini │  ───►  │ Kurva S Otomatis Rencana vs Aktual   │
├──────────────────────────────────────┤        ├──────────────────────────────────────┤
│ Pembelian material tanpa kontrol RAB │  ───►  │ Rantai Validasi MR ➔ PR ➔ PO ➔ Gudang │
├──────────────────────────────────────┤        ├──────────────────────────────────────┤
│ Mandor dibayar melebihi opname fisik │  ───►  │ Kartu Borongan Upah Mandor per Proyek │
├──────────────────────────────────────┤        ├──────────────────────────────────────┤
│ Piutang termin owner macet           │  ───►  │ Modul Termin Berjenjang & Peringatan │
├──────────────────────────────────────┤        ├──────────────────────────────────────┤
│ Pajak & akuntansi dikerjakan manual  │  ───►  │ Jurnal Otomatis & Faktur Pajak Terkait│
└──────────────────────────────────────┘        └──────────────────────────────────────┘
```

---

## 2. Struktur Hak Akses & Matriks Multi-Project (RBAC)

Aplikasi menerapkan sistem isolasi data proyek (**Project Isolation Matrix**) dengan 3 tingkatan utama:

```
                          ┌─────────────────────────────┐
                          │   1. OWNER / SUPER ADMIN    │
                          │   (Global Overview - All)   │
                          └──────────────┬──────────────┘
                                         │
                 ┌───────────────────────┴───────────────────────┐
                 ▼                                               ▼
   ┌───────────────────────────┐                   ┌───────────────────────────┐
   │ 2. ADMIN PROYEK 1 (PM)    │                   │ 2. ADMIN PROYEK 2 (PM)    │
   │ Gedung C Perkantoran      │                   │ Apartemen Sky Tower       │
   └─────────────┬─────────────┘                   └─────────────┬─────────────┘
                 │                                               │
   ┌─────────────┴─────────────┐                   ┌─────────────┴─────────────┐
   ▼                           ▼                   ▼                           ▼
┌──────────────┐        ┌──────────────┐        ┌──────────────┐        ┌──────────────┐
│  Estimator   │        │ Logistik / Gud│        │  Estimator   │        │ Logistik / Gud│
│  Keuangan P1 │        │ Akuntansi P1 │        │  Keuangan P2 │        │ Akuntansi P2 │
└──────────────┘        └──────────────┘        └──────────────┘        └──────────────┘
```

### Matriks Otorisasi Pengguna (RACI Matrix)

| Modul / Fitur | Owner / Dirut | Project Manager (PM) | Estimator / QS | Logistik / Gudang | Finance / Kasir | Akuntan / Pajak |
| :--- | :---: | :---: | :---: | :---: | :---: | :---: |
| **Portofolio Global All Projects** | **A/R** | V (Terbatas) | - | - | V (Terbatas) | V |
| **Buat Proyek Baru & Akun PM** | **A/R** | - | - | - | - | - |
| **Database Harga & Analisa Satuan** | V | V | **A/R** | C | - | - |
| **RAB Proyek & Volume Pembesian** | **A** | C | **R** | - | - | - |
| **Time Schedule & Kurva S** | V | **A/R** | C | - | - | - |
| **Material Request (MR)** | - | **A** | - | **R** | - | - |
| **Purchase Order (PO)** | **A** | C | - | **R** | C | - |
| **Gudang, Surat Jalan & Kartu Stok**| - | V | - | **A/R** | - | - |
| **Sewa Alat Berat & Opname Mandor** | V | **A/R** | - | C | **R** | - |
| **Penagihan Termin ke Owner** | **A** | C | - | - | **R** | C |
| **Jurnal Umum, COA & Buku Besar** | V | - | - | - | C | **A/R** |
| **Pajak PPN & PPh 4(2) Final** | V | - | - | - | - | **A/R** |

*Keterangan: A = Accountable (Pemberi Persetujuan), R = Responsible (Pelaksana), C = Consulted (Pihak Konsultasi), V = Viewer (Hanya Melihat).*

---

## 3. Peta Alur Bisnis Konstruksi End-to-End (The 6-Phase Lifecycle)

Berikut adalah diagram alur kerja siklus hidup proyek dari pra-kontrak hingga serah terima final (FHO):

```
+-----------------------------------------------------------------------------------------+
| FASE 1: ESTIMASI BIAYA & TENDER PRA-KONTRAK                                             |
|                                                                                         |
|  [Database Harga] ───► [Analisa Satuan SNI] ───► [Volume Besi] ───► [Penyusunan RAB]   |
|                                                                            │            |
|                                     [Surat Penawaran Harga (SPH)] ◄────────┘            |
+--------------------------------------------┬--------------------------------------------+
                                             │ Owner Menyetujui & Terbit SPK
                                             ▼
+-----------------------------------------------------------------------------------------+
| FASE 2: KICK-OFF PROYEK & PERENCANAAN LAPANGAN                                          |
|                                                                                         |
|  [Daftar Proyek: Input SPK] ──► [Setup Akun PM Proyek] ──► [Time Schedule & Kurva S]    |
+--------------------------------------------┬--------------------------------------------+
                                             │ Pelaksanaan Lapangan Berjalan
                                             ▼
+-----------------------------------------------------------------------------------------+
| FASE 3: RANTAI PASOK LAPANGAN (SUPPLY CHAIN & LOGISTIK)                                 |
|                                                                                         |
|  [Rencana Bahan] ──► [Material Request (MR)] ──► [Purchase Request (PR)]                |
|                                                               │                         |
|  [Kartu Stok Gudang] ◄── [Surat Jalan / GR] ◄── [Purchase Order (PO ke Vendor)]         |
+--------------------------------------------┬--------------------------------------------+
                                             │ Penggunaan Alat & Pekerja
                                             ▼
+-----------------------------------------------------------------------------------------+
| FASE 4: BIAYA OPERASIONAL & KONTROL PROGRES FISIK                                       |
|                                                                                         |
|  [Update Progres Mingguan] ──► [Kontrak Sewa Alat Berat] ──► [Opname & Upah Mandor]     |
+--------------------------------------------┬--------------------------------------------+
                                             │ Capaian Milestone Fisik
                                             ▼
+-----------------------------------------------------------------------------------------+
| FASE 5: KEUANGAN & PENAGIHAN TERMIN PROYEK                                              |
|                                                                                         |
|  [Penerbitan Invoice Termin] ──► [Faktur Pajak PPN & PPh] ──► [Kas/Bank Masuk Termin]   |
+--------------------------------------------┬--------------------------------------------+
                                             │ Transaksi Otomatis Terbukukan
                                             ▼
+-----------------------------------------------------------------------------------------+
| FASE 6: AKUNTANSI TERPADU & PELAPORAN LABA RUGI                                         |
|                                                                                         |
|  [Jurnal Double-Entry] ──► [Buku Besar] ──► [Neraca & Laba Rugi Real-Time per Proyek]   |
+-----------------------------------------------------------------------------------------+
```

### Rincian Alur Setiap Fase:

#### Fase 1: Estimasi & Tender Pra-Kontrak
1. **Database Harga**: Mengelola standar harga bahan bangunan, tarif sewa peralatan, dan upah harian tenaga kerja di berbagai wilayah.
2. **Template Analisa SNI**: Mengatur koefisien kebutuhan bahan dan tenaga kerja per satuan pekerjaan (misal: 1 m3 Beton K-350 membutuhkan 400 kg semen, 0.54 m3 pasir, 0.81 m3 koral, dan 1.65 OH tukang).
3. **Volume Besi & Beton**: Menghitung berat besi beton tulangan (kg) dari diameter D8, D10, D13, D16, D25 berdasarkan panjang gambar kerja struktur.
4. **RAB & Progress**: Menggabungkan volume dan harga satuan analisa menjadi Rencana Anggaran Biaya (RAB) resmi proyek.
5. **Surat Penawaran**: Menerbitkan surat penawaran harga resmi dengan nomor surat otomatis, masa berlaku, termin pembayaran, dan spesifikasi teknis untuk dikirimkan ke calon owner/klien.

#### Fase 2: Kick-Off Proyek & Penjadwalan
1. **Daftar Proyek**: Setelah tender dimenangkan dan Surat Perintah Kerja (SPK) ditandatangani, proyek didaftarkan dengan nomor kontrak, nilai kontrak, lokasi, dan tanggal mulai/selesai.
2. **Setup Akun Project Manager**: Administrator secara instan membuat akun login khusus Site Manager / PM yang langsung terikat pada `project_id` proyek tersebut.
3. **Time Schedule (Kurva S)**: Merencanakan bobot pekerjaan dari Minggu ke-1 hingga minggu akhir. Sistem secara otomatis menghitung deviasi keterlambatan/percepatan fisik lapangan (`Actual Progress` vs `Planned Progress`).

#### Fase 3: Rantai Pasok Lapangan & Pengadaan Material
1. **Rencana Bahan**: Merinci total kebutuhan material yang boleh diadakan sepanjang umur proyek berdasarkan plafon RAB.
2. **Material Request (MR)**: Diajukan oleh Site Engineer/Mandor dari lapangan ketika suatu material dibutuhkan di lokasi.
3. **Purchase Request (PR)**: Validasi internal oleh tim logistik proyek untuk mengelompokkan MR yang disetujui.
4. **Purchase Order (PO)**: Penerbitan dokumen pemesanan resmi kepada Supplier rekanan yang memuat harga satuan negosiasi, syarat pembayaran, dan tanggal pengiriman.
5. **Surat Jalan / Goods Receipt**: Pemeriksaan fisik material saat truk tiba di proyek. Petugas mencocokkan jumlah fisik dengan PO.
6. **Kartu Stok Gudang**: Sistem secara otomatis menambah stok gudang saat barang diterima (IN) dan mengurangi stok saat material dipakai di lantai kerja (OUT).

#### Fase 4: Biaya Lapangan, Peralatan & Upah Mandor
1. **Update Progres Fisik**: Menginput capaian realisasi fisik mingguan di lapangan untuk pembaruan Kurva S.
2. **Sewa Alat Berat**: Mencatat biaya mobilisasi, demobilisasi, dan sewa harian/bulanan alat berat (Tower Crane, Excavator, Genset, Mobile Crane).
3. **Upah Mandor Borongan**: Mengelola kontrak borongan mandor (bekisting, pembesian, plester acian, MEP). Sistem memisahkan plafon total upah borongan, uang muka yang sudah dicairkan, sisa yang belum dibayar, serta status opname.

#### Fase 5: Keuangan & Penagihan Termin Proyek
1. **Penerbitan Invoice Termin**: Berdasarkan capaian milestone fisik (misal: Uang Muka 20%, Progres 40%, Progres 70%, PHO 95%, dan Retensi 5%), invoice resmi diterbitkan kepada Owner.
2. **Pencairan Termin Kas & Bank**: Saat owner mentransfer dana termin, dana dicatat masuk ke rekening penampungan proyek dan kasir menerbitkan kuitansi.
3. **Pinjaman Modal Kerja**: Fasilitas kredit bank (KMK) dipantau tenor, cicilan bulanan, bunga, dan sisa pokok pinjamannya.

#### Fase 6: Akuntansi & Pelaporan Keuangan Proyek
1. **Pajak Konstruksi**: 
   - PPN Keluaran 11% dari nilai termin owner.
   - PPN Masukan 11% dari faktur supplier material.
   - PPh Final Pasal 4(2) Jasa Konstruksi (1.75% untuk kualifikasi menengah / 2.65% kualifikasi kecil).
2. **Jurnal Umum Otomatis**: Setiap transaksi pencairan kas, pengakuan utang supplier, dan penerimaan termin secara otomatis menghasilkan entri jurnal *double-entry* (Debit & Kredit) tanpa perlu input ulang manual.
3. **Buku Besar & Neraca Konsolidasi**: Menghasilkan Laporan Laba Rugi per-proyek (Pendapatan Termin dikurangi Beban Material, Upah Mandor, dan Sewa Alat) serta Neraca Perusahaan.

---

## 4. Spesifikasi Arsitektur Database & Relasi Tabel

Database `kontraktor_erp` menggunakan mesin MySQL/MariaDB dengan relasi terindeks:

```
┌─────────────────┐       1:N       ┌─────────────────┐       1:N       ┌─────────────────┐
│    projects     │────────────────►│      rabs       │────────────────►│    po_items     │
└────────┬────────┘                 └─────────────────┘                 └────────▲────────┘
         │                                                                       │
         │ 1:N                      ┌─────────────────┐       1:N                │
         ├─────────────────────────►│material_requests│─────────────────┐        │
         │                          └────────┬────────┘                 │        │
         │                                   │ 1:N                      │        │
         │                                   ▼                          ▼        │
         │                          ┌─────────────────┐        ┌────────┴────────┴┐
         │                          │    mr_items     │        │    po_headers    │
         │                          └─────────────────┘        └────────▲─────────┘
         │                                                              │
         │ 1:N                                                          │ N:1
         ├─────────────────────────►┌─────────────────┐                 │
         │                          │    schedules    │        ┌────────┴─────────┐
         │                          └─────────────────┘        │    suppliers     │
         │ 1:N                                                 └──────────────────┘
         ├─────────────────────────►┌─────────────────┐
         │                          │     termin      │
         │                          └─────────────────┘
         │ 1:N
         ├─────────────────────────►┌─────────────────┐
         │                          │   upah_mandor   │
         │                          └─────────────────┘
         │ 1:N
         ├─────────────────────────►┌─────────────────┐
         │                          │    sewa_alat    │
         │                          └─────────────────┘
         │ 1:N
         └─────────────────────────►┌─────────────────┐
                                    │    karyawan     │ (Multi-Project Login User)
                                    └─────────────────┘
```

---

## 5. Ringkasan API Endpoints Utama

Seluruh endpoint menghasilkan format **JSON murni** dengan response code HTTP yang sesuai:

| Endpoint | Method | Fungsi & Payload |
| :--- | :---: | :--- |
| `/api/login.php` | `POST` | Autentikasi email/NIK + password, mengembalikan token session, profil user, dan cakupan proyek (`ALL` atau `project_id`). |
| `/api/projects.php` | `GET, POST` | Mengambil seluruh portofolio proyek atau mendaftarkan proyek baru beserta akun login PM-nya. |
| `/api/rabs.php` | `GET, POST` | Mengambil item RAB berdasarkan `?project_id={id}` atau menambahkan item volume satuan baru. |
| `/api/schedule.php` | `GET, POST` | Mengelola data kurva S mingguan (`planned_progress` vs `actual_progress`) per proyek. |
| `/api/mr.php` | `GET, POST` | Pengajuan Material Request (MR) dari lapangan beserta rincian item barang dan quantity. |
| `/api/po.php` | `GET, POST` | Penerbitan Purchase Order kepada supplier rekanan dan tracking status approval. |
| `/api/warehouse.php`| `GET, POST` | Mutasi stok gudang real-time (IN / OUT) dan Kartu Stok barang. |
| `/api/termin.php` | `GET, POST` | Pencatatan termin penagihan progres fisik proyek ke owner. |
| `/api/upah-mandor.php`| `GET, POST` | Administrasi borongan mandor, volume kerja, DP, dan sisa pembayaran. |
| `/api/sewa-alat.php`| `GET, POST` | Manajemen masa sewa dan perhitungan tarif harian alat berat. |
| `/api/pajak.php` | `GET, POST` | Pencatatan faktur PPN Masukan/Keluaran dan PPh Final 4(2) konstruksi. |
| `/api/jurnal.php` | `GET, POST` | Pembukuan akuntansi double-entry (Debit & Kredit) per transaksi proyek. |
| `/api/profile.php` | `GET, POST` | Pengaturan identitas perusahaan kontraktor, logo kop surat, dan informasi legalitas. |

---

## 6. Standar Kualitas Antarmuka & UX (Design Principles)

1. **Visibilitas Konteks Proyek Nyata**:
   Header dan sidebar wajib menampilkan indikator proyek aktif yang sedang dipantau (Owner All Access vs PM Single Project Access) sehingga pengguna tidak salah kamar data.
2. **Kontras & Keterbacaan Sempurna**:
   Semua kolom isian formulir (input fields, select boxes) menerapkan kontras tinggi dengan latar belakang yang jelas, kursor aktif berwarna aksen oranye, dan bebas dari isu benturan warna teks vs latar belakang.
3. **Data Pre-population & Responsif Cepat**:
   Tabel proyek dan detail panel langsung terisi secara default (*zero empty awkward state*) dengan indikator grafik, rincian biaya, dan tautan langsung ke modul terkait.
4. **Bebas Ketergantungan Eksternal**:
   Sistem berjalan 100% mandiri pada server lokal XAMPP maupun server intranet tanpa membutuhkan koneksi internet publik untuk operasi inti.

---

> **E-Manajemen Project ERP** — *Efisiensi, Akurasi Anggaran, dan Kendali Terpadu Portofolio Konstruksi.*