# Modul 02 - Project Setup, RAB, Schedule, dan Handover Eksekusi

Dokumen ini melanjutkan Modul 01. Modul 02 dimulai saat tender sudah `won` dan project/job number dibuat.

## Tujuan Modul

- Membuat project resmi dari tender yang menang.
- Mengunci data awal project: client, scope, nilai kontrak, dokumen tender, dan PIC.
- Menyusun RAB final, BOQ/BOM, quotation final, dan margin.
- Menyusun time schedule, bobot pekerjaan, dan kurva S.
- Menentukan kesiapan procurement, manpower, safety, QC, dan construction.
- Menjadi dasar progress claim dan invoice pekerjaan.

## Menu Utama

- `/master-project`
- `/master-project/rab-page`
- `/rab-project`
- `/master-project/penawaran/{project_id}`
- `/master-project/material-requests`
- `/master-project/purchase-orders`
- `/master-project/warehouse-stock`
- `/master-project/warehouse-receipts`
- `/master-project/warehouse-issues`
- `/master-project/invoice-progress`

## Role Utama

| Role | Tugas |
|---|---|
| Marketing | Handover data tender won ke project. |
| Project Manager | Menentukan PIC eksekusi dan validasi scope kerja. |
| Engineering | Finalisasi RAB, BOQ, BOM, drawing, dan metode teknis. |
| PPIC | Membuat time schedule, bobot progress, dan kurva S. |
| Procurement | Menyiapkan PR/PO berdasarkan kebutuhan project. |
| Warehouse | Mengelola penerimaan, stok, transfer, dan pengeluaran material. |
| Safety | Menyiapkan JSA, izin kerja, dan dokumen HSE. |
| QC | Menyiapkan checklist mutu dan punch list. |
| Finance | Menyiapkan skema penagihan progress claim dan invoice. |
| Management | Approval project execution dan margin final. |

## Flow Proses

```text
Tender Won
        |
        v
Create Project / Job Number
        |
        v
Project Setup
        |
        +-- Client, project name, lokasi, nilai kontrak
        +-- Scope pekerjaan
        +-- PIC project
        +-- Dokumen tender
        |
        v
Engineering Release
        |
        +-- RAB final
        +-- BOQ/BOM
        +-- Quotation final
        +-- Margin final
        |
        v
PPIC Release
        |
        +-- Time schedule
        +-- Bobot pekerjaan
        +-- Kurva S
        +-- Plan manpower
        |
        v
Execution Readiness
        |
        +-- Procurement plan
        +-- Material request
        +-- Safety document
        +-- QC checklist
        |
        v
Approval Project Execution
        |
        +-- Revisi -> kembali ke departemen terkait
        |
        v
Project Active
        |
        v
Modul 03 - Procurement & Material Control
```

## Status Project

| Status | Arti |
|---|---|
| `draft_penawaran` | Project baru dari tender, belum siap eksekusi. |
| `engineering_review` | RAB/BOQ/quotation sedang disusun. |
| `schedule_review` | Schedule dan kurva S sedang disusun. |
| `execution_review` | Kesiapan project sedang dicek. |
| `active` | Project siap dijalankan. |
| `hold` | Project ditunda. |
| `closed` | Project selesai dan ditutup. |

## Data Project Setup

Field minimal:

- Job number / project code.
- Lead/tender reference.
- Client.
- Nama project.
- Lokasi project.
- Nilai kontrak / quotation approved.
- Scope pekerjaan.
- Start date dan end date.
- PIC project manager.
- PIC engineering.
- PIC PPIC.
- PIC procurement.
- PIC safety.
- PIC QC.
- Dokumen tender dan kontrak.

## Data RAB dan Quotation

Field minimal RAB:

- Scope pekerjaan.
- Item pekerjaan.
- Volume.
- Satuan.
- Harga satuan.
- Total biaya.
- Vendor/subvendor optional.
- Markup/margin.
- Revisi.
- Catatan teknis.

Field minimal quotation:

- Nomor quotation/proposal.
- Nilai quotation.
- Dasar RAB.
- Margin persen.
- Margin rupiah.
- Status approval.
- Tanggal kirim.
- Tanggal approve.

## Data Schedule dan Kurva S

Field minimal:

- Scope pekerjaan.
- Tanggal mulai.
- Tanggal selesai.
- Bobot target persen.
- Actual progress persen.
- Billable progress persen.
- Dependency optional.
- Catatan delay.

Rule:

- Total bobot target sebaiknya 100%.
- Billable progress menjadi dasar progress claim.
- Jika actual lebih kecil dari target, tampilkan warning delay.
- Jika schedule belum ada, tombol invoice progress sebaiknya diberi warning.

## Readiness Checklist

| Area | Checklist |
|---|---|
| Engineering | RAB final, BOQ/BOM, drawing, metode kerja. |
| PPIC | Schedule, kurva S, manpower plan. |
| Procurement | Material request awal, vendor, lead time. |
| Warehouse | Gudang tujuan, stok awal, alur issue material. |
| Safety | JSA, izin kerja, APD, dokumen HSE. |
| QC | Inspection plan, checklist mutu, punch list template. |
| Finance | Termin/progress claim, invoice plan, pajak. |

## Aturan Delete Project

- Project tanpa RAB boleh dihapus.
- Project yang sudah punya RAB tidak boleh langsung dihapus.
- Jika salah input, gunakan status `cancelled` atau `hold`.
- Delete hard hanya untuk admin super dengan audit trail.

## Output Modul 02

Output yang wajib ada sebelum masuk Modul 03:

- Project/job number aktif.
- Scope final.
- RAB final atau minimal baseline.
- Schedule dan kurva S.
- PIC eksekusi.
- Kesiapan material awal.
- Dokumen safety/QC minimal.
- Approval execution.

## Kesesuaian AHSP Saat Ini

Status: **70% sesuai**

Yang sudah ada:

- Master Project.
- Create project dari Lead Client saat `won`.
- RAB dan scope RAB.
- Upload/review/commit RAB.
- Quotation project.
- Progress schedule dan kurva S.
- Material request.
- Purchase order.
- Warehouse receipt, stock, issue, transfer, adjustment.
- Progress invoice.

Yang belum rapi:

- Status project belum sepenuhnya mengikuti flow formal Modul 02.
- Approval project execution belum jelas sebagai gerbang sebelum `active`.
- Readiness checklist lintas departemen belum jadi satu panel.
- Handover dokumen dari Lead Client ke Project masih perlu dirapikan.
- Schedule/kurva S belum wajib sebelum progress claim.

## Prioritas Implementasi

1. Rapikan status project.
2. Tambah panel `Project Readiness`.
3. Tambah approval `Project Execution`.
4. Kunci progress invoice jika schedule/kurva S belum siap.
5. Tambah audit trail perubahan RAB, schedule, dan status project.

## Handoff ke Modul 03

Modul berikutnya:

```text
Modul 03 - Procurement & Material Control
```

Isi Modul 03:

- Purchase Request.
- Approval PR.
- Purchase Order.
- Receiving material.
- Warehouse stock.
- Material issue ke project.
- Stock return.
- Cost actual material.

## Deliberate Simplification

`ponytail:` Modul 02 belum perlu accounting jurnal otomatis. Batasnya sampai project siap jalan, schedule disetujui, dan baseline biaya tersedia. Jurnal accounting masuk setelah invoice, payment, dan cost actual matang.